前言¶
DeepSeek Harness (Cordis) 提供了構建智能體的基礎框架。在對接即時通訊（IM）時，通常需要配置公網 IP 和回調服務器來接收事件。本插件基於飛書官方 @larksuiteoapi/node-sdk，使用官方 WebSocket 長連接接收事件，省去了配置回調服務器的步驟。
插件由 tkwkeven 維護，同時提供兩個插件入口：一個用於消息通道橋接，另一個用於進程重啓後的恢復通知。安裝後，它會自動插入配置到 Harness 的 cordis.patch.yml 中。
功能特性¶
- 消息通道橋接：基於 WebSocket 長連接的消息通道橋接，支持飛書中國版與國際版。
- 並行任務會話：支持創建獨立的、可持久化的 Harness 會話，並在各自的話題中運行，帶有實時流式交互卡片。
- 媒體處理：支持媒體入站（文件、語音、視頻）和出站（通過斜槓命令或模型標記），支持超大文件自動降級與雲空間上傳。
- 雲文檔支持：支持飛書雲文檔的讀取與生成。
- 進程恢復通知：進程重啓完成後，向發起重啓的聊天發送恢復提示。
- 無需公網環境：無需配置公網 IP 和回調服務器即可運行。
安裝與啓用¶
安裝前請確保已安裝 Node.js 22.19 或更高版本，並已安裝 DeepSeek Harness。
執行以下命令進行安裝：
pnpm dsh plugin --profile web add https://github.com/tkwkeven/dsh-lark-all/releases/download/v1.0.0/dsh-lark-all-1.0.0.tgz
安裝完成後，插件會自動插入配置到 Harness 的 cordis.patch.yml 中。你需要確保已通過 Harness 憑據服務解析 App Secret，並在飛書開放平臺配置好權限。
典型用法¶
基礎命令¶
在聊天中發送以下命令以進行連通性檢查或查看狀態：
/bot-ping：連通性檢查，返回pong。/bot-help：查看命令幫助。/bot-status：查看連接狀態。
並行任務會話¶
在聊天中發送以 任務： 開頭的消息，即可創建獨立會話：
任務：幫我調研一下開源社區的 Cordis 插件生態
ptc任務：寫一個 PowerShell 腳本批量重命名文件
任務執行過程中會顯示流式卡片，任務完成後報告以回覆形式投遞。在任務話題中繼續發消息即可繼續該會話。
發送媒體¶
可以使用斜槓命令或模型標記的方式發送文件、圖片、語音或視頻：
/bot-send-file C:\path\to\demo.txt
/bot-send-image C:\path\to\photo.png
模型在回覆中單獨一行輸出 [lark-file: 路徑] 也可以附帶媒體。
接收媒體¶
接收到的文件、語音、視頻會自動下載到 <cwd>/.lark-inbox/ 目錄，文本類文件附帶內容預覽。原圖若超過附件限制，會自動降級爲工作區文件。
注意事項與適用場景¶
- 依賴要求：需要
Node.js >= 22.19，且依賴@larksuiteoapi/node-sdk與 DeepSeek Harness 的相關 peer dependencies。 - 憑據安全：App Secret 不寫入插件配置，必須通過 Harness 憑據服務解析，建議使用環境變量注入 App ID。
- 平臺配置：需要在飛書開放平臺配置權限，並在“事件與回調”中啓用“使用長連接接收事件”。
- 運行權限：插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證。
結尾¶
該插件通過整合消息通道與運維通知功能，降低了 DeepSeek Harness 在飛書/Lark 環境下的接入成本。更多配置細節與源碼，可參考 GitHub 倉庫。
