前言¶
DeepSeek Harness（DSH）的生態強調「一切皆插件」。在使用 Codex 進行子代理委派時，官方提供的 @deepseek-ai/dsh-subagent-codex 插件存在兩個限制：其一，其 Schema 僅暴露 description 和 prompt，無法在每次調用中指定具體的模型或推理強度；其二，它作爲全局 Host 工具存在，無法按預設關閉，且在與某些配置組合時可能引發衝突。dsh-subagent-codex-pro 插件旨在填補這一空白，它通過在 Agent 上下文中註冊委派工具，實現了爲每次調用攜帶獨立模型與推理強度的能力。
插件簡介¶
- 名稱：dsh-subagent-codex-pro
- 定位：DeepSeek Harness 插件，提供 Codex 委派能力
- 核心能力：允許調用者爲每次委派指定
model（模型）和reasoning_effort（推理強度） - 維護者：ckanner
- 許可證：MIT
安裝與啓用¶
作爲 DSH 的一個插件，安裝過程遵循 DSH 的插件管理規範。在桌面 profile 下安裝該插件：
dsh plugin --profile desktop add dsh-subagent-codex-pro
安裝後，插件會自動註冊所需的工具。
功能與用法¶
該插件支持在工具調用中傳遞模型、推理強度、結構化輸出模式以及圖像輸入。
1. 指定模型與推理強度¶
在調用 tools.subagent_codex 時，可以通過 model 和 reasoning_effort 參數覆蓋 Codex 的默認配置。
tools.subagent_codex({
description: "Probe output PROBE_OK",
prompt: "Output exactly one line of text: PROBE_OK",
model: "gpt-6-astra",
reasoning_effort: "xhigh",
})
2. 結構化 JSON 輸出¶
通過 output_schema 參數，可以讓 Codex 返回符合特定 JSON Schema 的結構化數據，便於後續處理。
tools.subagent_codex({
description: "Smoke verdict",
prompt: "Assess whether both endpoints returned 200.",
output_schema: {
type: "object",
properties: {
verdict: { type: "string", enum: ["pass", "fail"] },
count: { type: "number" }
},
required: ["verdict", "count"],
additionalProperties: false,
},
})
3. 視覺輸入¶
插件支持將圖片作爲輸入，images 參數接受一個絕對路徑數組。
tools.subagent_codex({
description: "Match this design",
prompt: "Rebuild this screen's layout in the component below.",
images: ["/tmp/design.png"],
})
注意事項¶
在使用該插件時，需注意以下行爲與限制：
- 衝突避免：插件註冊的 tool 名爲
subagent_codex。由於該名稱與官方全局 Host 工具衝突，絕不能在同一預設中啓用同名的tool-subagent行，否則會引發註冊衝突。 - 配置顯示：如果需要隱藏模型和推理強度字段，需將
modelSelection設置爲false。 - 圖像路徑有效性：傳入的
images路徑必須是絕對路徑且文件必須存在。App-server 會靜默忽略無效的本地圖像路徑，這可能導致任務在視覺輸入上失敗而不會拋出錯誤。 - 默認值策略：當調用中未指定
model和reasoning_effort時，插件不設置默認值，而是依賴 Codex 自身的配置（~/.codex/config.toml）。
技術實現細節¶
該插件通過兩層機制解決官方適配器無法傳遞參數的問題：
- 執行層：實現了官方適配器的協議邏輯（線程啓動、輪次啓動、通知處理），但在
thread/start和turn/start中顯式傳遞了model和reasoning_effort。它使用自定義的 JSON-RPC 傳輸和通過 PATH 啓動的app-server --stdio，而非依賴官方適配器。 - 註冊層：插件在
agent/created事件中，將自己註冊到該 Agent 的本地上下文（agent.ctx.tools）中。這種作用域內的註冊會覆蓋全局的 Host 工具，從而實現了對特定 Agent 的精細控制。
結語¶
dsh-subagent-codex-pro 解決了 DSH 中 Codex 委派無法精細化控制模型與推理強度的問題。通過在 Agent 作用域內註冊工具，它繞開了官方全局工具的限制，並提供了結構化輸出與視覺輸入的支持。代碼開源，基於 MIT 許可證，適合需要在複雜推理任務中動態切換模型策略的開發者使用。
