formulahendry/wechat-acp

解决的问题

wechat-acp 是一个桥接工具，允许用户通过 WeChat 直接消息与 ACP 兼容的 AI 代理（如 Copilot CLI、Claude Code 或 Gemini）进行交互。它通过将 WeChat 消息路由到本地 AI 代理，并将代理的响应返回给用户，从而无需使用终端或专用 AI 应用程序。

工作原理

该工具通过 WeChat iLink 机器人 API 登录，并轮询接收的 1:1 消息。当收到消息时，它会将内容转发给本地运行的配置好的 ACP 代理（通过 stdio），并为每个 WeChat 用户管理专用会话。它支持多种数据类型，可将代理输出（如图像、音频和文件）转换为原生 WeChat 消息。此外，还提供缓冲模式，可将多个 WeChat 消息（文本、图像、文件）合并为单个代理请求，避免触发多个独立的交互回合。

适用人群

希望通过移动消息界面访问本地 AI 代理或基于 CLI 的 AI 工具的开发者和高级用户，或希望通过本地注入命令在 WeChat 中自动化 AI 交互的用户。

主要特性

• 多代理支持：内置对 Claude、Gemini、Qwen 和 Copilot 等流行代理的预设支持。
• 会话管理：支持每个用户的独立会话，可选择在重启后保持状态持久化。
• 富媒体处理：在 WeChat 与代理之间转发图像、音频和文件；将接收到的二进制文件保存到磁盘，供代理访问。
• 桥接命令：内置斜杠命令用于会话重置（/acp-new）、回合取消（/acp-cancel）和配置（/acp-config）。
• 本地注入：允许外部脚本或 cron 任务将消息排队，供代理处理并通过 WeChat 回复。
• 实例隔离：支持运行多个桥接实例，使用不同的 WeChat 账号和项目目录。