You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
[RFC] acp_rule lifecycle & CRUD design: source of truth, full semantics, protection as downstream conclusion #390
formatRulesForPrompt 在 src/ 全量 grep 零命中——没有任何宿主把规则注入系统提示词。规则的模型可见载体就是历史 record pair 本身。(billion-context#1259 review floor 4 的「rules still reach the model every turn via formatRulesForPrompt system-prompt injection」与代码不符,系转述内核文档;内核 README、types.ts:152-154、RULES_USAGE_PROMPT(rules.ts:29-35)同样声称「每轮重新注入」——此文档漂移建议 phase 1 PR 内标注顺手修。)
executeRule(src/rules-feature.ts)是 streaming loop 与 plugin tool API 共用的唯一执行器,直接 mutate ctx.session.state——执行器与折叠管线共享同一 state 实例。delete/clear 尚未接线(#1178 open),当前生产无 Removed/Cleared 事件,任何方案此刻都 no-op safe。
record 候选 ⟺ 调用参数解析成功且含 string rule 键;解析失败 → 按 record 候选处理(fail-closed);
从结果文本提取全部 /^rule\d+$/ id token(内核拥有的 id 格式);
受保护 ⟺ record 候选 ∧ (liveIds === null ∨ 结果含 ≥1 个 live id ∨ 结果无任何 id token → fail-closed 保护)。
鲁棒性(与 PR #378 的关键差异):前缀词无关——只耦合内核自有的 id 格式 rule\d+,不碰 "Recorded"/"Removed" 这类宿主字符串;前缀改名最坏退化为 fail-closed 过保(= 现状),不可能欠保。已知假阳性类(可接受,安全方向):list 结果含 live id 但非 record 候选(参数无 rule 键)→ 不受保护,消除「list pair 永保」累积向量;成功 record 的 text 恰好引用其他 live id → 该 pair 过保;失败的 record 尝试(超限/重复被拒,错误文本无 id token)按第 4 步 fail-closed 保留保护——小量过保换格式漂移安全,可接受。
Activity
ranxianglei commentedon Sep 24, 2026
#390 设计分析完成。 结论先行:同意以 C 为主机制,附三点修正(保持扁平数组形状 / 跳过 B 式镜像层 / A 完全移除而非降级 fallback)。按 issue 约束,未开始任何实现,等拍板。
0. 查重结论
全仓(open+closed)检索
acp_rule:无并行设计任务。相关线程均已在 issue 正文关联(#377、PR #378、bili#1177/#1178/#1179、pi#433/#490)。本 issue 是唯一设计任务,不重复。1. 前提核实(全部对照当前代码验证,非转述)
内核侧(master
d3808d6,v0.0.86):src/protected.ts:10ALWAYS_PROTECTED_TOOLS = ["compress", "acp_rule"],在isMessageProtected内无条件先行判定(:70);宿主钩子(config.isToolProtected)在其后、只能加保护不能撤。src/recommend.ts:174,211;assignRefsNodesrc/compress.ts:592-620;filterProtectedToolMessagessrc/compress.ts:1253;CCR skip-storesrc/ccr.ts:293;absorb refusalsrc/absorb.ts:95,304。发现既有不一致:消费点②被hasProtection(保护配置非空,:595-610)门控,其余四点无条件——空保护配置宿主(内核默认protectedTools: [])今天给 acp_rule pair 普通 mNNNNN ref 而非 BLOCKED。统一谓词必须顺带修掉(行为变更披露见 §3)。src/rules.tsaddRule(文本去重拒绝 :95-101)/removeRule/clearRules/allocateRuleId(单调不复用 :67-69 + 最高存活 id 回填守卫 :54-61,id 格式RULE_ID_RE = /^rule(\d+)$/:52);状态字段state.rules?: RuleRecord[](src/types.ts:257)+state.nextRuleId(:261);持久化经src/persist/state-merge.ts:23-24携带;rebuildCompressionState展开输入 state(src/rebuild.ts:39)→ rules 随输入 state 保留、不从历史重放。DESIGN.md:221已定位:"rules as structured data in core; text rendering in adapter"。src/compress-tool.ts、pisrc/rule-tool.ts),但 record 参数名两边一致(可选rule文本);结果文本格式由共享执行器产出。宿主侧(billion-context master 浅克隆核实):
formatRulesForPrompt在 src/ 全量 grep 零命中——没有任何宿主把规则注入系统提示词。规则的模型可见载体就是历史 record pair 本身。(billion-context#1259 review floor 4 的「rules still reach the model every turn via formatRulesForPrompt system-prompt injection」与代码不符,系转述内核文档;内核 README、types.ts:152-154、RULES_USAGE_PROMPT(rules.ts:29-35)同样声称「每轮重新注入」——此文档漂移建议 phase 1 PR 内标注顺手修。)executeRule(src/rules-feature.ts)是 streaming loop 与 plugin tool API 共用的唯一执行器,直接 mutatectx.session.state——执行器与折叠管线共享同一 state 实例。delete/clear 尚未接线(#1178 open),当前生产无 Removed/Cleared 事件,任何方案此刻都 no-op safe。.acp.jsonsidecar 跨重启持久化,deriveChildState/mergeInitialState携带 rules/nextRuleId,明确零系统提示词参与。对 #377 原始前提的修正:"plugin 模式下折叠跑在 agent 自带 kernel 副本、其 state 没有 rules 表"在可核实的部署中不成立(bili 两条 lane 共享 state 实例;pi sidecar 带表)。该场景只存在于假想未来宿主(stateless 每轮重建 state / 远程执行器)。这削弱了 A(流推导)作为主机制的必要性;其安全价值(无表时仍判对存活性)可被更简单的 fail-closed 覆盖(§3 C4)。
2. 三问回答
Q1 生命周期所有权(source of truth)
建议:宿主执行器拥有生命周期,内核经既有
state.rules消费 typed 快照。 即选项 C,但有一个重要修正:机制自 v0.0.80 起已经存在——缺的不是新状态通道,而是三样东西:①显式契约(adapter 保证每轮state.rules反映权威存储);②以表为 liveness oracle(替代按名 ALWAYS 保护);③表缺失时的 fail-closed 定义。契约条文(建议入 DESIGN.md/AGENTS.md):
state.rules是该轮的权威存活集合;adapter 保证其新鲜度(executor 与 folder 共享 state 实例时平凡成立——所有现有宿主皆如此)。state.rules为 undefined(pre-rules 状态 / 未接线的宿主)→ 所有 record pair 视为受保护(= 现状)。不确定时绝不过度释放。src/rules.ts:63-69)——保证任何重建路径下终态集合成员资格良定义。拒 A 作主机制:格式漂移耦合(内核不拥有结果字符串契约)、只编码存活性不编码 CRUD、且其动机场景无可核实实例。拒 B 另建:B 即现状(宿主经 helpers mutate 内核 state 表),再叠「第二副本 + 对账」层是为当前架构中不存在的同步问题买单——留 phase 3 规格化(仅当远程执行器架构出现时)。
Q2 完整 CRUD 语义
src/rules.ts:95-101)。注意:record schema 无 id 参数(只有可选rule文本;delete 才按 id 定位),所以 issue 里「同 id 重复提交 = 幂等更新」不映射到现行 schema——真正的决策是是否新增显式 update action。建议:phase 1 维持现状(诚实报错、无静默覆盖、零 schema 变更);update/re-record 移入 phase 2——有下面发现的 load-bearing 理由,不宜无限期推迟。types.ts:258-261文档一致)。与 ref 同纪律(§2 principle 6)。.acp.jsonsidecar 跨重启)。内核立场:只收快照、不拥有状态。fork/rebuild:rebuildCompressionState保留输入 state 的 rules(src/rebuild.ts:39),在 C2 下正确;明确文档化 rebuild 不从历史重放 rule 操作(C2 下无需;而重放结果需要解析结果字符串——正是要去掉的耦合)。state.rules仍有条目但无任何机制渲染回上下文 → 提醒静默死亡。phase 1 在此不引入回归(现状同样丢失,只是把既有缺口文档化);phase 2 规格:adapter MUST 在任何历史重置事件后重新物化存活规则为新 record pair(字节变化发生在重置时刻,前缀缓存彼时本已整体失效 → 满足缓存安全条件)。这需要 update/re-record 能力(今日 addRule 对相同文本拒绝,朴素重录必败)——这就是 update action 必须排进 phase 2 的理由。storeCoveredOriginals,bili#1179/#1207,proxy 模式默认开)归档原文、可按 ref 取回;摘要得 lossy 提及。live pair 保持受保护 → ccr skip-store(src/ccr.ts:293)阻止占位符替换 → 原文持续可见。两机制正交组合,除统一谓词外无额外工作。Q3 保护语义(下游结论)
统一谓词(具体提案,替代 PR #378 的流 walk):
判定链(每个 acp_rule call/result pair,按 toolCallId 配对):
liveIds = state.rules ? new Set(ids) : null(null = 未知 → fail-closed);rule键;解析失败 → 按 record 候选处理(fail-closed);/^rule\d+$/id token(内核拥有的 id 格式);鲁棒性(与 PR #378 的关键差异):前缀词无关——只耦合内核自有的 id 格式
rule\d+,不碰 "Recorded"/"Removed" 这类宿主字符串;前缀改名最坏退化为 fail-closed 过保(= 现状),不可能欠保。已知假阳性类(可接受,安全方向):list 结果含 live id 但非 record 候选(参数无rule键)→ 不受保护,消除「list pair 永保」累积向量;成功 record 的 text 恰好引用其他 live id → 该 pair 过保;失败的 record 尝试(超限/重复被拒,错误文本无 id token)按第 4 步 fail-closed 保留保护——小量过保换格式漂移安全,可接受。五个消费点统一消费(每轮计算一次,各点 union):
src/recommend.ts:174,211src/compress.ts:592-620hasMediaPayload同层、hasProtection 门外(:606)——修复既有不一致src/compress.ts:1253src/ccr.ts:293src/absorb.ts:95,304并从
ALWAYS_PROTECTED_TOOLS移除"acp_rule"(保留"compress")。行为变更披露(old → new):
触及 §7.3 契约 #6(protected-tool filtering)→ 人工把关;跨仓顺序:kernel 先发 → bili pin bump(待 #1178 合并后)→ pi pin bump。
3. 方案对比结论(同意 C 主机制,三点修正)
RuleRecord[],不引入{version, entries}信封:扁平形状已在 0.0.80+ 发布并持久化于真实会话(bili server state、pi sidecar);改信封破坏跨仓 state 兼容性,功能收益为零。日后需元数据(createdAt、human/model 来源标记)时 additive 扩展 RuleRecord 可选字段即可,向后兼容。4. 分阶段实施计划(拍板后执行)
5. 待 owner 拍板(每条附我的默认建议)
{version, entries}?→ 建议扁平(R1)。6. 分析中新立 issue
载体缺口(历史重置后存活规则静默丢失)是独立于本设计结论的既有问题,已按规范单独立项并带来源标记:#391。
中文一句话总结:核实了全部前提(含一处修正——plugin 模式"折叠侧无 rules 表"在现有部署中不成立)后,建议以 C 为主机制(宿主拥有生命周期、内核经既有
state.rules消费 typed 快照 + fail-closed 兜底),id 永不复用纪律保持、重复 record 维持文本去重拒绝、跨会话归宿主持久化;保护语义收敛为单一谓词统一喂五个消费点,仅耦合内核自有 id 格式、对宿主字符串漂移免疫;A 完全移除、B 式镜像层留待远程执行器出现再说;另发现"无宿主注入提示词 → 历史重置即静默丢规则"的载体缺口,已单立 #391。等你拍板 §5 四点后即可开工 phase 1。fix: unify tool-message accounting across status report surfaces (issue
Merge pull request #177 from ranxianglei/2026-08-31_status-report-acc…