来源: ranxianglei/acp-kernel#390 (https://github.com/ranxianglei/acp-kernel/issues/390) 分析「acp_rule lifecycle & CRUD 综合设计」时发现 ## Problem acp_rule 规则的模型可见载体目前是**历史 record 调用/结果消息对本身**(内核按工具名硬保护、不可折叠)。经核实,**没有任何宿主把规则注入系统提示词**:billion-context master `src/` 全量 grep 对 `formatRulesForPrompt` 零命中;billion-context-pi#490 亦明确「零系统提示词参与」。因此任何替换/重写历史的事件都会让存活规则的载体整体消失: - pi lane 的 native compaction(内置压缩以摘要替换历史); - fork adoption / 任何宿主侧历史重建路径(billion-context `fork-adoption.ts` 即有一例)。 事件发生后 `state.rules` 仍持有条目(宿主侧持久化不变),但没有任何机制把它们渲染回上下文——提醒**静默死亡**:模型后续看到的 list 输出、record 轨迹全部随历史消失,规则不再影响行为,且无人察觉。 ## Repro 1. 启用 `compress.rules`,记录一条规则(record pair 进入历史,受保护)。 2. 触发 native compaction 或任何历史替换型重置。 3. 观察:record pair 从消息流消失;系统提示词无规则内容(无注入);模型侧规则不可见。`state.rules` 不受影响但完全惰性。 ## Impact - 持久提醒恰好在上下文压力最大时(压缩触发于压力)静默丢失——功能在最需要它的时刻失效。 - 内核文档漂移放大此问题:README、`src/types.ts:152-154`(RuleRecord doc)、`RULES_USAGE_PROMPT`(`src/rules.ts:29-35`)均声称规则「每轮重新注入系统提示词」,但无任何宿主实现该行为——文档描述了一个不存在的兜底。(措辞修正属顺手小修,可随本修复或 #390 phase 1 PR 处理。) ## Suggested fix(方向,待 #390 设计拍板后细化) 1. **规格**:adapter MUST 在任何历史重置事件后,将存活规则**重新物化为新的 record pair**(新 ref、按既有 id 纪律)。字节变化发生在重置时刻——该时刻前缀缓存本已整体失效,满足 owner 的缓存安全条件。 2. **前置能力**:需要显式 update/re-record 语义。当前 `addRule` 对相同文本拒绝("identical rule already exists",`src/rules.ts:95-101`),朴素重录必然失败;需与 billion-context 执行器行为协同设计(#1178 未合,executor 尚无 delete/clear 接线)。 3. **替代方案(暂否)**:每轮系统提示词注入——每次增删改头部字节 → 每次变更全量前缀缓存失效,稳态成本高于 pair 载体;留待 update 能力落地后作为独立产品决策再评估。 4. **跨仓范围**:内核规格 + 两个 adapter lane(billion-context、billion-context-pi);wire 格式变更遵循 kernel 先发顺序。 相关:#390(设计 RFC)、#377(原始保护问题)、PR #378(draft 参考实现)、billion-context#1177 / #1178、billion-context-pi#490。
Activity
ranxianglei commentedon Sep 24, 2026
[bot] 🏷 Triage 完成:核心事实主张逐条核实(含两处修正);层次判断与方向建议如下。按 #390「owner 拍板方案前不要实现」及本 issue 自述「待 #390 设计拍板后细化」,本轮未改任何代码。
① 查重:open+closed 全量检索,无重复。与相关项的区分:#377 = dead pair 过度保护(已删规则不可折叠),本 issue = live rule 载体丢失(存活规则随重置消失)——同一谱系的镜像问题;#390 是伞状 RFC,本 issue 是从中切出的具体缺口,来源标记合规。
② 核实结论(证据均基于 kernel master
d3808d6+ 两个宿主的全量 git 历史):formatRulesForPrompt在 billion-context master 零命中,全历史git log -S亦零命中——从未实现过;billion-context-pi master 同样零命中。bilisrc/rules-feature.ts的executeRule只做 add/list,server.ts仅向 tools 数组注入 schema(:2555/:2747/:2941/:3178),无任何 prompt 内容注入src/protected.ts:10ALWAYS_PROTECTED_TOOLS = ["compress", "acp_rule"],无条件src/rules.ts:94-101,错误串identical rule already exists (ruleN) — no change.(按文本去重)src/rules.ts:34"Rules are re-injected into the system prompt every turn."——这是模型可见文本,会让模型误信规则有提示词兜底而不去 list/依赖历史 pairtypes.ts:152-154、rules.ts:3-8(模块头注释,issue 未提)、rules.ts:29-35(line 34)额外发现(同谱系佐证,建议纳入同一规格):
fork-adoption.ts(#629)的 adoptable 清单明写 "Deliberately NOT inherited: … rules"——fork 后state.rules被整体丢弃,子会话nextRuleId从 1 重新起算,而父会话的 ruleN id 仍出现在重放的历史里 → 存在潜在 rule-id 冲突隐患。这是「重置事件」类缺口的又一具体实例,且比"载体丢失"更严重(state 条目本身也没了)。③ 层次判断:表面现象 = 「重置后规则静默死亡」;根因 = 「carrier coverage invariant」无人拥有——规则唯一的模型可见载体(record pair)挂在宿主可变的 mutable history 上,而没有任何契约规定「历史替换事件之后载体必须如何」。这是生命周期不变量的缺失,不是某个函数的缺失,所以应与 #390 三问一起拍板,不宜独立打补丁。
④ 方向评估(对 Suggested fix 逐条回应):
Recorded ruleN: …,消息 ref 由 assignRefsNode 正常分配新 mNNNNN——这些是真新消息,不违反 principle 6)。确定性、无需模型配合、无字符串嗅探、无 state schema 变更。反之,内核侧「每轮核对 state.rules vs 可见 pair」要么解析Recorded ruleNresult 文本(= [RFC] acp_rule lifecycle & CRUD design: source of truth, full semantics, protection as downstream conclusion #390 明确否决的字符串协议耦合),要么在 state 里跟踪 carrier messageRef(state schema 变更,§7.3 human-gate + 跨仓)——现阶段都不建议。state.rules不变),重复拒绝并不阻塞它。重复拒绝真正阻塞的是模型驱动恢复——模型发现规则消失后自发重录相同文本,得到的是错误串,而按 feat: conditionally protect acp_rule pairs by stream-derived rule liveness #378 的闭合划分,错误串属可折叠 event trace,不能充当载体。因此「相同文本 = 幂等 reaffirm(返回Recorded ruleN成功)」是让模型驱动兜底生效的关键件,应与 [RFC] acp_rule lifecycle & CRUD design: source of truth, full semantics, protection as downstream conclusion #390 Q2 一并拍板,并与 bili#1178(open,delete/clear 未合)协同落地。Recorded ruleNpair 在两种下游设计下都幂等——feat: conditionally protect acp_rule pairs by stream-derived rule liveness #378 stream-derived 方案下 id 已在 live set(no-op);[RFC] acp_rule lifecycle & CRUD design: source of truth, full semantics, protection as downstream conclusion #390-C typed snapshot 方案下以快照为准。不冲突。⑤ 处置建议(明确建议,非选择题):
state.rules中每条规则在可见历史中 MUST 有 ≥1 个对应 record pair;formatRuleRecordPair(rule)统一渲染(可选,防各宿主各写一套格式漂移);types.ts:152-154:改为规范性契约——"Visible carrier is the recorded call/result pair in history (hard-protected from ACP compression). Adapters MUST re-materialize surviving rules after any history-reset event (see acp_rule carrier gap: surviving rules silently lost after historical reset events (native compaction, etc.) — requires re-materialization spec + update/re-record capability | acp_rule 载体缺口:历史重置事件(native compaction 等)后存活规则静默丢失 — 需 re-materialization 规格 + update/re-record 能力 #391)."rules.ts:34(模型可见):"Recorded rules persist in the conversation as protected entries; omit the text argument to list them."rules.ts:3-8头注释:由事实断言改为规范性契约表述。本 issue 保持 open,等 #390 拍板;拍板后即可按上述骨架进入实现。
中文摘要:核实了 acp_rule「重置后存活规则静默丢失」问题——除 README 一条外全部属实(且比 issue 所述更强:历史上从未有任何宿主注入过规则到系统提示词),根因判定为缺失「carrier coverage invariant」这一生命周期契约而非单点功能缺口;建议采用 adapter 事件驱动的 re-materialization 机制(合成复用原 id 的 record pair,缓存安全论证成立并更锐利),幂等 update 语义与 #390 Q2 一并拍板,整体并入 #390 设计、暂不单独实现。
[-]acp_rule 载体缺口:历史重置事件(native compaction 等)后存活规则静默丢失 — 需 re-materialization 规格 + update/re-record 能力[/-][+]acp_rule carrier gap: surviving rules silently lost after historical reset events (native compaction, etc.) — requires re-materialization spec + update/re-record capability | acp_rule 载体缺口:历史重置事件(native compaction 等)后存活规则静默丢失 — 需 re-materialization 规格 + update/re-record 能力[/+]