前言¶

DeepSeek Harness（命令名 dsh）是 DeepSeek AI 開源的智能體運行時，目前仍是開發者預覽。它的核心理念是「一切皆插件」：模型、工具、技能、會話、沙箱和界面都可以用插件替換或組合。社區裏還有一份獨立的插件目錄站點 deepseek-harness-plugin.com，它和 DeepSeek / 幻方沒有官方從屬關係，收錄的是帶 dsh-plugin 話題的社區倉庫。

日常跑 dsh，任務多半還停在終端或本機 Web UI。人一旦去開會、看羣消息，就要來回切窗口：想看進度得回到電腦前，模型提問、計劃確認、工具審批也卡在原來的界面裏。omdsh-dev 維護的 dsh-lark 把正在使用的 Harness 接到飛書 / Lark：私聊機器人或在羣裏 @ 它，就可以派任務、看執行過程，並在同一條聊天裏處理需要人點頭的步驟。

本文按插件目錄頁、GitHub 倉庫 README / package.json、npm 包頁和 DeepSeek Harness 官方倉庫交叉覈對後整理。飛書橋接在社區裏不止這一份，目錄裏還能看到 dsh-lark-bot 等同類插件；本文只寫倉庫 omdsh-dev/dsh-lark，不要和 GitHub 上其他同名或近名項目混用安裝命令。

dsh-lark 是什麼¶

dsh-lark 是一款面向 DeepSeek Harness 的「通知與集成」插件，由 GitHub 組織 omdsh-dev 維護，倉庫地址是 omdsh-dev/dsh-lark。社區目錄頁的定位是：飛書（Lark）機器人通道，直接在飛書裏和 DeepSeek Harness 智能體對話。

需要分清三個名字：目錄和倉庫叫 dsh-lark，真正發佈到 npm、命令行入口用的包名是 dsh-lark-channel。當前 npm 版本是 0.0.6（2026-08-15 發佈），許可證 BSD-3-Clause，主要語言 TypeScript。目錄頁收錄於 2026-08-12；截至 2026-08-17，GitHub 顯示 30 顆星，目錄頁當時仍標註 15 顆，星標以倉庫頁面爲準。

倉庫 README 把它寫成一條 IM 通道，而不是隻會問答的聊天機器人：可以切換真實工作區和模型，執行 Harness 裏已有的命令與工具；提問、計劃審閱和工具審批會回到當前飛書會話，用按鈕或文字作答。首次啓動用飛書掃碼創建應用，文檔寫明無需公網服務器，也無需配置回調地址。README 同時聲明：這是非官方社區插件，與 DeepSeek、飛書或 Lark 不存在隸屬、授權或背書關係。

核心功能¶

倉庫 README 列出的能力可以分成下面幾類。

1、把 Harness 會話留在飛書裏。重啓後可以恢復上下文，後續消息接着上次繼續；/new 會在原地開一個新會話，工作區和模型保持不變。會話可以按聊天、話題或羣成員隔離，對應配置項 sessionScope 的 chat、chat-thread、chat-sender 三種粒度。

2、工作區與模型可在聊天裏切換。/ws 查看可用工作區，/cd 切換；回到原來的工作區時繼續之前的任務。/model 打開模型選擇卡片，切換後保留當前會話；也可用 /model use 直接切換，或 /model reset 恢復默認模型。

3、執行過程按飛書原生形態展示。推理、工具調用和結果會作爲思考過程出現，最終答案單獨發送。人機協作則走卡片：單選、多選或文字回答問題，批准計劃或提出修改，允許或拒絕工具調用。會改變狀態的卡片綁定原聊天，轉發到其他聊天后不能操作原會話。

4、斜槓命令進入 DSH 命令運行時。除了通道自己的 /status、/help、/stop 之外，宿主自帶的 /plan、/compact、/permission 等也會直接交給 Harness。/status 展示工作區、模型和 session，可用時還顯示上下文佔用與累計 token，並支持刷新。渠道自帶文案會按每位讀者的飛書語言顯示中文或英文。

5、多個機器人可以進同一個羣協作。dsh-lark-channel add <名稱> 會寫入新實例並顯示二維碼；掃碼後，這個機器人擁有自己的設置、App Secret 和 session，不與第一個共享上下文。它們可以通過 @ 交接回合。默認最多連續進行 6 個機器人輪次（botHops），任何人發言都會恢復額度。

安裝與啓用¶

社區目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端中運行即可：

dsh plugin add github:omdsh-dev/dsh-lark

dsh CLI 會從 GitHub 解析插件並安裝到當前配置。如需可復現安裝，目錄頁要求固定 commit 哈希：

dsh plugin add github:omdsh-dev/dsh-lark#commit

把上面的 commit 換成倉庫裏實際的提交哈希。目錄頁同時提醒：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。

倉庫 README 把日常啓用寫成獨立 CLI。若本機還沒有 DeepSeek Harness，需要先安裝官方包：

npm i -g @deepseek-ai/dsh

然後安裝通道並啓動：

npm i -g dsh-lark-channel
dsh-lark-channel start

終端會顯示二維碼。用飛書掃碼完成應用創建，然後私聊機器人，或在羣裏 @ 它即可開始。啓動命令會在首次安裝依賴前寫好 profile 的 pnpm 構建策略：未經批准的依賴構建腳本一律警告並跳過，而不是讓安裝失敗；protobufjs 那個只打印提示的 postinstall 還會被按名字記爲跳過，因此不需要手工執行 pnpm approve-builds。

