DeepSeek Harness Lark Bridge

English | 中文

把飞书变成 DeepSeek Harness 的安全远程控制面，而不只是一条通知通道。

Bridge 将 Harness 的 Project 与 Session 映射到飞书群聊和话题，把实时执行过程呈现为原生交互卡片，也把文字、文件、图片、命令、审批和回答送回同一个 Agent。

当前版本已针对 DeepSeek Harness 0.1.0-rc.6 验证。Harness 仍处于开发者预览阶段，可能发生破坏性变更；升级前请重新运行本仓库检查与真实联调。

为什么叫 Bridge

• 双向控制：可从飞书创建、继续、纠偏、停止、恢复和检查 Agent。
• Project 路由：每个群可绑定独立工作目录、模型路线、访问策略和卡片视图。
• 话题即 Session：默认一个话题/线程对应一个 Harness Session；同话题回复延续上下文，新话题从新会话开始。
• 实时 V2 卡片：一张卡片从运行中原位更新为完成、阻塞、取消或失败。
• 人在回路：不离开飞书即可处理工具审批和 Agent 结构化提问。
• 双向媒体：接收图片与文件，也允许 Agent 安全投递工作区内的 Markdown、图片或文件。
• 可调信息密度：精简、标准、开发者三种视图适配不同用户。
• 安全默认值：默认拒绝、群聊强制 @、交互身份复核、去重、过期事件拒绝、脱敏、SSRF 防护与文件系统边界。
• 无需公网 Webhook：使用飞书官方 Node SDK WebSocket 长连接接收消息和卡片回调。

执行轨迹只展示工具名称与受长度限制、已脱敏的摘要，不会暴露模型隐藏思维链。

flowchart LR
  U["飞书私聊 / 群聊 / 话题"] -->|"文字 · 图片 · 文件 · 命令 · 卡片操作"| B["DSH Lark Bridge"]
  B -->|"followup · steer · cancel · resume"| H["DeepSeek Harness Agent"]
  H -->|"Session 事件 · 工具 · 审批 · 提问"| B
  B -->|"动态卡片 · 回复 · 附件"| U

Project 与 Session 最佳实践

推荐采用下面的映射：

飞书实体	Harness 实体	推荐用途
话题群	Project 容器	一个代码库或长期工作流一个群
话题/线程	Session	一个任务或一段完整对话一个话题
机器人私聊	控制面	查看、切换 Project，再进行私密操作
普通群	Project 容器	每条顶层 @机器人 消息开启一个线程 Session

默认 groupSessionScope: thread 时：