huashu-mac-use — скилл
Скилл учит агента управлять нативными приложениями Mac без API: чтение в фоне, запись без кражи фокуса, снимок каждого шага.
- 343 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент получает управление мышью, клавиатурой и снимками окон приложений на Mac, включая окна с личными данными.
- Скилл просит права «Запись экрана» и «Универсальный доступ» для терминала: они действуют для всех процессов из него.
- Ошибочное действие в приложении без отмены, например удаление или перезапись, может необратимо изменить данные.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/huashu-mac-useОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает управление мышью, клавиатурой и снимками окон приложений на Mac, включая окна с личными данными.
- Скилл просит права «Запись экрана» и «Универсальный доступ» для терминала: они действуют для всех процессов из него.
- Ошибочное действие в приложении без отмены, например удаление или перезапись, может необратимо изменить данные.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл `huashu-mac-use` выбирает канал управления по устройству приложения. Сначала проверяются его собственный CLI, словарь AppleScript, URL-схемы и локальные порты (в том числе отладочный порт встроенного Chromium), затем дерево доступности, координаты окна и пиксели. Чтение (снимки окон, список окон, дерево доступности) идет в фоне и не переключает рабочий стол. Запись по умолчанию отправляется прямо процессу приложения, а перед любым выводом на передний план срабатывают четыре проверки. Каждый шаг сопровождается снимком, оригиналы не удаляются. Ядро на Swift компилируется скриптом `build.sh` при первом запуске.
Для кого. Пользователям Claude Code, Codex и Cursor на macOS, которым нужно автоматизировать приложения без публичного API, не мешая своей работе.
Подходит, если
- Агент должен собрать сцену в Blender, пока пользователь работает в другом окне.
- Нужны скриншоты процесса в приложении без API, снятые в фоне.
- Перед автоматизацией проверяют, есть ли у приложения CLI, порт или словарь AppleScript.
- Каждое действие агента требуется подтвердить снимком для отчета.
Не подходит, если
- Задачу решает штатный API или CLI приложения.
- Нужно кликать по кнопкам оплаты, отправки и удаления без участия человека.
- Компьютер не macOS.
Пример запроса к агенту
Проверь, можно ли автоматизировать «Системные настройки», и сними фоновый скриншот окна, не переключая мой рабочий стол.Ограничения
Работает только на macOS, нужны Xcode Command Line Tools и Node.js, а терминалу выдают права «Запись экрана» и «Универсальный доступ». Скилл сам останавливается на необратимых действиях, диалогах доступа и связке ключей, но в терминале и IDE нажатие Enter равно доступу к оболочке. Описание и документация на китайском. Для приложений без доступного фонового снимка скилл временно берет фокус. Автор сам пишет, что часть возможностей скоро может покрыть штатный computer use моделей. Последний коммит в октябре 2026.
Как отключить. Удалите папку `~/.claude/skills/huashu-mac-use` и снимите права «Запись экрана» и «Универсальный доступ» у терминала в системных настройках.
Частые вопросы
Что делает скрипт probe.sh?
Он проверяет приложение перед работой: архитектуру, URL-схемы, словарь AppleScript, локальные порты и число редактируемых элементов в дереве доступности.
Мешает ли скилл работе пользователя?
По замыслу нет. Чтение идет в фоне, запись по умолчанию без фокуса, а при необходимости фокус занимается на доли секунды и возвращается.
Какие действия скилл не выполняет сам?
Публикацию, оплату, удаление, перезапись, диалоги прав доступа и связку ключей он оставляет человеку.
Нужны ли особые права в macOS?
Да. Терминалу, из которого запускается агент, выдают «Запись экрана» и «Универсальный доступ». Смена терминала требует выдать права заново.
Что такое четыре проверки перед фокусом?
Это защитные условия перед выводом окна на передний план, например проверка, что активно целевое приложение. Режим `--dry` показывает вердикт каждой без выполнения.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыMCP-сервер на Swift дает агенту управлять любым приложением macOS: кликать, печатать и читать дерево интерфейса
Mano skill
Mano skill (mano-cua)
CLI и скилл для управления рабочим столом по текстовой задаче: скриншоты, клики, ввод, прокрутка, в облаке или локально на Apple Silicon
CLI и MCP-сервер для macOS: скриншоты, разбор интерфейса через accessibility и управление приложениями по кликам и вводу
CLI ведет Mac к цели из одной фразы: читает экран кодом, выбирает действия дешевой моделью, пишет текст большой.
DesktopCtl — локальный CLI для macOS: агент смотрит на экран через OCR, кликает и печатает, облако и зрение у модели не нужны
MCP-сервер управления рабочим столом macOS через Accessibility API: клики, ввод, окна, приложения, команды и AppleScript
Коротко о README
Четыре слоя управления: структурный интерфейс приложения, дерево доступности, координаты окна и пиксели. Выбор слоя зависит от того, что показал предварительный зонд.