dsh-archived-digest · 归档会话提炼
把已归档的会话压缩成一条条记忆和可复用技能，统一存放管理；再可选地回收那些日志占用的磁盘空间。自动清理可以整个关掉，也可以手动挑选要提炼哪几个归档会话。
DSH 的归档只是把会话从列表里收起来——日志文件仍然完整躺在 $DSH_HOME/sessions/ 下，一条都不少。本机实测：77 条归档会话占 411 MB，其中绝大部分是重复的流式 chunk、工具结果、推理块，以及每一轮都被重新注入的环境说明。这些内容对后来的会话毫无价值，但它们一直占着磁盘，而且在归档列表里堆成一片噪音。
这个插件做的事很直接：把每个归档会话读一遍，只留下值得留的部分（结论、决策、坑、可复用的做法），写成人类和 agent 都能读的 markdown，然后把日志删掉。提炼在前，删除在后，顺序在代码里是强制的。
记忆层：事实、时效、主题
逐会话的摘要够用来"留个记录"，但不够用来"回忆"：77 个会话就是 77 段各自讲一角的文字，而真正想知道的是「这个项目我到底知道些什么」。
所以提炼之后还有一层，参考了社区里已经跑通的做法：
- 事实级写入（mem0）——把每个会话的结论拆成一条条事实，逐条决定
ADD / UPDATE / NOOP。同一件事换个说法说是 UPDATE（旧结论标 validUntil 退役，不删），一模一样是 NOOP（只刷新 lastSeenAt），只有新话题才 ADD。这样纠正过的结论不会和错误的旧结论并排躺着。
参考：mem0 的 ADD/UPDATE/DELETE 抽取管线
- 时效而非覆盖（Zep/Graphiti）——退役的事实保留
validUntil 和 supersededBy，所以"八月时我们以为是什么"仍然答得出来。
参考：Zep: A Temporal Knowledge Graph Architecture for Agent Memory
- 主题聚合——事实按主题聚成尽量少的几块，每块正文里的每个条目都带
^f00012 这样的出处，可以追回产生它的会话。整合是幂等的：主题是事实的纯函数，跑两遍不会变成两份。
- 可选导出——检测到本机装了记忆插件（OpenViking / Mnemon）时可以把聚合结果推过去；本地台账始终是真相源，推送失败只记录原因，不回写。
聚合这一层有两个坑，都靠能在真实台账上跑的数字才发现：
- 拿候选事实去和「簇里所有成员拼起来的长文本」比相似度是自毁的。候选只有一句话，而簇的文本随成员增加而变长，共享词占比反而下降——簇越大越难加入，正好反了。改成最近成员（single-linkage）：一个事实只要和簇里任何一条足够像就算同一主题。修前实测
127/156 个主题只含一条事实，等于没聚合。
- 光靠字面相似度根本跨不了会话。事实来自不同会话时，讲同一件事也常常不共享任何字：「碰撞体穿透」vs「ShipHullCollision 扫掠」的字面重合远低于任何阈值。所以每个事实还带一个主题名（subject）——由该会话记忆的标题给出——同一会话的事实天然同主题；老台账里没有主题名的事实会在整合时用标题回填一次。修后同一台账是
188/188 个事实进入多事实主题、共 7 个主题。
跑 node scripts/clustermetric.mjs 可以直接在真实 facts.json 上打出聚类分布——区分「在聚合」和「没在聚合」只能靠这个数。
相似度用的是免 embedding 的混合度量（拉丁词 Dice + 中文单字 Dice）。这里踩过一个坑：最初用中文二元组，结果是「日志要先按 magic 切帧」和「日志需要按 magic bytes 切帧」只得了 0.33——人类的同义复述被判定为不同事实。换成单字集合后同一对是 0.77，而不相干的两句稳定在 0.05 以下。阈值因此落在 0.5（合并）与 0.3（聚类）这两个空档里。
它产出什么
$DSH_HOME/archived-digest/
├── memories/ # 一个归档会话 → 一条记忆 <slug>.md
│ ├── <slug>.md
│ └── index.json
├── skills/ # 可复用的做法 → 一个技能 <name>/SKILL.md
│ ├── <name>/SKILL.md
│ └── index.json
├── facts.json # 事实台账（含 validUntil 历史）+ 聚合出的主题
├── trash/ # cleanupMode=trash 时的回收站
├── state.json # 哪些提炼过 / 失败过 / 清理过
└── settings.json # 面板里的设置（唯一真相）
技能同时发布一份到 $DSH_HOME/skills/<name>/SKILL.md——这是技能中心和 agent 技能目录扫描的位置。只写在插件自己的目录里，技能就只会在本面板里可见，agent 永远加载不到（这个缺口在开发时抓到并补掉了，见 scripts/mirrortest.mjs）。发布失败（比如同名技能是你手写的）不会覆盖对方的文件，面板里会标成「同名技能已存在，未覆盖」。
面板
左侧栏多一个「归档会话提炼」入口（order: 12，在 github-manager 之后），九个标签页：
- 总览 — 归档条数、磁盘占用、提炼进度、自动开关状态、最近几次跑批记录。
- 归档会话 — 一列所有归档会话，带状态徽章（待提炼 / 已提炼 / 已清理 / 失败 / 缺失 / 已固定）。前有复选框，可以手动勾选要提炼哪几个；顶部有「全选待提炼」「提炼所选」。
- 进行中 — 未归档的实时会话（见下节）。每行显示水位线
lastSeq、待提炼字节数，带「只读」徽章；可以整批提炼，也可以只提炼某一条的新内容。
- 主题记忆 — 聚合出的主题，每个条目带
^f00001 出处；顶部有「重新整合」「导出到记忆后端」和检索框。
- 事实 — 事实台账：文本、类型、强度、出处；「显示已失效」展开被取代的旧事实（带
→ 新 id）；每条可以「忘记」（唯一会真正删行的操作，会二次确认）。
- 记忆 — 逐会话的 markdown 记忆，可搜索、可展开看原文。
- 技能 — 已提炼的技能，标注是否已发布到技能中心。
- 自检 — 测量与压缩记忆本身（见下节）。「只统计，不改动」和「执行精简」是两个分开的按钮。
- 设置 — 下面那些开关，改完即存。
设置
| 键 | 默认 | 含义 |
|---|
autoEnabled | false | 后台自动提炼总开关。默认关闭，因为提炼要花 token |
autoIntervalMinutes | 30 | 自动跑批间隔 |
autoMaxPerRun | 3 | 每次自动跑批最多提炼几个会话（串行，避免抢你交互的 token） |
autoRetryFailed | true | 失败过的会话下次是否重试（最多 3 次） |
cleanupMode | 'off' | 提炼成功后怎么处理日志：off / logs（只删 .zstd）/ dir（删整个会话目录）/ trash（丢回收站） |
cleanupMinAgeDays | 7 | 只清理日志 mtime 超过这么多天的会话 |
extractSkills | true | 是否顺带提炼可复用技能 |
extractFacts | true | 是否把结论拆成事实行进台账（去重/可被取代） |
autoConsolidate | true | 提炼后是否自动重算主题 |
exportToBackend | true | 整合后是否推给已挂载的记忆插件（没有就跳过） |
captureLiveSessions | false | 是否也提炼未归档的实时会话（见下节） |
liveMaxPerRun | 2 | 每次自动跑批最多提炼几个实时会话 |
liveSettleSeconds | 90 | 实时会话静默多少秒后算结束 |
incrementalLiveCapture | false | 对进行中会话做增量提炼（只读，见下节） |
incrementalMinEvents | 40 | 新事件少于这么多就不值得调一次模型 |
selfCheckEnabled | false | 后台定期自检精简 |
selfCheckIntervalMinutes | 720 | 自检间隔 |
selfCheckApply | false |
三处需要强调：
自动提炼默认是关的。 关着的时候调度器仍然每 60 秒醒一次，但只读设置、什么都不做。要它自己干活，得在面板里打开。
cleanupMode 默认 'off'。 提炼完不会自动删任何东西，直到你显式选一种清理模式。即使选了，也只会动已经有记忆落盘的会话——没有记忆的会话会被拒绝（NOT_DIGESTED），除非走强制路径。
captureLiveSessions 默认 false。 见下节。
实时会话：为什么「刚聊完的」原来不在范围内
这是个容易被忽略的边界：没有归档的会话，本插件看不到。 归档动作由你触发，所以一段刚结束的对话要等你归档它才可能进记忆——而大多数人从不归档，于是记忆一直是空的。本机实测：某天写了 11 个会话，其中归档数为 0；全机 502 个会话里只有 77 个是归档的。
打开「提炼实时会话」后，本插件会把已静默的未归档会话也当作提炼对象。
不需要任何会话钩子。 这一点是实测出来的，不是猜的：正在进行的会话，它在磁盘上的日志已经完整且同步——从一段运行中的会话解出了 23609 个事件，包括它的最后一句话（见 scripts/livee2e.mjs）。日志按 flush 追加，所以「日志不再变化」就等于「这段对话结束了」，不需要向宿主询问任何东西。
静默窗口（默认 90 秒）。 正在写的会话不会被提炼，否则只会记住半截对话；下次跑批再收它。窗口比任何一次模型调用加长工具执行的时间都长。
成本是有意的上限。 未归档会话很多（本机 426 个 / 245 MB，其中 422 个已静默），所以实时通道单独限流（默认每轮 2 个），不会把归档那部分的任务挤掉。这也是它默认关闭的原因。
安全不变式：清理永远只作用于归档会话。 cleanup 的 id 映射只从归档清单构建，所以实时会话不可能被删——实时通道只写记忆，从不回收磁盘。scripts/livetest.mjs 把这条钉住了。
「没有可记的」不是失败。 一行字的会话被记为 state.skipped 而不是 state.failed，否则几百个短会话会把真正的失败埋掉；同时它也不会每轮都被重新解码。
进行中的会话：只读增量提炼
上一节的实时通道有一个说不出口的缺陷：它等会话静默才动手，于是你今天正在聊的这一段永远不会进记忆——而聊得越久的那一段，恰恰是最该被记住的。
增量通道解决这个，并且遵守一条硬约束：会话日志一个字节都不改。
怎么做到的。 每个事件的 JSON 里带一个单调递增的 seq（实测本会话 8350 个事件里 8349 个有 seq，且严格递增；唯一没有的是文件首行的 session 头事件，它自己就是第 0 条）。所以「提炼到哪了」可以表达成一个整数水位线，存在插件自己的 <store>/live-cursors.json 里——永远不写进会话日志。下一轮只读 seq > lastSeq 的事件。
怎么证明它是只读的。 不能靠「sha256 没变」——进行中的会话本来就在被 agent 追加写，整文件哈希每一轮都在变。判据必须是前缀不变：记录上次的大小与前缀哈希，之后只比对 buf.subarray(0, beforeSize)。scripts/appendcheck.mjs 做的就是这个，实测输出 +0 bytes appended / prefix IDENTICAL / RESULT: append-only。
怎么标注已提炼部分。 三层，都落在插件自己的存储里，不碰会话：
- 水位线
lastSeq —— 面板「进行中」每行显示它，以及「已是最新」/「有新内容 X MB」。
- 游标还记
segments 与 bytesAtDigest，所以一段会话被反复提炼多次是可数的。
- 记忆条目带
partial: true，渲染时也标明这是部分提炼。
回退保护。 会话日志被截短（detectRewind）时水位线重置到 0，而不是永远跳过。否则一次日志损坏会让你此后再也读不到这段会话。
部分提炼的会话不能被清理。 只提炼到 seq=9646 的会话，它的完整内容还没进记忆；cleanupSession 因此加了一道 PARTIAL_DIGEST 门禁，拒绝删这种会话的日志。同时 needsDigest 让 partial 会话仍然可以接受一次完整提炼——否则它会卡在「既不能清理、也不会再提炼」的死角里。
自检精简：记忆自己也会变脏
提炼会不断往里加东西，时间一长记忆自己就成了新的噪声源。自检就是回头收拾它。先测量，再决定要不要动手——这两个动作在面板上是两个分开的按钮。
为什么技能目录是最大的成本。 技能会被宿主注入每一轮对话，所以它是永久开销，而且单调增长。本机实测：142 个技能、12841 字符、约 3669 token 每一轮。这比 facts 台账的噪声严重得多，所以自检把它排第一位。
三类动作，风险递增：
| 动作 | 做什么 | 默认 |
|---|
| 重复事实合并 | 文本高度相似的同 kind 事实，保留强的、把弱的标 validUntil + supersededBy | 测量时只报告 |
| 失效事实清理 | 强度低于地板的 open 类事实标为失效 | 同上 |
| 重复技能合并 | 名字/描述高度相似的技能合成一个 | 默认关，需显式勾选 |
永远不会 delete。 除了用户手动「忘记」，自检对事实只做 supersede——保留 validUntil、supersededBy、supersededReason，所以随时能看见「这条为什么被取代」。
阈值为什么是 0.75 而不是写入期的 0.5。 在真实 1755 条事实上标定过：0.5–0.6 是「同话题不同事实」的假阳性带（例如 0.510 的「把代码注释里的历史断言与 git 提交版本对质」vs「会话未提供 git 是否可用的信息」——这显然是两件事）。0.9 以上才是真复述。写入期用 0.5 是因为那条路径有人看着、且合并是可逆的；无人值守的 housekeeping 不能拿 0.5 赌，静默毁掉两条不同事实不可接受。实测在 0.75 下 100 个候选对收敛到 8 组真重复。
「只统计」也会算完整代价。 测量那一次仍然要比较 153 万个事实对（本机实测 pairsCompared: 1539135）——所以它是按钮，不是每秒轮询的东西。后台自检默认关闭（selfCheckEnabled: false）。
Agent 工具
注册了一个 archived_digest 工具，所以你也可以直接在对话里让它干活：
action: status # 库存与进度
action: sessions # 列出归档会话
action: digest # 提炼（可带 sessionIds）
action: cleanup # 清理已提炼的会话
action: memories # 逐会话记忆列表
action: skills # 技能列表
action: inspect # 预览某个会话会被提炼成什么（不花 token）
# 记忆层
action: topics # 聚合出的主题
action: facts # 事实台账（含失效历史）
action: recall # 检索记忆（query=...）
action: remember # 手动加一条事实，走同一套合并管线
action: consolidate # 重算主题
action: export # 推给已挂载的记忆插件
# 进行中会话与自检
action: live # 未归档的实时会话（含水位线）
action: live-digest # 对进行中会话做只读增量提炼
action: selfcheck # 测量或执行记忆精简（apply / mergeSkills / purgeTrash）
action: health # 一次拿全：事实、技能目录成本、回收站、游标
inspect 只是解码加去噪，不调模型，适合先看看这个会话到底有没有值得留的东西。remember 也走同一个合并管线，所以你补一条和已有结论同义的事实会更新它，而不是并存。
和记忆插件的关系
本机装过三个记忆插件，但它们的状态不一样，这决定了插件怎么对接：
| 插件 | 本机状态 | 对接方式 |
|---|
@openviking/dsh-memory-plugin | 已启用，但服务端 127.0.0.1:1933 从未监听 | 只做检测：它 provide('openvikingMemory') 但没有文档写入 API，只有会话捕获。明确返回 NO_WRITE_API 而不是伪造一次调用 |
dsh-mnemon | 已安装但未启用（不在 bundles 里） | 检测 mnemon_* 工具，有就调 mnemon_remember |
memory-eternal | 已安装但未启用 | 未对接 |
判据写在 lib/backends.js 里：本地台账是真相源，后端只是镜像。导出失败记录原因并显示，不回写台账；没有后端时面板直接说「本地存储就是唯一落盘处」，而不是给一个点了没反应的按钮。
安装
# 从 GitHub 装（推荐）
dsh plugin add github:LLL-lyh0/dsh-archived-digest
# 或者先 clone 再按本地路径装
git clone https://github.com/LLL-lyh0/dsh-archived-digest
dsh plugin add link:./dsh-archived-digest
装完重启宿主才生效（bundles 只在启动时读一次）。
本插件依赖宿主自带的 @deepseek-ai/dsh-llm（LLM 后端），以 peerDependencies 声明、optional: true。它是懒加载的：加载不到时插件不会挂掉，而是退化成"只做本地提炼、不调模型"。
从源码开发
把插件目录链进 profile 的 node_modules，改源码即刻生效。必须是链接，不能是拷贝——用 cp -r 或某些 ln -s 在 Windows 上会得到一份拷贝，之后改源码不再生效，而且不报任何错：
cmd //c "mklink /J dsh-archived-digest D:\path\to\dsh-archived-digest"
stat -c '%i' node_modules/dsh-archived-digest/index.js /d/path/to/dsh-archived-digest/index.js
# 两个 inode 必须相同
探针确认插件真的加载了：
curl -s -o /dev/null -w "%{http_code}\n" http://127.0.0.1:58902/api/dsh-archived-digest/status
# 200 = 已加载；401 = 没加载（宿主网关直接拒了）
测试
node scripts/selftest.mjs # 解码 / 提炼 / 清理 / JSON 修复 / 截断收缩，22 项
node scripts/hosttest.mjs # 假 ctx 挂载整个 Host，37 项
node scripts/clienttest.mjs # 迷你 React 渲染面板（含 9 个 tab），90 项
node scripts/memorytest.mjs # 事实合并 / 时效 / 主题 / 检索 / 后端，27 项
node scripts/livetest.mjs # 实时会话范围 / 静默窗口 / 清理不变式，21 项
node scripts/incrementaltest.mjs # 水位线 / 增量取数 / 回退 / 部分提炼门禁 / 自检阈值，27 项
node scripts/assemblertest.mjs # 流式分片归类 / 降级 shim / 预算升级，27 项
node scripts/copytest.mjs # 面板语言：中文界面必须是中文，16 项
node scripts/skillcompat.mjs # SKILL.md 对技能中心可解析，23 项
node scripts/mirrortest.mjs # 技能发布与不覆盖用户技能，14 项
node scripts/e2e.mjs # 真实归档会话（63.6 MB / 4063 轮）走完提炼 → 事实 → 主题
node scripts/livee2e.mjs # 真实未归档会话（27 MB / 501 轮）同样走完整条路
node scripts/seqprobe.mjs <session-id> # 打印该会话的 seq 水位线与 compaction 取证
node scripts/appendcheck.mjs <session-id> snapshot|verify # 证明日志前缀未被改动
node scripts/dupecalibrate.mjs # 在真实 facts.json 上标定重复阈值（不是测试，是判据）
node scripts/clustermetric.mjs # 在真实 facts.json 上打出聚类分布（不是测试，是判据）
全部离线跑，不发网络请求，不碰真实 store。测试里临时改了 DSH_HOME 或 DSH_ARCHIVED_DIGEST_SKILLS，所以不会往你真实的 ~/.dsh/skills 里丢假技能。
记忆层的关键性质都配了反向验证——把实现改回错误的写法，对应用例必须变红。已验证的有：改回粗粒度分词会让三条用例红（同义复述被判为新事实）；让 validUntil 不落盘会让三条红；去掉检索相关性闸门会让「不相关查询返回 0 条」变红（它返回了全部 3 条）；去掉静默窗口会让「正在进行的会话不该被提炼」变红；去掉归档排除会让「实时清单不得包含归档会话」变红（它多吐了一条）；把流分片里的 reasoning-delta 改回写进 text 槽位会让 5 条红，忽略 finish.reason 会让 3 条红；让主题聚类的 subject() 无视显式主题名，会让「同一主题、毫无共同用词的两条事实必须聚到一起」变红（它裂成了 2 个主题）；把「截断后缩小输入」的循环停掉，会让「截断的提炼要缩小转录而不是只加预算」变红（它报 MAX_TOKENS 而不是成功）；把面板「只统计」的 apply: false 改成 true，会让「测量不得改动数据」变红（incrementaltest 里另有 8 个 mutation 覆盖水位线与自检阈值）。
十四个实现上的坑（都已在代码里处理）
zstd 日志是多帧追加的。 zstdDecompressSync(整个文件) 和流式解码都只吐出第一帧——一个 16703 字节的文件只解出 211 字节，看起来像"日志是空的"。正确做法是按 magic bytes 28 b5 2f fd 切帧逐段解压（lib/session-log.js 的 decodeZstdFrames）。
单条 tool/result 可以到 12958 字符。 直接喂给模型会把上下文塞满，还会把 token 预算烧光在 glob 文件清单上。所以解析时只取 user/message 和 assistant/message 的 text 块，推理块和工具结果一律丢弃；再剥掉每轮注入的 <system-reminder>、<available_skills>、<environment_context> 整块。一个 174 轮、3.7 MB 的会话，去噪后送去提炼的正文是 14292 字符。
自动清理的顺序必须是把 state 落盘再删。 cleanupSession 会从磁盘重读 state 来判断这个会话到底提炼过没有；如果 digestOne 只在内存里 recordDigest 就去调它，读到的还是"未提炼"，于是被 NOT_DIGESTED 挡回去——而提炼本身是成功的，所以界面上一切正常，只有磁盘没被回收。这个 bug 一度存在，scripts/selftest.mjs 里的 digestOne honours cleanupMode by itself 就是为它加的回归（撤掉那行 writeState 该用例会红）。
document.documentElement.lang 在客户端插件加载时还是空的。 locale 服务要稍后才写这个属性，而 '' 不以 zh 开头，所以 lang.startsWith('zh') ? zh : en 会落到英文分支；更糟的是 const t = pickCopy() 只在工厂执行时算一次，整个会话就一直是英文。修法：改成每次取用时现读（activeLanguage()，空值按中文兜底，再看 navigator.languages），并把 t 换成 Proxy 让 t.xxx 每次解析当前语言——这样在设置里切语言不用刷新页面。scripts/copytest.mjs 把这条钉住了：撤掉修复该用例会红。
宿主只在启动时快照客户端 bundle。 dsh-client-modules 用 readFileSync 在激活时读一次 client.js 缓存成 record.bundle，HMR 只重载 ESM 模块、不会重建客户端 combo。所以改完 client.js 必须重启宿主，否则浏览器拿到的还是旧代码，而且不会有任何报错。
「会话」和「归档会话」不是一回事，这个差集会把功能整体架空。 插件最初的取数口是 workspace.json 的 archivedSessionIds，而没有归档动作的会话永远不在里面——于是"边聊边攒记忆"完全不会发生，而且不报任何错：面板照常显示 77 条归档、进度正常、没有任何失败。实测本机 502 个会话里只有 77 个已归档，某天新写的 11 个全是 0 归档。修法是补一条实时通道（listLiveSessions + 静默窗口），并且在设计时确认了一个关键事实：正在进行的会话，它在磁盘上的日志已经是完整的（从一段运行中的会话解出 23609 个事件、含最后一句），所以实时提炼不需要任何会话钩子，只需要一个"日志不再变化"的静默判据。
中文相似度不能用二元组。 中文没有空格，二元组看起来是自然选择，但它对同义复述几乎失效：「日志要先按 magic 切帧」vs「日志需要按 magic bytes 切帧」只共享 日志 一个二元组，得分 0.33——低于任何合理阈值，于是同一件事会被反复 ADD 成多条。换成单字集合的 Dice 后同一对是 0.77，而无关句仍稳定在 0.05 以下。scripts/memorytest.mjs 里改了会红的正是这两条。
检索必须有相关性闸门，不能只靠权重。 原来的 score = relevance*0.7 + strength*0.3 里，一条完全不相干的事实也能靠强度拿到 ≈0.25 分，于是「这次查询没有命中」被表达成「返回全部事实，按新旧排序」——使用者看到一堆结果，却一条都不对题。修法是先过 MIN_RELEVANCE（0.12）再算分；现在无关查询返回 0 条。
推理通道会泄进正文，而且「被截断」会被当成「成功」。 import('@deepseek-ai/dsh-llm') 从插件位置解析会抛 ERR_MODULE_NOT_FOUND（profile 的 node_modules/@deepseek-ai/ 下只有 cosmokit 和 schemastery），所以实际跑的是包内自带的降级 assembler。它最初把所有 *-delta 都追加进同一个字符串，于是模型的思考（"We need produce JSON only. Need compress session…"）被当成回复正文，JSON 解析必然失败——表面症状是「模型没返回 JSON」，真因是分片归类错了。修法是按 ${index}#${分片自身声明的类型} 建槽位，并且认 finish.reason：reasoning-delta 永远进不了 text 通道，max-tokens 会被如实报成截断而不是成功。scripts/assemblerprobe.mjs 打印真实分片形状，scripts/assemblertest.mjs（27 项）把这两条钉住——把 reasoning 改回 text 会让 5 条红，忽略 finish.reason 会让 3 条红。
Windows 路径原样写进 JSON 就是一个坏转义。 模型把 "cwd": "D:\\DeepSeekHarness" 写成 "cwd": "D:\DeepSeekHarness"，而 \D 不是合法 JSON 转义，JSON.parse 报 Bad escaped character in JSON at position 228——整个会话的记忆就这么没了，日志里只留一句「不是 JSON」。修法是修好而非放弃：已知转义（" \ / b f n r t）和 \uXXXX 原样保留，其它反斜杠一律补成真转义。另外输出被截断时会按预算阶梯重试（更大 maxTokens），而不是直接判失败。
「聚合」这个功能会静默地完全不聚合。 主题是把事实聚成尽量少的几块，但它不报错：面板上「156 个主题」看起来像是聚得很细，实际是 127 个主题各含一条事实——等于没有聚合。两个独立原因叠在一起：① 拿候选事实去和「簇内所有成员拼起来的长文本」比相似度，簇越大分母越大、越难加入，正好反了；② 跨会话讲同一件事的两句话常常不共享任何字（「碰撞体穿透」vs「ShipHullCollision 扫掠」），字面相似度永远过不了阈值。修法是最近成员比较加每个事实带主题名（取自该会话记忆的标题，老台账整合时回填），同一台账变成 188/188 个事实进入 7 个多事实主题。判据是能在真实文件上跑的数字：node scripts/clustermetric.mjs。
被截断时加大预算是错的，该缩小输入。 有一个真实归档会话连续三次失败：output hit the maxTokens=8000 ceiling and was truncated (reasoning 17853 chars before the answer) —— 8000 的输出预算全花在思考上，一个答案字符都没写出来。原来的重试只是在 MAX_TOKENS_CEILING = 8000 内翻倍预算，对这种「思考占满预算」的情况，加预算只会买到更多思考。修法是反过来缩输入：lib/digester.js 保留解码后的事件列表（read.eventList），遇到 MAX_TOKENS 就把 maxSourceChars 减半重新抽取正文再试，下界是 max(1500, 25%)；要思考的东西少了，答案才装得下。同一个会话缩到 6628 字符后一次性成功。回归在 selftest.mjs 的「a truncated digest shrinks the transcript instead of only raising the budget」，停掉这个循环就会红。
改 touch cordis.patch.yml 不会重载插件，看起来"验证通过"其实跑的还是旧代码。 在 index.js 里加 const BUILD = 'xxx' 并让 /status 返回它之后才看清：touch 只改了 mtime，宿主仍在跑旧模块图（build: undefined）；必须改文件内容（哪怕追加一行注释）才会触发 watcher。这条元缺陷会让所有"修完再验一遍"的结论都不可信，所以 scripts/reload.sh <build> <port> 会改内容、等待、并断言 /status 里的 build 与传入值一致，不一致就报错退出。
进行中的会话在线，"已清理"的会话不在线，两者都会被算成"丢了"。 findSessionDir 只在 sessions/<slug>/<id> 里找，所以已经清理到 trash/ 的会话找不到——面板于是显示「38 缺失」，和「38 段对话被弄坏了」在界面上完全无法区分，而这 38 个其实都还能恢复。修法是 trashedSessionIds() 去 trash/ 里反查，并且要同时认两种目录名（trash 目录名过了 sessionSlug()，session- 前缀被剥掉了，真实名形如 01231136-…-1793096037689）。修后 39 present + 38 cleaned + 0 missing = 77。selftest.mjs 里三条用例钉住这个分区。
只有部分记忆的会话，既不能删也不能再提炼——除非你特意开一扇门。 增量提炼只会记到当前水位线，所以那种会话的完整内容还没进记忆；cleanupSession 因此加了 PARTIAL_DIGEST 门禁拒绝删它。但只看这一条会制造死角：needsDigest 原本用 if (session.digestedAt) continue，于是这个会话永远拿不到一次完整提炼，永远停在"不能删、不再提炼"。修法是判据改成 if (session.digestedAt && !partial) continue。
许可
MIT
