前言¶

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