前言¶

DeepSeek Harness (DSH) 的核心理念是插件化。在構建複雜的智能體系統時，開發者常面臨的問題是如何在受控環境下驗證不同的 Agent Preset 組合。dsh-agent-evolution 是一個公共的 DeepSeek Harness bundle，專門用於這類實驗。

它提供了一套運行時工具，用於從顯式配置的 DSH Presets 中組裝全新的 Agent，並執行任務以收集證據，供後續評估使用。該 bundle 提供的是實驗的原語，而非自動進化的閉環。

插件概覽¶

該插件由 FriendsHL 維護，採用 MIT 許可證。它是一個 DSH Bundle，核心包含一個運行時插件 agent-experiment-runner。

DSH 目前處於開發者預覽階段，因此使用此插件時需要鎖定特定的 commit 以保證穩定性。

插件提供以下三個核心工具，用於控制實驗流程：

實驗運行工具支持配置以下限制：
* maxDepth：限制子 Agent 的層級深度，默認爲 3。
* maxTokens：可選的輸出 token 限制，默認繼承父級。

此外，插件支持 allowedPresets 白名單機制。如果不配置，默認只允許來自 roots 中配置了 trust: system 的 presets。配置白名單後，插件會在加載時解析所有指定的 preset ID，並在執行前再次解析以確保有效性。

安裝該插件需要使用 --profile web 參數。由於處於開發者預覽階段，建議從 GitHub 指定 commit 安裝。

從 GitHub 安裝：

dsh plugin --profile web add github:FriendsHL/dsh-agent-evolution#<commit>

本地開發安裝：

dsh plugin --profile web add link:/absolute/path/to/dsh-agent-evolution

安裝或修改配置後，需要重啓正在運行的 DSH 進程，讓 Loader 重新組裝 profile。

配置項說明：

配置項	默認值	作用
`maxDepth`	3	實驗子 Agent 的絕對委託深度限制。
`maxTokens`	inherited	當工具調用未覆蓋時，可選的正數輸出 token 限制。
`allowedPresets`	system-trust roster	非空的 preset ID 白名單。不配置時僅允許 `trust: system` 的 roots。
`listToolName`	agent_experiment_list_presets	模型可見的發現工具名稱。
`runToolName`	agent_experiment_run	模型可見的單次運行工具名稱。
`compareToolName`	agent_experiment_compare	模型可見的對比工具名稱。

在實驗行爲和系統交互上，該插件有以下特性：

不自動評分與選擇：插件本身不負責評分輸出、選擇優勝者、編輯 presets 或插件，也不自動發佈變更。評估、失敗歸因、候選編寫、晉升或回滾是獨立的、延後的能力。
日誌權威性：DSH 的 Session 日誌是權威記錄。該 bundle 不會創建第二份 transcript 或評估存儲。調用者應檢查返回的持久化 session 來獲取完整的 prompt、工具調用、結果和輸出。
SubAgent 可見性：實驗產生的子 Agent 是普通的有血緣關係的 Agent，其 session 頭部記錄了 parentSession、delegationDepth 和 agentPreset，但不會出現在 SubAgent catalog、continuation 或 control APIs 中。
依賴要求：該插件依賴多個 DeepSeek Harness 包作爲 peer dependencies，安裝時需確保這些依賴滿足版本要求。

此插件適合需要手動驗證 Agent 組合策略的開發者和運維人員。當你需要對比不同的 Prompt 組合、模型配置或工具調用鏈路時，可以使用 agent_experiment_run 或 agent_experiment_compare 工具進行受控測試。

dsh-agent-evolution 爲 DeepSeek Harness 生態提供了一個標準化的實驗框架。它通過嚴格的配置和明確的運行時工具，讓開發者能夠安全地測試 Agent 組合。