前言¶
DeepSeek Harness (DSH) 採用插件化架構，強調可擴展性。dsh-feishu-integration 插件旨在解決 DSH 在後臺或 Web 端運行時，用戶無法通過即時通訊工具進行交互的問題。它提供了一套機制，將 DSH 會話的總結髮送到飛書，並允許用戶通過回覆飛書消息來反向控制或繼續 DSH 會話。
核心能力¶
該插件提供以下核心功能：
* 會話總結推送：DSH 會話結束後，自動將總結內容發送到飛書。
* 回覆路由：在飛書中回覆某條總結，系統會自動識別並路由回產生該總結的 DSH 會話。
* 固定會話延續：支持點對點（p2p）和羣聊場景下的固定會話延續。
* 管理入口：在 DSH 設置頁提供綁定狀態查看、掃碼綁定、重連、斷開和解綁功能。
* 配置管理：提供二維碼 provisioning 和 fsum-admin CLI 管理入口。
* 多域支持：同時支持飛書 Feishu 域和國際版 Lark 域。
安裝與綁定¶
安裝插件需要在目標 DSH profile 中執行以下命令：
dsh plugin --profile web add github:yangwuan55/dsh-feishu-integration
安裝完成後，重啓對應的 DSH profile。插件自帶 dsh.bundle.patch，會自動掛載到 profile 中。安裝完成後，可以在 DSH 的設置頁中查看綁定狀態並掃碼綁定。該插件默認不會開啓入站長連接，因此安裝時不會自動與已有的飛書長連接插件競爭事件流。
啓用入站回覆路由¶
要實現“在飛書中回覆總結 -> 路由回 DSH 會話”的功能，需要啓用入站接管。由於飛書長連接使用集羣式事件分發，同一個應用同時運行多個長連接客戶端可能導致事件隨機分流，因此同一個 DSH profile 中必須先禁用其他飛書長連接插件，然後再啓用此插件的入站接管。
在 profile patch 中覆蓋配置以啓用入站接管：
- id: xmanrui-dsh-feishu
disabled: true
- id: dsh-feishu-integration
config:
takeoverInbound: true
replyTimeoutMs: 600000
CLI 管理¶
除了網頁端設置頁，插件也提供了 CLI 工具 fsum-admin 用於綁定、驗證和解綁等操作：
fsum-admin list
fsum-admin bind
fsum-admin bind --app-id cli_xxx --app-secret xxx --owner ou_xxx
fsum-admin verify --app-id cli_xxx
fsum-admin set-owner --app-id cli_xxx --open-id ou_xxx
fsum-admin unbind --app-id cli_xxx
數據與可靠性¶
- 數據遷移：插件保留了舊版
@xmanrui/dsh-feishu的本地數據佈局（$DSH_HOME/integrations/dsh-feishu/），以便遷移時延續已有綁定和固定會話。 - 安全存儲：敏感的
app_secret使用 DSH credential store 存儲，不寫入公開配置文件。 - 發送重試：總結髮送內置了重試機制，最多嘗試 10 次，採用指數退避策略（1s 起、30s 封頂、±20% 抖動），總截止時間爲 10 分鐘。斷網時順延等待但不消耗嘗試次數。每次邏輯發送攜帶飛書消息冪等
uuid，避免重複投遞。 - 超時處理：當等待回答超時（默認 600s）時，插件保持靜默，不追發錯誤回帖。轉發回執本身被視爲送達確認，超時僅記錄在 host 日誌中。
開發與維護¶
該插件使用 MIT 許可證。開發者可以通過以下命令進行開發：
git clone https://github.com/yangwuan55/dsh-feishu-integration.git
cd dsh-feishu-integration
pnpm install
pnpm build # 構建前端代碼
pnpm test # 運行迴歸測試
- Host 側邏輯：位於
lib/host/目錄，直接編輯 JS 文件即可，無需構建。 - Client 側邏輯：位於
client-src/目錄，修改後必須運行pnpm build重新生成lib/client.js。
生態背景¶
DSH 理念是“一切皆插件”，本插件爲該生態的一部分。該插件由社區用戶 yangwuan55 維護，與 DeepSeek 或幻方官方無直接隸屬關係。更多細節可查閱插件目錄頁或源碼倉庫。
