前言¶
DeepSeek Harness (DSH) 採用插件化架構，旨在通過擴展實現功能集成。在本地開發環境中，開發者通常已經安裝了多種代碼輔助工具（如 OpenCode、Claude Code 等）。將 DSH 與這些已有的智能體 CLI 工具打通，是提升開發效率的關鍵。
這是什麼¶
dsh-agent-bridge 是一個數據驅動的智能體橋接插件。由維護者 mike-sl-ig 開發，旨在解決 DSH 與現有編程智能體集成困難的問題。
該插件通過 JSON 配置文件（Recipes）描述智能體的行爲，而非硬編碼廠商邏輯。這意味着添加新智能體或修復配置變更，只需修改數據文件，無需修改插件代碼。
核心功能¶
插件提供了以下核心能力：
- 跨平臺啓動器：支持在不同操作系統上定位和啓動本地智能體。
- JSON Recipes：通過 JSON 文件定義智能體的運行參數、輸出解析和版本探測。
- 會話頭部交互：在 DSH 會話頭部提供按鈕，用於切換候選智能體池，查看上一次運行結果。
- 工具集：模型可直接調用的三個工具：
agent_list：探測可用智能體，查看位置、成本及支持能力。agent_run：以獨立工作者的身份執行智能體，返回答案、會話 ID、耗時、工具調用及運行報告路徑。agent_mode：讀取或修改按鈕當前顯示的狀態。
- 運行報告：每次運行生成 Markdown 和 JSON 兩種格式的報告。
- 嚮導與自測：提供配方向導和自測功能，輔助配置。
- 註冊表導入：支持從社區註冊表導入配置。
安裝與啓用¶
安裝前請確保環境滿足要求：
- Node.js 版本 >= 20
- 依賴的 DSH 版本：
@deepseek-ai/dsh >=0.2.0-rc.2 <0.3.0
使用以下命令安裝插件：
dsh plugin --profile <your-profile> add dsh-agent-bridge
典型用法¶
1. 切換與探測智能體¶
在 DSH 會話的頭部，可以通過按鈕切換候選智能體池。模型可以使用 agent_list 工具探測當前環境中的可用智能體：
agent_list：用於探測可用智能體，包括位置、成本和支持能力。使用probe: true參數會額外運行版本檢測。
2. 執行智能體任務¶
模型可以使用 agent_run 工具將某個智能體作爲獨立工作者執行任務。該工具會返回答案、會話 ID、執行時間、工具調用記錄以及運行報告的文件路徑。
3. 讀寫狀態¶
使用 agent_mode 工具可以讀取當前智能體的狀態，或手動修改按鈕顯示的配置。
4. 編寫配置¶
智能體的行爲由 JSON 配置文件定義，文件需放置在 lib/recipes/ 目錄下。參考 opencode.json、claude.json 或 workbuddy.json 的示例編寫自己的配置。
5. 使用角色模式¶
插件定義了四種角色模式，用於控制智能體的行爲策略：
default：標準模式，不附加額外指令。verify：獨立驗證者，來自不同模型家族，禁止使用工具，執行一次通過。bulk：廉價機械工作流，偏好直接回答，禁止自我工具檢查。second：獨立第二意見，禁止使用工具，執行一次通過。
注意事項與適用場景¶
- 廠商無關性：插件本身不硬編碼任何特定廠商的 CLI，所有廠商邏輯由 Recipes 定義。
- 工具限制：在
verify和second模式下，插件會強制禁止工具調用，以防止非預期的長耗時或死循環。 - 依賴與生命週期：插件無運行時依賴，也無安裝時的生命週期鉤子。
- 環境檢查：使用前請檢查源碼與許可證（MIT）。
- 適用場景：適合需要跨模型驗證、低成本批量任務處理或獲取獨立第二意見的開發場景。
結尾¶
dsh-agent-bridge 提供了一種標準化的方式將 DSH 與現有的本地智能體工具連接起來。通過 JSON Recipe 機制，它保持了高度的靈活性和可維護性。若需查看完整文檔或源碼，可參考其目錄頁或 GitHub 倉庫。
