distill ## 安装（DSH profile bundle） sh # 从本仓库 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 查看器，最终答案通过结构化输出契约捕获。派发前会发出非持久化的 Cordis 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 目录中。反省派发通过仅运行期的 distill/review-request 通知暴露给观察者，不写入会话日志，也不进入对话循环；需要跨进程审计的部署应由监听方自行持久化该通知。 ## 已知限制与后续工作 - 仅整文件更新 — update 会重写整个 SKILL.md；不支持局部补丁或支持文件（references/ / templates/ / scripts/）写入。提示词把支持文件意图并入正文或跳过。 - 所有权标记按来源选择 — 本变更之前蒸馏出的技能没有 distilled-by 标记，会被当作用户所有（永不更新），除非用户重新创建或手动标记。 - 检查点仅限当前进程 — 检查点保存在内存中；恢复或 fork 的会话从 Session.firstLiveSeq 开始，只处理本进程新增的消息。上一个进程中尚未达到阈值的消息不会结转。 - 既有受损日志需单独修复 — 本版本不再写入 session/distill-review-request，但已经含有该未知事件的日志仍需为事件信封补上 ignorable: true 或使用宿主提供的修复工具后才能重新加载。 - 项目目标需要 git 根 — 没有 .git 祖先时，项目目标回退到会话 cwd。 - 每个会话一次进行中的反省 — 反省进行期间到达的已结束回合会被跳过；下一次结算会重新评估。 - 反省子代理依赖部署的工具 — 子代理的 skill 工具和目录来自同一部署中的 tool-skill；没有它的部署仍会运行反省，但子代理在提议前无法查看技能。