dsh-chatops
用微信和飞书远程操控 DeepSeek Harness——IM 机器人直连全部工作区与会话，任务完成推送，危险操作远程审批。
Drive DeepSeek Harness from WeChat and Feishu — IM bots bridged to every workspace and session, with completion push and remote approval.
用 IM 操控 DeepSeek Harness：微信（官方 ClawBot / iLink）+ 飞书（自建应用）双通道并行，机器人和你私聊（或群 @）即可操作所有工作区和会话——任务完成自动推送，危险操作远程审批。
✅ 微信走官方机器人平台（iLink），合规、无封号风险、纯 HTTPS 长轮询。
✅ 飞书走官方开放平台自建应用，WS 长连接，支持审批卡片按钮和流式进度卡。
⚠️ 备选通道 wechaty（个人号协议）违反微信用户协议，仅供自用、务必小号。
功能
- 🔀 多通道并行：
channels: [ilink, feishu] 微信飞书同时在线，指令集完全一致
- 📱 微信：浏览器打开
/wechat/qr 扫码绑定一次，bot_token 长效，重启免扫码
- 🐦 飞书：填 App ID/Secret 即用，私聊直聊、群里 @机器人、首个私聊用户自动成为管理员
- 🗂 指令：
/sessions（含 📦 冷会话自动唤醒）、/use、/status、/log（完整输出）、/approve /reject
- 🚀 普通文字直接作为 prompt 发给绑定会话（首次自动绑定最近活跃会话）
- 🃏 飞书专属：审批发交互卡片（点【批准】【拒绝】按钮，卡片原地变终态）；任务发进度卡，完成后原地更新为结果
- 🔐 微信 bot_token 存 DSH 凭据存储；owner/白名单模型，陌生人消息静默忽略 + 审计
- 🛡 微信发送双通道队列（交互消息优先，长输出不堵回执）；掉线自动重连；全量审计日志
安装
dsh plugin --profile web add /path/to/dsh-chatops
# 重启 dsh web
改代码后：pnpm build + 重启 dsh web（link 安装，产物即时生效）。
使用（ilink 通道，默认）
- 重启
dsh web 后，浏览器打开 **http://127.0.0.1:3080/wechat/qr**；
- 用微信扫描二维码，手机上确认绑定（如提示短信验证码，在同一页面输入）；
- 微信聊天列表出现机器人（ClawBot），它会发一条上线通知；
- 和机器人聊天：
/help → 查看指令
/sessions → 1. 修复登录bug 💤空闲 2. 写周报 🔄运行中 …
/use 1 → ✅ 已绑定会话：修复登录bug
把 README 翻译成英文 → 🚀 已发送… →（完成后）✅ 任务完成：…
安全模型：只有扫码绑定的 owner（和 security.allowContacts 白名单）能操控 DSH，其他人给机器人发消息一律静默忽略并记审计。
使用（feishu 通道）
- 飞书开发者后台创建企业自建应用 → 添加机器人能力（没有租户可免费创建团队）；
- 权限：
im:message、im:message:send_as_bot（图片/文件再加 im:resource）；
- 事件订阅：订阅方式选使用长连接接收事件，添加
接收消息 im.message.receive_v1 和 卡片回传交互 card.action.trigger（审批按钮必须）；
- 创建版本并发布（自用可用范围选自己）；
- 配置
channels: [ilink, feishu] + feishu.appId/appSecret，重启 dsh web；
- 飞书里搜到机器人直接私聊——首个私聊用户自动成为管理员（审计日志记录，可在
security.allowContacts 改白名单模型）。
群聊：把机器人拉进群，security.allowRooms 填群 chat_id，群里 @机器人 下指令。
使用（wechaty 通道，备选）
cordis.patch.yml 里把 channel 改为 'wechaty'，按需配置 puppet / puppetToken，重启后终端出现登录二维码（小号扫）。文件传输助手就是遥控器。
配置
见 cordis.patch.yml（每个键都有注释）。关键项：
| 键 | 说明 |
|---|
channel | 'ilink'（默认）/ 'wechaty' |
security.allowContacts / allowRooms | 额外信任的用户/群（owner 始终受信） |
push.onApproval / approvalTimeoutSec | 审批推送与超时（超时转 GUI 处理） |
reply.rateLimitMs | 发送节流（默认 1.2s+抖动） |
架构
微信用户 ──私聊──► ClawBot（iLink 平台，35s 长轮询）
飞书用户 ──私聊/群@──► 飞书开放平台（WS 长连接）
▲ 均为主动出站，零公网部署
src/host/
├─ index.ts apply(ctx)：多通道装配 + 生命周期 + /wechat/qr 绑定页
├─ manager.ts ChannelManager：windowKey 前缀路由（多通道并行）
├─ ilink/ 微信 iLink 通道（api / store / channel / qrimg）
├─ feishu/ 飞书通道（channel: WSClient+事件+发送；cards: 审批/进度卡）
├─ channel.ts [备选] wechaty 个人号通道
├─ auth.ts 来源过滤(owner/白名单) + 窗口↔会话绑定 + 审计
├─ bridge.ts SessionBridge：指令路由、prompt 投递、审批 answerer、进度卡钩子
└─ qrcode.ts [wechaty] 终端二维码渲染
已标注的 TODO（接入前需对照 DSH 运行时确认 API）：
/new 会话创建 API、/stop 会话中断 APIapproval/request waterfall 的"放行给下一个 answerer"语义- 会话标题字段名（
sessionTitle 兜底逻辑）
- 二期：群聊 @、图片/文件消息（CDN+AES）、GUI 设置页卡片
协议说明
iLink 协议细节（端点、状态机、消息格式）逆向确认自 xmanrui/dsh-im（MIT），协议版本 2.4.6。腾讯可能演进该协议——所有端点集中在 src/host/ilink/api.ts，跟进 dsh-im 更新即可。
