wechat-assistant-for-claude

Claude Skill для управления Windows-клиентом WeChat через computer-use — отправка и ответы на сообщения в групповых и личных чатах.

Skill написан на упрощённом китайском, поскольку целевое приложение (微信) и целевая аудитория — китайскоязычные пользователи.

---

Что умеет этот Skill

• Отправить сообщение в указанный групповой или личный чат
• Прочитать несколько последних сообщений и сгенерировать «уместный» ответ с учётом темы, отношений и тона переписки
• Отследить новые сообщения собеседника и продолжить диалог

Зачем нужен отдельный Skill

Десктопный WeChat не имеет официального API — Claude вынужден работать через «скриншот + визуальное распознавание + эмуляция мыши и клавиатуры». При реальном запуске на Windows обнаружился ряд конкретных проблем: потеря китайских символов при вводе, ложные ошибки авторизации Wechatappex в процессе запуска, случайный запуск нового экземпляра через open_application с разрушением уже авторизованной сессии, скрытый в трее UI при работающем процессе, случайное открытие «Помощника по передаче файлов» вместо нужного чата. После отладки всех этих случаев стабильный сценарий был зафиксирован в Skill — чтобы Claude не наступал на те же грабли заново.

Поддерживаемые платформы

• ✅ Windows — полный сценарий проверен лично, только на WeChat 4.1.8.29 (Weixin.exe, UI на WebView2)
• ❓ macOS / Linux — не тестировалось. Windows-специфичные проблемы вроде ложной авторизации Wechatappex на macOS могут отсутствовать, однако расположение UI, имена процессов, горячие клавиши и механизм фокуса окна отличаются — даже при успешном запуске шаги из этого Skill могут не подойти.

Установка

Способ 1: импорт через Cowork UI (рекомендуется, проще всего)

В интерфейсе Cowork нажмите Customize в правом верхнем углу → откройте панель Skills → импортируйте SKILL.md. Вручную указывать пути и перезапускать не нужно.

Способ 2: ручное размещение в директории skills

Поместите SKILL.md в директорию skills в отдельной подпапке:

<ваша директория .claude>/skills/wechat-reply-assistant/SKILL.md

Например:

• Cowork mode: ~/.claude/skills/wechat-reply-assistant/SKILL.md
• Claude Code на уровне проекта: <проект>/.claude/skills/wechat-reply-assistant/SKILL.md

После перезапуска Claude Skill автоматически появится в списке доступных.

Ключевые фразы для активации

Skill активируется, если в диалоге встречаются фразы вида:

• «帮我发个微信给 XX» (отправь WeChat-сообщение XX)
• «回复一下 XX» (ответь XX)
• «在 XX 群里说一下 ...» (напиши в группе XX)
• «跟进一下 XX 的消息» (отследи сообщения от XX)

Явно упоминать «微信» необязательно — достаточно контекста мессенджера с фразами «отправить XX / написать в группе / ответить».

Взаимодействие после активации

Skill задаёт только один вопрос: сгенерировать ответ автоматически на основе последних сообщений или ввести текст вручную. После выбора выполнение идёт до конца без повторных подтверждений, просмотра черновика и уточняющих вопросов — вплоть до реальной отправки сообщения. Единственное возможное прерывание — одно окно request_access для запроса разрешений.

Предварительные требования

1. Авторизованный Windows-клиент WeChat. Skill не выполняет вход по QR-коду — при появлении экрана сканирования потребуется сканирование вручную.
2. Доступный computer-use MCP — в начале задачи единовременно запрашиваются следующие разрешения:
   • 微信 (все дочерние процессы WeChat 4.1.8.29 называются Weixin.exe и маппятся resolver'ом обратно на «微信» — достаточно одного этого разрешения; не добавляйте варианты Wechatappex / msedgewebview2.exe / Weixin — resolver их отклонит)
   • 文件资源管理器 (область трея принадлежит процессу Explorer; нужен для поиска иконки WeChat в трее и для обхода ложной ошибки авторизации Wechatappex)
   • clipboardWrite запись в буфер обмена (китайский текст необходимо передавать через буфер — прямой ввод через type приводит к потере символов)
3. Рекомендуется монопольное использование переднего плана. Во время работы Skill не перехватывайте управление мышью и клавиатурой — это может привести к кликам в неверных местах.

Ключевые особенности реализации

Полное содержание — в SKILL.md. Ниже перечислены наиболее частые источники ошибок:

• Не вызывайте open_application("微信") сразу. Если WeChat уже запущен в фоне, прямой вызов open_application инициирует процедуру входа нового экземпляра и разрушает текущую авторизованную сессию. Правильный порядок: сначала попытаться активировать существующий экземпляр через панель задач или трей, и только если не найден — запустить новый.
• Решение ложной ошибки авторизации Wechatappex — open_application("文件资源管理器"). На некоторых промежуточных этапах запуска WeChat процесс Wechatappex захватывает передний план, из-за чего left_click блокируется проверкой frontmost-app. Открытие Проводника перехватывает фокус — это не реальная проблема с разрешениями, поэтому не добавляйте разрешения для Wechatappex (resolver их отклонит).
• Китайский текст — только через буфер обмена. Используйте write_clipboard + ctrl+v; не применяйте type для прямого ввода китайских символов.
• Перед отправкой читайте 5–10 последних сообщений. Сообщение должно звучать как написанное «самим пользователем»: отвечать на последние темы собеседника, использовать уже сложившиеся в переписке имена, тон и emoji — без шаблонных фраз и выдуманных фактов.
• Операцию отправки выполняйте через computer_batch за один раз для сокращения числа итераций. После отправки делайте screenshot для подтверждения появления сообщения в области диалога.

Конфиденциальность и ограничения по действиям

• Сообщения отправляются только по явному запросу пользователя и только указанному адресату. История чата читается исключительно для составления текущего сообщения и не передаётся третьим лицам и не записывается в другие документы.
• Не выполняется: удаление сообщений, отзыв сообщений, изменение настроек группы, исключение участников, переводы, отправка красных конвертов. Эти чувствительные действия должен выполнять сам пользователь.
• Чувствительные данные из переписки (номера удостоверений личности, банковские счета, пароли, медицинская информация и т. п.) не цитируются и не сохраняются.

Ограничения

• Официального API нет — работа полностью основана на визуальном распознавании и эмуляции ввода. При изменении UI в новых версиях WeChat может потребоваться повторная калибровка логики определения координат. При сбоях сначала делайте screenshot и сравнивайте — это поможет определить, на каком шаге перестала работать локализация элементов.
• Поддерживаются только текстовые сообщения; голосовые и видеозвонки, отправка изображений и файлов не поддерживаются.

Участие в разработке

Issue и PR приветствуются. Если вы столкнулись с проблемами на других версиях Windows или WeChat, не описанными в этом Skill, — опишите симптомы, сообщения об ошибках и своё решение. Это наиболее ценный вклад в развитие Skill.

Лицензия

MIT © 2026 ZHOU JUNAN