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 帳號和專案目錄。