# 从本仓库 checkout 安装到 profile（web / headless 等），bundle 声明自动加入组合层
dsh plugin --profile web add <目录|git-url>
# 验证
dsh --profile web --dump-config | grep distill- 插入行 id：
distill（cordis.patch.yml）；不注册任何面向模型的工具或技能——它只挂接agent/turn-stopping并运行后台反省。 - 宿主前提：dsh 组合必须挂载
subagent-spawn-in-process（注册反省子代理使用的spawn子代理提供方）与tool-skill（子代理可调用的skill查看器）——两者在 base bundle 中默认存在。 - 卸载：
dsh plugin --profile web remove distill。 - 安装后需重启目标 profile 的 DSH 进程（组合层变更不参与 HMR 热更新）。
自动对话反思与技能蒸馏。
需要 ctx.subagents（inject: ['subagents']）以及已注册的子代理提供方——subagent-spawn-in-process 插件注册了默认的 spawn 提供方——并且部署中包含面向模型的 skill 工具（tool-skill），反省子代理才能查看技能。反省提示词改编自 Nous Research 的 hermes-agent _SKILL_REVIEW_PROMPT（MIT 许可，Copyright (c) 2025 Nous Research），针对本界面做了改写；完整署名见源文件头。
每个回合完成（agent/turn-stopping 触发）时，插件会收集自上次蒸馏检查点以来新增的人类 user/message 事件；数量达到 minUserMessages 后，派发一个后台反省子代理（Hermes Agent 后台反省的形态：受限工具集的全新子代理，在回合之后运行，从不与用户任务争抢）。子代理的提示词携带 Hermes 策展课程、消息窗口帧和可更新技能列表；其工具集白名单只保留 skill 查看器，最终答案通过结构化输出契约捕获。该派发会以仅日志的 session/distill-review-request 事件记录精确的路由、提示词、工具白名单和 token 上限，使模型可见输入可从会话日志中重建。
反省子代理提议以下之一：
{"action": "skip"}— 无值得保存的内容；本轮结束。{"action": "create", "skill": {"name", "description", "whenToUse?", "content"}}— 一个新技能，写成带 frontmatter 的SKILL.md包，本地技能提供方会像发现手写技能一样发现它。{"action": "update", "skill": {...}}— 对某个先前蒸馏出的技能的完整替换。
每个提议都会经过校验（通过 isSkillName 校验 kebab-case 名称，描述和内容非空）。目标文件已存在时 create 被跳过。只有目标文件存在且带有插件 distilled-by: dsh-distill frontmatter 所有权标记时 update 才会被应用；缺失或非蒸馏所有的目标会跳过并记录警告，因此用户手写、内置和运行时注册的技能永远不会被重写。蒸馏出的文件都带该标记，且只有带标记的技能会出现在子代理的可更新列表中。无论结果如何，检查点都会推进到最后一条已反思消息，因此每轮只覆盖新消息。
反思目标优先使用显式配置的 provider/model 对（两者需同时配置），否则使用已结束 agent 自身的 agent.options 路由。两者都不存在时本轮跳过并记录警告。子代理运行在 providerName 指定的子代理提供方上；提供方缺失、或运行失败、被取消、无捕获结果时只记录警告，绝不会使循环崩溃。
| 字段 | 默认值 | 含义 |
|---|---|---|
enabled |
true |
总开关。 |
minUserMessages |
3 |
触发一次反省所需的新增人类用户消息数。 |
provider / model |
未设置 | 显式辅助路由；必须同时提供。默认使用 agent 自身路由。 |
maxTokens |
2048 |
反省子代理输出 token 上限。 |
timeoutMs |
30000 |
反省的端到端截止时间。 |
targetRoot |
project |
project 写入 <git-root>/.agents/skills；user 写入 ~/.agents/skills。 |
providerName |
spawn |
反省子代理使用的子代理提供方注册名。 |
allowUpdate |
true |
是否允许反省更新先前蒸馏出的技能；false 时只提供 create。 |
主对话不注册任何工具或提示，插件从不改变其表面。唯一的模型可见效果是间接的：后台运行一个带 skill 工具的反省子代理（它看到与主 agent 相同的目录，可在提议前查看任意技能内容），写入或更新的技能会在后续轮次出现在 dsh-tool-skill 目录中。反省派发本身是记录在日志中的辅助委派，对话循环不可见。
- 仅整文件更新 — update 会重写整个
SKILL.md；不支持局部补丁或支持文件（references//templates//scripts/）写入。提示词把支持文件意图并入正文或跳过。 - 所有权标记按来源选择 — 本变更之前蒸馏出的技能没有
distilled-by标记，会被当作用户所有（永不更新），除非用户重新创建或手动标记。 - 内存检查点推导 — 检查点从最近一条已记录的
session/distill-review-request推导；从未反省过的会话从第一条用户消息开始。 - 项目目标需要 git 根 — 没有
.git祖先时，项目目标回退到会话 cwd。 - 每个会话一次进行中的反省 — 反省进行期间到达的已结束回合会被跳过；下一次结算会重新评估。
- 反省子代理依赖部署的工具 — 子代理的
skill工具和目录来自同一部署中的tool-skill；没有它的部署仍会运行反省，但子代理在提议前无法查看技能。