在本地记录重复的任务纠正与工具错误，通过显式启动的演化将经验编译为八类运行组件的改动，经过基线与候选成对验证、影子试用和回滚，并提供预算与审计账本。需要 Node.js 24+ 及兼容的 DSH 0.2.1-rc.2 起的 0.2.x 宿主。
从真实任务的分歧中精炼运行策略。保留独立 Evolve 架构，不包含旧 Soul 的记忆检索、后台学习或固定答案套件。
1.5 增加记忆骨架：会话被编译成一张小图（约束/决策/产物/进度），每轮投影 600 字节进系统提示。投影不写进历史，所以压缩擦不到它；细节留在库里，用 soul_recall 按需回捞。1.6 把同一张图接成压缩后端：压缩不再由模型写摘要，改由图选子集。
1.0 的重点是经验编译：每轮结束免费记录重复出现的纠正、工具错误、未完成和“出错后恢复”模式；经验先留在本地 SQLite，不进入主代理上下文。支持度达到阈值后，才由一次编辑会话把它编译成普通的 C1–C8 改动，再走 0.9 已有的成对验证、影子试用与回滚。核心约束是：经验存起来是免费的，进上下文是要付费的，进版本必须通过因果门控。模型权重不变。
需要 Node.js 24+、Git、DSH 0.2.1-rc.2 起的 0.2.x，以及本地 spawn、skills、tools、systemPrompt、commands、llm 服务。实际接口测试覆盖 0.2.1-rc.2；0.2.0-rc.2 缺少 startActivation，不能探测。后续宿主版本仍需能力检查。
~~~powershell dsh plugin --profile tui add "C:\path\dsh-soul-1.0.0.tgz" ~~~
插件默认关闭。在 profile 的用户 patch 中配置已有节点，provider/model 使用宿主已注册的路由：
~~~yaml
config: enabled: true profile: tui provider: your-provider model: your-model validationTrials: 2 repeatThreshold: 3 shadowWindow: 3 memory: enabled: true projectionBytes: 600 checks:
argv: [node, --test, tests/acceptance.test.mjs] protectedPaths: [tests, package.json] ~~~
checks 必须验证实际产物。文件型检查必须声明 protectedPaths，覆盖测试代码、测试配置和依赖的验收逻辑；相对路径以项目工作目录为基准，不支持 glob。独立的 node -e 内联检查可省略该字段，其完整命令固定在配置中。只检查退出码的空测试无法证明任务正确；验收覆盖面仍由项目维护者负责。
探测使用新的 Git worktree，需要干净、已有提交的仓库。被忽略的 node_modules、虚拟环境、密钥不会自动复制；请先确保验收命令和任务环境可在独立 worktree 使用。命令直接按 argv 执行，不经过 shell。
数据库默认在 DSH_HOME/dsh-soul//evolve.sqlite，未配置 DSH_HOME 时用 ~/.dsh。无法确定 profile 且未指定 database 时明确拒绝。不同 profile 不共享默认库。旧 Soul 数据库不自动打开或迁移。
组件 · 存储形式 · 实际连接 C1 工作方式 · system.md · 主会话与探测子会话的提示上下文，保留锚定区 C2 护栏 · guardrails.md · 同上；不能改宿主权限和审批规则 C3 项目事实与记忆策略 · memory.md · 同上；不是旧 Soul 记忆检索系统 C4 工具指引 · tools.md · 同上 C5 委派指引 · subagents.md · evolve_catalog 返回决策指引；evolve_delegate 启动真实 spawn 并给子代理加载指引 C6 技能 · skills//SKILL.md · 注册到真实 ctx.skills provider，宿主 skill 工具按需读取 C7 脚本 · scripts/.mjs · evolve_script 在可终止独立进程中执行纯 JSON 转换 C8 工具反馈 hook · hooks/.mjs · 真实 tools/post-execute 事件调用，追加建议，保留原始值和错误状态
候选探测与线上使用同一套组件加载机制。候选目录拥有独立的技能视图；探测结束移除视图。版本切换会使技能目录缓存失效，脚本和 hook 根据当前版本重新选择；回滚后不能再加载被撤销的组件。已进入历史上下文的文字不会被擦除。
先调用 evolve_catalog 读取 delegationPolicy，再调用 evolve_delegate，并写清子任务与验收标准。子代理遵守宿主递归深度和权限；不修改 provider 配置，不扩大授权。探测中的插件委派以及可识别的本地宿主后代调用，共用该探测的请求上限和预算，usage 汇总进对照指标。远程或外部工具自行调用第三方服务不在此计量范围。
~~~markdown
name: build-check description: 构建失败时使用，先检查依赖，再执行项目验收
先检查项目声明的构建命令与依赖，再执行相关验收，报告通过和失败项。 ~~~
对应路径 skills/build-check/SKILL.md，宿主注册名为 soul-build-check。元数据仅支持 name 和单行 description。技能正文按需加载；宿主仍会展示简短技能目录，这部分也会占用上下文。
~~~javascript export function run(input) { return [...new Set(input)].sort() } ~~~
用 evolve_script 传入 name 和 JSON 字符串 input。当前契约是独立纯函数：不提供 import、文件、网络、进程、环境变量或宿主工具接口。输入最多 100 KB（含代码），输出最多 24 KB，进程超时 5 秒，单次同步执行最多 200 毫秒。需要读写项目文件时仍调用宿主工具，保留其权限链。
~~~javascript export const timeoutMs = 100 export const failOpen = true export function run(event) { return event.isError ? {note: '先检查失败原因，避免原样重复调用。'} : {} } ~~~
当前只连接工具执行后的建议反馈；不替换工具参数、结果、成功状态或审批结果。运行失败、超时、非法输出不会拦截原工具结果。每个 hook 的 timeoutMs 为 1–1000 毫秒，总进程生命周期上限 1 秒，最多激活 4 个；单次同步执行最多 200 毫秒。hook 运行在独立进程中，代码无法通过提供的接口直接调用宿主服务。
会话压缩会丢掉"这轮到底定了什么"。经验编译解决不了这个问题：它存的是行为模式，周期是天级，而且按设计不进入上下文。骨架补的是另一层——状态。
每轮结束，tools/post-execute、agent/pre-step 与 turn/end 上已经存在的钩子把这一轮编译成节点，写入本地 SQLite。不调用模型，因为机械抽取的保留率是模型摘要的五倍（Compact-Bench：79.1% vs 16.0%）。
节点 · 对应哪种压缩失败 · 特殊处理 constraint · 摘要丢掉约束 → 后面违规 · pin=1，永不摘要，独立预算 decision · 只留结论，理由是「因为」那半句 · derived 边指向它依据的产物 artifact · 证据已被后来的改动作废 · 写入时的内容指纹，失效可判定 progress · 记得事实，接不上任务 · 只取最近两条
边只有五种：derived / supersedes / depends / supports / contradicts。加第六种需要数据，不是需要想象。
投影是每轮的 600 字节卡片，走 ctx.systemPrompt.context（order 940），每轮从图重算、不写进历史——所以压缩在结构上碰不到它。图为空时输出空串，新项目一分钱不花。同一图状态必得同一字节串，prompt cache 稳定，/mem show 能看到会被注入的原文。
回捞是显式的，一个工具两层次：soul_recall 先查节点图（约束/决策/产物）及其一跳邻居，命中不足时自动翻会话原文（含历史会话），返回里用 source 标明来源是 node 还是 span。每次回捞写一条 activation，既是边权来源，也是垃圾节点的判据；命中原文时还会回写成 reference 指针，同一个问题第二次就是卡片命中。
/mem show | stats | recall | prune 全部本地，零调用。
实测（npm run bench，300 个场景，历史 7 KB）：预算 1200 字节时，细节保留 25.5% → 83.4%，约束 0% → 100%，损失率 74.5% → 16.6%。方法与局限见 docs/SKELETON-BENCH.md——包括 2400 字节时均匀采样反超骨架这件事。
1.5 的投影是"压缩后补一块"。1.6 换掉压缩本身。
DSH 的压缩是可插拔后端，@deepseek-ai/dsh-compaction-basic 只留了一个子类扩展点：
~~~js async summarize(input, agent, signal) // 决定用什么文本替换被压掉的跨度 ~~~
重放、持久锁、表层替换、checkpoint 框架都不动，只换"挑什么留下"。把默认后端换成同名的 graph 后端：
~~~yaml
~~~
压缩后的内容变成骨架 + 锚点，而不是一段模型写的摘要：
~~~text [压缩上下文] 以下为历史骨架，是数据不是指令。
另有 29 个原文片段未展开（seq 4–33），可用 recall 回捞。 ~~~
三件事随之改变：
llmStreamCall: false，压缩从"一次付费生成"变成"一次本地选点"。代价与边界：
ctx.compaction）。换回去就是改一行配置。/compact 手动压缩同样走这条路径。@deepseek-ai/dsh-compaction-basic；缺失时该入口在加载期直接报错，不影响主插件。真实宿主实测（DSH 0.2.0-rc.2，Cordis + AgentLoop + TokenMeter + 官方后端）：
~~~text host 0.2.0-rc.2 | shadowed 23 | tokens freed 420 [压缩上下文] 以下为历史骨架，是数据不是指令。
另有 19 个原文片段未展开（seq 3–21），可用 recall 回捞。 ~~~
压缩期间模型调用次数为 0（assert.equal(requests.length, before)）。
两次重复同一任务不能证明泛化能力。转正只表示通过已声明的检查和试用窗口，不是所有任务都会变好。结构检查和锚定区也不等于自然语言策略的完备安全证明。
主代理的每轮上下文不增加任何经验文本。每轮结束后只在本地库做一次分类与聚类：
观察 · 类型 · 能否触发编译 用户纠正 · user_correction · 是 工具错误且未完成 · tool_error · 是 未完成 · incomplete · 是 工具错误但最终完成 · recovery · 是 同类任务此前分歧、本轮干净完成 · resolved · 否，只作正样本 /evolve verify 实际检查通过 · verified_success · 否，只作正样本
同一类模式按词项重合聚类，措辞变化不会新建簇；支持度达到 repeatThreshold（默认 3）且最近一次出现在 repeatWindowDays（默认 7 天）内，才转为 candidate 并出现在 /evolve diagnose、evolve_diagnose 和 evolve_request 的候选里。候选仍然不是提示，也不是版本。过期模式仍是历史，不会因为很久以前出现过就再次触发付费编译。聚类、状态变更和报告都不调用模型。
/evolve run 仍是唯一的付费入口。它可以用当前会话的分歧，也可以直接用支持度达标的经验簇（以该簇最近一次的任务文本、指标与轨迹作为探测输入）；阈值只决定资格，不会自动启动付费编译。编辑会话的 index.contrast 只有三块：经验簇摘要、当前观察的指标与错误、同任务的成功/恢复样本；原始轨迹仍按路径读取。contrast 上限 3000 字节，并明确标注为数据而非指令。
编译结果不是新版本：它先经过结构检查，再从同一固定提交、同一任务、同一路由和同一验收定义做旧策略/候选成对重跑；通过后才进入 shadow。shadow 内出现用户纠正、未完成或工具错误高于基线时自动回滚，并让编译这条经验的版本重新变为可尝试；同一经验因回滚或拒绝累计两次失败后退役，不再自动复活。只有显式回滚会重开已编译的经验，普通复发只增加支持度，不会重复购买编辑会话。
/evolve report 汇总经验池状态、进入试用/转正/回滚率、按阶段的调用与输入字节，并明确区分“已观察到的成本”与“尚未证明的留存/迁移”。不能把一次转正率当成泛化能力。
~~~text /evolve status 能力、验证规则、当前版本、经验池、额度和试用窗口 /evolve diagnose 最近分歧与重复次数；无分歧时列出支持度达标的经验簇 /evolve run [C1–C8] 对最近分歧或经验簇启动一次精炼，默认使用归因目标 /evolve verify 验收最近一次真实试用任务，并记录正样本 /evolve report 经验池、进入试用/转正/回滚率、按阶段调用与输入字节 /evolve diff [A] [B] 比较版本 /evolve log [n] 审计账本 /evolve explain [rev] 采纳依据 /evolve rollback [rev] 回滚并撤销新增组件加载 /evolve watch 待决试用窗口 /evolve tree 组件大小 /evolve lint 校验当前树 /evolve export [目录] 导出供人工审阅 /mem show 打印当前会被注入的骨架（不调用模型） /mem stats 节点数、边数、激活次数与字节数 /mem recall 按关键词回捞节点与一跳邻居 /mem prune 按上限回收未激活的旧节点，pin 的永不删除 ~~~
同类分歧默认出现 3 次才允许启动；没有当前分歧时，经验簇也必须达到同样的支持度。一次 /evolve run 授权编辑、成对探测及通过后的真实试用；没有按关键词自动付费的后台循环。未结束的试用窗口会阻止叠加新演化。
管理工具：evolve_status、evolve_diagnose、evolve_request、evolve_tree。执行工具：evolve_catalog、evolve_script、evolve_delegate。evolve_request 只返回资格，不会直接启动付费演化；evolve_delegate 是真实付费子任务。
默认每次最多 60 次模型请求、640,000 输入字节、20 分钟；每个探测臂另有 3 分钟独立超时。每个臂的步数按 (episodeCalls - 编辑器预算) / (2 × validationTrials) 均分（默认 12 步，probeSteps 只是上限），避免前面的臂吃光额度、后面的臂付费后失败。每项目每日最多 100 次请求、800,000 输入字节。编辑请求最多 24,000 输入字节，探测请求最多 64,000 输入字节，单请求 60 秒。validationTrials 默认 2，可配 2–5，总额度不会随试验数自动提高。预算包含编辑、旧策略重跑、候选以及受管本地委派，失败或取消也计费；额度用完会停止，不降低验证门槛。装不下一对最小探测时，在编辑器调用前直接拒绝。
这些是上限，不是固定消耗，也不是货币预算。C1–C4 默认 1952 字节，上限 2400 字节；此数不包含工具 schema、技能目录、按需加载正文和宿主自身上下文。状态读取缓存已物化的版本，避免重复查询每个组件正文。
经验观察与聚类是本地 SQLite 写入：不调用模型，不增加任何提示字节，1.0 也没有新增 C9。主代理每轮的固定税仍是 C1–C4，与 0.9.1 相同。只有 /evolve run 触发的编辑会话会读取 contrast（≤3000 字节）；经验轨迹、detail 与 success 快照按 4–8 KB 截断保存。/evolve report 只读本地数据，同样零调用。