dsh-plugin-wechat-official

DeepSeek Harness 微信 ClawBot 渠道插件 —— 通过腾讯官方开放的 微信 ClawBot 插件功能（iLink 协议），让用户在个人微信中直接与 DeepSeek Harness Agent 对话。

✅ 全部基于腾讯官方通道（ilinkai.weixin.qq.com），不使用任何个人微信逆向协议、网页自动化、Hook 客户端或其它可能导致封号的非官方方案。 底层协议与 openclaw 的微信渠道插件 @tencent-weixin/openclaw-weixin 同一套（HTTP/JSON，腾讯仅作为消息管道，不存储输入输出内容）。

---

目录

• 工作原理
• 前置条件
• 安装
• 配置
• 首次运行（扫码登录）
• 使用
• 连接续期（24 小时）
• 访问控制
• 合规与风险提示
• 常见问题
• 项目结构
• 开发与测试
• 参考

---

工作原理

微信用户 ──▶ 微信 ClawBot（腾讯官方 iLink 服务）
                 │  getupdates 长轮询（游标 get_updates_buf）
                 ▼
        dsh-plugin-wechat-official（本插件，运行在 DSH 进程中）
                 │  文本 → createUserMessage → followup
                 ▼
        DSH Agent 会话（每个微信用户独立会话，持久化可恢复）
                 │  回复文本 ← assistant/message 事件
                 ▼
        sendmessage（必须回带 context_token 关联对话窗口）
                 │  sendtyping「正在输入」状态
                 ▼
微信用户 ◀── 收到 Agent 回复

关键机制：

机制	说明
官方通道	登录走 get_bot_qrcode / get_qrcode_status 扫码；收消息走 getupdates 长轮询；回消息走 sendmessage
会话关联	每条入站消息带 context_token，回复时必须原样回带，否则消息无法关联到对话窗口
独立会话	每个微信用户对应一个 DSH Agent 会话（id 由用户 id 派生），历史经 sessionPersistence 持久化，重启可恢复