前言¶

DSH 生态强调“一切皆插件”，不少场景需要在终端之外查看和控制 DeepSeek Harness 的运行状态。dsh-lark-bridge 把飞书/Lark 作为控制面，将 Lark 消息、群聊、话题线程和 Harness Session 关联起来。下面介绍它是什么、能做什么，以及如何安装和验证。

这是什么¶

imetn/dsh-lark-bridge 是一个用于 DeepSeek Harness 的飞书/Lark 双向控制器。仓库 owner 是 imetn，许可证为 MIT。

它用于从飞书/Lark 启动、继续、修正、停止、恢复并检查 DeepSeek Harness Session。README 资料说明它测试于 DeepSeek Harness 0.1.0-rc.6，且 Harness 仍处于 developer preview。

运行要求是：

• Node.js 22+
• pnpm
• 可用的 DeepSeek Harness 模型配置
• 已安装 dsh CLI，或附近存在官方 Harness 源码

它使用 WebSocket 长连接，不需要公网 webhook 服务。

核心功能¶

dsh-lark-bridge 提供以下已核实能力：

• 支持从 Lark 启动、继续、修正、停止、恢复并检查 DeepSeek Harness Session。
• 可将每个 Lark 群映射到一个 Harness Project、工作目录、模型路由、访问策略和卡片预设。
• 默认将每个 topic/thread 映射为隔离 Session。
• 可在一张原生卡片上更新运行、完成、阻塞、取消或失败状态。
• 支持通过卡片按钮批准单次工具调用，或回答结构化 Agent 问题。
• 支持接收文本、图片和文件，并可通过 lark_deliver 回传安全的工作区文件。
• 支持按 Project 或 Session 选择 compact、standard、developer 卡片详细程度。
• 使用 WebSocket 长连接，不需要公网 webhook 服务。

在文件与审批方面，它有以下限制：

• 出站文件必须解析为 Project workspaceRoot 内的常规文件，拒绝符号链接逃逸。
• 入站文件使用 0700 目录和 0600 文件。
• 单次审批按钮仅授予一次操作。
• 卡片展示有界的工具摘要，不显示隐藏模型推理。

安装与启用¶

先在要控制的 Project 目录中运行：

pnpm dlx github:imetn/dsh-lark-bridge setup --project "$PWD"

这条命令会把当前目录作为要控制的 Project。

如果使用 ByteDance larkoffice 租户，可以加 --brand larkoffice：

pnpm dlx github:imetn/dsh-lark-bridge setup --project "$PWD" --brand larkoffice

如果已有 App Secret，可以使用：

printf '%s' "$LARK_APP_SECRET" | pnpm dlx github:imetn/dsh-lark-bridge setup --project "$PWD" --app-id cli_xxxxxxxxxxxxxxxx --app-secret-stdin

自动创建流程固定传 createOnly: true，不能选择或修改已有应用。

如果走手动应用流程，需要启用 bot 能力、选择长连接、发布版本，并配置指定权限、消息事件和卡片回调；保留群 @ 权限，而不是请求所有群消息。

典型用法¶

安装完成后，可以先验证状态。

1、在机器人 DM 中发送：

/status

2、在本地运行：

pnpm dlx github:imetn/dsh-lark-bridge doctor

如果存在多个 Project，可以在群中发送：

@bot /bind <project-id>

用于绑定当前群。

常用控制指令如下：

/steer <text>
/stop
/new
/sessions
/resume <id>

含义分别是：

• /steer <text>：修正当前运行步骤，或补充上下文。
• /stop：取消当前任务。
• /new：新建 Session。
• /sessions：列出 Session。
• /resume <id>：恢复指定 Session。

另外需要注意：

dsh --profile lark

只启动 Bridge，不暴露 HTTP 页面。http://127.0.0.1:3080 属于单独的 dsh web 命令。

适用场景与注意¶

它适合希望把 DeepSeek Harness Session 放进飞书/Lark 协作场景中的 DSH 插件使用者，例如：

• 从 DM、群聊或 topic/thread 发起任务。
• 将不同 Lark 群映射到不同 Harness Project。
• 默认按 topic/thread 隔离 Session。
• 通过原生卡片查看运行、完成、阻塞、取消或失败状态。
• 用卡片按钮批准单次工具调用，或回答结构化 Agent 问题。
• 在需要时接收文本、图片、文件，并通过 lark_deliver 回传工作区文件。

需要注意：作为 DSH 插件，它会在当前 dsh 进程权限下运行相关能力。安装前应检查源码和 MIT 许可证。由于 DeepSeek Harness 仍处于 developer preview，并且 dsh-lark-bridge 测试于 0.1.0-rc.6，实际使用时应以当前 Harness 版本和权限边界为准。

结尾¶

dsh-lark-bridge 的价值在于把 DeepSeek Harness Session 的控制、状态、审批、文件交互集中到飞书/Lark 会话中，同时保持 WebSocket 长连接、项目映射和文件边界检查。

目录页 URL 未在本次已核实事实中给出，本文不列具体地址。GitHub 仓库：

https://github.com/imetn/dsh-lark-bridge