前言¶
離開電腦後，需要繼續與 DeepSeek Harness 助手對話、查看結果或處理任務時，通常只能回到桌面端。dsh-lark-agent 爲 DeepSeek Harness 提供了一個飛書（Lark）私聊入口，讓助手在手機或平板上也能響應請求。
這是什麼¶
dsh-lark-agent 是一個 DeepSeek Harness 插件，通過官方飛書 CLI 與運行中的 Harness 實例通信。它會在飛書中創建一個獨立的私聊會話，不會接管桌面端或網頁端已打開的對話。插件由 Nirvana-Jie 維護，開源協議爲 MIT。
核心功能¶
在飛書私聊中，助手支持以下能力：
- 發起請求：助手使用 Harness 的工具（網頁搜索、頁面讀取、工作區文件等）處理請求，結果以卡片形式流式返回，思考過程摺疊在卡片內部
- 確認請求：需要用戶審批的操作會發送確認卡片，點擊「允許一次」或「拒絕」；5 分鐘內未響應則不會執行
- 選項選擇：當 Harness 需要用戶選擇時，發送選項卡片供點擊或填寫
- 權限切換：通過
/permission或底部菜單「設置 → 權限模式」在只讀、工作區編輯、完全訪問之間切換，完全訪問後不再詢問 - 文件傳輸：助手可以將工作區文件直接發送到聊天中
- 優先結論：說「lead with the conclusion from now on」，助手會記住此偏好
- 會話管理：使用
/sessions、/new繼續、切換或開啓新話題 - 圖表展示：請求柱狀圖等數據時，返回原生飛書圖表卡片
- 表單交互：先讓用戶選擇選項再繼續，發送表單卡片
- 文檔與白板：請求架構圖或報告時，創建只讀共享的飛書文檔（含白板），App 0.2.1-rc.2/0.2.1-rc.3 中打開該文檔可在 App 內預覽
- 模型與思考深度：通過
/model、/thinking切換模型與思考深度，與電腦端保持同步
默認情況下，助手只響應自己的私聊。權限和會話記憶保留在運行 Harness 的主機上，消息通過飛書傳遞給模型提供商。
安裝與啓用¶
前置要求¶
- DeepSeek Harness 正在運行，已選擇默認模型
- PC App 版本 0.2.1-rc.3（0.2.1-rc.2 也可），或 Web / dsh CLI 版本 0.1.1-rc.2
- 在同一機器上安裝官方飛書 CLI（需要 Node.js / npm）：
npm install -g @larksuite/cli@1.0.98
lark-cli --version
安裝插件前不要運行 lark-cli config init 或 lark-cli auth login，插件會在掃碼時創建自己的專用 CLI 配置文件。
桌面應用安裝¶
- 在側邊欄打開「插件 → 添加插件」
- 輸入
dsh-lark-agent，點擊「安裝」 - 點擊「立即啓用」，如需則重啓應用
CLI 安裝¶
dsh plugin 使用 pnpm，需確保 pnpm 在 PATH 中：
dsh plugin --profile web add dsh-lark-agent --allow-build=protobufjs
然後重啓 dsh web。
注意：
--allow-build=protobufjs允許 Lark SDK 依賴的安裝腳本運行。pnpm 11 在未指定時會跳過該腳本並報錯ERR_PNPM_IGNORED_BUILDS。若已報錯，可執行：
dsh plugin --profile web approve-builds '!protobufjs'
然後再重啓 dsh web。
連接飛書¶
- 打開飛書設置頁面：桌面應用「設置 → 內置插件 → 飛書」，網頁「設置 → 插件 → 飛書」
- 點擊「掃碼創建並連接」，用你的飛書賬號掃碼並批准
- 若組織需要管理員批准，點擊「重新檢查」等待批准
- 點擊「打開飛書私聊」，從掃碼賬號發送配對詞（
DSH-…，10 分鐘內有效）作爲純文本消息，必要時確認「這是我，完成連接」 - 頁面顯示「已連接」後，即可向助手發送消息
注意：飛書入口僅在主機在線時可用（主機未關閉、網頁未停止、電腦未睡眠）。
典型用法¶
在飛書私聊中：
- 請求查詢或任務處理：助手會使用工具並流式返回結果卡片
- 需要審批時：點擊「允許一次」或「拒絕」
- 需要選擇時：點擊選項或填寫表單並提交
- 切換權限模式：使用
/permission或底部菜單 - 查看結果文件：助手直接發送文件
- 請求圖表：獲得原生飛書圖表卡片
- 請求文檔或白板：創建只讀共享的飛書文檔
- 切換模型或思考深度：使用
/model或/thinking
適用場景與注意¶
適合需要移動端訪問 Harness 能力的場景，如外出時繼續對話、查看生成結果、快速審批或處理簡單任務。
注意：插件以當前 Harness 進程的權限運行。安裝前應檢查源碼與許可證。不同版本和平臺的兼容性尚未完全驗證，當前已驗證的版本組合見 README 中的兼容性說明。
結尾¶
dsh-lark-agent 讓 DeepSeek Harness 助手從電腦延伸到飛書，在離開屏幕時也能保持連續交互。更多文檔、升級說明與排障步驟請參考項目頁面。
- 插件目錄：https://www.skillhub.cn/plugins/Nirvana-Jie/dsh-lark-agent
- GitHub：https://github.com/Nirvana-Jie/dsh-lark-agent
