ides_adapter_weixin

微信（WeChat iLink Bot）adapter for IDES channel——让微信消息驱动 IDES agent。

按 IDES 的 外挂配置哲学：这是一个独立的 Python 进程，通过 MCP（stdio）接入 IDES，用 channel 机制收发消息。底座（Rust）不碰微信协议，翻译全在这。

Quick Start（给 agent 看：怎么装、怎么连）

1. 注册 MCP server

IDES 通过 mcp/*.toml 注册 MCP server。在 IDES_HOME 的 mcp/ 目录下放 weixin.toml：

name = "weixin"
transport = "stdio"
command = "uvx"
args = ["ides-adapter-weixin"]
enabled = true
exclude = []

[env]
IDES_HOME = "<你的 IDES_HOME>"
WEIXIN_ACCOUNT_ID = "default"

本地开发版（还在迭代不想发布）：把 command 换成 uv，args 换成 ["run", "--with", "<项目路径>", "ides-adapter-weixin"]。

agent 也可以用 mcp_manager 工具自动注册（mcp_manager add weixin ...），不用手改 toml。

2. 连接

IDES 启动时自动拉起 MCP server（stdio）。注册后，IDES 会暴露 3 个工具，命名 mcp_weixin_<tool>：

3. 登录（必须做，否则收不到消息）

agent 调 weixin_qrcode_login：

mcp_weixin_weixin_qrcode_login

返回一个二维码（qr_image_path 是落盘的图片，qrcode_url 是完整 liteapp URL）。agent 自行决定展示方式——转成图片给用户扫 / 直接给 URL / 命令行渲染，都行。

二维码会自动渲染落盘到 <IDES_HOME>/weixin/qrcode.png，agent 直接展示这张图即可。

用户用微信扫码，确认后工具自动拿到 token 存起来（后登录，不用启动时登录）。

4. 收发消息

登录成功后：

• 收：调 mcp_weixin_channel_ingest，返回 {"messages":[{"msg_id","from","text","timestamp"}]}。未登录时返回 {"messages":[]}（零打扰，感知层自动过滤）。
• 发：调 mcp_weixin_channel_emit，传 text（要发的文本）+ to_user_id（收件人，用消息里的 from）。

环境变量

单账号即可，不用多账号（微信 iLink Bot 本身不支持多 claw 绑定）。

实现参考

核心 API 参考 hermes-agent 的 gateway/platforms/weixin.py（已验证的 iLink Bot API），按 IDES channel 契约精简重做，不依赖 hermes-agent 生态。

License

MIT