BiBoyang/dsh-im-bridge

dsh-im-bridge

DSH（DeepSeek Harness）插件：把 DSH 桥接到 IM。v0.1 先落地微信（iLink 通道），架构上通道层（src/ilink.ts 协议客户端）与桥接层（src/index.ts 事件/批准/注入）分离，后续按同样模式接钉钉、飞书、Telegram。

当前（微信通道）能力：在电脑上跑长任务，离开后用微信远程监控、批准、追加指令。

- DSH → 微信：turn 完成 / 出错 / 被阻塞、批准请求（含工具名与原因）实时推送
- 微信 → DSH：回复文本注入绑定会话；回复「批准 / 拒绝」应答 pending approval；/bind  切换绑定会话
- iLink 扫码登录，单用户白名单，消息去重、长回复分段、.. / !! / 超时合并

差异化：为什么又一个微信桥

IM 桥方向已有一批竞品（dsh-chatnode-wechat、dsh2wechat、dsh-wechat-notify 等）。本插件不抢“先做出来”，而是把一个生产级微信 bot（AMClaw，Rust）在微信通道上踩过的坑完整移植到 DSH 插件形态：

- 消息去重是持久的：iLink 的轮询 cursor 不落盘，重启后全靠去重防重复回复。本插件用持久化去重表（跨重启有效）+ 内存 FIFO 双层判重，而不是只在内存里记 msg_id。
- 长回复分段是收敛的：微信单条消息有长度限制，按 1200 字符（Unicode 码点）拆分，分段前缀 （i/n） 的长度参与递归收敛，不会出“第 3/2 段”；某段发送失败即停后续段并持久化补发队列，避免乱序。
- .. / !! / 超时合并：手机输入长指令天然分多条发。.. 后缀=还有后续先别回，!! 后缀=说完了立即提交，裸文本进 5 秒合并窗口。缓冲会话每次写入即快照落盘，进程崩溃重启后自动恢复并 flush。
- context_token 缓存：iLink 回复必须携带该用户最近的 context_token，双层缓存（内存 + 落盘）保证重启后仍能回复。
- 协议层容错：iLink 响应字段全部多候选 fallback（qrcode/cursor/msgs/message_id），异构消息宽松解析、单条失败跳过不炸整个轮询；登录确认后支持服务端下发的新 baseurl 运行时切换。
- 安全默认：approval 应答强制校验白名单 user_id + pending approval id 一一对应；微信消息只能进会话流，不能直接执行任意 shell。

安装

dsh plugin --profile web add
headless profile 需单独安装：
dsh plugin --profile headless add

使用

1. 启动 DSH Web 后查看日志获取微信扫码链接，手机扫码完成登录
2. 扫码确认的用户自动成为白名单用户（也可在配置里显式指定 allowedUserId）
3. 微信里发消息即注入当前绑定会话；/bind  切换；/status 查看状态
4. agent 请求批准时收到推送，回复「批准」或「拒绝」

配置

在 profile 的 cordis.patch.yml 行上加 config 字段：

| 字段 | 默认 | 说明 |
|---|---|---|
| allowedUserId | 空 | 白名单微信用户 id；空时首个扫码确认的用户自动绑定 |
| mergeTimeoutSecs | 5 | 消息合并窗口 |
| chunkMaxChars | 1200 | 分段长度（字符） |
| pollTimeoutSecs | 70 | iLink 长轮询超时 |

安全红线

- 微信通道等于绕过本机批准体系：approval 应答必须来自白名单 user_id 且对应真实的 pending approval id
- token 不落库；不打印聊天内容明文以外的任何东西
- 微信来的消息只能进会话流（source.kind = 'plugin'），不能直接执行任意 shell

开发命令

pnpm install
pnpm build     # tsc，产物在 lib/（提交入库，git 安装不跑构建）
pnpm test      # vitest

改完代码必须 pnpm build 并重启 DSH Web 才生效（ESM 缓存）。