dsh-lark-bridge

飞书机器人 ↔ DeepSeek Harness (DSH) 会话桥接。通过飞书单聊/群聊与 DSH 会话对话，操作审批路由到飞书交互卡片。

DSH Store 插件兼容声明：dsh.compatibility.dshReleases 已在 package.json 中声明，支持 DSH 0.1.0-rc.8 / 0.1.1-rc.1 / 0.1.1-rc.2。插件补丁清单见 dsh-bundle-patch.json。

功能

实时对话

• 在飞书给机器人发消息 → 注入到 DSH 会话作为用户回合 → 助手回复回传飞书
• 支持私聊和群聊 @机器人
• 每个飞书聊天（私聊/每个群聊）拥有独立的 DSH 会话，互不干扰
• 会话上下文持久化，重启 bot 后自动复用

操作审批

• DSH 执行中触发操作审批 → 飞书交互卡片（同意/拒绝按钮）
• 用户在飞书点击 → 裁决回传 DSH 继续执行
• 审批卡片发到触发操作的聊天中，只有管理员能点击审批

提问交互

• DSH 调用 ask_user_question → 每个问题发一张飞书交互卡片
• 支持选项按钮、自定义输入、跳过
• 自由文本问题通过 @机器人回复
• 所有答案收集完成后一次性提交给 DSH

会话管理（斜杠指令）

停止回合

• 运行中发 /stop → 调用 DSH session.cancel 停止当前回合（保留排队中的消息）
• 运行中直接发 「停止」「stop」「中止」 → 同上，自然语言停止
• 消息前加 ! → 插话模式（steer），打断当前回合并注入新消息

模型切换

可用模型取决于 DSH 配置，常见包括 DeepSeek-V4-Flash、DeepSeek-V4-Pro、fuyao-coding 等。

发送模式

权限管理

架构

飞书用户 ←WS长连接→ 飞书开放平台 ←→ dsh-lark-bridge (bot进程)
                                              ↕ HTTP RPC + WebSocket
                                      DSH 会话 (127.0.0.1:3080)

• 独立 Node.js 进程，使用 @larksuiteoapi/node-sdk 长连接（WebSocket，免公网 IP）接收飞书事件
• 通过 DSH 的 HTTP/WS API 代理（与 Web GUI 同一套接口）发送消息、订阅事件流、回传审批裁决
• 每个飞书 chatId → 独立 DshClient → 独立 DSH 会话，多会话完全隔离
• 仅写入工作目录（沙箱友好），不修改 DSH 核心
• 无鉴权（DSH 安全靠 loopback 绑定，bot 必须与 DSH 同机运行）

配置

方式一：交互式向导（推荐）

node setup.mjs

按提示依次填写飞书 App ID、App Secret、管理员 open_id，其余项回车用默认值。完成后自动生成 .env。

方式二：手动复制

复制 .env.example 为 .env 并填写：

copy .env.example .env

首次双击 start-bot.bat 时如检测到没有 .env，会提示你先运行 node setup.mjs 完成配置。

启动

方式一：双击启动脚本（推荐）

双击 start-bot.bat，弹出独立命令行窗口运行 bot。

• 关闭 DSH Web GUI 不影响 bot
• 关闭弹出的窗口即停止 bot

方式二：命令行

cd E:\Workspace\dsh-lark-bridge
node src/bot.js

停止 bot

• 关闭运行 bot 的命令行窗口（或按 Ctrl+C）
• 任务管理器 → 详细信息 → 添加「命令行」列 → 找含 dsh-lark-bridge 的 node.exe → 结束任务

飞书后台配置清单（开发者后台）

1. 应用能力：开启「机器人」能力
2. 事件订阅：接收方式选择「使用长连接接收事件」
3. 订阅事件：
   • im.message.receive_v1（接收消息）
   • card.action.trigger（交互卡片回调）
4. 权限范围：
   • im:message、im:message:send_as_bot（发送消息）
   • im:message.p2p_msg:readonly（接收单聊消息）
   • 交互卡片相关权限
5. 发布版本并审核通过（自建应用内部可用）

项目结构

dsh-lark-bridge/
├── src/
│   ├── bot.js              # 主入口：多会话管理、消息路由、指令处理
│   ├── dsh/
│   │   └── client.js       # DSH API 客户端（RPC + WS mux + 审批/提问/模型切换）
│   └── feishu/
│       └── bridge.js       # 飞书传输层（LarkChannel 长连接 + 卡片构建）
├── setup.mjs               # 交互式配置向导（生成 .env）
├── dsh-bundle-patch.json   # DSH 插件补丁声明（DSH Store 上架契约）
├── .env.example            # 配置模板
├── .session-cache.json     # 会话缓存（自动生成）
├── .chat-session-map.json  # 飞书chatId → DSH会话ID 映射（自动生成）
├── start-bot.bat           # Windows 启动脚本
└── package.json

会话管理说明

• 首次在某个聊天发消息 → bot 自动创建 DSH 会话并缓存映射
• 重启 bot → 自动复用缓存的会话，上下文不丢失
• /new → 创建新会话，旧会话保留可 /switch 回去
• /list → 只显示磁盘上实际存在的会话（过滤 DSH 内存缓存的残留）
• /clean → 查看手动清理旧会话的方法（DSH 无删除 API，需手动删文件）