Skip to content

Commit 3162272

Browse files
committed
feat(continuity): 压缩边缘双落点(#249 N3)
上下文即将被宿主压缩前抢救「正在做什么」,让它活过这次压缩。**必须双落点**: 落一条提案到新表,再把同一份快照追加成序列末尾的插件消息——宿主的压缩摘要器 只看对话里的内容,只放系统提示段等于白写(#249 §4.4)。 - 触发不自定阈值,直接订阅宿主真的压缩(compaction/start|summary|end):压缩插件 在自己那一步先压缩再 return next(),所以我们在 agent/pre-step 拿到结果时边缘已 落库;返回的 decision.messages 由宿主以 surfaceOp:append 追加,晚于压缩的 replace——落点天然在压缩之后。 - 新表 continuity_proposals:(session_id, kind) 唯一键,再次触发是刷新而不是新增; status/edge_seq 就地支撑 §8 要求的触发率与采纳率统计;队列满则弃新(200 条, 不淘汰旧行——旧行是别的会话还没转正的工作状态),丢弃会留痕。 - 三字段确定性抽取(最近一条真实 user/message 取头部 200 字符、最近一条 assistant/message 取尾部 200 字符、open_questions 判不出就留白),全程不调模型。 - 注入按「统一前缀 + 全文」在**当前表面**上判重,同文本不追加第二次(DSH 没有 in-memory 消息改写钩子,这是形态上限);按表面而不是全量日志判重,是因为被 压缩折叠出表面的旧注入仍在 append-only 日志里,照日志判重会让该补的一次静默跳过。 注入物用 source.kind=plugin,不会被下一轮蒸馏成记忆。 - 写侧两条不变量:监听器绝不把宿主的这一步带崩(落库失败只告警、注入照做,注入不 依赖库);落库是单条 UPSERT,多进程共库 WAL 下由唯一键裁决,先查后插会撞约束。 - 新开关 continuityRescueEnabled:autoInject 的子项、默认关(新注入表面), lightMode 强制关;落点 config.js schema + settings.js 白名单 + 面板 FEATURE_CHILDREN 与双语文案,跨文件关系由 test/inject-parent-gate.test.js 钉住。 - 降级路径:宿主无压缩前时机时把规则写进 memory_save 描述交给 agent 自判,不算失败 (本批不做宿主能力探测,子开关打开即常驻)。 - 回归 14 条(test/continuity.test.js)、新文档 docs/CONTINUITY.md、CHANGELOG。
1 parent fc03ff3 commit 3162272

19 files changed

Lines changed: 1217 additions & 15 deletions

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,26 @@
7777

7878
## [Unreleased]
7979

80+
## 🆕 新增
81+
82+
- **压缩边缘双落点(issue #249 N3)**:上下文即将被宿主压缩前抢救「正在做什么」,新增
83+
opt-in 键 `continuityRescueEnabled`(注入父开关 `autoInject` 的子项,默认关;`lightMode`
84+
强制关)。**必须是双落点**:①落一条连续性提案到新表 `continuity_proposals`(脱离对话
85+
独立存活);②把同一份快照追加成序列末尾的插件消息——宿主的压缩摘要器**只看对话里的
86+
内容**,只放系统提示段等于白写。触发不自定阈值,直接订阅宿主真的压缩
87+
(`compaction/start|summary|end`):压缩插件在自己那一步先压缩再 `return next()`,所以
88+
我们在 `agent/pre-step` 拿到结果时边缘已落库,而返回的 `decision.messages` 由宿主以
89+
`surfaceOp: "append"` 追加,晚于压缩的 `replace`——落点天然在压缩之后。三字段
90+
(`current_work` / `next_step` / `open_questions`)用确定性抽取、**全程不调模型**:
91+
最近一条真实 `user/message` 取头部 200 字符、最近一条 `assistant/message` 取尾部 200
92+
字符(下一步活在末尾那句里),`open_questions` 判不出就留白(注入文本里如实标 `none`,
93+
不编造)。提案行按 `(session_id, kind)` 唯一键落「同一会话同一类只留一条」:再次触发是
94+
刷新而不是新增,`status`/`edge_seq` 就地支撑 #249 §8 要求的触发率与采纳率统计;**队列满
95+
则弃新**(200 条,不淘汰旧行——旧行是别的会话还没转正的工作状态)。注入按「统一前缀 +
96+
全文」判重,同文本不追加第二次(没有 in-memory 改写钩子,这是形态上限)。宿主若无压缩前
97+
时机则**降级为持久规则**(写进 `memory_save` 描述交给 agent 自判),不算失败、不要求宿主
98+
加接口。新增回归 14 条(`test/continuity.test.js`),新文档见 [docs/CONTINUITY.md](docs/CONTINUITY.md)。
99+
80100
## [0.8.6] - 2026-09-23
81101

82102
## 🆕 新增

‎dsh-mneme/docs/CONTINUITY.md‎

Lines changed: 122 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,122 @@
1+
# dsh-mneme 压缩边缘抢救(issue #249 N3)
2+
3+
- **日期**:2026-09-24
4+
- **状态**:✅ 已实现(opt-in,默认关)
5+
- **范围**:上下文即将被宿主压缩前,抢救「正在做什么」,让它活过这次压缩
6+
- **相关文档**:[存储与回收](STORAGE.md)(同批的 #275 第一批) · [语义增强](SEMANTIC.md)
7+
8+
## 1. 问题
9+
10+
宿主的压缩摘要器只看对话里的内容:压缩时它按固定字段模板重建对话(Current Work /
11+
Next Step / Critical Context 等),**系统提示段里的东西不进这次重建**。所以任何"只放在
12+
提示段里的工作状态",一过压缩就等于没写过。
13+
14+
## 2. 形态:必须双落点
15+
16+
| 落点 | 去处 | 为什么不能省 |
17+
|---|---|---|
18+
| ① 落提案 | `continuity_proposals` 表(`src/store.js`) | 脱离对话独立存活;注入失败/被跳过也不丢工作状态 |
19+
| ② 追加消息 | 序列末尾一条 `user/message`(`source: {kind: "plugin", plugin: "dsh-mneme"}`) | 这是唯一能进宿主摘要器重建范围的落点 |
20+
21+
落库先于注入。落点顺序由宿主契约保证:压缩插件在自己那一步先压缩、再 `return next()`,
22+
所以我们在 `agent/pre-step` 拿到 `next()` 结果时压缩事件已落库;而我们返回的
23+
`decision.messages` 由宿主在本步末尾以 `surfaceOp: "append"` 追加,晚于压缩的
24+
`surfaceOp: "replace"`——追加物天然在压缩之后、靠近序列末尾。
25+
26+
注入文本是**结构化快照**(统一前缀 + 三行固定字段,整条 ≤900 字符),不是 §6.3 那种
27+
≤160B 的单行提醒——那条上限约束的是"一句话提醒",不约束固定字段的快照;字段内部的换行
28+
仍会被压平成空格,保证它仍是一条消息。**判重按当前表面**(`session.surface.nodes`),
29+
不按全量日志:被一次压缩折叠出表面的旧快照还在 append-only 日志里,照日志判重会让这次
30+
该补的注入静默跳过。
31+
32+
## 3. 触发
33+
34+
**不自定阈值**,就是订阅宿主真的压缩:`compaction/start` / `compaction/summary` /
35+
`compaction/end`(都在宿主的事件白名单里)。理由:「压缩边缘」由宿主定义,我们再校准
36+
一份阈值参数只会与之漂移,还多一份没人维护的旋钮。
37+
38+
DSH 没有 in-memory 消息改写钩子,所以本机制一律是「注入 + 序号引用寻址」,**不改写
39+
历史消息本体**。
40+
41+
## 4. 字段与抽取口径
42+
43+
固定三字段(不用自由散文),全程不调模型、纯确定性抽取(`src/continuity.js`):
44+
45+
| 字段 | 来源 | 截断 |
46+
|---|---|---|
47+
| `current_work` | 最近一条**真实** `user/message`(插件注入与子代理上报不算用户指令) | 头部 200 字符 |
48+
| `next_step` | 最近一条 `assistant/message` | **尾部** 200 字符(下一步活在末尾那句里) |
49+
| `open_questions` | 恒 `null` | —— |
50+
51+
「哪些问题还没解决」判不出就是判不出,硬猜会给出似是而非的字段;空字段在注入文本里
52+
如实标 `(none)`。这个字段留给转正通道与人工补。
53+
54+
字段名以 #249 §6.2 为准(`current_work` / `next_step` / `open_questions`)。§4.4 里的
55+
Current Work / Next Step / Critical Context 是**宿主压缩模板**的字段名,不是这张表的列名
56+
(规格里两处用词不同,实现取 §6.2)。
57+
58+
## 5. 存储与生命周期
59+
60+
```
61+
continuity_proposals(id, session_id, kind, current_work, next_step, open_questions,
62+
status, edge_seq, created_at, updated_at)
63+
UNIQUE (session_id, kind) -- 「同一会话同一类只留一条」:再次触发是刷新,不是新增
64+
```
65+
66+
- `kind`:`compaction-edge`(一次会话里这一类只留一条)。
67+
- `status`:`pending`(本批唯一写入态)→ 未来 `promoted` / `discarded`(转正通道与
68+
#254 的二次确认共用一套,阶段二才打开)。
69+
- **队列满则弃新**(`MAX_CONTINUITY_PENDING = 200`):达上限丢掉本次触发,而不是淘汰
70+
旧行——旧行是别的会话还没转正的工作状态,用「更近的边缘」把它挤掉是反的。满队列
71+
不影响已有行的刷新。
72+
- 丢弃会**留痕**(`agent/pre-step` 监听器 `logger.warn`):弃新属于"静默失效",不报出来
73+
的话 §8 的触发率口径会把它算成"没触发"。
74+
- **本批没有回收路径**:`status` 只写 `pending`,`maintenance`/`reclaim` 不碰这张表,
75+
所以 200 是上限——满了之后新会话不再落行,直到转正通道打开(阶段二)。判定是进程内的
76+
(先查计数再写),两个宿主共用同一 `memoryDir` 时可能各自都看到未满,实际越过 200 条。
77+
- `edge_seq` 记最近一次触发的压缩事件序号,是「实际触发率」的证据。
78+
- 落库失败只告警、不抛:可选插件的故障不该把宿主的这一步变成失败,而注入那一半不依赖
79+
库,照做。
80+
81+
指标口径(#249 §8 要求触发率/采纳率可统计):实际触发率 = 提案行数;采纳率 =
82+
`promoted` / 全部。两者都是就地读表,不需要额外打点。
83+
84+
## 6. 开关
85+
86+
| 层级 | 键 | 默认 |
87+
|---|---|---|
88+
| 父 | `autoInject` | 开(既有总闸) |
89+
| 子 | `continuityRescueEnabled` | **关**(引入新注入表面,按 #249 §10 判据独立成键) |
90+
91+
父关则子不生效(`injectChildEnabled`);`lightMode` 强制关。面板落点在 `lib/client.js`
92+
的 `FEATURE_CHILDREN` / `FEATURE_GROUPS`(该文件无 src 对应物),跨文件关系由
93+
`test/inject-parent-gate.test.js` 逐个断言钉住。
94+
95+
## 7. 降级路径(不要求宿主加接口)
96+
97+
宿主若不提供可挂钩的压缩前时机,双落点里的 ② 就没有触发者。这时**不算失败**:把规则
98+
写成持久规则交给 agent 自判(`src/guide.js` 的 `CONTINUITY_TOOL_RULE`,挂在
99+
`memory_save` 的工具描述尾部——常驻文本、零注入成本,只在子开关开启时出现)。
100+
101+
本批**不做宿主能力探测**(没有可靠的探测口,宿主也没有暴露"有没有压缩前时机"这个事实),
102+
所以子开关打开时这条规则就常驻,与 ② 并存——两者不是互斥的备选,而是同一个开关下的两层:
103+
② 在宿主真的压缩时自动生效,持久规则在 agent 自己判断"上下文要炸了"时兜底。
104+
105+
## 8. 已知坑
106+
107+
- **判重只能做到「同一份文本不追加第二次」**。没有改写钩子,就不能删掉表面里已经存在
108+
的那条旧快照;内容一变就是新的一份(旧的那份随宿主压缩自然消失)。这是形态上限,
109+
不是实现偷懒。
110+
- **注入物不得变成记忆**:追加消息用 `source.kind = "plugin"`,`summarize.js` 的
111+
`collectMessages` 会跳过它——否则注入物会被下一轮蒸馏成记忆,形成自我强化。
112+
- **`open_questions` 恒 null** 是刻意留白,不是没实现。
113+
114+
## 9. 验收锚点
115+
116+
`test/continuity.test.js` 逐条锁形态(不是锁文案):抽取口径(头/尾方向、插件消息跳过、
117+
插件消息是最后一条 `user/message` 时仍被跳过)、渲染(统一前缀、单行、`none`、整条上限)、
118+
唯一键刷新(`created_at` 不动、幂等 UPSERT)、队列满弃新且不影响刷新、丢弃留痕、
119+
pre-step 双落点与一次性消费、同文本不重复追加(按当前表面)、被折叠出表面的旧注入要补、
120+
落库失败不打断宿主的一步、`reject` 放行且不消费边缘、缺 session 不抛、dispose 后不再动作、
121+
默认关 + 父关不生效 + 轻量档压掉 + 降级规则只在开启时进描述、门控不调模型(静态锁)、
122+
存量库重开即建表。

‎dsh-mneme/lib/client.js‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -381,6 +381,8 @@ window.__ModuleLoader__.load({
381381
"memory.features.autoInject.hint": "每轮对话自动携带相关记忆",
382382
"memory.features.injectGuidanceEnabled": "能力说明",
383383
"memory.features.injectGuidanceEnabled.hint": "在工具描述与一次性提示段里说明怎么用记忆(何时查、何时写、拿不准就不做)",
384+
"memory.features.continuityRescueEnabled": "压缩边缘抢救",
385+
"memory.features.continuityRescueEnabled.hint": "上下文即将被精简前,落一条连续性快照(正在做什么 / 下一步 / 未决问题)并追加到对话末尾,让它活过这次压缩",
384386
"memory.features.parentOff": "父开关关闭时不生效",
385387
"memory.features.autoSummarize": "自动总结",
386388
"memory.features.autoSummarize.hint": "对话结束自动提炼记忆条目",
@@ -769,6 +771,8 @@ window.__ModuleLoader__.load({
769771
"memory.features.autoInject.hint": "Carry relevant memories into every turn",
770772
"memory.features.injectGuidanceEnabled": "Capability guide",
771773
"memory.features.injectGuidanceEnabled.hint": "Explain how to use memory (when to search, when to save, when to do nothing) in tool descriptions plus a one-time prompt section",
774+
"memory.features.continuityRescueEnabled": "Compaction-edge rescue",
775+
"memory.features.continuityRescueEnabled.hint": "Before context compaction, record a continuity snapshot (current work / next step / open questions) and append it near the end of the conversation so it survives the compaction",
772776
"memory.features.parentOff": "Inactive while auto injection is off",
773777
"memory.features.autoSummarize": "Auto summarization",
774778
"memory.features.autoSummarize.hint": "Distill memory entries when a conversation ends",
@@ -1931,7 +1935,7 @@ window.__ModuleLoader__.load({
19311935
// 「重置用户配置」,子项自己勾着的值要留着,也应该能提前设好。同一份关系在
19321936
// 后端 src/config.js 的 INJECT_CHILD_FLAGS(运行时闸门),两侧漂移由
19331937
// test/inject-parent-gate.test.js 钉住。
1934-
const FEATURE_CHILDREN = { autoInject: ["injectGuidanceEnabled"] };
1938+
const FEATURE_CHILDREN = { autoInject: ["injectGuidanceEnabled", "continuityRescueEnabled"] };
19351939
const FEATURE_GROUPS = [
19361940
{ key: "group.core", items: ["autoInject", "autoSummarize", "hotMemoryEnabled", "memoryQualityFilter.enabled", "llmAudit.enabled"] },
19371941
{ key: "group.enhance", items: ["entityExtractionEnabled", "codingRetrospect", "rerankEnabled", "resilientModelDownload", "searchSemanticDedup", "bm25SearchEnabled", "heatEnabled", "documentMemoryEnabled"] },

‎dsh-mneme/lib/config.js‎

Lines changed: 21 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,6 +87,21 @@ export const Config = z.object({
8787
// 父开关 `autoInject` 关闭时它不生效(闸门见 injectChildEnabled);用户显式写进
8888
// feature_flags 的值永远优先于这里的默认值。
8989
injectGuidanceEnabled: z.boolean().default(true),
90+
// #249 N3(压缩边缘双落点):上下文即将大幅精简前抢救「正在做什么」。默认关。
91+
// 触发靠宿主自己的压缩事件(`compaction/start|summary|end`,都在事件白名单里),
92+
// 不自定一套阈值参数——「压缩边缘」由宿主定义,我们再校准一份只会与之漂移。
93+
// 为什么是「新时机 + 新表面」因而默认关:它往对话里**追加消息**(新的注入表面,
94+
// 参照实现里最容易累积成一堆历史的那类),并多写一张提案表。按 §10 判据,引入
95+
// 新时机/新表面/新成本的子项独立成键、默认关;只修正既有块的(基础内容分池、
96+
// 库可见性行)才随父开关默认开。`pinnedInjectBudget` 与它同批,但属前者之外:
97+
// 那是既有块内的预算,不是新表面。
98+
// 双落点是硬要求,不能只留一半:宿主的压缩摘要器**只看对话里的内容**,只落库不
99+
// 注入,等于在摘要重建里什么都没留下;只注入不落库,则压缩一过就随旧消息一起
100+
// 消失。两者都做,且落库先于注入(注入失败不该丢提案)。
101+
// 祖先:`autoInject`(父关则本项不生效,闸门见 injectChildEnabled)。lightMode
102+
// 强制关(见 LIGHT_MODE_OFF):轻量档多一份注入物是反的,与 injectGuidanceEnabled
103+
// 同一取舍。
104+
continuityRescueEnabled: z.boolean().default(false),
90105
// #249(第一批):B1 pin 池预算——约束/偏好类注入条目的独立小上限。约束与
91106
// 偏好被静默降级是本议题的立项核心(同类知识与情景日志同池同速率摘要,实测
92107
// 一轮压缩后仅保 53%、五轮 10%),故这两类不进相关性竞争、不参与跨轮轮换、
@@ -633,7 +648,11 @@ const LIGHT_MODE_OFF = [
633648
// 轻量模式不开 document 指针行(#230,opt-in:注册/注入/检索增强全随闸)。
634649
"documentMemoryEnabled",
635650
// 轻量模式不开热计算(heat 属于重型增强;关掉后 sleep 降级也退回纯时间分层)。
636-
"heatEnabled"
651+
"heatEnabled",
652+
// #249 N3:轻量档不开压缩边缘双落点——它往对话里追加消息(新的注入表面),
653+
// 轻量档(小模型 / 小上下文)最不该再多一份注入物;真要用的用户在轻量档下手动
654+
// 勾选也会被压掉,这是本预设的既定语义(同 injectGuidanceEnabled)。
655+
"continuityRescueEnabled"
637656
];
638657

639658
/**
@@ -670,7 +689,7 @@ export function applyLightModePreset(cfg) {
670689
* 是扁平键,不受这条限制。
671690
*/
672691
export const INJECT_CHILD_FLAGS = Object.freeze({
673-
autoInject: Object.freeze(["injectGuidanceEnabled"])
692+
autoInject: Object.freeze(["injectGuidanceEnabled", "continuityRescueEnabled"])
674693
});
675694

676695
/** 子开关的运行时生效值:父开关显式关(false)时恒不生效。 */

0 commit comments

Comments
 (0)