@weniatall/dsh-im-bot
DeepSeek Harness 的即时通信机器人集成：个人微信（Tencent iLink Bot）和企业微信智能机器人（长连接 API），支持双向聊天和回合完成通知
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @weniatall/dsh-im-bot@0.1.14Im Bot 以 @weniatall/dsh-im-bot 发布，当前版本为 0.1.14。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DeepSeek Harness（DSH）的集成机器人插件：把企业微信智能机器人与个人微信接入 DSH， 让微信成为会话的另一个入口与出口。
| 需求 | 实现 |
|---|---|
| 企业微信 + 个人微信双机器人 | 两个独立通道，可只启用其一，也可同时启用 |
| 双向通信 | 入站消息落成会话 prompt；回合结果回推原聊天 |
| 任务完成主动通知 | turn/end 且 completed 时推摘要；error/aborted/max-tokens 时推告警 |
刻意只推给「发起过对话」的聊天：Web 端新开的会话不会打扰任何人。哪个聊天绑了哪个 会话，设置页里一目了然，也能手动解除。
在微信里直接发这些命令，不会进入模型上下文（不消耗 token、不污染历史）：
| 命令 | 作用 |
|---|---|
/new [标题] | 新建一个会话并绑定到当前聊天 |
/use <会话ID> | 绑定到已有会话（可用前 8 位前缀） |
/sessions | 列出最近会话（带 ▶ 标记当前绑定） |
/status | 查看两个通道状态与当前绑定 |
/stop | 中止当前正在生成的回合 |
/notify on|off | 开关本聊天的完成通知 |
/help | 命令列表 |
其它任何文本都会作为该会话的下一条消息投递进去。
对接企业微信官方的智能机器人长连接：
wss://openws.work.weixin.qq.com，用 BotID + Secret 发 aibot_subscribe；aibot_msg_callback（文本/图文混排/语音）与 aibot_event_callback；aibot_send_msg，显式带 chat_type（1 单聊 / 2 群聊）；ping 心跳，连续 3 次没回应判定假死重连；disconnected_event（同一机器人只能一条长连接，新连接会踢旧的）后指数退避重连，
不会与另一个实例互踢。为什么选长连接而不是回调 URL：不需要公网 IP、不需要 HTTPS 证书、不需要自己实现 AES 验签解密。代价是同一机器人同时只能有一条连接——所以如果你在别处也连了同一个 BotID，两边会互踢，表现为「刚连上又断」。
对接腾讯 iLink Bot 的官方 HTTP 接口（与 iLink 官方 App 同一套协议）：
ilink_bot_id + bot_token；ilink/bot/getupdates 长轮询收消息，get_updates_buf 游标持久化到
~/.dsh/im-bot/，重启不重复消费、不丢消息；ilink/bot/sendmessage 发消息，必须回带该 peer 最近的 context_token；
过期（errcode -14）时自动去掉 token 重试一次——这是通知能发出去的关键；ilink/bot/sendtyping 显示「正在输入」，typing_ticket 缓存 600 秒。不读取
~/.hermes下的任何文件。 如果你同时用 hermes 跑同一个 bot 账号， 两边各自持游标会互相抢消息。本插件独立扫码、独立存储，互不干扰。
# 从 npm 安装
dsh plugin --profile web add @weniatall/dsh-im-bot
# 或从本仓库本地打包安装
cd plugins/dsh-im-bot && npm pack
dsh plugin --profile web add ./weniatall-dsh-im-bot-0.1.14.tgz
@deepseek-ai/dsh CLI 没有 service 子命令，用仓库自带脚本：
./scripts/dsh-web.sh restart.\scripts\dsh-web.ps1 restart（或 scripts\dsh-web.cmd restart）安装后插件默认完全关闭，不会建立任何连接。打开 设置 → 集成机器人 才启用。
状态标签变成「在线」即连接成功。
白名单为空时，任何人都不能使用机器人（安全默认）。否则任何知道机器人账号的人 发条消息就能消耗你的模型额度。
userid，每行一个；chatid）。群聊默认关闭。企业微信里机器人创建者是超级管理员时，from.userid 是明文 userid；否则是加密 userid
（需要通过「自建应用与智能机器人的对接」转换）。用你在回调里实际看到的那个值。
设置后即可让脚本/CI 主动推消息：
curl -X POST http://127.0.0.1:3080/dsh-im-bot/send \
-H 'content-type: application/json' \
-H 'x-dsh-im-bot-token: <你设置的令牌>' \
-d '{"sessionId":"<会话ID>","text":"构建完成 ✅","format":"text"}'
sessionId 会查绑定表找到对应聊天；也可直接给 channel + peer。插件注册了原生工具 im_bot_send，模型可以自己决定在任务中途把进度或结果推给你：
im_bot_send(text="部署已完成，版本 v1.2.3", sessionId="<当前会话>")
微信/企微 ──入站──▶ Channel(ilink|wecom)
│ 归一化 + 去重 + 白名单
▼
命令？──是──▶ 本地执行并回发（不进模型）
│否
▼
agent.followup(createUserMessage) ──▶ DSH 会话
│
│ （记录「本会话由哪个聊天发起」）
▼
模型跑一轮
│
session/event: turn/end
│ reason.kind
┌──────────┴──────────┐
completed error/aborted/max-tokens
│ │
推送结果摘要 推送失败告警
└──────────┬─────────────┘
▼
回推原聊天（同一通道，断线则降级到另一通道）
为什么监听 session/event 而不是 agent/status：只有 turn/end 带 reason，
能区分「正常完成」与「报错/被中止/超出 token」，这是「失败也要告警」的前提。
agent/status 只知道 idle / running。
| 场景 | 处理 |
|---|---|
| 企微长连接被新连接踢掉 | 收 disconnected_event → 指数退避重连（1s→60s 封顶），不与对方互踢 |
| 企微心跳无响应 | 连续 3 次未收到回包判定假死，主动关闭并重连 |
iLink 会话过期（-14） | 发送时去 context_token 重试一次；轮询时退避 10 分钟 |
| iLink 游标丢失 | 游标原子落盘（tmp + rename），坏文件只降级为空游标，不阻止启动 |
| 重复消息 | msgid 级去重 + 内容指纹兜底，TTL 5 分钟 |
| 长文本 | 按通道上限分片（默认 2000 字符），同 peer 串行发送避免交错 |
| 消息风暴 | 每 peer 滑动窗口限流（30 条/分钟）+ 连续失败 3 次退避 30 秒 |
| 通道断开 | 通知自动降级到另一个在线通道；都不可用则记日志丢弃（不排队积压） |
| 宿主重启 | 绑定关系、游标、context_token 全部持久化在 ~/.dsh/im-bot/ |
| 绑定会话被删/归档 | 投递前 resolveAgent 失败 → 回「会话不可用，请 /new」 |
状态文件（~/.dsh/im-bot/，权限 0600）：
| 文件 | 内容 |
|---|---|
bindings.json | 聊天 ↔ 会话绑定关系 |
ilink-sync.json | iLink 长轮询游标 |
ilink-context-tokens.json | 每个 peer 最近一次的 context_token |
wecom-peers.json | 企业微信 peer 的单聊/群聊类型 |
凭据（Bot Secret、iLink Token、HTTP 令牌）不进配置文件，统一存于 DSH 凭据存储
（ctx.credentials），设置页只显示「已配置 / 未配置」。
检查总开关。通道启用开关与总开关是两个开关，总开关关闭时任何通道都不会连接。
同一个 BotID 在别处还有一条长连接。企微规定一个机器人同时只能有一条长连接， 新连接会踢掉旧的。关掉另一处（比如另一个 DSH profile、或你在别的地方跑的脚本）。
按顺序检查：
/status 看通道是否「在线」；im-bot:，拒绝原因会写成 拒绝 <channel>/<peer>（<reason>）。/status 看绑定是否还在；/notify 是否被关成了 off；context_token，过期会自动降级重试；若仍失败，
在微信里给机器人随便发条消息刷新会话。双向对话依赖 ctx.sessionController（由 dsh-web-app 提供）。desktop 与 headless
组合里没有它，此时设置页会提示「当前 Profile 不支持双向对话」，通道仍可出站推送。
设置页底部「重新读取」会刷新状态；也可以在浏览器控制台调
ctx.connection.rpc.call('/dsh-im-bot', 'diagnostics', {}) 拿到完整诊断。
cd plugins/dsh-im-bot
npm test
测试包含四套，全部零网络、零宿主、零依赖：
| 文件 | 覆盖 |
|---|---|
test/core.test.mjs | 命令解析、白名单、绑定表、通知文案、分片、限流、去重 |
test/wecom.test.mjs | 假 WebSocket 驱动订阅/心跳/入站/被踢重连/分片 |
test/ilink.test.mjs | 假 fetch 驱动长轮询/发送/token 降级/扫码状态机 |
test/client.test.mjs | 假 ModuleLoader + React 桩验证设置面板注册与渲染 |
另含两道宿主闸门：
node ../../scripts/check-host-settings.mjs plugins/dsh-im-bot im-bot # 设置写入闸门
node ../../scripts/verify-pack-contents.mjs --plugin dsh-im-bot # 发布内容闸门
schemastery 明确拒绝「volatile 字段嵌在另一个 volatile 对象里」：
volatile fields require a fixed object path without an enclosing volatile field
因此 Config 里所有可改字段都是扁平的（wecomBotId、ilinkBaseUrl、
notifyOnTurnComplete…），由 flatToNested() / nestedToFlat() 在扁平配置与
core 层使用的嵌套结构之间转换。改配置字段时三处要同步：
Config、CONFIG_KEYS、这两个转换函数。
stream.id 流式回复留待后续。WebSocket（企微长连接）。Node 20 需要额外引入 ws 依赖。MIT