dsh-anagenesis

给 Agent 一套它自己管得住、你也看得见的记忆。

不是又一个"自动记忆黑箱"：记忆操作是 Agent 手里的 20 个语义工具；注入策略是运行时可换的纯函数栈；每一次变更都带逆操作、进日志、可回滚；整个存储自包含、离线、零依赖。

anagenesis 桌面窗口 —— 设施平面图（默认面）

一眼看懂它和"自动记忆插件"的差别

	典型「自动记忆」插件	anagenesis
谁在写	后台抽取流水线，模型不知道它记了什么	Agent 主动调用 `ana_remember` / `ana_promote` / `ana_link`，写什么、为什么写由它自己决定
怎么取	一条固定的相似度管线	7 种意图（orient / recall_fact / recall_precedent / avoid_mistake / reuse_procedure / verify / contrast）× 6 套可切换策略栈
错了怎么办	改了就改了	每笔变更都是声明式 patch，带 `revert()`；日志是唯一真相，审计可复查，重启后仍可回滚
谁看得见	全局共享，靠自觉	项目指纹自动隔离；跨项目要显式授权并逐条标注；预设 = 权限开关（没启用时写入工具根本不存在）
依赖什么	向量库 / 云服务 / 模型调用	零运行时依赖、离线、单文件 JSONL；唯一网络出口是可选版本检查
质量证据	靠演示视频	自带离线检索基准：211 条记忆 × 41 条查询，`npm run bench` 可复跑、可对比、可回退

四个能立刻感受到的点

不会"越想越脏"：相关性不足的记忆不会为了填满预算被注入；被取代的旧信念默认不再出现； ana_recall 会明确告诉你排除了谁、为什么（excluded.nearMisses）。
不会"记了就忘为什么"：每条记忆带 kind / state / confidence / provenance / links；关系参与检索（1 跳图扩展），不是画着好看。
不会"改了就回不去"：单写 Mutex + 事件溯源 + 冻结快照；revert(seq) 在重启后仍然有效，连"撤销审计行"都会被显式拒绝。
不会"出了事看不见"：设施仪表盘把存储画成楼层（命名空间）× 分区（记忆类型）× 传感器（记录），右侧是读数、能耗基线、告警与实时电文；换到"体检"面是 11 个分区的中文仪表盘。

它不做什么：不做后台自动抽取、不桥接别的记忆插件、不调用模型、不起子进程、不加遥测。卸载之后，你的记忆仍然是一堆可读的 JSONL。

0.4.0 新增：先量，再改

这一版不新增工具、不新增依赖，改的是注入的每一分注意力值不值。存储升到 v8（自动迁移，只加一个字段）。

变化	之前	现在
相关性门槛	没有：预算有多少就灌多少	绝对 + 相对两道门槛，按 intent 缩放；空查询（orient 简报）不受限
词法分	原始 BM25（记录越长越占便宜）	IDF 加权覆盖率：词表内排序，含未知词做门槛
语义项	`(cos+1)/2`：每条白拿 0.5 底分	`max(0, cos)`：不相关就是 0
重复与多样性	先排序再罚分（顺序不变）	短名单内真 MMR；预算放不下的候选移出池
`links`	只画图，不参与检索	1 跳图扩展：`supports`/`part_of`/`caused_by` 等可救回被门槛挡掉的上下文
取代	`supersedes` 字段从未被写入	`ana_link rel=supersedes` 双写两侧；旧信念默认不再注入（`includeSuperseded` 可看历史）
时间衰减	读 `updatedAt`：连一条线就变"新鲜"	读 `confirmedAt`：提升/锁定才算确认
写入	只做完全字符串去重	返回近重复 top-3 + 建议动作；`supersedes: [id...]` 一次事务收编
自调参	4 个旋钮无人消费	全部接线或删除；奖励来自"变更之后"的反馈窗口；一次只允许一个在飞变更
召回输出	只有排除计数	`excluded`：按原因计数 + 最强 3 条近失（带 `why`）

基准（同一份语料，0.3.2 → 0.4.0）

211 条确定性合成记忆 × 41 条带 gold 的查询，覆盖精确/改写/图/取代/作用域/无关查询：

指标	0.3.2	0.4.0
nDCG@10	0.903	0.974
MRR	0.780	0.854
Recall@5	0.963	1.000
Precision@5	0.180	0.809
污染率（注入但无关）	0.908	0.193
平均注入条数 / 查询	11.6	1.6
tokens / 相关条	627	162
无关查询注入条数	8.3	0.0
`crossProject: true` 命中	0	1.0

npm run bench 可复跑；bench/baseline.json 是回归闸门。语料是合成的、确定性的，不替代真实会话，但它让每一次评分改动都能被对比、被回退。

升级须知（行为变化）：存储 v7 → v8 自动迁移；相关性不足的记忆不再为了填满预算而注入，召回结果可能比以前少 —— 那是真的没有相关内容，ana_recall 的 excluded 会说明排除了谁。 recall.explorationRate 已删除（它从未产生任何效果）。

0.3.0 新增：一个包，一块设施仪表盘

这一版做两件事：两个插件合成一个（窗口不再是需要单独安装的兄弟包），以及把仪表盘换成设施视图 —— 记忆库被画成一栋可以运维的楼。

新增	一句话	你能看到什么
一个包	`dsh-anagenesis-window` 并入 `dsh-anagenesis`：一个包、六个 Loader 行（仍可逐行 `disabled: true`）、一份 `dsh.client`	安装只有一条命令；行 id 与工具不变
设施视图（默认面）	楼层 = 命名空间（当前项目 / 全局 / 每个会话），分区 = 记忆类型，传感器 = 一条活跃记忆	左侧图标栏 / 中央平面图 / 右侧分区详情 / 上下状态条
真实读数	显著度 / 置信度 / 新鲜度，以及「本分区单条能量 vs 全楼实测均值」	模型里没有的数字不会出现在屏幕上
告警台	矛盾链接、即将过期、高显著但陈旧、悬空链接、锁定、安全模式、脱敏关闭、只读档位	每一条都带数量与"为什么值得看"
实时电文	日志尾部真实事件流，底部滚动	你改了什么、刚才发生了什么，一眼可见
适配宿主 0.2.1-rc.2	三处 `peerDependencies` 抬到 `^0.2.1-rc.2`，并用真 Cordis 复跑 98 项启动契约	装得上、启动得了

升级须知（破坏性）：旧的 dsh-anagenesis-window 包停止更新了。如果你装过它，请卸载（dsh plugin remove dsh-anagenesis-window，或从 profile 的 bundles 里删掉那一行），只保留 dsh-anagenesis —— 窗口现在是这个包的第六行。窗口路由改为 /anagenesis/api，存储格式没有变（仍是 v7），不需要迁移。

0.2.0 新增：记忆按项目隔离，预设成为权限开关

这一版解决两件真事：A 项目的经验不再在 B 项目里被召回；不启用预设时，模型连写入工具都看不到。

