dsh-chatops

dsh-chatops

用微信、飞书、钉钉、企业微信远程操控 DeepSeek Harness——IM 机器人直连全部工作区与会话，任务完成推送，危险操作远程审批。

Drive DeepSeek Harness from WeChat, Feishu, DingTalk and WeCom — IM bots bridged to every workspace and session, with completion push and remote approval.

四通道并行的 IM 桥接插件：机器人和你私聊（或群 @）即可操作所有工作区和会话——发文字就是发 prompt，任务完成自动推送，危险操作推审批（飞书支持卡片按钮一键批准），生成的报告/图片/文件可直接回传到 IM。

---

截图

功能特性

• 🔀 四通道并行：微信 / 飞书 / 钉钉 / 企业微信同时在线，指令集完全一致
• 📱 微信（ClawBot / iLink）：官方机器人平台，扫码绑定即用，普通微信里出现机器人联系人；bot_token 长效，重启免扫码
• 🐦 飞书（自建应用）：WS 长连接；审批发交互卡片（按钮一键批准）；任务发流式进度卡原地更新为结果
• 🟦 钉钉（企业内部应用）：Stream 长连接，文本/文件回传齐备
• 🟩 企业微信（智能机器人）：官方 aibot SDK 长连接（仅企业内成员可见）
• 🗂 指令集：/sessions（含 📦 冷会话自动唤醒）、/use、/status、/log（完整输出）、/send <路径>、/approve /reject
• 🚀 普通文字直接作为 prompt 发给绑定会话（首次自动绑定最近活跃会话）
• 📎 文件回传：模型可调用内置 im_send_file 工具主动把成果文件发到 IM（图片内联显示，其他为文件卡片）；/log 超长输出自动转 txt 文件
• 🖥 设置页 GUI：「设置 → IM 通道」面板——通道开关、凭据填写、状态监控、微信扫码绑定全部可视化（主题跟随深浅色）
• 🔐 安全模型：owner/白名单、工作区路径围栏、凭据入 DSH 凭据存储、全量审计日志、陌生人消息静默忽略

安装

# 从 GitHub 安装（推荐）
dsh plugin --profile web add github:ZhuoSir/dsh-chatops

# 或本地源码安装
dsh plugin --profile web add /path/to/dsh-chatops

# 重启生效
dsh web

然后打开 设置 → IM 通道，在面板上启用通道并填写凭据（微信无需凭据，直接面板内扫码）。

兼容性与 profile

各通道官方 SDK 均为可选依赖（@larksuiteoapi/node-sdk / dingtalk-stream / @wecom/aibot-node-sdk / wechaty），随主包安装；未装时对应通道空转并在日志给出指引，不影响其他通道。

权限说明

插件自身的安全边界

• 网络：仅出站连接各 IM 平台官方域名（ilinkai.weixin.qq.com / open.feishu.cn / api.dingtalk.com / 企微 WS 网关）；本机回环端口只暴露 /chatops/* 只读状态与配置端点（loopback 校验）；
• 凭据：微信 bot_token 写入 DSH 凭据存储（ctx.credentials，文件兜底 0600 权限）；飞书/钉钉/企微凭据保存在本机 profile 配置中，不上传任何第三方；
• 文件：文件回传只允许发送当前会话工作区内的文件（路径逃逸拒绝 + 审计）；大小上限默认 100MB（可配）；
• 访问控制：微信扫码绑定者 / 飞书钉钉企微首个私聊用户自动成为 owner；其余人消息静默忽略并写审计日志（storages/dsh-chatops/audit.jsonl）；可用 security.allowContacts / allowRooms 收敛白名单；
• 审计：绑定、指令、审批决策、文件发送全部留痕。

各通道需要的平台权限

⚠️ wechaty 备选通道（个人号协议）违反《微信软件许可及服务协议》，存在封号风险，仅限自用、务必小号，默认关闭。

快速开始

微信（ilink，默认）

设置 → IM 通道 → 微信卡片内扫码绑定（或打开 http://127.0.0.1:3080/chatops/qr），手机确认后机器人和你打招呼：

/help            → 查看指令
/sessions        → 1. 修复登录bug 💤空闲  2. 写周报 🔄运行中 …（📦=冷会话，自动唤醒）
/use 1           → ✅ 已绑定会话：修复登录bug
把 README 翻译成英文  → 🚀 已发送…  →（完成后）✅ 任务完成：…
/send reports/a.md    → 📤 文件发送中…
"把结果整理成报告发给我"  → 模型自动调用 im_send_file 推文件给你

飞书 / 钉钉 / 企业微信

1. 按上表在对应开放平台建好应用/机器人、拿到凭据；
2. 设置 → IM 通道 → 填凭据、勾选启用 → 保存（cordis 自动热重载，无需重启；无反应则重启 dsh web）；
3. 在对应 IM 里私聊机器人发 /help——首个私聊用户自动成为管理员（审计留痕）；
4. 群聊：拉机器人入群，security.allowRooms 填群 id（飞书 chat_id / 钉钉 conversationId / 企微 chatid），群里 @机器人 下指令。

配置

面板可配全部常用项；完整配置见 cordis.patch.yml（每个键都有注释）。关键项：

架构

微信用户 ──私聊──► ClawBot（iLink，35s 长轮询）
飞书用户 ──私聊/群@──► 飞书开放平台（WS 长连接）
钉钉用户 ──私聊/群@──► 钉钉开放平台（Stream 长连接）
企微用户 ──私聊/群@──► 企业微信（aibot WS 长连接）
                          ▲ 均为主动出站，零公网部署
src/host/
├─ index.ts          apply(ctx)：多通道装配 + 生命周期 + /chatops/* API + 工具注册
├─ manager.ts        ChannelManager：windowKey 前缀路由（多通道并行）
├─ ilink/            微信 iLink 通道（api / store / channel / qrimg）
├─ feishu/           飞书通道（channel + cards：审批/进度卡）
├─ dingtalk/         钉钉通道（Stream SDK）
├─ wecom/            企业微信通道（aibot SDK）
├─ channel.ts        [备选] wechaty 个人号通道
├─ auth.ts           来源过滤(owner/白名单) + 窗口↔会话绑定 + 审计
├─ bridge.ts         SessionBridge：指令路由、prompt 投递、审批 answerer、文件回传
└─ src/client/       设置页「IM 通道」面板（settings.section 插槽，主题跟随）

协议致谢

iLink / 飞书 / 钉钉 / 企微各通道的协议与 SDK 用法参考了 xmanrui/dsh-im（MIT）的实现，致谢。本插件的通道实现为独立编写。

许可证

MIT © ZhuoSir