dsh-evolve 自进化 harness 插件：agent 在 session 内随对话给自己长出/剪掉能力。用户的表述暴露出一个缺口（反复要查的表、天天要算的换算、老要看的端点），agent 现场写一个 cordis 插件挂载给自己——新工具在下一个 step就可调用；不再需要时可逆卸载；重启自动恢复。 进化不限于工具。evolution 是完整的 cordis 插件：常驻 system prompt 规则、agent/step / agent/settled 事件钩子、定时器主动唤醒 agent——改行为、而不只是加能力的进化，同样一次 evolve_add 完成（三条非工具实录）。 依据的机制：dsh 的工具列表每个 step 都从当前挂载的插件实时重算（无 session 级快照），cordis 4 的 fiber 具有可回滚 effect——挂载即生效，dispose 即净。 ## 工具 - evolve_add(name, source, description?, config?) — 把一段纯 ESM cordis 插件源码持久化到 evolve store（~/.dsh/evolve/<name>.mjs + manifest），并热挂载。同名再次调用即替换（旧 fiber 先完整卸载）。 - evolve_remove(name, keepSource?) — 卸载 fiber（它注册的工具/监听/服务全部自动清理）、移出 manifest、删除源码。 - evolve_list() — 每个 evolution 的名称、fiber 状态、版本、用途。 另注册一段 system prompt（order 118）教模型进化姿态：会复用才长、过时就剪、长了剪了要告知用户；并附四条非工具进化的配方（常驻规则 → prompt section、每步自纠 → agent/step 钩子、事后自动化 → agent/settled 监听、主动性 → 定时器 + agent.send 唤醒）。 ## 什么值得进化 不是所有事都配长一个工具——温度换算这种模型口算就对的，进化只是噪音。工具要挣到它的位置，得至少占一条模型裸答做不到的： 1. 跨会话状态 — 随口记的账、喂药时间，下个会话还要接着用； 2. 实时/外部数据 — 天气、汇率、你们的 git 仓库； 3. 精确计算 — 日期边界、分类汇总、利息摊销，模型心算容易出错； 4. 你的私有信息 — 家人的城市、家里的日子、项目的表，长进工具后零参数随口问。 还有第五条，它筛选的不是"值不值得进化"，而是"该进化成什么形态"：工具是 pull——模型得记得去调。凡是"不经过模型决策也必须发生"的需求（每次都要、自动发生、没人问也要来），做成工具就是错的姿态——该长的是 prompt section、事件钩子或定时器，见下面的非工具实录。 ### 生活 | 你的日常表述 | agent 长出的工具 | 凭什么需要工具 | |---|---|---| | 「今天买菜花了 86，以后我随口说你就记着，月底我要问分类统计」 | expense_add / expense_stats：持久账本 | 跨会话状态：下个会话接着记、接着算 | | 「我妈周六去杭州，要带伞吗？我经常帮家里人看天气」 | weather_city：降水概率+带伞建议，「妹妹」自动对应深圳 | 实时数据 + 私有别名 | | 「帮我记下宝宝生日、结婚纪念日、我妈生日」 | family_* 三件套：日子固化在工具里 | 私有信息 + 精确日期计算 | | 「供应商报价 12800 美元折人民币？天天要算」 | convert_currency：实时汇率、双数据源容错 | 实时数据 | | 「房贷 120 万 30 年，提前还 10 万能省多少利息」 | 等额本息摊销表工具 | 精确计算（模型心算容易出错） | ### 工作 | 你的日常表述 | agent 长出的工具 | 凭什么需要工具 | |---|---|---| | 「每周五我都要汇总三个仓库大家这周的提交写周报」 | team_weekly_report：仓库清单长在工具里，按人/按仓库分组 | 私有数据源 + 多步聚合 | | 「E4103 是什么错误来着？」（项目错误码表天天翻） | lookup_error_code：实时解析表文件 | 私有信息 | | 「这批实验数据 A/B 组差异显著吗」（每周都问） | 显著性检验工具（t-test/卡方，出精确 p 值） | 精确计算 | | 「staging 现在什么版本？」（每天问） | 包住团队 health 端点的状态工具 | 实时私有端点 | 以上带工具名的都不是设想——全部有下面的实录。 ## 实证（未剪辑 E2E） 六条真实会话（dsh web + DeepSeek-V4-Flash，RPC 驱动，事件流原样提取）。重点看前两条： ① 家庭记账 — 跨会话状态，模型裸答做不到的事（session 1 · session 2）：session 1 里用户说「帮我记账，买菜 86、加油 400，月底要分类统计」，agent 长出带持久存储的记账工具并入账；session 2 是完全独立的新会话，用户只说「昨天外卖 62 记一下，这个月花了多少」，agent 直接调用上个会话长出的工具——账本延续（¥486 → ¥548，3 笔，分类正确）。 ② 团队周报 — 多仓库聚合 + 模型修自己写的 bug（完整 trajectory）：用户说「每周五要汇总三个仓库的提交写周报，想个办法以后一句话就出」。agent 先手动拉数据核对，再把逻辑固化成 team_weekly_report（仓库清单、周界计算长在工具里）；验证 weekOffset: -1 时自己发现了自己写的日期边界 bug（--since 开区间把本周提交漏进上周报表），同名 evolve_add 替换为 rev 2 修复，三条参数路径回归全过。以后说「出这周周报 / 上周的 / 7月20号那周的」一句话即可。 ③ 帮家里人看天气 — 个人化别名 + 真实气象 API（trajectory）：接 open-meteo 的天气插件（地理编码→逐日降水概率→带伞建议），家人城市做成别名；挂载后「杭州 / 成都 / 妹妹」三查全过，还结合联网搜索发现台风「白海豚」周末过境，给出「周六带结实的伞、能调就避开周日」的活人建议。 ④ 家庭纪念日 — 日子长进工具里（trajectory）：三个日子固化进插件，长出三个工具并逐个验算（宝宝 0 岁 4 个月 19 天、离纪念日 287 天、下一个生日是妈妈还有 88 天）。以后任何会话秒答。 ⑤ 汇率换算 — 真实网络请求 + 挂载失败自修复（trajectory）：双数据源容错；前两次挂载因引号转义、additionalProperties 失败，agent 读错误同名重试修复，成功后当场算出 12800 USD ≈ ¥86,372。 ⑥ 项目错误码查询 — agent 主动提出进化（trajectory）：用户只抱怨「每天都得来查错误码」，agent 答完当次问题后主动长出查表工具并验证。 挂载后的 store（跨会话、跨重启持久）： json { "plugins": { "expense-tracker": { "rev": 1, "description": "个人记账：随口说花钱就记录，自动分类，按月统计。数据持久化在账单文件里" }, "team-weekly-report": { "rev": 2, "description": "每周五周报：汇总三仓库本周/指定周的 git 提交，按仓库和按人分组" }, "weather-check": { "rev": 1, "description": "查任意城市天气…支持家庭成员别名（爸妈→成都、妹妹→深圳）…" }, "family-reminders": { "rev": 1, "description": "家庭重要日期常驻工具：宝宝年龄、结婚纪念日倒计时、下次是谁的生日…" }, "currency-converter": { "rev": 1, "description": "实时汇率换算工具，支持 150+ 币种…" }, "error-code-lookup": { "rev": 1, "description": "实时查询 demo-shop 错误码表…", "config": { "path": "…/docs/error-codes.md" } } } } 另验证过：重启 dsh web 后新 session 直接调用已恢复的工具；用户说「不需要了」时 agent 调 evolve_remove，manifest 清空、源码删除、工具消失。 ## 不止工具：改行为的进化 上面六条长的都是工具。但 evolution 是完整的 cordis 插件，而工具是 pull——模型得记得去调。下面三条实录里用户的需求都带着"每次、自动、主动"，工具形态在这些需求面前必败，agent 长出的插件一个工具都没注册： | 你的日常表述 | agent 长出的注册面 | 为什么工具做不到 | |---|---|---| | 「说了多少遍简短点都没用，想个办法真正管住自己」 | prompt section（常驻规则）+ agent/settled 钩子（量长度）+ 插件唤醒（超限逼重写） | 违规的是模型自己，不能指望违规者记得调工具自纠 | | 「每次帮我干完活，自动往 worklog.md 记一行」 | agent/settled 监听器，普通代码里 appendFileSync | "每次"押在模型自觉上必然漏；监听器跟着 turn 提交的事实走 | | 「每天早上 9 点你主动来找我过安排」 | 定时器 + agent.send(…, { wakeup: true }) 造出新 turn | 清晨没有会话、没有 step——工具连被调用的宿主都不存在 | ⑦ 回复长度自我监督 — 守卫的第一个猎物是它自己的出生通告（完整 trajectory）：用户说「超过 300 字符就该被自动提醒，不靠你记得」。agent 长出 brevity-guard（常驻规则 + 事后测量 + 超限唤醒收敛），挂载成功后的"搞定"通告本身 407 字符——立刻被自己刚长出的插件拦下重写成 78 字符。随后的三次误报成了整条 trajectory 的主菜：agent 自己读 dsh 源码和 session 日志，逐层定位出字数语义（reasoning 思考块被计入）、触发时机（agent/step 在步骤开始前触发、量到旧消息）、投递积压（旧版排队的"幽灵提醒"逐轮延迟送达）三个根因，rev 5 收敛稳定——终验 132 字符一次过，45 秒零幽灵。 ⑧ 干完活自动记工作日志 — 零工具调用的自动化（完整 trajectory）：worklog 插件只有一个 agent/settled 监听器。关键验证在 turn 2：用户问了个 base64 解码，模型纯回答、事件流里没有任何 tool/call，settle 后 worklog.md 里照样多了一行——"记录"这件事从模型的决策空间里被拿走了，一个 token 都不花。第三轮让 agent 念日志，"念日志"这轮自己也被记了进去。 ⑨ 每天早上主动来找我 — 工具在定义上做不到的事（完整 trajectory）：用户要求"你主动发起对话，不是等我来问"，并要求先看 45 秒演示版。agent 长出 morning-reminder-demo（inject: ['agents']，定时器到点对空闲 agent send 唤醒）；45 秒后 turn 2 的 trigger source 是 plugin: morning-reminder-demo——用户全程没发消息，对话是插件造出来的。用户确认后一个 turn 内完成 evolve_add 正式版（自算距下一个 9:00 的毫秒数、fire 后自动重排）+ evolve_remove 演示版（定时器随 fiber dispose 自动清理）。正式版提醒文案还主动引用了此前长出的天气/账本/家庭日期工具——organism 在互相咬合。 一个未剪辑的涟漪：demo 定时器用 ctx.agents.list() 广播，而挂载是进程级的——同进程另一个会话也收到了演示提醒。那个 agent 先怀疑「我没装过定时器插件」，调 evolve_list 查明真相后照做打招呼。广播还是定向是进化代码该考虑的事；但每个 agent 都对突如其来的插件消息做出了正确反应，这本身是鲁棒性的证据。 ## 安装 本插件是标准 Profile Bundle：package.json 的 dsh.bundle 指向 cordis.patch.yml，patch 按包名（而非绝对路径）挂载，dsh 版本升级后挂载不再失效。构建后从 checkout 安装进 profile： sh scripts/build.sh # 见下 dsh plugin --profile web add . # 追加为该 profile 的 bundle 层 卸载：dsh plugin --profile web remove @dsh-external/dsh-evolve。另一条互斥通道是 plugin-registry（dsh registry，读 dsh.plugin.json 增量清单）——同一部署二选一，不要双挂载。 构建：scripts/build.sh（需要 dsh 在 PATH，或设 DSH_CHECKOUT 指向 checkout 根；用 checkout 的 tsc 对 symlink 的 checkout 包编译）。测试：$CHECKOUT/node_modules/.bin/vitest run。 evolve store 的 node_modules 会自动 symlink 到本插件的 node_modules（后者已链入 dsh checkout），因此进化源码里可以直接 import { defineTool } from '@deepseek-ai/dsh-tools'，Node 内置模块也完全可用。 ## 配置 | 键 | 默认 | 说明 | |---|---|---| | dir | ~/.dsh/evolve | store 目录 | | autoRestore | true | 启动时重挂 manifest 里的全部 evolution | ## 设计要点 - 同名重试必须能加载新源码：挂载失败不写 manifest、rev 不前进，若用 rev 做 import() 的 cache-bust，重试会命中 Node 模块缓存加载旧的坏源码（这个 bug 正是在 E2E 里被 agent 自己诊断出来的）。现用进程内单调 seq 作为 cache-buster，与持久 rev 解耦。 - 中途改工具集会使该 session 的 prompt cache 前缀失效，一次性成本，正确性不受影响。 - 信任立场：evolution 是真实模块加载、无沙箱（与主 harness 同权限），面向可信的自用环境；需要人工把关的部署可在此基础上加确认模式（roadmap）。