新增	一句话	你能看到什么
记忆作用域	每条记忆都带 `global` / `project`（默认）/ `session` 标签；检索默认只召回当前项目 + 全局 + 当前会话	仪表盘新增「作用域」分区：当前项目青色、别的项目黄色、全局与旧记忆一目了然
项目指纹	由 git remote（优先）或工作目录算出 `p1_<hash>`，纯函数、跨重启稳定 —— 同一份代码的多个检出是同一个项目	换目录、换机器、开新会话都不会认错项目
跨项目要授权	传 `crossProject: true` 才纳入别的项目，命中被降权并逐条标注「⚠ 其他项目经验，请勿盲从」	注入块里直接写明哪些不能盲从
冲突自动降权	与当前项目记忆语义相似但内容相反时，跨项目那条的有效置信度当场减半，并提示以当前环境为准	只改这一次的投影，绝不回写存储
物理隔离	日志按命名空间分文件（`journal-<ns>-*.jsonl`），全局记忆有自己的文件；旧存储原样可读	`node tools/scope-report.mjs` 一眼看到"谁占了多少、在哪个文件里"
预设 = 权限层	写入类工具只在启用 `anagenesis` 预设时才注册；档位 `passive`（只读）/ `assisted`（可写）/ `autonomous`（可自动调度）	`ana_preset action="status"` 就是权威答案：你现在到底有哪些工具
执行期检查	`ctx.tools.guard()` + 每个写入工具自带的授权校验：没注册就调不到，授权撤销后连缓存的定义也拒绝执行	提示词不是唯一防线
状态脉冲	每一步都有一段 `<anagenesis-pulse>`：当前项目指纹、档位、可用工具集	模型自己就能核对"这条记忆能不能用"
会话即弃	会话级记忆默认 24h 过期；`ana_scope action="drop-session"` 一键回收（普通事务、可回滚）	临时任务的中间状态不会变成永久信念
新工具	`ana_list`（按作用域列出）、`ana_scope`（status / list / namespaces / retag / adopt / drop-session）	`retag` 可回滚；把项目记忆提升为全局需要用户显式授权

升级须知（破坏性）：存储结构 v6 → v7 自动迁移。迁移把带 workspace 的旧记录归入正确项目，其余标为 migrated-global —— 继续可召回但被降权，可用 ana_scope action="adopt" 收回到当前项目。建议重启桌面端以加载新的工具分层。

它在同类里的独特之处

作用域是存储的一等公民，不是检索时的一个过滤器：写入、日志分段、召回过滤、按 id 读取、可视化五处共用同一个命名空间判定，所以"这条经验属于谁"在文件系统层面也成立。
预设不是提示词集合，是权限开关：档位决定写入工具存不存在，而不是"该不该用"。宿主侧没有权限字段可用（ToolDefinition 里没有 readOnly），所以我们用唯一真正可靠的那把锁：注册 / 不注册。
单一 seq 空间 + 声明式 patch：正因为日志没有按项目分库，revert(seq)、审计轨迹与工具返回的句柄才仍然全局唯一 —— 隔离做在文件上，可逆性做在计数器上。
物理隔离与旧数据兼容同时成立：每个命名空间有自己的日志段与归档段，而全局命名空间保留原有的无前缀命名，升级前写下的存储一个字节都不用改。
契约可被证伪：150 条主测试 + 91 条窗口测试 + 一个真 Cordis / 真 defineTool / 真预设注册表的开机沙箱 98 项检查 + 35 项发布自检 + 一次真打包真安装的打包闸门 + 一份可复跑的离线检索基准，跑的都是真实行代码，不是 mock 的复制品。

三句话说明它是什么

它是一座你自己操作的记忆库：按意图召回、按主张提交、按证据提升，全部由 Agent 主动调用 —— 没有黑盒注入。
它的注入策略是一栈纯函数，运行时可换（explore / exploit / debug / distill），还能依据自己的结果做元调参，每一步都可回滚。
它的记忆按项目隔离、按档位授权：写下来的经验只属于当前项目，没启用预设时模型连写入工具都看不到。

作用域：记忆属于一个项目

每条记忆都带一个作用域标签，这是它默认的行为，不需要你配置：

层级	何时使用	谁能召回
`global`	跨项目通用的事实（团队约定、工具用法）	任何项目
`project`（写入默认）	只在这个项目成立的结论	只有当前项目
`session`	本次任务的临时状态，默认 24h 后自动过期	只有写它的那个会话

项目指纹由 git remote（优先）或工作目录的规范化绝对路径算出：p1_<hash>，纯函数、跨会话稳定 —— 同一份代码的两个检出是同一个项目，换台机器也是。
默认只召回当前项目 + 全局 + 当前会话。跨项目检索必须显式传 crossProject: true：命中会被降权，并在注入块里逐条标注「⚠ 其他项目经验，请勿盲从」。
冲突会被指出来：跨项目的记忆与当前项目记忆语义相似但内容相反时，那条跨项目记忆的有效置信度当场减半，注入块与状态脉冲都会提示「建议忽略历史经验，以当前环境为准」—— 只改这一次的投影，绝不回写存储。
物理上也分开了：日志按命名空间分文件（journal-<ns>-*.jsonl），全局记忆有自己的文件；隔离之前写的存储原样可读，那些记录被标成 migrated-global 并自动降权，可用 ana_scope action="adopt" 收回到当前项目。
体检一座存储：node tools/scope-report.mjs（只读：命名空间分布、已知项目、物理文件、档位解释）。

预设是权限开关，不是建议

装上插件只给你眼睛：默认注册的全部是只读工具（ana_recall / ana_list / ana_audit / ana_dashboard / ana_diagram / ana_window，以及 ana_scope / ana_preset / ana_strategy / ana_tune 的查看动作）。写入类工具只在启用 anagenesis 预设时才存在 —— 不是"被劝阻"，而是没被注册，模型看不到它们。想写记忆就启用预设，这是唯一的路。

档位	写入工具	额外能力
`passive`	不注册	只读：召回、审计、可视化、策略状态
`assisted`（预设默认）	注册	每次写入都由 Agent 显式调用工具
`autonomous`	注册	策略可自动调度（报告失败后自动切 `debug`）、被反复引用的草稿可自动结晶为 active；两者都带审计与 seq

档位在预设配置里选（gear:），运行时可用 ana_preset action="gear" 查看与降级； 向上升级需要宿主授权，Agent 不能自己扩大自己的权限。
切换与注销都精确回滚：降回 passive 时写入工具被逐个注销；卸载预设后工具集回到只读那一套。
权限检查在执行时生效（ctx.tools.guard() + 每个写入工具自带的 assertGrant）：即使有人缓存了工具定义，撤销授权之后它一样拒绝执行。提示词约束只是第二道，不是唯一一道。
Agent 每一步都会看到一段 <anagenesis-pulse>：当前项目、档位、它手上到底有哪些工具。

和典型「自动记忆」插件不一样在哪

