前言¶
DeepSeek Harness（DSH）遵循“一切皆插件”的設計理念，其 CLI 工具通常與特定的運行時環境或協議集成。當你需要將 DSH 的推理能力直接暴露給 Multica 時，需要一個符合特定 JSONL 過程協議的橋接層。dsh-profile-multica 作爲一個安裝式社區包，實現了這一點，它將官方 DSH CLI 轉換爲 Multica 可識別的 JSONL 流。
核心功能¶
該插件通過一個專用的 multica profile 向 DSH 添加了以下能力：
- 添加命令：新增三個命令行選項：
--probe、--list-models和--stdio。 - 模型發現：
--list-models命令會投影當前已安裝的 DSH 提供商、模型和推理級別。 - 事件流：
--stdio模式接受執行請求，並將 Agent 和 Session 事件以 JSONL 格式流式傳輸。 - 請求取消：支持對正在進行的請求進行取消操作。
安裝與啓用¶
在安裝前，請確保環境滿足以下要求：
- Node.js 版本爲
^22.19.0或>=24.0.0 @deepseek-ai/dsh版本爲0.1.0-rc.7或兼容的後續預發佈版本- PATH 中包含 pnpm 以便調用
dsh plugin
安裝插件需要使用官方 CLI 命令：
dsh plugin --profile multica add dsh-profile-multica
安裝完成後，可以執行以下命令驗證插件是否生效：
dsh --profile multica --probe
典型用法¶
1. 探測與模型列表¶
--probe 命令用於打印 Multica 使用的發現幀。--list-models 則用於查看當前配置的可用模型列表：
dsh --profile multica --probe
dsh --profile multica --list-models
2. 執行請求與事件流¶
--stdio 命令是核心執行入口。它接受一個版本 1 的執行請求，通過 stdout 流式輸出事件，並通過 stderr 輸出診斷信息。
在使用前，需要配置環境變量：
MULTICA_DSH_SESSION_ROOT：選擇 JSONL 持久化目錄。DSH_PERMISSION_MODE：設置權限模式。選項包括read-only（只讀）、workspace-write（工作區寫，默認）或danger-full-access（完全訪問）。
由於協議沒有交互式批准回合，因此必須在執行前選擇符合當前環境策略的權限模式。
適用場景與注意¶
- 單進程單請求：協議限制一個進程只能接受一個執行請求。Multica 在處理任務時，需要爲每個任務啓動一個全新的進程。
- 無交互批准：該協議沒有批准響應機制。如果操作超出了所選的策略範圍，操作會直接失敗，而不會等待人工批准。
- 模型發現容錯：在模型發現過程中，如果某個提供商失敗，插件會將其錯誤信息打印到 stderr，然後繼續處理剩餘的提供商，不會中斷整個流程。
- API 版本跟蹤：該包跟蹤預發佈 DSH API。如果 DSH 發佈了新的預發佈版本，可能需要等待插件發佈相應的匹配版本。
總結¶
如果你需要在 Multica 中直接利用 DeepSeek Harness 的能力，dsh-profile-multica 提供了一個基於 JSONL 協議的輕量級橋接方案。它通過標準的命令行接口和流式事件傳輸，實現了 DSH 與 Multica 的集成。
