前言¶
DeepSeek Harness 的核心設計理念是「一切皆插件」,開發者可以通過編寫插件擴展智能體的能力。但在實際使用中,把 DSH 的邏輯直接嵌入到飛書(Lark)的工作流中,通常需要額外的開發工作。dsh-lark-claw 插件解決了這個問題,它提供了一個網關,讓 DSH 能直接作爲飛書機器人運行,從而將本地或服務端的智能體能力轉化爲即時通訊工具中的個人助手。
插件簡介¶
該插件由開發者 Illuminated2020 維護,是一個獨立的飛書/Lark 網關和持久化 cron 包。它的核心價值在於將 DeepSeek Harness 的運行環境與飛書生態打通,讓用戶無需切換應用即可在聊天界面中利用智能體處理任務、分析文件或管理日程。
核心功能¶
該插件主要提供以下能力:
1. 持續對話:保持每個主題的上下文,服務重啓後仍可繼續之前的對話。
2. 實時進度:在飛書卡片中實時展示響應狀態和工具活動。
3. 圖片和文件處理:支持理解截圖內容或回覆文件進行總結分析。
4. 定時任務:支持通過自然語言設置一次性提醒或重複執行的定時任務。
5. 審批和提問:當操作需要權限時,會彈出卡片供用戶審批或回答問題。
安裝與啓用¶
安裝前需確保環境滿足以下要求:
* DeepSeek Harness 版本需在 0.1.2-rc.1 或更高。
* Node.js 版本需爲 ^22.19.0 或 >=24.0.0。
* 已安裝 pnpm。
在終端中執行以下命令安裝插件:
dsh plugin --profile feishu add dsh-lark-claw
安裝完成後,需要在飛書開發者控制台中配置 App ID 和 App Secret,並啓用機器人能力、長連接事件訂閱以及必要的權限(如 im:message.group_msg)。配置完成後,啓動服務即可使用:
dsh --profile feishu
典型用法¶
- 任務分析:在飛書發送消息
分析項目並解釋如何運行,機器人會以卡片形式展示進度和結果。在同一個話題中回覆,可以繼續對任務進行追問。 - 文件處理:發送圖片或文件,並附帶指令(例如
總結此文件),機器人會解析內容並給出結果。文件格式支持取決於 Agent 當前可用的工具。 - 設置提醒:發送
每週一早上檢查項目進度,機器人會將其解析爲定時任務。 - 控制任務:使用
/stop命令停止當前任務,或使用/reset重置當前話題的對話狀態。
適用場景與注意¶
該插件適合需要在飛書環境中直接調用 DSH 智能體能力的場景。
注意事項:
* 權限配置:必須在飛書開發者控制台配置 App ID 和 App Secret,並啓用機器人能力、長連接事件訂閱和特定權限。
* 服務運行:定時任務僅在服務運行期間有效。如果服務停止,已設置的定時任務不會自動執行。
* 文件支持:圖片和文件的處理能力取決於 Agent 可用的工具,並非所有格式都支持。
* 許可證:該插件採用 MIT 許可證。
總結¶
通過 dsh-lark-claw,開發者可以將 DSH 的邏輯層無縫接入飛書,省去了手動轉發或開發獨立網關的麻煩。更多細節可查閱官方目錄或源碼倉庫。