在 DeepSeek Harness 的开发流程中，Agent 经常会在某些任务上陷入重复失败，或者我们需要从成功的 Session 中提取经验来指导后续工作。现有的流程往往缺乏对执行轨迹的本地沉淀与检索能力。dsh-evolve 是一个运行在同一进程内的插件，它旨在解决这些问题。
核心功能¶
dsh-evolve 通过确定性信号识别重复错误、重复工具调用和无进展轨迹。它主要提供以下能力：
- 记录与沉淀：记录重复失败、用户纠正与成功路径。
- 本地提炼：在 Session 结束后提炼本地 Experience，为后续相似任务提供有界、临时的经验摘要。
- 后台挖掘：可选地运行经验侧车在后台挖掘 correction、successful-procedure 与 failure-pattern。
- 检索过滤：经验检索按相关性、置信度和兼容性过滤，最多返回 3 条。
安装与启用¶
确保环境满足先决条件：Node.js >= 22.19 和 pnpm 10。
先在 dsh-evolve 根目录完成构建，然后把本地 checkout 加入目标 profile：
dsh plugin --profile <profile-name> add .
卸载时执行：
dsh plugin --profile <profile-name> remove dsh-evolve
配置¶
默认 bundle 使用 reset-v1：检测到明确的卡住轨迹时，最多按 recipe 的冷却与总量限制注入通用策略重置。若只想观察，不注入，请在 profile 的后续 Cordis patch 中覆盖为：
- id: dsh-evolve
config:
recipe: baseline
Experience 挖掘侧车只有在显式提供 evolution 配置时才启用。下面是最小的本地经验配置：
- id: dsh-evolve
config:
evolution:
enabled: true
mining: true
routing: true
skillInjection: false
commons:
enabled: false
常用开关说明：
| 配置 | 默认值 | 作用 |
|---|---|---|
recipe |
reset-v1 |
baseline 只记录；reset-v1 可注入策略重置。 |
evolution.enabled |
true |
启用或关闭经验侧车。 |
evolution.mining |
true |
在 Session 结束后挖掘本地 Experience。 |
evolution.routing |
true |
记录已激活 Skill 的任务匹配结果。 |
evolution.skillInjection |
false |
仅在已激活 Skill 场景下允许注入其说明。 |
evolution.commons.enabled |
false |
启用 Commons 缓存同步；不会自动信任或激活远端内容。 |
日常使用与诊断¶
插件装载后无需每个任务手动操作。它在 Session 结束后将数据写到 DSH evolve 根目录（默认由 DSH_HOME/用户目录解析；也可通过 storageRoot 覆盖）。可用 CLI 检查本地状态：
dsh-evolve status
dsh-evolve experience list
dsh-evolve mutations list
dsh-evolve audit --all
dsh-evolve benchmark
适用场景与注意¶
- 运行环境：插件与 DSH 运行在同一进程内，不是安全沙箱，请只安装可信插件。
- 权限边界：它不会自动读取凭据、关闭 Sandbox、绕过 Approval、安装第三方插件、执行社区代码或上传原始 Session。
- 数据安全：普通 Experience 默认只保存、检索和临时提供；只有显式 Skill 蒸馏和用户确认才能产生或激活 Skill。任务结束后不保留为常驻上下文。原始 Session、Prompt、工具输出和本地数据不会自动上传。
总结¶
dsh-evolve 是一个专注于本地执行经验沉淀与检索的 DSH 插件。它通过确定性信号识别问题，并在 Session 结束后提供有界、临时的经验摘要，帮助开发者优化 Agent 的执行策略。
本插件遵循 MIT 许可证。源码位于 GitHub。相关详情可参考 SkillHub 插件目录。
