前言¶
DeepSeek Harness (DSH) 的設計理念是「一切皆插件」。dsh-prime-orchestrator 旨在解決在 DSH 代理內部編排 Prime Agent 會話的需求。它將一個 DSH 代理轉變爲一個委託引擎，提供了從主機端到模型端的全套接口，使智能體能夠管理目標、監控會話、協調子代理並控制隊列。
插件概覽¶
該插件由 mrme000m 維護，遵循 MIT 許可證。它作爲一個單一的安裝包，將 Prime Agent 的核心能力集成到 DSH 生態中，包括主機引擎、模型端工具、Web UI 集成以及一個完整的編排代理預設。
核心能力¶
主機引擎¶
插件在主機端提供以下核心組件：
* 共享委託表：用於管理跨會話的委託狀態。
* 上下文接口：提供 ctx.prime 上下文對象。
* 通信層：包含協議-7 守護進程套接字客戶端和 /prime JSON API。
* 配置命名空間：提供 prime-orchestrator 設置命名空間。
模型端接口¶
模型通過 prime_agent 工具與編排層交互，支持以下操作：
* 會話管理：委託、監控、引導、協調、管理目標、心跳和記錄。
* 子代理控制：讀取記錄、檢查和管理遞歸子代理。
* 會話控制：在會話中途切換模型、控制隊列和遞歸深度、分叉分支以及導出記錄。
Web UI 集成¶
插件爲 DSH Web 界面增加了以下功能：
* Prime 艦隊列：位於 Web GUI 右側（可在側邊欄底部切換），顯示實時委託/會話/事件流。
* 設置區域：Settings → Prime Orchestration 區域，用於配置引擎參數。
* 待處理問題橫幅：瀏覽器端的 shell.overlay 組件。
代理預設與工具¶
- 代理預設：
prime-orchestrator，派生自standard，包含完整的編碼能力和編排接口。 - Cloudflare Workers AI 工具：提供
cf_ai_run（運行模型）和cf_ai_models（列出模型）工具。
安裝與啓用¶
前置條件¶
在安裝前，請確保以下工具已安裝在系統 PATH 中：
* dsh CLI：@deepseek-ai/dsh
* prime-agent CLI：pip install prime-agent
安裝命令¶
通過 npm 安裝插件：
dsh plugin --profile web add dsh-prime-orchestrator
啓用與使用¶
安裝完成後，可以在 Web 界面中創建一個會話，並選擇 prime-orchestrator 預設。或者，也可以通過 Settings → Agent presets 將其設置爲默認代理。
插件會在啓動時將預設文件具象化到 $DSH_HOME/.agent-presets/prime-orchestrator/ 目錄。
兼容性與注意事項¶
版本兼容性¶
該插件僅兼容以下 DSH 版本：
* 0.1.0-rc.7
* 0.1.1-rc.2
* 0.1.1-rc.2 (npm latest)
對於 0.1.2-alpha 版本，由於客戶端插件 API 變更，目前不兼容。
佈局限制¶
DSH 的默認佈局只有三列 Shell。dsh-prime-orchestrator 需要通過插件自帶的 layout-override.js 邏輯來添加第四個名爲 prime 的 Shell 列。這是通過重寫引導 manifest 中的入口 URL 實現的，不會修改主機文件系統中的任何文件。
二進制輸出處理¶
通過該插件調用 Cloudflare Workers AI 等接口產生的二進制輸出（如圖像、音頻），會被寫入文件而非原始字節流。例如，cf_ai_run 的二進制結果會保存爲 <model-slug>-<timestamp>.<ext> 文件，並返回文件路徑供模型引用。
卸載¶
卸載插件會自動恢復 DSH 的默認三列 Shell 佈局。
