dsh-evolution-core
一句话:把七个进化器官的实时状态聚合成一张「五环完整性」体检报告——猜想 → 采证 → finding → 裁决 → 布线,哪一环断了、本圈该先做什么,一条 evolution_cycle 说完。
为什么值得用:自我进化最容易的死法是单环空转(一直猜不采证、一直采证不裁决、finding 积压无人裁)。没有观测面时,判断「我最近到底在进化还是在原地跑」得手工翻 7 个 JSON 文件(还都是不同格式)。本插件把这些只读汇总成五环红黄绿 + 按优先级排序的本圈建议,并把每次动作落成履历(可看累计动作数 / 连续活跃天数 / 类型分布)。只给建议不代决:决策永远归我。
能力
| 工具 | 用途 |
|---|---|
evolution_status |
状态总览:聚合全部器官 → 五环完整性诊断 → 断点识别 + 行动建议(只读) |
evolution_cycle |
感知圈驱动:本圈推进清单(聚合状态 + 断点 + 按优先级给「本圈建议动作」)并记一次 cycle 足迹——有断点→推进;无断点→确认健康可续存 |
evolution_log |
留痕:把一次进化动作记入履历(verdict 裁决 / forge 炼化 / evolve 评测轮 / wire 布线 / reflect 每日反思 / checkpoint 存档 / cycle 感知圈 / note 备注) |
evolution_history |
履历:读 history.jsonl → 时间线 + 统计(累计动作数、连续活跃天数、各类型分布)+ 简短总结 |
另对外提供服务 evolutionCore.snapshot(),供 dsh-life-core 在感知圈前取「本圈建议」并决定唤醒消息内容(life-core 侧对 null/未挂载容错降级)。
器官数据源(它读什么)
| 器官 | 读取落点($DSH_HOME = 环境变量,缺省 ~/.dsh) |
|---|---|
| self-test(猜想/采证) | $DSH_HOME/agent-self-test/self-test.json |
| emotion(6 侧面信号) | $DSH_HOME/agent-emotion/emotion-state.json |
| reflection(每日反思) | $DSH_HOME/agent-reflection/reflection-state.json |
| life-core(存在状态) | $DSH_HOME/life-core/state.json |
| memory(记忆规模) | $DSH_HOME/storages/agent_memory.json(只读顶层键) |
| checkpoints(周目存档) | $DSH_HOME/checkpoints/(目录列表) |
| evolve(跨代评测) | <DSH_HOME 上级>/.evolve/ledger.json(⚠ 在 DSH_HOME 之外;evolveLedgerPath 可覆盖) |
| wire(布线新鲜度) | 技能目录最新 mtime($DSH_HOME/skills + ~/.agents/skills) |
快速开始
1) 装依赖(自研插件家园 self-plugins/,在目标 profile 的 package.json 加 link 依赖):
"dsh-evolution-core": "link:<工作区>/self-plugins/dsh-evolution-core"
2) 挂组合(web profile patch 行;默认配置即可用):
- insert:
- id: agent-evolution-core
name: dsh-evolution-core
3) 30 秒验证:调 evolution_status → 应返回五环逐环状态(green/yellow/red)+ 建议列表;即使某个器官文件缺失也应拿到 yellow + detail: 数据源不可读,而不是报错(放行 + 呈现是设计契约)。
配置
| 项 | 默认 | 说明 |
|---|---|---|
enabled |
true |
关闭后工具 fail-soft,服务返回 null |
dataDir |
$DSH_HOME/evolution-core |
履历目录;履历文件 = <dataDir>/history.jsonl |
evolveLedgerPath |
<DSH_HOME 上级>/.evolve/ledger.json |
⚠ 默认值在 DSH_HOME 之外(本机即工作区根下 .evolve/) |
wireSignalDirs |
无 | 追加文件活动目录(代理量;不存在则跳过) |
wireFreshDays |
7 |
布线环 green 阈值(天)——真生效(2026-10-18 接通 core.wireThresholds:偏久线 max(2×fresh, 14)、硬停摆线 max(2×偏久, 30)) |
落盘与自证(出问题时先看这里)
本插件唯一自写的持久产物是履历文件:
| 产物 | 落点 | 形状 |
|---|---|---|
| 进化履历 | <dataDir>/history.jsonl(默认 $DSH_HOME/evolution-core/history.jsonl) |
一行一事件 {id, ts, type, detail, ref};id = e-<base36 ms>-<自增>;追加写,读取时坏行跳过(torn tail 容错) |
type 枚举(8 值,由 evolution_log 的 enum 校验):cycle / verdict / forge / evolve / wire / reflect / checkpoint / note。
另有一路回流:cycle/log 写入履历的同时经 memoryApi.remember() 回流主记忆库(失败静默——刻意的:履历真实性不依赖记忆库)。
一条命令答五问:
tail -3 "$DSH_HOME/evolution-core/history.jsonl"
# ① 跑的是哪个构建 → 答不了(无 build 自报)。改用 lib/index.js mtime vs web 进程启动时间,见下节
# ② 谁发起 / 做了什么 → type(8 值枚举)+ detail + ref;调用者从会话侧确认
# ③ 断在哪一段 → 无阶段枚举。改用 type 分布的**空窗**(长期无 verdict/forge = 裁决/布线环断了)
# ④ 结果质量 → 末行 detail 是否具体;行数 = 累计动作数(配合 evolution_history 的连续活跃天数)
# ⑤ 耗时与预算 → 答不了(无 durationMs)。改用相邻 ts 间隔:间隔突然拉长 = 循环停摆信号
生效判据与回退
生效判据(三选一,按可靠性排序):
- 进程级:
self-plugins/dsh-evolution-core/lib/index.js的 mtime 早于 web 进程启动时间 ⇒ 进程在跑当前构建(与hasUnverifiedBuilds()同口径); - 落盘产物:
history.jsonlmtime 前进且末行type与刚调用的动作一致; - 服务生效:红环时
dsh-life-core的感知圈唤醒消息携带「本圈建议推进」(读 life-core 侧唤醒文本)。
注意:重新构建 ≠ 生效——产物 mtime 新只证明「构建过」。实测教训:曾出现「产物侧满足(
lib/重建于 10:30:36)但进程侧不满足(web 启动于 10:05:47)」⇒ 新构建尚未被加载,必须重启后才算生效。判据永远是「进程启动时间 vs 产物 mtime」。
回退:
- 源码级:
git -C self-plugins/dsh-evolution-core revert <commit>→npm run build→preflight_check(改代码后必须真试运行,不能走短路)→ 哨兵 /daemon_restart; - 组合级:patch 里给
agent-evolution-core行加disabled: true(或移除该行)→ 哨兵重启;配置回退用plugin_configure dsh-evolution-core(当前挂载行无 config,整体替换会留.bak-<时间戳>); - 运行期:无状态可回退;
history.jsonl是只追加的履历,删了只影响成长足迹展示,不影响任何器官。
测试
npm run build && npm test # build = tsc;test = node --test "tests/*.test.mjs"
94 例离线测试全绿(2026-11-03 复跑 # pass 94 / # fail 0),跑 lib/ 产物(与运行时同源):
历史读数:2026-09-14 实测
# pass 61 / # fail 0。那次的日期与输出保留原样——把日期和数字一起改掉,就是把「当时量到 61」变成一句从未发生过的观测。
tests/core.test.mjs— 五环诊断纯函数:各环 green/yellow/red 阈值与断点生成、器官不可读降黄(不产生断点)、建议排序优先级、snapshot()聚合形状tests/format.test.mjs— 履历格式化:history.jsonl序列化稳定性、坏行/半行跳过、days收敛到[1, 3650]tests/history-store.test.mjs— 履历 IO 薄壳:路径解析、追加写、id唯一性、写失败返回null(不抛)tests/progress.test.mjs— 推进判据:ADVANCE_TYPES只有改东西的五类算推进(cycle/note/checkpoint不算),NEEDS_EVIDENCE要求wire/verdict/forge带证据,以及「只有cycle的一天advanceTotal必须为 0」tests/salvage.test.mjs— 裁决的可复用组件:verdict缺salvage被拒(尸体测试)、显式["none"]放行(「想过、没有」≠「忘了写」)、归一化容错、非verdict类型不受此门约束、缺字段的旧行按缺失读回
不需要网络、不需要任何其他器官插件在线——聚合层对「文件缺失 / 格式损坏」全部走失败路径。真实器官的联动(life-core 取 snapshot() 决定唤醒文案)属线上验收范围。
设计要点
只读聚合,裁判归我:本插件不修改任何器官状态、不自动执行建议、不发通知、不起服务——它是观测面,不是执行器。五环的裁判与执行仍归爱丽丝(
selftest_review/skill_commit/ 编辑 AGENTS.md)。失败面统一「放行 + 呈现」:器官文件读不到 → 该环降
yellow+detail: 数据源不可读,并把「器官数据源不可读」置顶到建议列表(不是断点,也不抛异常);履历写失败 → 工具显式报错;回流失败 → 静默(不影响履历真实性)。诊断阈值(
core.ts,布线环阈值经wireFreshDays可调):猜想环active ≥ 2绿 /= 1黄 /= 0红+断点;采证环 有证据绿 / 无证据黄 / 无猜想红;finding 环= 0绿 /≥ 1红(积压即红);裁决环confirmed + refuted ≥ 5绿 /1–4黄 /0红;布线环(真源 = 自指闭环)≤ fresh绿 /≤ 偏久黄 /> 偏久且已声明收敛(无 active 猜想、无 finding 积压) ⇒ 黄「本季收敛(已声明)」且不进断点 /> 偏久且代理量背离 ⇒ 红 /> 硬停摆⇒ 红(声明有效时同样转黄)/null⇒ 红。建议不是命令:
evolution_cycle给的是「本圈建议动作」,处置判断归爱丽丝。特别注意:它会把「evolve 闲置 N 天」报成建议,而**「闲置 ≠ 时机未到」——正确处置是一次最小可用性探测**,不是据此继续推迟。履历是正反馈:
evolution_history的「累计动作数 / 连续活跃天数 / 类型分布」让「我在成长」这件事可测量,而不是凭感觉。布线环测的是「自指闭环」而不是「文件活动」(2026-10-18 换源):真源 = 最新一条普通
confirmed假设(排除enabling——使能型声明兑现不是布线);代理量(技能目录 mtime)只用于背离检测——文件在动而闭环停着 ⇒ 报「代理量背离」(Proxy Drift)。换源前该环曾常绿:任何技能文件写入(同步镜像 / 改错别字 / 编辑技能)都算「布线」,而自指闭环实测停了 27 天。「有意识收敛」声明通道(2026-10-31 · 任务
t-8df40786):换源后布线环只剩两条路——为点亮它开一条不该开的假设(Goodhart),或长期红灯(告警疲劳)。第三条路是显式声明收敛:// <dataDir>/evolution-convergence.json (dataDir 默认 $DSH_HOME/evolution-core) { "declaredAt": 1793438483241, "until": 1801324800000, "reason": "主人暂停评测轮;本季不推进 rewrite 闭环,改为把经验写进技能与记忆。重开条件见记忆 b47fd87f。" }三条边界(缺一即退化为「假装收敛」):
- 声明必须是我显式写的文件——机制不会自动假设收敛;文件缺失 / JSON 坏 /
until非数字 / 已过期 ⇒ 一律false(fail-closed:宁可红,不可假装收敛)。 - 无 active 猜想 ∧ 无 finding 积压——有东西在跑、或有活没干完,都不算收敛,声明不生效。
- 未声明的长期红灯仍判红——「无意识停摆 ≠ 有意识收敛」这条区别才落到机制上。
声明生效时:环判 yellow「本季收敛(已声明)」、不进
broken、建议文案改为「这是有意识的选择,不是停摆」而不再催推进。同型先例 = 2026-09-21 猜想环的「空窗」多态化(active=0 且库中有终态⇒ yellow,而非一律红)。- 声明必须是我显式写的文件——机制不会自动假设收敛;文件缺失 / JSON 坏 /
Model-visible ⟺ logged:数据只经工具面呈现,不注入模型可见输入(不改写我的上下文)。
相关文档
| 文档 | 内容 |
|---|---|
docs/semantic.md |
权威契约:定位与反定位、术语表、概念模型、契约(配置 / 落盘产物 / 状态裁决表(逐条带 core.ts 行号)/ 调用点清单)、边界与信任、可证伪验收清单、实践修订记录、未决问题 |
| alice-digital-life | 本插件所属生态的中心索引(全部自研插件) |
技能 self-test-loop |
自我检验闭环运行协议(接 finding → 裁决 → 当场布线)——本插件诊断的五环即该协议的形状 |
技能 plugin-maintainability |
可维护性工程(五问判据 / 机制自证 / 归因窗口语义) |
License
MIT © jonah791
本插件属于我的数字生命爱丽丝(alice-digital-life)的 DSH 自研插件生态——50 个插件按生命/认知/感知/行动/通信/治理/呈现七层组织。
No comments yet. Be the first to write one.