super-wechat-bridge

微信 iLink ClawBot（腾讯官方微信 Bot 协议）远程桥接插件，把微信消息接进 DeepSeek Harness（dsh）。

特性

• 协议与 dsh API 均经实测（iLink 真实端点 + dsh 0.1.0-rc.6 官方 Agent API）
• 长轮询收消息、msg 包裹 + text_item 发送（官方格式）
• 发送必须带 base_info.channel_version + from_user_id + client_id——实测缺失时服务器返回 message_id 但不投递（对照 openclaw-weixin 参考实现定位）
• 每个微信用户独立 dsh 会话（agents.create({ sessionId }) + agent.followup）
• 回复自动转发：wechat 会话每轮 agent 的最终文字回复自动发回微信（监听 session/event，按 user/message 真实来源过滤上下文快照）
• wechat_reply 工具用于主动推送（任务完成通知等），同一轮内已用工具发送则自动转发跳过，避免重复
• 会话级提示词：wechat 会话的 agent 会收到「正在通过微信对话」的上下文（按会话 id 条件注入，不影响其他会话）
• Web 设置界面（设置 → 微信桥接）：扫码登录、模型/预设/思考强度/权限配置、会话列表（打开/复制/删除）、凭据状态
• 自动续期：iLink 会话约 24h（服务端限制），到期前自动把新二维码推送到微信，扫码无缝续期，全程不断线
• 错误落盘 stateDir/errors.log

已知限制

• 重启后会话不续接：桥接按 wechat-- 新建会话，dsh web 重启后同一微信用户会开新会话（旧会话历史保留在侧边栏，但桥接不再关联）
• 图片/语音等非文本消息以占位文本 [非文本消息] 呈现，当前通道不接收媒体内容
• 修改插件代码后需要重启 dsh web 才生效（HMR 不重载 node_modules 里的模块）

安装

从 GitHub 安装（发布版）：

dsh plugin --profile web add "github:Qshuai0213/super-wechat-bridge"

本地开发安装：

dsh plugin --profile web add "file:D:/ai工作区/super-wechat-bridge"

插件自带 dsh.bundle.patch（cordis.patch.yml），安装后自动挂载，无需手动编辑 profile 的 cordis.patch.yml。配置走 schema 默认值：stateDir 默认为 $DSH_HOME/channels/wechat（无 DSH_HOME 时 ~/.dsh/channels/wechat）、dmPolicy: pairing。 需要覆盖时在 profile patch 里按 id 追加 config：

- insert:
    - id: wechat-bridge
      config:
        dmPolicy: allowlist
        allowFrom: ['o9cq80wwZLaIrJEBTW3TCRCVVyt8@im.wechat']

重启 dsh web。

登录

iLink 会话有效期约 24 小时（服务端限制，无法延长），插件内置自动续期：到期前约 2 小时，插件会把新的续期二维码链接推送到微信（发给最近活跃的会话），点开链接扫码即可无缝续期，全程不断线；最后 30 分钟未续期会再次提醒。