用途:把用户的微信账号与智能体连接起来,以便通过 send_to_wechat 推送消息。wechat 工具本身是内置的,本技能为其参考文档。相关参考包括消息通道说明配置,以及类似的 Telegram 绑定流程 skills/tg-bot-binding/SKILL.md。
主要能力(action):status 查看当前微信连接状态;qrcode 生成二维码图片并保存到工作区,返回 qrcode(id)与 file_path;qrcode_status 需传 qrcode,轮询用户是否已扫码并确认,成功后返回 bot_token;connect 需传 bot_token,完成首次微信连接,可选 ilink_bot_id、ilink_user_id(多账号时);disconnect 断开当前微信会话(解绑);reconnect 需传 bot_token,重新建立此前绑定过的微信连接(token 来自新扫码)。
典型绑定流程:qrcode → 用户扫码 → qrcode_status(qrcode=...) → connect(bot_token=...)。生成二维码后用合适方式展示给用户:Web 渠道在回复中包含 file_path,由前端内联渲染;Telegram 渠道用 send_to_telegram(file_path=<qr_path>, message_type="photo") 发送图片;若用户本身在微信里,则无法这样发,应让其打开 Web 应用。用户扫码并确认后先等其回复“已扫”或“完成”,再轮询 qrcode_status,成功后立即把 bot_token 传给 connect 或 reconnect,并告知用户已连接。
connect 与 reconnect 的区别:connect 用于首次绑定(此前从未绑定过);reconnect 用于此前连接过但连接掉线(如 ilink 会话过期)且刚重新扫码的情况。不确定时先调用 status:connected 为 false 且无历史记录用 connect;connected 为 false 且存在先前记录用 reconnect。
限制与注意事项:qrcode 之后不要自动轮询 qrcode_status,以免向上游 API 发送大量请求;每次 qrcode 调用生成新图片,不要用旧 qrcode id 配新图片,上游会话与 id 绑定;bot_token 是凭据,绝不能在聊天中粘贴,拿到后立即传给 connect/reconnect 且不回显给用户;disconnect 具有破坏性,调用前需与用户确认。