DeepSeek Harness (DSH) 業務橋接插件介紹

前言¶

DeepSeek Harness (DSH) 採用了「一切皆插件」的架構理念。業務系統接入 DSH agent 能力時，通常需要針對 SDK 或內部通信協議進行定製開發。newspringwei/dsh-biz-bridge 插件通過標準 HTTP 協議，將 DSH 的 agent 能力開放給外部系統，讓業務方通過簡單的 HTTP 請求即可獲取流式或回調響應，無需理解 DSH 內部細節。

插件概覽¶

• 插件名稱：newspringwei/dsh-biz-bridge
• 功能定位：DeepSeek Harness 業務橋接插件
• 維護者：NewSpringWei
• 許可證：MIT

核心能力¶

該插件主要提供以下能力：

• 標準 HTTP 協議接入：對外暴露 RESTful 接口，業務系統通過 HTTP 調用。
• 響應模式：支持 流式 (SSE) 和 回調 兩種響應模式。
• 上下文複用：通過 session_id 參數實現多輪對話上下文保持。
• 任務調度與存儲：任務調度與日誌存儲於 SQLite 數據庫。
• 附件雙向轉接：
  • 入站：業務方提交 URI，插件負責拉取附件並落盤。
  • 出站：agent 產出的文件會被發現、登記，並提供簽名下載接口。
• 安全校驗與約束：
  • 入口校驗：支持簽名認證、SSRF 防護、路徑越界檢測、越權校驗、附件體量與完整性檢查。
  • Agent 約束：支持移除工具、沙箱只讀模式等能力約束。
• 便攜部署：支持生成自帶運行時的便攜部署包。

安裝與啓用¶

在安裝前，請確保環境滿足以下要求：

• Node.js：^22.19.0 || >=24.0.0
• DSH 環境：機器上已安裝 DSH 並有 dsh 命令可用。

安裝步驟如下：

1. 獲取安裝包。可以從倉庫的 release 目錄獲取 dsh-biz-bridge-0.1.3.tgz，或自行構建。

    ls release/dsh-biz-bridge-0.1.3.tgz

2. 使用 dsh plugin 命令安裝插件。建議創建一個獨立的 profile bizbridge。

    dsh plugin --profile bizbridge add ./release/dsh-biz-bridge-0.1.3.tgz

3. 啓動服務。

    dsh --profile bizbridge

啓動日誌中出現 `activation rescue` 與 `activated` 即表示成功。

使用與測試¶

服務啓動後，可通過以下工具頁面進行接入測試：

• 接入測試頁：http://127.0.0.1:42731/bizbridge/static/client.html
• 密鑰工具頁：http://127.0.0.1:42731/bizbridge/static/utils.html

在測試頁中，可以進行流式/回調模式的請求測試，並測試附件的雙向轉接功能。

若需生成便攜部署包（將 Node + DSH + pnpm + 插件打包），可使用 tools/bundle/ 目錄下的工具。

安全與注意事項¶

• 信任模型：該插件面向可信業務系統，需私鑰簽名認證。通道是可信的，但轉發的內容可能來自上游，內容層仍按不可信處理。
• 當前版本狀態：版本 0.1.3 處於草創期，接口可能調整，不建議用於生產關鍵鏈路。
• 未配置 Client：若未配置 clients.json 和對應的公鑰，所有 API 請求將返回 401，只有靜態頁面可達。
• 獨立性：插件進程與 web/GUI 互不干擾。

結語¶

該插件爲業務系統提供了一條通往 DSH agent 能力的標準化 HTTP 路徑。更多配置細節、API 定義及安全邊界說明，請參考其官方目錄頁或GitHub 倉庫。