前言¶
DeepSeek Harness (DSH) 的核心理念是插件化。在构建复杂的智能体系统时，开发者常面临的问题是如何在受控环境下验证不同的 Agent Preset 组合。dsh-agent-evolution 是一个公共的 DeepSeek Harness bundle，专门用于这类实验。
它提供了一套运行时工具，用于从显式配置的 DSH Presets 中组装全新的 Agent，并执行任务以收集证据，供后续评估使用。该 bundle 提供的是实验的原语，而非自动进化的闭环。
插件概览¶
该插件由 FriendsHL 维护，采用 MIT 许可证。它是一个 DSH Bundle，核心包含一个运行时插件 agent-experiment-runner。
DSH 目前处于开发者预览阶段，因此使用此插件时需要锁定特定的 commit 以保证稳定性。
核心功能¶
插件提供以下三个核心工具，用于控制实验流程：
agent_experiment_list_presets：列出当前部署授权的 presets。agent_experiment_run：使用单个 preset 运行单个任务。agent_experiment_compare：顺序运行基线 preset 和候选 preset，返回两条记录而不自动选择优胜者。
实验运行工具支持配置以下限制：
* 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 组合。
插件主页：https://www.skillhub.cn/plugins/FriendsHL/dsh-agent-evolution
代码仓库：https://github.com/FriendsHL/dsh-agent-evolution
