Anionex/dsh-computer-use

Anionex

Плагин для DeepSeek Harness, дающий агенту управление macOS через Accessibility API: наблюдения, привязка действий к состоянию и безопасный ввод без перехвата курсора.

Это нативный macOS-бандл для DeepSeek Harness, который позволяет агенту наблюдать и управлять интерфейсом приложений через Accessibility API. Нужен разработчикам, которые строят агентов для настольных задач и хотят избежать перехвата курсора и глобального ввода.

Ключевые возможности

  • Возвращает ограниченное дерево Accessibility с индексами элементов и метаданными процесса и окна.
  • Каждое действие привязано к конкретному наблюдению и отклоняется при устаревшем состоянии.
  • Семантический ввод через Accessibility имеет приоритет над резервными кликами и клавиатурой.
  • Резервный ввод направлен на конкретный процесс и окно, а не на глобальный поток событий.
  • Отдельный программный курсор анимируется без перемещения системного указателя.
  • Область доступа ограничена выбранными приложениями и проверяется после каждого действия.

Для каких задач подходит

  • Автоматизация рутинных операций в настольных приложениях macOS без вмешательства в работу пользователя.
  • Построение агентов, которым нужно читать состояние интерфейса и выполнять действия по Accessibility.
  • Задачи, где важно не перехватывать фокус и курсор, пока пользователь работает в другом приложении.
  • Сценарии с подтверждением человеком перед выполнением шагов в интерфейсе.
  • Тестирование и отладка агентных сценариев на macOS с проверкой состояния после действий.

Подробнее

DSH Computer Use — это плагин для DeepSeek Harness, который добавляет агенту нативный слой действий в macOS. В основе лежит Accessibility API: агент сначала получает наблюдение — ограниченное дерево элементов с индексами, метаданными процесса и окна, состоянием разрешений и опциональным скриншотом. Действия привязываются к этому наблюдению через opaque targetHandle, а устаревшие состояния отклоняются, чтобы агент не работал вслепую по изменившемуся интерфейсу.

Отличие от типичных решений для computer use — в маршрутизации ввода. По умолчанию плагин не двигает системный курсор и не инжектит глобальные события: клики, скролл и перетаскивание идут через адресованный процессу и окну маршрут SkyLight. Семантический ввод через Accessibility стоит первым, а резервные мышь и клавиатура направлены на выбранный процесс. Отдельный программный курсор анимируется только когда целевое приложение на переднем плане, а системный указатель остаётся нетронутым. Политика клавиатуры настраивается: preserve не активирует приложение, activate выводит целевое приложение вперёд перед вводом с клавиатуры.

Стоит учитывать привязку к macOS 14+ и к экосистеме DeepSeek Harness: это не самостоятельный инструмент, а бандл для конкретного харнесса. Разрешение Accessibility даёт процессу доступ к элементам интерфейса, но само по себе не защищает от перехвата фокуса — здесь это решается маршрутом ввода. Лицензия MIT.

Частые вопросы

Как установить dsh-computer-use?

Отдельной команды установки в README нет — склонируйте репозиторий и следуйте инструкции из README:

git clone https://github.com/Anionex/dsh-computer-use.git

Какие задачи решает dsh-computer-use?

Репозиторий решает задачу управления настольными приложениями macOS из агента DeepSeek Harness: он даёт свежие наблюдения Accessibility, точное нацеливание на процесс и окно и проверку состояния после действия. Дополнительно он закрывает безопасность ввода — отклоняет устаревшие состояния и не перехватывает системный курсор и фокус по умолчанию.

Какие требования к системе для dsh-computer-use?

Нужна macOS 14 или новее; бандл собирается как универсальный бинарник для arm64 и x86_64. Также требуется DeepSeek Harness, для которого этот плагин предназначен.

Чем этот плагин отличается от других решений computer use?

По умолчанию он не двигает системный курсор и не инжектит глобальные события: резервный ввод адресован конкретному процессу и окну через SkyLight. Семантический Accessibility стоит первым, а каждое действие привязано к наблюдению и отклоняется при устаревшем состоянии.

Можно ли использовать dsh-computer-use в коммерческих проектах?

Да, репозиторий распространяется под лицензией MIT, которая допускает коммерческое использование при сохранении уведомления об авторских правах.