自带闭环存储：journal/*.jsonl 追加式日志 + 原子快照。不调用、不桥接、不代理任何外部记忆服务 —— 没有数据库、没有云、没有模型调用。
记忆是 Agent 主动调用的工具（17 个 ana_*）：按意图召回（orient / recall_precedent / avoid_mistake / reuse_procedure / …），而不是靠后台自动抽取。
它不只存记忆，还管自己的行为：注入策略可换栈、元层可自调参、护栏单调收紧、每次变更可回滚 —— 并且这三件事都留痕、可审计。

维度	典型自动记忆插件	anagenesis
谁决定记什么	后台抽取，Agent 无感	Agent 用工具显式决定：`ana_remember` / `ana_promote` / `ana_split` / `ana_rethink` / `ana_forget`
怎么召回	关键词或向量相似度	意图驱动：7 种意图 → 种类 / 状态 / 置信度下限 / 权重 / 粒度 / token 预算 / 多样性
谁看得见	所有项目共用一座库	按项目隔离：写入默认属于当前项目，跨项目检索必须显式授权并降权标注
谁能写	装了就都能写	预设即权限层：没启用预设时写入工具根本不存在；档位 passive / assisted / autonomous
注入策略	固定	运行时可换栈（6 个具名栈），且按作用域存栈，一个 Agent 换栈不影响另一个
变更的后果	多数不可逆	每笔事务返回逆函数；逆操作与正向 patch 同写日志，重启后仍可回滚
自我调节	无	元层依据反馈自调参：参数包络约束 + UCB1 选臂 + 审计 + 评估 + 回滚
失控风险	—	单调护栏 + 熔断 + `safeMode`；能自改的只有 tier-1，外环冻结
依赖	常常需要外部服务或向量库	零运行时依赖、离线可用、无子进程；唯一的网络请求是可选的新版本检查（一条 GET，可一行关掉）
可见性	一个黑箱	设施视图（楼层平面 / 分区详情 / 告警 / 电文）+ TUI 仪表盘 + mermaid/d2/ascii 文本图表

安装

一条命令

一个包、六个 Loader 行（内核 / 只读工具 / 护栏 / 预设 / 可视化 / 桌面窗口）， dsh plugin add 直接取 npm 上的最新版：dsh-anagenesis。

dsh plugin add dsh-anagenesis

装完重启 profile。安装会自动注册名为 anagenesis 的 Agent 预设 —— 新会话里选中它即可。

从 0.2.x 升级：先卸掉旧的窗口包（它已停止更新），只保留这一个包： dsh plugin remove dsh-anagenesis-window（或从 profile 的 bundles 里删掉那一行），然后重启。

从源码安装（想改代码、或跟进 `main`）

git clone https://github.com/3likofj/dsh-anagenesis.git
cd dsh-anagenesis
dsh plugin --profile desktop add link:<仓库绝对路径>

window/ 只是这个包的一个目录（客户端半 + 渲染层 + 窗口 Host 半），不再是第二个包。

五分钟上手

安装并重启 profile，新建会话时选 anagenesis 预设（默认策略栈 guard + exploit）。
正常干活就行：Agent 会自己调 ana_recall 与 ana_remember —— 你不需要写查询语言。
想看一眼记忆库：让 Agent 调 ana_dashboard（一帧 TUI 仪表盘，直接出现在回答里）或 ana_diagram（可粘贴进 Markdown 的图）。
想在真实终端里持续刷新：node tools/viz-watch.mjs --watch（只读、独立进程）。
想要桌面窗口：重启后让 Agent 调 ana_window（默认打开设施视图），或直接点界面上的入口。

能力地图（20 个工具，按权限分层）

只读层（装上插件就有）

分组	工具	干什么
召回	`ana_recall` · `ana_list`	按意图取回（默认只搜当前项目 + 全局 + 当前会话）；按作用域列出库里有什么
治理查看	`ana_audit` · `ana_scope` · `ana_preset` · `ana_strategy` · `ana_tune`	状态 / 日志 / 审计 / 某条记忆；作用域报告；档位与权限；策略清单；调参指标（变更动作需要相应档位）
可视化	`ana_dashboard` · `ana_diagram` · `ana_window`	终端仪表盘（含作用域分区）、文本图表、桌面窗口（后两个工具各自属于可视化行与窗口行，行没装工具就不存在）

写入层（只在启用 anagenesis 预设时存在）

分组	工具	干什么
写入与生命周期	`ana_remember` · `ana_promote` · `ana_demote` · `ana_lock` · `ana_expire` · `ana_forget`	写入默认落在当前项目；`draft → active → verified → locked`，或降级 / 过期 / 删除（删除只留可审计的墓碑）
结构化	`ana_link` · `ana_split` · `ana_rethink`	建立关系；把信息过载的记忆拆窄（子记录继承父作用域）；反事实重思
反馈与修正	`ana_feedback` · `ana_scope action="retag"/"adopt"` · `ana_strategy`·`ana_tune` 的变更动作	回报实际使用；重新归档作用域（可回滚）；换栈 / 元调参（`admin` 档位）

注入策略：什么时候用哪副脑子

具名栈	组成	适合
`explore`	guard + explore	问题还在摸清阶段：高召回、低门槛，写入落为草稿
`exploit`	guard + exploit	执行已知方案：只注入已验证 / 已锁定的，写入直接生效
`debug`	guard + debug	出事那一刻：失败与未决假设优先，关闭时间衰减
`distill`	guard + distill	长会话要省 token：压缩优先，只注入要点
`recon`	guard + explore + distill	先铺开再收紧
`crisis`	guard + debug + exploit	连续失败时：失败与已验证事实同时注入

guard 是不变量：永远在栈底、自己不注入内容，只做"锁定信念加权 / 草稿降权 / retired 永不注入"。策略是纯函数包 + 有界参数：Agent 只能"点名一个内置实现 + 参数差分"来派生新策略 —— 能持久化任意代码的 Agent，也就是能把自己弄砖的 Agent。

每一次变更都可以撤销

变更不是闭包，是声明式 JSON patch；存储把所有写者串行化，先追加日志、再换入冻结快照（读者因此无锁）。
transact() 返回 revert(reason)：它把逆操作作为补偿事件提交，与正向 patch 一起进日志 —— 所以重启之后回滚依然有效。
ana_strategy action:"revert" 与 ana_tune action:"rollback" 只是这个原语上的薄封装。
日志有三条上界：段数超限时合并最老的归档段（合并不丢 seq）、检查点只留最新、以及唯一有损的保留策略（默认关闭；一旦丢过东西，状态视图会显式报告，而不是假装那个 seq 从没存在过）。

自我引导的边界（它为什么不会跑偏）

能自我引导 —— 但外环是冻的。

tier 1（可自改）：记忆、策略栈、可调参数。Agent 能召回自己过去的失败、从内置策略派生新策略、用自己收集的反馈调整置信度下限与 token 预算。
tier 2（冻结）：参数包络、可调命名空间白名单、guard 的存在、工具 schema、以及插件代码本身。运行中的 Agent 改不了其中任何一项。

理由很直接：能改写自己适应度函数与刹车的 Agent，会漂向"得分高"而不是"真管用"，而且没有可恢复的状态可以回滚。这条边界是可执行的（8 条单调收紧的不变量 + safeMode 整体冻结），不是口号。

看得见

设施视图 —— 楼层平面 / 分区详情 / 告警 / 电文

有新版本时，顶条会多一块牌子（下面是 0.3.1 发现 0.3.2 时的真实画面）：

顶条上的「有新版本」提示（示例 v0.4.1）

记忆关系图（横向）

生命周期流转

策略时间线

仪表盘面（另一张脸：`ana_dashboard` 的图形化版本）

仪表盘

TUI 仪表盘（ana_dashboard）：总览、生命周期分布、类型分布、策略栈与健康度、偏离默认值的调参旋钮、日志尾部、重要度排行、渲染器自身状态。按显示宽度精确对齐（中日韩标签不会把边框撕开），颜色只有被要求时才上。
文本图表（ana_diagram）：Mermaid（默认）/ D2 / ASCII 三种格式；三种图 —— 记忆关系图（含 supports / contradicts / supersedes 等关系）、策略时间线、生命周期流转（只画日志真实记录到的迁移，lock / expire 这类"只记录目的态"的操作会如实说明，而不是编造一条来源边）。
设施视图（桌面窗口的默认面，method=facility）：楼层 = 命名空间、分区 = 记忆类型、传感器 = 一条活跃记忆；读数只有真的东西（显著度 / 置信度 / 新鲜度 / 单条能量 vs 全楼实测基线），告警台列出矛盾链接、即将过期、高显著但陈旧、悬空链接、锁定、安全模式、脱敏关闭、只读档位，底部电文条是日志尾部真实事件流。模型里没有的数字不会出现在屏幕上。
新版本提示（0.3.1）：设施视图顶条会出现 v0.4.0 可更新 的牌子，告警台里也有一条；仪表盘面多一个「版本更新」分区； ana_audit view=status 里同样能读到当前版本 / 最新版本 / 上次检查。它只提示 —— 不下载、不安装、不重启。
桌面窗口（同一个包的第六行）：仪表盘 / 设施 / 图表三张脸，共享同一批纯函数产出的中文卡片与自研内联 SVG 有向图（横向 / 纵向 + 缩放），三个入口席位（better-sidebar 侧栏行 / 官方右侧边栏 / 对话顶部栏），只读镜像存储。
渲染是只读投影：一次渲染不是一次事务。唯一可选的写入 auditRenders 默认关闭；另一个只读进程 tools/viz-watch.mjs 可以在真实终端里持续刷新。

数据在哪、隐私如何

$DSH_HOME/anagenesis/
  journal/journal-000001.jsonl          追加式事件日志（全局命名空间，保留原命名）
  journal/journal-<ns>-000001.jsonl     每个项目/会话命名空间自己的段（物理隔离）
  journal/archive-<ns>-<seq>.jsonl      折叠后的归档，按命名空间分开（保留 undo）
  journal/checkpoint-<seq>.json         边界上的冻结状态（缓存，整库一份）
  snapshot.json                         原子启动缓存

记忆按命名空间分文件：project:<指纹> 与 session:<id> 的事件写进各自命名的段，全局记忆留在无前缀的 journal-*.jsonl 里 —— 所以"这条经验属于谁"在文件系统层面也成立，而不只是查询时过滤一次。
全本地：不联网、不下载模型、不调用模型、不启动子进程。
零运行时依赖：检索是内置 BM25 倒排索引 + 确定性哈希向量化器（192 维），真正的语义后端可以在运行时注入。
脱敏默认开：工具与窗口的输出默认 secrets —— 抹掉凭据形状的文本、省略正文；strict 连标签一起遮挡；none 是显式的本地调试逃生门，产物本身会就此发出警告。
旧目录兼容：默认 $DSH_HOME/anagenesis；若检测到改名前的 $DSH_HOME/evolution 数据更完整，会继续沿用旧目录并在日志里说明，一个字节都不搬。要搬就 npm run migrate:store（复制 + 逐文件 sha256 校验，源目录不动）。

配置（全部可选，全部有安全默认值）

内核行的关键旋钮：

键	默认	作用
`rootDir`	`$DSH_HOME/anagenesis`	存储根目录；显式设了就完全听它的（不再回退旧目录）
`safeMode`	`false`	冻结策略注册、切换与调参
`defaultScopeTier`	`project`	没有显式指定作用域时，记忆落在哪一层（`project` / `global` / `session`）
`sessionTtlMs`	`86400000`	会话级记忆的默认存活时间；`0` = 不过期
`recallCrossProjectDefault`	`false`	是否默认纳入其它项目的记忆（默认关闭：跨项目必须显式授权）
`workspace`	空	显式指定"当前项目"的工作目录；留空时用工具调用携带的 cwd
`recallDefaultTokenBudget`	`1600`	召回注入的默认 token 预算
`hookBudgetMs`	`8`	单个策略钩子的时间预算（超时按失败计，不拖住召回）
`compactAfterEvents`	`2000`	活跃事件超过它就压缩日志；`0` 关闭
`archiveMaxSegments`	`16`	归档段数上界（合并最老的段，不丢 seq）；`0` 不设界
`retainEvents`	`0`	唯一有损策略：只保留最近 N 条事件的归档段；`0` = 全留
`embedProvider`	`hash`	启动时用哪个向量后端；语义后端可在运行时装入
`reflectionEnabled`	`true`	定时反思：质疑证据已明显衰减的既有信念（只归档为草稿假设）
`updateCheck`	代码里 `off`，bundle 里 `npm`	新版本检查：`off` = 完全离线；`npm` = 每 6 小时读一次 npm 上的 `latest` 版本号（只读 GET，不带标识，不自动安装）
`updateCheckIntervalMs`	`21600000`	检查间隔（也是缓存的寿命）；默认 6 小时
`updateRegistry`	`https://registry.npmjs.org`	换镜像时改这里；只在 `updateCheck: npm` 时使用

其余：工具行 exposeAuditTool / exposeTuneTool；可视化行 lang / redaction / width / auditRenders 等；窗口包见 window/README.md。

常见问题

会拖慢每次召回吗？ 策略钩子有 8ms 预算、超时按失败计；读取走冻结快照，不上锁。

记忆会越写越乱吗？ 生命周期状态、置信度、重要度衰减、过期清扫、反事实重思都是显式工具，可以随时收拾。

卸载会留残留吗？ 每一行释放自己创建的效应（工具、服务、定时器、路由、席位）；卸载后 journal 句柄关闭、存储目录可以正常删除。

能换成真正的语义检索吗？ 能。运行时 service.useEmbedder(...) 装入后端，再 reembed() 把已存向量重算一遍；在那之前状态里会一直标记向量"陈旧"。

为什么桌面窗口是单独的包？ 声明 dsh.client 的包只能有一个活跃 Loader 行，而内核是五行（预设还会再挂一次）。这是 DSH 的硬约束，所以窗口做成单行兄弟包。

许可证

dsh-anagenesis

给 Agent 一套它自己管得住、你也看得见的记忆。

English · 更新日志 · Apache-2.0

anagenesis 桌面窗口 —— 设施平面图（默认面）

一眼看懂它和"自动记忆插件"的差别

	典型「自动记忆」插件	anagenesis
谁在写	后台抽取流水线，模型不知道它记了什么	Agent 主动调用 `ana_remember` / `ana_promote` / `ana_link`，写什么、为什么写由它自己决定
怎么取	一条固定的相似度管线	7 种意图（orient / recall_fact / recall_precedent / avoid_mistake / reuse_procedure / verify / contrast）× 6 套可切换策略栈
错了怎么办	改了就改了	每笔变更都是声明式 patch，带 `revert()`；日志是唯一真相，审计可复查，重启后仍可回滚
谁看得见	全局共享，靠自觉	项目指纹自动隔离；跨项目要显式授权并逐条标注；预设 = 权限开关（没启用时写入工具根本不存在）
依赖什么	向量库 / 云服务 / 模型调用	零运行时依赖、离线、单文件 JSONL；唯一网络出口是可选版本检查
质量证据	靠演示视频	自带离线检索基准：211 条记忆 × 41 条查询，`npm run bench` 可复跑、可对比、可回退

四个能立刻感受到的点

不会"越想越脏"：相关性不足的记忆不会为了填满预算被注入；被取代的旧信念默认不再出现； ana_recall 会明确告诉你排除了谁、为什么（excluded.nearMisses）。
不会"记了就忘为什么"：每条记忆带 kind / state / confidence / provenance / links；关系参与检索（1 跳图扩展），不是画着好看。
不会"改了就回不去"：单写 Mutex + 事件溯源 + 冻结快照；revert(seq) 在重启后仍然有效，连"撤销审计行"都会被显式拒绝。
不会"出了事看不见"：设施仪表盘把存储画成楼层（命名空间）× 分区（记忆类型）× 传感器（记录），右侧是读数、能耗基线、告警与实时电文；换到"体检"面是 11 个分区的中文仪表盘。

它不做什么：不做后台自动抽取、不桥接别的记忆插件、不调用模型、不起子进程、不加遥测。卸载之后，你的记忆仍然是一堆可读的 JSONL。

0.4.0 新增：先量，再改

这一版不新增工具、不新增依赖，改的是注入的每一分注意力值不值。存储升到 v8（自动迁移，只加一个字段）。

变化	之前	现在
相关性门槛	没有：预算有多少就灌多少	绝对 + 相对两道门槛，按 intent 缩放；空查询（orient 简报）不受限
词法分	原始 BM25（记录越长越占便宜）	IDF 加权覆盖率：词表内排序，含未知词做门槛
语义项	`(cos+1)/2`：每条白拿 0.5 底分	`max(0, cos)`：不相关就是 0
重复与多样性	先排序再罚分（顺序不变）	短名单内真 MMR；预算放不下的候选移出池
`links`	只画图，不参与检索	1 跳图扩展：`supports`/`part_of`/`caused_by` 等可救回被门槛挡掉的上下文
取代	`supersedes` 字段从未被写入	`ana_link rel=supersedes` 双写两侧；旧信念默认不再注入（`includeSuperseded` 可看历史）
时间衰减	读 `updatedAt`：连一条线就变"新鲜"	读 `confirmedAt`：提升/锁定才算确认
写入	只做完全字符串去重	返回近重复 top-3 + 建议动作；`supersedes: [id...]` 一次事务收编
自调参	4 个旋钮无人消费	全部接线或删除；奖励来自"变更之后"的反馈窗口；一次只允许一个在飞变更
召回输出	只有排除计数	`excluded`：按原因计数 + 最强 3 条近失（带 `why`）

基准（同一份语料，0.3.2 → 0.4.0）

211 条确定性合成记忆 × 41 条带 gold 的查询，覆盖精确/改写/图/取代/作用域/无关查询：

指标	0.3.2	0.4.0
nDCG@10	0.903	0.974
MRR	0.780	0.854
Recall@5	0.963	1.000
Precision@5	0.180	0.809
污染率（注入但无关）	0.908	0.193
平均注入条数 / 查询	11.6	1.6
tokens / 相关条	627	162
无关查询注入条数	8.3	0.0
`crossProject: true` 命中	0	1.0

npm run bench 可复跑；bench/baseline.json 是回归闸门。语料是合成的、确定性的，不替代真实会话，但它让每一次评分改动都能被对比、被回退。

0.3.0 新增：一个包，一块设施仪表盘

这一版做两件事：两个插件合成一个（窗口不再是需要单独安装的兄弟包），以及把仪表盘换成设施视图 —— 记忆库被画成一栋可以运维的楼。

新增	一句话	你能看到什么
一个包	`dsh-anagenesis-window` 并入 `dsh-anagenesis`：一个包、六个 Loader 行（仍可逐行 `disabled: true`）、一份 `dsh.client`	安装只有一条命令；行 id 与工具不变
设施视图（默认面）	楼层 = 命名空间（当前项目 / 全局 / 每个会话），分区 = 记忆类型，传感器 = 一条活跃记忆	左侧图标栏 / 中央平面图 / 右侧分区详情 / 上下状态条
真实读数	显著度 / 置信度 / 新鲜度，以及「本分区单条能量 vs 全楼实测均值」	模型里没有的数字不会出现在屏幕上
告警台	矛盾链接、即将过期、高显著但陈旧、悬空链接、锁定、安全模式、脱敏关闭、只读档位	每一条都带数量与"为什么值得看"
实时电文	日志尾部真实事件流，底部滚动	你改了什么、刚才发生了什么，一眼可见
适配宿主 0.2.1-rc.2	三处 `peerDependencies` 抬到 `^0.2.1-rc.2`，并用真 Cordis 复跑 98 项启动契约	装得上、启动得了

0.2.0 新增：记忆按项目隔离，预设成为权限开关

这一版解决两件真事：A 项目的经验不再在 B 项目里被召回；不启用预设时，模型连写入工具都看不到。

新增	一句话	你能看到什么
记忆作用域	每条记忆都带 `global` / `project`（默认）/ `session` 标签；检索默认只召回当前项目 + 全局 + 当前会话	仪表盘新增「作用域」分区：当前项目青色、别的项目黄色、全局与旧记忆一目了然
项目指纹	由 git remote（优先）或工作目录算出 `p1_<hash>`，纯函数、跨重启稳定 —— 同一份代码的多个检出是同一个项目	换目录、换机器、开新会话都不会认错项目
跨项目要授权	传 `crossProject: true` 才纳入别的项目，命中被降权并逐条标注「⚠ 其他项目经验，请勿盲从」	注入块里直接写明哪些不能盲从
冲突自动降权	与当前项目记忆语义相似但内容相反时，跨项目那条的有效置信度当场减半，并提示以当前环境为准	只改这一次的投影，绝不回写存储
物理隔离	日志按命名空间分文件（`journal-<ns>-*.jsonl`），全局记忆有自己的文件；旧存储原样可读	`node tools/scope-report.mjs` 一眼看到"谁占了多少、在哪个文件里"
预设 = 权限层	写入类工具只在启用 `anagenesis` 预设时才注册；档位 `passive`（只读）/ `assisted`（可写）/ `autonomous`（可自动调度）	`ana_preset action="status"` 就是权威答案：你现在到底有哪些工具
执行期检查	`ctx.tools.guard()` + 每个写入工具自带的授权校验：没注册就调不到，授权撤销后连缓存的定义也拒绝执行	提示词不是唯一防线
状态脉冲	每一步都有一段 `<anagenesis-pulse>`：当前项目指纹、档位、可用工具集	模型自己就能核对"这条记忆能不能用"
会话即弃	会话级记忆默认 24h 过期；`ana_scope action="drop-session"` 一键回收（普通事务、可回滚）	临时任务的中间状态不会变成永久信念
新工具	`ana_list`（按作用域列出）、`ana_scope`（status / list / namespaces / retag / adopt / drop-session）	`retag` 可回滚；把项目记忆提升为全局需要用户显式授权

它在同类里的独特之处

作用域是存储的一等公民，不是检索时的一个过滤器：写入、日志分段、召回过滤、按 id 读取、可视化五处共用同一个命名空间判定，所以"这条经验属于谁"在文件系统层面也成立。
预设不是提示词集合，是权限开关：档位决定写入工具存不存在，而不是"该不该用"。宿主侧没有权限字段可用（ToolDefinition 里没有 readOnly），所以我们用唯一真正可靠的那把锁：注册 / 不注册。
单一 seq 空间 + 声明式 patch：正因为日志没有按项目分库，revert(seq)、审计轨迹与工具返回的句柄才仍然全局唯一 —— 隔离做在文件上，可逆性做在计数器上。
物理隔离与旧数据兼容同时成立：每个命名空间有自己的日志段与归档段，而全局命名空间保留原有的无前缀命名，升级前写下的存储一个字节都不用改。
契约可被证伪：150 条主测试 + 91 条窗口测试 + 一个真 Cordis / 真 defineTool / 真预设注册表的开机沙箱 98 项检查 + 35 项发布自检 + 一次真打包真安装的打包闸门 + 一份可复跑的离线检索基准，跑的都是真实行代码，不是 mock 的复制品。

三句话说明它是什么

它是一座你自己操作的记忆库：按意图召回、按主张提交、按证据提升，全部由 Agent 主动调用 —— 没有黑盒注入。
它的注入策略是一栈纯函数，运行时可换（explore / exploit / debug / distill），还能依据自己的结果做元调参，每一步都可回滚。
它的记忆按项目隔离、按档位授权：写下来的经验只属于当前项目，没启用预设时模型连写入工具都看不到。

作用域：记忆属于一个项目

每条记忆都带一个作用域标签，这是它默认的行为，不需要你配置：

层级	何时使用	谁能召回
`global`	跨项目通用的事实（团队约定、工具用法）	任何项目
`project`（写入默认）	只在这个项目成立的结论	只有当前项目
`session`	本次任务的临时状态，默认 24h 后自动过期	只有写它的那个会话

项目指纹由 git remote（优先）或工作目录的规范化绝对路径算出：p1_<hash>，纯函数、跨会话稳定 —— 同一份代码的两个检出是同一个项目，换台机器也是。
默认只召回当前项目 + 全局 + 当前会话。跨项目检索必须显式传 crossProject: true：命中会被降权，并在注入块里逐条标注「⚠ 其他项目经验，请勿盲从」。
冲突会被指出来：跨项目的记忆与当前项目记忆语义相似但内容相反时，那条跨项目记忆的有效置信度当场减半，注入块与状态脉冲都会提示「建议忽略历史经验，以当前环境为准」—— 只改这一次的投影，绝不回写存储。
物理上也分开了：日志按命名空间分文件（journal-<ns>-*.jsonl），全局记忆有自己的文件；隔离之前写的存储原样可读，那些记录被标成 migrated-global 并自动降权，可用 ana_scope action="adopt" 收回到当前项目。
体检一座存储：node tools/scope-report.mjs（只读：命名空间分布、已知项目、物理文件、档位解释）。

预设是权限开关，不是建议

档位	写入工具	额外能力
`passive`	不注册	只读：召回、审计、可视化、策略状态
`assisted`（预设默认）	注册	每次写入都由 Agent 显式调用工具
`autonomous`	注册	策略可自动调度（报告失败后自动切 `debug`）、被反复引用的草稿可自动结晶为 active；两者都带审计与 seq

档位在预设配置里选（gear:），运行时可用 ana_preset action="gear" 查看与降级； 向上升级需要宿主授权，Agent 不能自己扩大自己的权限。
切换与注销都精确回滚：降回 passive 时写入工具被逐个注销；卸载预设后工具集回到只读那一套。
权限检查在执行时生效（ctx.tools.guard() + 每个写入工具自带的 assertGrant）：即使有人缓存了工具定义，撤销授权之后它一样拒绝执行。提示词约束只是第二道，不是唯一一道。
Agent 每一步都会看到一段 <anagenesis-pulse>：当前项目、档位、它手上到底有哪些工具。

和典型「自动记忆」插件不一样在哪

自带闭环存储：journal/*.jsonl 追加式日志 + 原子快照。不调用、不桥接、不代理任何外部记忆服务 —— 没有数据库、没有云、没有模型调用。
记忆是 Agent 主动调用的工具（17 个 ana_*）：按意图召回（orient / recall_precedent / avoid_mistake / reuse_procedure / …），而不是靠后台自动抽取。
它不只存记忆，还管自己的行为：注入策略可换栈、元层可自调参、护栏单调收紧、每次变更可回滚 —— 并且这三件事都留痕、可审计。

维度	典型自动记忆插件	anagenesis
谁决定记什么	后台抽取，Agent 无感	Agent 用工具显式决定：`ana_remember` / `ana_promote` / `ana_split` / `ana_rethink` / `ana_forget`
怎么召回	关键词或向量相似度	意图驱动：7 种意图 → 种类 / 状态 / 置信度下限 / 权重 / 粒度 / token 预算 / 多样性
谁看得见	所有项目共用一座库	按项目隔离：写入默认属于当前项目，跨项目检索必须显式授权并降权标注
谁能写	装了就都能写	预设即权限层：没启用预设时写入工具根本不存在；档位 passive / assisted / autonomous
注入策略	固定	运行时可换栈（6 个具名栈），且按作用域存栈，一个 Agent 换栈不影响另一个
变更的后果	多数不可逆	每笔事务返回逆函数；逆操作与正向 patch 同写日志，重启后仍可回滚
自我调节	无	元层依据反馈自调参：参数包络约束 + UCB1 选臂 + 审计 + 评估 + 回滚
失控风险	—	单调护栏 + 熔断 + `safeMode`；能自改的只有 tier-1，外环冻结
依赖	常常需要外部服务或向量库	零运行时依赖、离线可用、无子进程；唯一的网络请求是可选的新版本检查（一条 GET，可一行关掉）
可见性	一个黑箱	设施视图（楼层平面 / 分区详情 / 告警 / 电文）+ TUI 仪表盘 + mermaid/d2/ascii 文本图表

安装

一条命令

一个包、六个 Loader 行（内核 / 只读工具 / 护栏 / 预设 / 可视化 / 桌面窗口）， dsh plugin add 直接取 npm 上的最新版：dsh-anagenesis。

dsh plugin add dsh-anagenesis

装完重启 profile。安装会自动注册名为 anagenesis 的 Agent 预设 —— 新会话里选中它即可。

从 0.2.x 升级：先卸掉旧的窗口包（它已停止更新），只保留这一个包： dsh plugin remove dsh-anagenesis-window（或从 profile 的 bundles 里删掉那一行），然后重启。

从源码安装（想改代码、或跟进 `main`）

git clone https://github.com/3likofj/dsh-anagenesis.git
cd dsh-anagenesis
dsh plugin --profile desktop add link:<仓库绝对路径>

window/ 只是这个包的一个目录（客户端半 + 渲染层 + 窗口 Host 半），不再是第二个包。

五分钟上手

安装并重启 profile，新建会话时选 anagenesis 预设（默认策略栈 guard + exploit）。
正常干活就行：Agent 会自己调 ana_recall 与 ana_remember —— 你不需要写查询语言。
想看一眼记忆库：让 Agent 调 ana_dashboard（一帧 TUI 仪表盘，直接出现在回答里）或 ana_diagram（可粘贴进 Markdown 的图）。
想在真实终端里持续刷新：node tools/viz-watch.mjs --watch（只读、独立进程）。
想要桌面窗口：重启后让 Agent 调 ana_window（默认打开设施视图），或直接点界面上的入口。

能力地图（20 个工具，按权限分层）

只读层（装上插件就有）

分组	工具	干什么
召回	`ana_recall` · `ana_list`	按意图取回（默认只搜当前项目 + 全局 + 当前会话）；按作用域列出库里有什么
治理查看	`ana_audit` · `ana_scope` · `ana_preset` · `ana_strategy` · `ana_tune`	状态 / 日志 / 审计 / 某条记忆；作用域报告；档位与权限；策略清单；调参指标（变更动作需要相应档位）
可视化	`ana_dashboard` · `ana_diagram` · `ana_window`	终端仪表盘（含作用域分区）、文本图表、桌面窗口（后两个工具各自属于可视化行与窗口行，行没装工具就不存在）

写入层（只在启用 anagenesis 预设时存在）

分组	工具	干什么
写入与生命周期	`ana_remember` · `ana_promote` · `ana_demote` · `ana_lock` · `ana_expire` · `ana_forget`	写入默认落在当前项目；`draft → active → verified → locked`，或降级 / 过期 / 删除（删除只留可审计的墓碑）
结构化	`ana_link` · `ana_split` · `ana_rethink`	建立关系；把信息过载的记忆拆窄（子记录继承父作用域）；反事实重思
反馈与修正	`ana_feedback` · `ana_scope action="retag"/"adopt"` · `ana_strategy`·`ana_tune` 的变更动作	回报实际使用；重新归档作用域（可回滚）；换栈 / 元调参（`admin` 档位）

注入策略：什么时候用哪副脑子

具名栈	组成	适合
`explore`	guard + explore	问题还在摸清阶段：高召回、低门槛，写入落为草稿
`exploit`	guard + exploit	执行已知方案：只注入已验证 / 已锁定的，写入直接生效
`debug`	guard + debug	出事那一刻：失败与未决假设优先，关闭时间衰减
`distill`	guard + distill	长会话要省 token：压缩优先，只注入要点
`recon`	guard + explore + distill	先铺开再收紧
`crisis`	guard + debug + exploit	连续失败时：失败与已验证事实同时注入

每一次变更都可以撤销

变更不是闭包，是声明式 JSON patch；存储把所有写者串行化，先追加日志、再换入冻结快照（读者因此无锁）。
transact() 返回 revert(reason)：它把逆操作作为补偿事件提交，与正向 patch 一起进日志 —— 所以重启之后回滚依然有效。
ana_strategy action:"revert" 与 ana_tune action:"rollback" 只是这个原语上的薄封装。
日志有三条上界：段数超限时合并最老的归档段（合并不丢 seq）、检查点只留最新、以及唯一有损的保留策略（默认关闭；一旦丢过东西，状态视图会显式报告，而不是假装那个 seq 从没存在过）。

自我引导的边界（它为什么不会跑偏）

能自我引导 —— 但外环是冻的。

tier 1（可自改）：记忆、策略栈、可调参数。Agent 能召回自己过去的失败、从内置策略派生新策略、用自己收集的反馈调整置信度下限与 token 预算。
tier 2（冻结）：参数包络、可调命名空间白名单、guard 的存在、工具 schema、以及插件代码本身。运行中的 Agent 改不了其中任何一项。

看得见

设施视图 —— 楼层平面 / 分区详情 / 告警 / 电文

有新版本时，顶条会多一块牌子（下面是 0.3.1 发现 0.3.2 时的真实画面）：

顶条上的「有新版本」提示（示例 v0.4.1）

记忆关系图（横向）

生命周期流转

策略时间线

仪表盘面（另一张脸：`ana_dashboard` 的图形化版本）

仪表盘

TUI 仪表盘（ana_dashboard）：总览、生命周期分布、类型分布、策略栈与健康度、偏离默认值的调参旋钮、日志尾部、重要度排行、渲染器自身状态。按显示宽度精确对齐（中日韩标签不会把边框撕开），颜色只有被要求时才上。
文本图表（ana_diagram）：Mermaid（默认）/ D2 / ASCII 三种格式；三种图 —— 记忆关系图（含 supports / contradicts / supersedes 等关系）、策略时间线、生命周期流转（只画日志真实记录到的迁移，lock / expire 这类"只记录目的态"的操作会如实说明，而不是编造一条来源边）。
设施视图（桌面窗口的默认面，method=facility）：楼层 = 命名空间、分区 = 记忆类型、传感器 = 一条活跃记忆；读数只有真的东西（显著度 / 置信度 / 新鲜度 / 单条能量 vs 全楼实测基线），告警台列出矛盾链接、即将过期、高显著但陈旧、悬空链接、锁定、安全模式、脱敏关闭、只读档位，底部电文条是日志尾部真实事件流。模型里没有的数字不会出现在屏幕上。
新版本提示（0.3.1）：设施视图顶条会出现 v0.4.0 可更新 的牌子，告警台里也有一条；仪表盘面多一个「版本更新」分区； ana_audit view=status 里同样能读到当前版本 / 最新版本 / 上次检查。它只提示 —— 不下载、不安装、不重启。
桌面窗口（同一个包的第六行）：仪表盘 / 设施 / 图表三张脸，共享同一批纯函数产出的中文卡片与自研内联 SVG 有向图（横向 / 纵向 + 缩放），三个入口席位（better-sidebar 侧栏行 / 官方右侧边栏 / 对话顶部栏），只读镜像存储。
渲染是只读投影：一次渲染不是一次事务。唯一可选的写入 auditRenders 默认关闭；另一个只读进程 tools/viz-watch.mjs 可以在真实终端里持续刷新。

数据在哪、隐私如何

$DSH_HOME/anagenesis/
  journal/journal-000001.jsonl          追加式事件日志（全局命名空间，保留原命名）
  journal/journal-<ns>-000001.jsonl     每个项目/会话命名空间自己的段（物理隔离）
  journal/archive-<ns>-<seq>.jsonl      折叠后的归档，按命名空间分开（保留 undo）
  journal/checkpoint-<seq>.json         边界上的冻结状态（缓存，整库一份）
  snapshot.json                         原子启动缓存

记忆按命名空间分文件：project:<指纹> 与 session:<id> 的事件写进各自命名的段，全局记忆留在无前缀的 journal-*.jsonl 里 —— 所以"这条经验属于谁"在文件系统层面也成立，而不只是查询时过滤一次。
全本地：不联网、不下载模型、不调用模型、不启动子进程。
零运行时依赖：检索是内置 BM25 倒排索引 + 确定性哈希向量化器（192 维），真正的语义后端可以在运行时注入。
脱敏默认开：工具与窗口的输出默认 secrets —— 抹掉凭据形状的文本、省略正文；strict 连标签一起遮挡；none 是显式的本地调试逃生门，产物本身会就此发出警告。
旧目录兼容：默认 $DSH_HOME/anagenesis；若检测到改名前的 $DSH_HOME/evolution 数据更完整，会继续沿用旧目录并在日志里说明，一个字节都不搬。要搬就 npm run migrate:store（复制 + 逐文件 sha256 校验，源目录不动）。

配置（全部可选，全部有安全默认值）

内核行的关键旋钮：

键	默认	作用
`rootDir`	`$DSH_HOME/anagenesis`	存储根目录；显式设了就完全听它的（不再回退旧目录）
`safeMode`	`false`	冻结策略注册、切换与调参
`defaultScopeTier`	`project`	没有显式指定作用域时，记忆落在哪一层（`project` / `global` / `session`）
`sessionTtlMs`	`86400000`	会话级记忆的默认存活时间；`0` = 不过期
`recallCrossProjectDefault`	`false`	是否默认纳入其它项目的记忆（默认关闭：跨项目必须显式授权）
`workspace`	空	显式指定"当前项目"的工作目录；留空时用工具调用携带的 cwd
`recallDefaultTokenBudget`	`1600`	召回注入的默认 token 预算
`hookBudgetMs`	`8`	单个策略钩子的时间预算（超时按失败计，不拖住召回）
`compactAfterEvents`	`2000`	活跃事件超过它就压缩日志；`0` 关闭
`archiveMaxSegments`	`16`	归档段数上界（合并最老的段，不丢 seq）；`0` 不设界
`retainEvents`	`0`	唯一有损策略：只保留最近 N 条事件的归档段；`0` = 全留
`embedProvider`	`hash`	启动时用哪个向量后端；语义后端可在运行时装入
`reflectionEnabled`	`true`	定时反思：质疑证据已明显衰减的既有信念（只归档为草稿假设）
`updateCheck`	代码里 `off`，bundle 里 `npm`	新版本检查：`off` = 完全离线；`npm` = 每 6 小时读一次 npm 上的 `latest` 版本号（只读 GET，不带标识，不自动安装）
`updateCheckIntervalMs`	`21600000`	检查间隔（也是缓存的寿命）；默认 6 小时
`updateRegistry`	`https://registry.npmjs.org`	换镜像时改这里；只在 `updateCheck: npm` 时使用

其余：工具行 exposeAuditTool / exposeTuneTool；可视化行 lang / redaction / width / auditRenders 等；窗口包见 window/README.md。

常见问题

会拖慢每次召回吗？ 策略钩子有 8ms 预算、超时按失败计；读取走冻结快照，不上锁。

记忆会越写越乱吗？ 生命周期状态、置信度、重要度衰减、过期清扫、反事实重思都是显式工具，可以随时收拾。

卸载会留残留吗？ 每一行释放自己创建的效应（工具、服务、定时器、路由、席位）；卸载后 journal 句柄关闭、存储目录可以正常删除。

能换成真正的语义检索吗？ 能。运行时 service.useEmbedder(...) 装入后端，再 reembed() 把已存向量重算一遍；在那之前状态里会一直标记向量"陈旧"。

3likofj/dsh-anagenesis

dsh-anagenesis

一眼看懂它和"自动记忆插件"的差别

四个能立刻感受到的点

0.4.0 新增：先量，再改

基准（同一份语料，0.3.2 → 0.4.0）

0.3.0 新增：一个包，一块设施仪表盘

0.2.0 新增：记忆按项目隔离，预设成为权限开关

它在同类里的独特之处

三句话说明它是什么

作用域：记忆属于一个项目

预设是权限开关，不是建议

和典型「自动记忆」插件不一样在哪

安装

一条命令

从源码安装（想改代码、或跟进 main）

五分钟上手

能力地图（20 个工具，按权限分层）

注入策略：什么时候用哪副脑子

每一次变更都可以撤销

自我引导的边界（它为什么不会跑偏）

看得见

数据在哪、隐私如何

配置（全部可选，全部有安全默认值）

常见问题

许可证

Community comments

3likofj/dsh-anagenesis

dsh-anagenesis

一眼看懂它和"自动记忆插件"的差别

四个能立刻感受到的点

0.4.0 新增：先量，再改

基准（同一份语料，0.3.2 → 0.4.0）

0.3.0 新增：一个包，一块设施仪表盘

0.2.0 新增：记忆按项目隔离，预设成为权限开关

它在同类里的独特之处

三句话说明它是什么

作用域：记忆属于一个项目

预设是权限开关，不是建议

和典型「自动记忆」插件不一样在哪

安装

一条命令

从源码安装（想改代码、或跟进 main）

五分钟上手

能力地图（20 个工具，按权限分层）

注入策略：什么时候用哪副脑子

每一次变更都可以撤销

自我引导的边界（它为什么不会跑偏）

看得见

数据在哪、隐私如何

配置（全部可选，全部有安全默认值）

常见问题

许可证

Community comments

从源码安装（想改代码、或跟进 `main`）

从源码安装（想改代码、或跟进 `main`）