不想裝到全局也可以直接跑，之後每條命令都要帶 npx：

npx dsh-lark-channel@latest start

如果希望飛書和已經在跑的 dsh web 共用同一個 profile，README 給出的寫法是：

dsh plugin --profile web add dsh-lark-channel@latest
dsh web

環境要求以倉庫 README 和 package.json 爲準：Node.js ^22.19.0 || >=24，DeepSeek Harness 0.1.0-rc.6 或更新版本，以及一個飛書或 Lark 租戶。原生思考過程需要飛書 PC 7.70、移動端 7.74 或更新版本；舊客戶端可以使用 output: 'stream'。

典型用法¶

倉庫 README 建議先看當前狀態和可用工作區：

/status
/ws
/cd my-project
/model

各命令的含義如下：

• /status：查看並刷新工作區、模型和 session；可用時包含上下文與 token 狀態
• /ws：查看可用工作區
• /cd <名稱或路徑>：切換工作區
• /model：打開模型選擇卡片
• /new：原地開一個新會話，清空上下文，工作區和模型保持不變
• /stop：停止當前任務
• /help：查看全部命令（含宿主提供的）

然後可以直接派任務。README 裏的示例是：

檢查這個項目爲什麼構建失敗。先給我計劃，需要操作時讓我確認。

Agent 的執行過程會顯示在飛書中；需要你參與時，會發送提問、計劃或審批卡片。

macOS 和採用 systemd 的 Linux 會使用用戶級後臺服務，關閉終端後仍可運行：

dsh-lark-channel status
dsh-lark-channel logs -f
dsh-lark-channel restart
dsh-lark-channel stop

用 npx 啓動的話，這些命令同樣要帶 npx dsh-lark-channel@latest 前綴。工具會按實際啓動方式打印提示，讀到什麼就能直接粘貼。升級用 dsh-lark-channel upgrade，它會裝上最新 CLI 並在新版本上重啓機器人；npx 路徑本身就是最新，不必這一步。連接異常時，插件會在限額和退避控制下自動重建 WebSocket，避免進程仍在但機器人已經靜默離線。

給第二個飛書應用添加一套獨立 Agent：

dsh-lark-channel add reviewer

命令會寫入新實例、重啓服務並顯示二維碼。需要移除時用 dsh-lark-channel remove reviewer；移除會保留該實例的憑據和設置，之後用同一個名字重新添加即可恢復。

README 還列出若干權限與高級選項，配置在啓動時讀取，修改後需要重啓服務：

• 飛書應用的可用範圍決定誰能找到機器人；senderAllowlist、groupAllowlist 和 approvers 可以進一步收窄權限
• workspaceRoots 可以限制聊天中允許切換到的目錄
• botPeers 可以限制允許對話的機器人，botHops 控制連續機器人輪次，默認是 6
• 部署提供 credentials 服務時，掃碼得到的 App Secret 會存入其中；舊版本寫在 settings 中的 secret 會在下次啓動時自動遷移
• 圖片附件默認關閉；只有確認當前模型支持視覺時，才應開啓 attachImages

適用場景與注意事項¶

適合已經在本機跑 DeepSeek Harness、同時日常溝通又在飛書 / Lark 裏的人：出差或開會時從手機派一個構建排查任務，羣裏讓機器人和同事對齊進度，或者用第二個機器人專門做複覈。它依賴你本機（或同一套 profile）上已經可用的工作區、模型和工具，並不會單獨變成一臺雲端編碼服務。

使用前有幾件事需要先看清楚。

1、插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。目錄頁和倉庫都要求先檢查源碼與 BSD-3-Clause 許可證；需要可復現安裝時，用目錄頁的 #commit 寫法釘死提交，而不是長期跟蹤浮動的 latest。

2、這是社區插件，不是 DeepSeek、飛書或 Lark 的官方產品。社區目錄站點也不是官方應用商店。GitHub 上還有 dsh-lark-bot、dsh-lark-bridge 以及討論區裏出現過的其他飛書橋接，安裝命令、包名和能力邊界都不一樣，不要互相套用。

3、通道能切換到的目錄、誰能找機器人、誰能點審批，都受飛書應用可見範圍以及 workspaceRoots、senderAllowlist、groupAllowlist、approvers 約束。多機器人協作默認有 6 輪上限，避免羣裏兩個機器人互相 @ 停不下來。

4、Harness 本身仍是開發者預覽，官方 README 寫明未來會出現破壞兼容性的變更。本插件要求 dsh 至少 0.1.0-rc.6，Node.js 版本也比許多舊項目更嚴。飛書客戶端過舊時，原生思考過程可能畫不出來，需要按文檔改用 output: 'stream'。

小結¶

dsh-lark 做的事情很具體：把已經在跑的 DeepSeek Harness 接到飛書聊天，讓派任務、看過程和做審批不必再守着終端。目錄頁安裝命令是 dsh plugin add github:omdsh-dev/dsh-lark；真正掃碼拉起機器人，則以倉庫 README 裏的 dsh-lark-channel start 爲準。

目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-lark/

GitHub：https://github.com/omdsh-dev/dsh-lark

npm：https://www.npmjs.com/package/dsh-lark-channel