个人微信扫码连接
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-yq-weixin-connect。
技能介绍
问题
当 AI Agent 需要替用户完成个人微信扫码登录时,二维码有效期短、返回的 qrcode_img_content 是网页 URL 而非图片,轮询和凭证写入又很容易出错。这个技能把容易踩坑的流程收敛成固定步骤。
工作方式
- 严格限定个人微信:遇到“连接个人微信”等关键词时触发;企业微信 / WeCom 不使用本技能。
- 快速拿到可展示二维码:安装 legacy 插件、请求二维码后,将 URL 字符串用
qrcode库编码为 PNG,并通过 CDN 展示;CDN 失败时回退到 workspace 文件。 - 等待用户确认:展示二维码后不自动轮询,等用户说 ok 后再进入长轮询;根据
wait、scaned、confirmed、expired分支处理。 - 写入凭证并重启:confirmed 后提取
ilink_bot_id、bot_token、baseurl、ilink_user_id,注意bot_token已包含前缀,不能二次拼接,然后写入配置并重启 Gateway。
适用边界
只适用于个人微信扫码接入;不适合企业微信、消息群发、客服机器人或需要自动主动发消息的场景。执行时必须避免直接下载二维码 URL、避免拆分过多命令、避免手动改写配置文件。
使用场景
- 在 AI Agent 中为用户完成个人微信扫码登录并重启 Gateway
- 把个人微信账号绑定到本地 Gateway 并等待用户扫码确认
- 二维码过期后重新获取个人微信登录码并继续完成认证
- 用个人微信登录流程生成可展示二维码,避免误触发企业微信
适合人员
- 负责接入个人微信消息入口、需要稳定扫码登录的 Agent 工程师
- 要调试 Gateway 凭证写入和重启流程的自动化工程师
- 需要把个人微信扫码流程写成固定步骤的 AI 应用开发者
- 在本地环境绑定个人微信账号并验证登录状态的集成工程师