dsh-feishu-chat：DeepSeek Harness 飛書雙向聊天橋

前言¶

DeepSeek Harness 的設計理念是“一切皆插件”。開發者需要將 Agent 連接到外部平臺時，往往面臨配置繁瑣、連接不穩定的問題。現有的實現通常需要手動編輯配置文件，且難以在運行時動態調整工作區。

下面介紹 dsh-feishu-chat，這是一個用於連接飛書（Lark）機器人的插件，它通過官方 WebSocket 長連接實現雙向聊天，並提供可視化的設置頁面來管理機器人憑證和工作區路由。

這是一個客戶端插件，旨在打通 DeepSeek Harness 與飛書機器人之間的通信。它不依賴手動編輯配置文件，而是通過界面填入 App ID 和 App Secret 進行連接，支持在運行時動態切換工作區。

憑證連接
通過設置頁面填入 App ID 和 App Secret 即可建立連接，無需手動修改配置文件。憑證存儲在本地 $DSH_HOME/feishu-bot/config 目錄下。
工作區路由
設置頁面列出了 Profile 已知的所有工作區。點擊任意一行即可綁定該工作區，入站消息將路由至該工作區的最新會話。切換綁定關係無需重啓 Harness。
雙向聊天
消息通過飛書官方 WebSocket 長連接（im.message.receive_v1）接收。Agent 回覆後，消息會自動發送回同一聊天窗口。
Agent 工具
Agent 可使用 feishu_send_message 工具向飛書發送消息。默認 chat_id 爲最近聯繫過 DSH 的聊天。
長連接保障
插件在進程內維護長連接，支持 Protobuf 幀解碼（pbbp2）、自動 ACK、Ping 保活、分片合併以及自動重連。

使用官方 CLI 安裝插件：

dsh plugin --profile web add dsh-feishu-chat

安裝後，重啓 dsh web 進程（如果是本地開發，刷新瀏覽器即可）。在設置頁面找到“飛書”選項：

在飛書發送消息給機器人，DSH Agent 會接收到消息並生成回覆。Agent 也可以在運行時調用 feishu_send_message 工具主動向用戶發送消息。

權限與來源
這是一個社區第三方插件。安裝後它將以當前 DSH 進程的權限運行，請確保在安裝前檢查源碼和許可證（MIT）。
消息處理
每條入站消息會生成一個子 Agent（無隊列機制）。在消息密集時，回覆可能會出現亂序。
網絡環境
插件在底層使用了 rejectUnauthorized: false 放寬了 TLS 驗證，以便在公司代理或證書存儲損壞的環境中工作。請根據實際環境評估安全風險。
配置位置
憑證僅在本地保存，不會上傳或提交到倉庫。

dsh-feishu-chat 爲需要在飛書平臺上與 DeepSeek Harness Agent 交互的開發者提供了一個無需手動配置文件的解決方案。通過官方 WebSocket 長連接和可視化的設置頁面，它簡化了雙向聊道的搭建流程。