前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的架構。當需要在 DSH 中集成飛書消息時，通常需要自行開發 Webhook 服務來接收和轉發消息。dsh-lark-connector 插件通過飛書官方 SDK 提供長連接，將飛書消息直接接入 DSH 會話，由 Agent 處理後通過飛書回覆，無需額外的消息中轉服務。
功能特性¶
該插件包含以下核心能力：
- 飛書 WebSocket 長連接：使用官方 SDK 接收實時消息，無需部署外部 Webhook。
- 私聊與羣聊支持：私聊消息直接響應；羣聊僅響應明確 @ 機器人的文本消息。
- 識圖能力：支持 PNG/JPEG/WebP/GIF 格式，自動下載並持久化到 DSH 附件存儲，供視覺模型處理。
- 會話隔離與恢復：每個飛書
chat映射到獨立的 DSH session，支持 FIFO 順序處理。 - 原生 DSH 會話標題：使用飛書聊天標題作爲 DSH session 標題，並在消息中標註發送者信息。
- Workspace 歸屬：可將飛書會話歸入指定 DSH workspace。
- 新會話默認配置：在 Web 設置頁配置 Agent preset、Provider/Model 和 Workspace，應用於後續創建的飛書 session。
- 可靠回覆：支持超長文本分段，通過消息 ID 有界去重防止重複處理。
- 憑據管理：支持通過 DSH credentials 服務或環境變量保存 App ID、App Secret 等。
- lark-cli 集成：自動同步憑據到 lark-cli，提供配置檢查工具。
- 中英文 Web 界面：設置頁面文案跟隨 DSH 當前語言。
安裝與啓用¶
插件已發佈在 npm，安裝路徑需替換爲實際源碼路徑：
dsh plugin --profile web add /path/to/dsh-lark-connector
安裝完成後，重啓 DSH Web Host。插件註冊名爲 lark-connector。
配置¶
Web 設置頁¶
在 DSH 設置的「飛書連接器」頁面，需配置以下項：
- App ID：飛書應用 ID
- App Secret：飛書應用密鑰
- Brand：品牌標識，通常爲
feishu或lark - lark-cli 路徑：lark-cli 可執行文件路徑，留空則從系統 PATH 查找
- 飛書會話 Workspace：指定飛書會話歸屬的 DSH workspace
- 新建會話默認配置：Agent preset、Provider、Model 等
- 卡片展示選項：是否添加 THINKING 表情、是否使用交互卡片流式更新、是否展示工具調用等
環境變量¶
憑據支持通過環境變量配置，優先級高於 Web 頁面保存的值：
| 變量名 | 作用 |
|---|---|
LARK_APP_ID |
飛書應用 App ID |
LARK_APP_SECRET |
飛書應用密鑰 |
LARK_BRAND |
品牌，通常爲 feishu |
LARK_CLI_PATH |
lark-cli 可執行文件路徑 |
lark-cli 集成¶
插件提供兩個 DSH 工具：
lark_setup：檢查 lark-cli 和官方 Agent Skills，可選擇執行官方安裝器。lark_status：查看應用配置、CLI 版本和連接狀態。
使用與注意事項¶
典型用法¶
- 在飛書開放平臺創建應用並啓用機器人能力，訂閱
im.message.receive_v1事件。 - 在 DSH Web 設置頁配置 App ID、App Secret 等憑據。
- 使用
lark_setup工具檢查環境。 - 在飛書羣聊中 @ 機器人以開始交互。
注意事項¶
- 羣聊響應：羣聊僅響應明確 @ 機器人的文本消息。
- 附件限制：圖片超出單條消息附件數量上限會被忽略。
- 環境變量優先級：環境變量優先級高於 Web 頁面保存的憑據。
- 歸檔行爲：歸檔後的 chat 會自動創建新的可見 session。
生態與維護¶
dsh-lark-connector 是一個社區插件，由開發者 4t145 維護。
- 許可證：MIT
- 項目地址：https://github.com/4t145/dsh-lark-connector
- 插件目錄：https://www.skillhub.cn/plugins/4t145/dsh-lark-connector
