dsh-wx-bridge — 轻量微信桥接 DSH 插件

微信扫码绑定官方 ClawBot（腾讯 iLink 协议）后，私聊即驱动 DSH 会话： 发文字就是 prompt，任务完成自动推送。纯 JS（ESM）、零第三方运行时依赖、零公网部署（仅主动出站）。

---

功能

• 📱 微信官方 ClawBot：扫码绑定，普通微信里出现机器人联系人，重启免扫码（token 长效）
• 💬 私有聊天驱动 DSH：发文字 = prompt 发给绑定会话，完成自动推送结果
• 🔀 会话管理：/sessions 列表、/use N 切换、/detail N 查看会话详情（模型/推送/最近输出）
• 🎭 人格切换：/preset <名称> 切换会话 agent-preset（猫娘等自定义人格）
• 🧠 模型切换：/model 树状浏览/关键词搜索/能力筛选（--vision/--ctx/--effort），/default-model 设全局默认
• ⚠️ 危险操作审批：DSH 危险操作转微信文字审批（/approve /reject），可配授权码二次确认
• 📁 文件回传：/send <路径> 发工作区文件，模型可主动调 im_send_file 回传
• ⏹ 任务控制：/stop 中断、/log 查看完整输出
• 🛡 安全：单 owner 白名单、审计日志、安全提示词（高危操作 AI 自我审查）

快速开始

# 安装到 DSH web profile
dsh plugin --profile web add github:CMD128/dsh-wx-bridge

# 重启 DSH Web 后，打开设置 → 微信通道 → 扫码绑定
dsh web

微信里与机器人对话：

/help        → 指令帮助
/sessions    → 会话列表
/use 1       → 绑定会话
/model --vision → 切换视觉模型
/preset 猫娘 → 切换人格
直接发文字    → 作为 prompt 发给绑定会话

架构

微信用户 ──私聊──► ClawBot（iLink 35s 长轮询）
                      ▲ 主动出站，零公网部署
ilink-channel.js ──onMessage──► bridge.js ──followup──► DSH 会话
                    ◄──session/event── 任务完成 → 推送

• lib/ilink-api.js — iLink 协议客户端（纯 fetch，AES-128-ECB CDN 加密）
• lib/ilink-channel.js — 通道生命周期：扫码登录/重连/长轮询/收发
• lib/ilink-store.js — token 持久化（DSH credentials + 文件兜底）
• lib/bridge.js — DSH 会话桥接：指令路由/转发/推送/文件
• lib/models.js — 模型目录（llm.models + settings 视觉标记）
• lib/approval.js — 审批文字化 + 授权码
• client-src/ — 设置页 GUI（源码），npm run build:client 构建

兼容性

项	要求
DSH	0.1.x（cordis ^4，agents/sessionQuery/sessionTitle/credentials/tools）
Node.js	≥ 22（ESM）
网络	仅主动出站 HTTPS（ilinkai.weixin.qq.com），零端口转发

开发

git clone https://github.com/CMD128/dsh-wx-bridge
cd dsh-wx-bridge
npm install
npm run build:client && node --test lib/*.test.js  # 重建 GUI + 跑测试（90 项）

致谢

• dsh-chatops（MIT）— iLink 协议实现与插件架构的重要参考
• dsh-im（MIT）— iLink 协议逆向来源
• 腾讯 iLink / ClawBot 官方机器人平台

License

MIT © CMD128