前言¶
DeepSeek Harness 微信连接插件是一个客户端插件，用于将微信账号接入 DeepSeek Harness。插件运行在 dsh web 的 Host 进程内：设置页只负责显示一次性二维码和脱敏状态，扫码得到的 bot_token 直接写入 Harness 凭据服务，随后由 Host 通过腾讯 iLink Bot API 长轮询收消息并把回答发回微信。该插件由 1841220388zzzcccxxx-star 维护，采用 MIT 许可证。
前提条件¶
使用前需满足以下环境要求：
* DeepSeek Harness 版本：0.1.0-rc.6
* Node.js 版本：>=22.19
* 手机微信账号需已开通机器人功能（腾讯分批开放，若微信里尚未出现相关入口，请先检查「我 → 设置 → 插件」；该功能由腾讯分批开放，插件代码无法绕过账号侧的开放范围）
* 运行 Harness 的设备能够访问 *.weixin.qq.com
安装与扫码绑定¶
- 执行安装命令：
npx -y github:1841220388zzzcccxxx-star/dsh-wechat install
- 重启
dsh web。 - 打开「设置 → 插件 → 微信」。
- 点击「扫码绑定微信」。
- 使用手机微信扫描页面上的二维码，并在手机上确认。
- 如果手机显示配对数字，在 Harness 页面输入该数字。
扫码成功后必须同时满足以下条件，页面才会显示在线：
1. 腾讯 iLink 返回 bot_token、机器人账号 ID、扫码用户 ID 和消息 API 地址。
2. bot_token 已写入 Harness Host 凭据服务。
3. 非敏感账号配置已原子保存。
4. 微信 notifystart 验证通过并启动 getupdates 长轮询。
5. 插件能访问当前 Harness Host。
可以重复扫码添加多个微信账号。每个账号拥有独立凭据引用、长轮询、同步游标、消息去重记录和 Harness 会话映射；一个账号重连或移除不会影响其他账号。
核心功能¶
- 消息支持：支持文字消息，以及微信自带转写结果的语音消息。目前不支持图片、文件、视频或无转写语音。
- 多账号隔离：支持添加多个微信账号。每个账号拥有独立凭据引用、长轮询、同步游标、消息去重记录和 Harness 会话映射；一个账号重连或移除不会影响其他账号。
- 安全设计：浏览器永远不会收到或提交
bot_token、二维码内部令牌、扫码用户 ID 或凭据引用。bot_token只保存在 Harness Host 凭据服务中。微信消息 API 地址必须是https://weixin.qq.com或其子域，且只能使用默认 HTTPS 端口。
消息交互¶
扫码绑定成功后，可以在微信中向已绑定的机器人发送以下命令：
* /new：清除当前会话映射。
* /status：检查连接状态。
* /help：显示帮助信息。
Harness 回答较长时会拆成多条微信文本，每条都沿用入站消息的 context_token。
本地验证¶
源码安装后可进行本地验证：
npm run check
该命令会运行测试并检查包结构。若仅需验证腾讯扫码端点兼容性，可执行：
npm run verify:protocol
注意事项¶
- 消息范围：只接受扫码确认用户发来的私聊消息，其他用户默认拒绝。
- 运行环境：插件以当前 Harness Host 进程的权限运行，安装前请检查源码与许可证。
- 协议限制：微信消息 API 地址必须是
https://weixin.qq.com或其子域，且只能使用默认 HTTPS 端口。
总结¶
该插件通过微信扫码将腾讯微信机器人接入 DeepSeek Harness，实现了多账号隔离与安全凭据管理，适合需要在微信环境中使用 DeepSeek Harness 能力的场景。
详细文档与源码请参考：
* DeepSeek Harness 插件目录
* GitHub 仓库
