Little Mouse Pointer

English README

Этот репозиторий предоставляет Little Mouse Pointer — инструмент выбора UI-контекста для рабочего стола Windows, предназначенный для AI-агентов. Пользователь может мышью выбрать окно, элемент интерфейса или область экрана; контекст получается через UI Automation, снимки экрана и локальный OCR, и после подтверждения передаётся через MCP в OpenAI Codex, DeepSeek Harness или другие совместимые клиенты.

Каталог плагина — plugins/little-mouse-pointer. Полное описание функций, протокола и среды выполнения см. в README в каталоге плагина.

Документация

• Учебник для новичков: полный процесс первой установки, первого выбора и часто задаваемые вопросы.

• Контрольный список установки для новичков: пошаговая проверка для Codex, DeepSeek Harness и ручного запуска.

• Полный README плагина: функции, процесс использования, ограничения конфиденциальности и границы отказов.

• Примечания по среде выполнения: самодостаточный пакет запуска, run.ps1 и поведение MCP stdio.

• Конфигурация DeepSeek Harness: ручная конфигурация Cordis, когда bundle недоступен.

• Описание протокола: поля вывода инструмента и процесс подтверждения.

Related MCP server: atomic-computer-mcp

Установка в Codex из GitHub

Выполните в PowerShell следующую команду, заменив OWNER/REPOSITORY на фактический репозиторий GitHub:

codex plugin marketplace add OWNER/REPOSITORY --ref main
codex plugin add little-mouse-pointer@auto-mouse

Если нужно загрузить только каталог плагина, можно использовать zip-архив релиза GitHub или установить локально уровень plugins/little-mouse-pointer. Не принимайте корень репозитория за непосредственный корень плагина.

Интеграция с DeepSeek Harness

Скопируйте Контрольный список установки на китайском или English installation checklist, затем обратитесь к Конфигурации DeepSeek Harness и измените пути на фактические каталоги. MCP stdio должен запускаться напрямую:

plugins/little-mouse-pointer/app/MousePointer.Windows.exe

Не используйте run.ps1 в качестве моста для MCP stdio; run.ps1 предназначен только для ручного запуска GUI и self-test.

Прямая установка Harness bundle из GitHub

В корне репозитория также предоставляется установочный пакет, соответствующий спецификации Harness dsh.bundle. Рекомендуется зафиксировать тег релиза:

dsh plugin --profile demo add github:Fish121380/auto-mouse#v0.1.1
dsh --profile demo --dump-config

Этот bundle автоматически находит свой собственный Windows x64 exe и регистрирует @deepseek-ai/dsh-mcp-client. Он работает только на Windows x64; порт можно переопределить в cordis.patch.yml профиля:

- replace:
    - id: little-mouse-pointer
      config:
        port: 49154

Проверка перед установкой

• Windows 10/11 x64.

• Устанавливать .NET не требуется, дистрибутив уже self-contained.

• Сохраняйте все файлы plugins/little-mouse-pointer/app.

• Порт по умолчанию — 49153, endpoint и MOUSE_POINTER_HTTP_PORT должны совпадать.

• Перед запуском Codex/Harness закрывайте старые экземпляры Little Mouse Pointer.

• Инструменты MCP: ui_context_pick, ui_context_current, ui_context_clear.