前言¶
在 DeepSeek Harness (DSH) 中，使用 Agent 預設（如 router-spec 或 standard）通常需要手動打開 Web 界面，新建會話，選擇預設，然後輸入任務。這種流程在自動化腳本或批量處理場景下效率較低。我們需要一種編程方式來復用這些預設能力。
插件介紹¶
yigesama/dsh-preset-run 是 DeepSeek Harness 的一個插件。它將“Web 會話 + Agent 預設”封裝成可編程接口。通過註冊一個 host-plane 工具 preset_run，可以在任意會話中啓動一個全新的獨立子會話，執行任務並返回最終回答文本。這等價於無頭模擬 Web UI 的“新建會話 → 選預設 → 發消息”流程。
安裝¶
插件必須通過 dsh plugin add 裝進 profile。安裝後需重啓 web 進程使工具生效。
dsh plugin --profile web add "github:YiGeSama/dsh-preset-run"
環境要求：
* DeepSeek Harness >= 0.1.0-rc.6
* Node.js >= 18（建議 20+）
* 已配置可用的模型服務（settings.yaml 的 agent-default-model）
* 目標預設已存在於部署的 roster 中（如 router-spec、minimal）
Windows 注意：若使用本地路徑安裝且包含空格，dsh plugin 可能報錯。建議使用 GitHub 安裝或克隆到無空格路徑。
使用¶
在會話中直接調用 preset_run 工具。它接受預設 ID 和任務文本作爲參數。
// 示例 1：調用路由預設
preset_run("router-spec", "請調用 dev_router_status 工具並輸出結果")
// 示例 2：調用極簡預設
preset_run("minimal", "1+1=?")
// 示例 3：調用標準預設
preset_run("standard", "把 README.md 裏的 TODO 列表整理成表格")
參數：
* preset：Agent 預設 ID。支持 dsh 官方默認預設（standard、code、minimal、cordis）以及第三方路由預設（router-spec、router-standard）。
* timeoutMs：可選參數，控制單次子會話運行的最長耗時（默認 600000ms）。
注意事項¶
權限與安全：
* preset_run 讓任何能調用它的會話都能開啓子會話，能力較強。多用戶或不可信環境部署時，需確認只有受信調用方能觸達。
* 子會話沿用部署的默認權限預設。在默認 workspace-write + ask 環境下，子 agent 若需提權會進入審批流程。需要無人工介入時，請把權限預設配成 danger-full-access。
* 子會話是一次性的，返回文本後即銷燬，不留歷史。
router-spec 限制：
* router-spec 預設設計爲首輪只暴露核心工具（read、edit、glob、grep + shell），首次工具調用後纔開放完整目錄。
* 若在 router-spec 子會話中調用 dev_router_status，需先執行一次 shell 命令（如 pwd）來觸發目錄開放。
總結¶
dsh-preset-run 提供了在 DSH 中以編程方式複用 Agent 預設的能力，適合需要自動化調用特定 Agent 行爲的場景。
