Skip to content

Commit 46afefa

Browse files
committed
preInjectGate 注入前判定:意见/立场记忆先判定后处置(issue #380,E12 D1 裁决落地,opt-in 默认关)
- 判定:每帧注入候选出池后、进 system prompt 前,一次池级 LLM 调用(协议与 E12 实验 protocol-preinject.txt 同源;候选映射 m#i 局部序号——E13b 实测 UUID 回显脆弱), 判定结果绝不进模型上下文(E2/E3 标记线关闭;E12 过滤比标记好 +17.6pp) - 两级语义复用 #254 writeAdmission:enabled 观察档(审计行真实 token 用量 + flagged ids, 先看真实负载意见占比)、enforce 缓存命中帧真滤除;enforce 无 enabled 无效果 - 同步渲染约束:async prefetch + cache 同步消费(queryVectorCache 同款),冷缓存首帧 降级原样注入;判定失败 degraded 审计 + 不缓存——防线故障永不阻塞注入 - 豁免:pin 池(#249 逐字保真)与 graphHint 线索行只留给一般记忆槽;缓存键 = 查询 + 候选 id 集(轮换/新记忆即重判);llmAudit 关闭时本闸不运行;lightMode 强制关 (applyLightModePreset 支持点分键) - 白名单 + NESTED_FLAG_PATHS + 计数锁 +2 + 面板分组与双语文案 + 文档(CONFIGURATION 新节/README/CHANGELOG);新增 10 条回归(平价锁/observe/enforce/两类降级/映射越界/ 缓存键隔离/in-flight 去重/pin 豁免/lightMode)
1 parent 7f07bba commit 46afefa

20 files changed

Lines changed: 854 additions & 18 deletions

‎dsh-mneme/CHANGELOG.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22

33
## [Unreleased]
44

5+
## 🆕 新增
6+
7+
- **注入前判定 `preInjectGate`(issue #380,E12 D1 裁决落地,opt-in 默认关)**:每帧注入候选出池后、进入 system prompt 前,一次**池级** LLM 调用判出「会向本次请求注入意见/立场」的记忆(判定协议与 E12 实验 protocol-preinject.txt 同源;E12 实测判定+过滤把谄媚率 26.9%→2.5%,且 MemGauge 三阶段考卷实测写入/巩固/检索预算三面对内容毒均无防线——这是唯一过预注册判据的机制)。两级语义复用 #254 writeAdmission:`enabled` 观察档(判定完成落 `llm_audit_logs`,真实 token 用量 + 被标记记忆 id,先看真实负载的意见占比分布)、`enforce` 缓存命中帧真滤除(E12:判定+标记比过滤差 +17.6pp,判定结果**绝不进模型上下文**)。宿主注入渲染是同步回调 → 判定走 async prefetch + cache 同步消费(queryVectorCache 同款),冷缓存首帧降级为原样注入、下一轮同 key 渲染生效;判定失败原样注入 + `degraded` 审计行,防线故障永不阻塞注入。pin 池(#249 逐字保真)与 graphHint 线索行豁免;候选映射 `m#<i>` 局部序号(E13b 实测 UUID 回显脆弱);缓存键 = 查询 + 候选 id 集(轮换/新记忆即重判);`llmAudit` 关闭时本闸不运行;lightMode 强制关(`applyLightModePreset` 支持点分键)。白名单 + 计数锁 +2 + 文档(CONFIGURATION.md 新节)。
8+
59
## ⚠️ 行为变更
610

711
- **`dreamMergeGuard` 默认值 `false` → `true`(issue #339 / E8)**:巩固 merge 护栏自 v0.8.13 引入时是 opt-in 默认关,现改为默认开——合并对象命中长保留类型(与 archive 护栏同表:preference/pattern/rejected_solution/constraint/pitfall)的 merge 决策整条跳过,`dreamSkipInvalid`(默认开)下被跳条目进 `dream_runs.skipped`、run 记 degraded。依据是它引入时就已写明的机制:archive 护栏只挡 archive 不挡 merge,而 merge 的「更精炼摘要」恰是约束失真的主通道——E8 实测巩固损耗里 10/26 条被丢约束已归位 guarded 类型仍被 merge 吃掉;同类压缩管线的实测也显示安全规则被同速压缩后一轮只剩 53%、五轮只剩 10%,且全程无报错信号。需要旧行为的库显式设 `dreamMergeGuard: false`(面板可关)。

‎dsh-mneme/README.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -433,6 +433,7 @@ dsh web
433433
| `scopeEnabled` | `false` | 作用域隔离总开关(v0.8.0,issue #17):memory_save 按会话身份写入 agent / workspace 标注(agentPreset / 工作区路径,registry 反查取不到回退 header.cwd,再取不到 NULL);去重键扩展含作用域三元——跨作用域同标题不再物理合并;检索与注入排序按当前会话作用域加权(命中 ×1.25、他 scope ×0.5 保留可见,issue #339 补齐注入通道)。也走 feature_flags 白名单(面板可启停) |
434434
| `strictScope` | `false` | 作用域硬过滤(v0.8.0 引入,v0.8.1 起只认显式声明;依赖 `scopeEnabled`):检索 / 注入 / 列表 / 单取四路过滤,**显式声明**收窄到他者作用域的记忆完全不可见;载体自动标注只降权保留可见——真正的物理隔离请用 sensitivity。会话身份解析不到时 fail-closed 只挡显式行。关闭时全部为软隔离(降权保留可见)。也走 feature_flags 白名单 |
435435
| `writeAdmission` | `{enabled:false, enforce:false}` | 写入准入(issue #254,默认关):把「这条该不该进库」前移到 LLM 之前。第 1 级是零 LLM 的确定性判据——空白 / 纯噪声 + 密钥 / PII(判据来源是 #164 A2,经 `sensitiveScan` 注入,本批只定义接口)。`enabled` 跑判据并落审计行(`llm_audit_logs` 的 `metadata.deny`),`enforce` 才真的拒(`store.save` 之前返回,`memory_save` 返回 `action:"denied"` + `reason`);只开 `enabled` = 仅告警、写入不拦。去重键命中不进第 1 级(归 write-update 放行),G1/G2 阈值只计量。也走 feature_flags 白名单 |
436+
| `preInjectGate` | `{enabled:false, enforce:false}` | 注入前判定(issue #380,默认关):每帧注入候选出池后、进入 system prompt 前,一次池级 LLM 调用判出「会向本次请求注入意见/立场」的记忆(判定协议与 E12 实验同源;实测过滤把谄媚 26.9%→2.5%,且判定结果绝不进模型上下文——给模型看标记的线已被 E2/E3 关闭)。`enabled` 跑判定并落审计行(真实 token 用量 + 被标记记忆 id),`enforce` 才在缓存命中帧真滤除;冷缓存首帧降级为原样注入(宿主注入渲染是同步回调,判定走 prefetch+cache)。pin 池与检索线索行豁免;判定失败原样注入不阻塞;`llmAudit` 关闭时本闸不运行;lightMode 强制关。也走 feature_flags 白名单 |
436437
| `conflictFreezeEnabled` | `false` | 冲突冻结(v0.4.4):dream 发现矛盾对不自动裁决,冻结进冲突队列;状态页「冲突队列」支持并排对比与人工确认(保留 A / 保留 B / 仅标记已处理,v0.8.0) |
437438
| `conflictFreezeMaxPending` | `100` | 冲突冻结队列最大挂起数(1-1000):超出后不再入队(防队列无限膨胀) |
438439
| `escapePromptVariables` | `true` | 注入文本花括号转义(v0.8.0 恢复,issue #162):注入边界把 `{{...}}` 转义,防止 hot memory / 记忆原文里的 Go template / Vue 语法触发宿主 interpolate 抛错卡死会话(v0.7.4 曾修复、v0.7.11 误删) |

‎dsh-mneme/docs/CONFIGURATION.md‎

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,17 @@
4646

4747
第 1 级的判据面刻意收窄:**去重键命中不进第 1 级**(归 write-update 放行——同步近重复门跑在异步矛盾检测之前会把本该被裁决的矛盾直接拒掉),G1/G2 阈值也只是计量。两个键都走 feature_flags 白名单(面板可启停)。
4848

49+
## 注入前判定(#380)
50+
51+
每帧注入候选出池后、进入 system prompt 前,一次**池级** LLM 调用判出「会向本次请求注入意见/立场」的记忆(判定协议与 E12 实验同源;实验依据:D1 判定+过滤把谄媚率 26.9%→2.5%,判定+标记比过滤差 +17.6pp——判定结果**只给闸门用,绝不进模型上下文**)。两级语义与 writeAdmission 同构,落点在注入面而非写入面。
52+
53+
| 键 | 默认 | 作用 | 开启后果 / 冲突 |
54+
|---|---|---|---|
55+
| `preInjectGate.enabled` | `false` | 跑池级判定。判定 async prefetch + cache、渲染帧同步消费(宿主 systemPrompt 渲染是同步回调) | 关 = 注入行为与现状逐字节一致。**冷缓存首帧降级**:新查询的第一帧原样注入,下一轮同 key 渲染生效;判定完成落 `llm_audit_logs`(`trigger_source=preInjectGate`,真实 token 用量,`related_memory_ids`=被标记记忆)——先观察真实负载的意见占比分布 |
56+
| `preInjectGate.enforce` | `false` | 缓存命中帧真的滤除被标记候选 | 关 = 仅观察:候选集不动。**enforce 无 enabled 时无效果**。pin 池(constraint/preference,#249 逐字保真)与 graphHint 线索行豁免——判定与过滤只作用于一般记忆槽 |
57+
58+
降级路径:判定失败/超时/不可解析 → 本帧原样注入 + 审计行 `degraded:true` 且不缓存(下一帧重试)——防线故障永不阻塞注入。判定 LLM 走 `agentDefaultModel` 当前选择(entity adapter 同款装配,无独立 provider/model 键;审计行带实际模型与用量,成本痛了再加覆盖键)。缓存键 = 查询 + 候选 id 集,候选集变化(轮换/新记忆)即重新判定,不吃旧判定。`llmAudit.enabled=false` 时本闸不运行(无账目的判定不可见也不该花钱)。lightMode 强制关(LLM-per-turn 附加路径与低资源档互斥)。
59+
4960
## 蒸馏(会话 → 记忆)
5061

5162
| 键 | 默认 | 作用 | 开启后果 / 冲突 |
@@ -245,7 +256,8 @@
245256
`entityExtractionEnabled` · `autoDream` · `sleepModeEnabled` · `rerankEnabled` ·
246257
`autoReindexOnBoot` · `hybridInject` · `injectGuidanceEnabled` · `searchSemanticDedup` ·
247258
`selectiveInjectEnabled` · `bm25SearchEnabled` · `entityRecallEnabled` ·
248-
`dreamNarrativeEnabled` · `documentMemoryEnabled` · `heatEnabled` · `continuityRescueEnabled`
259+
`dreamNarrativeEnabled` · `documentMemoryEnabled` · `heatEnabled` · `continuityRescueEnabled` ·
260+
`preInjectGate.enabled`(#380)
249261

250262
预设只是默认值而非强制:用户显式写进 feature_flags 的值在装配顺序上后展开、仍然生效
251263
(「用户开关 > 轻量预设 > bundle 配置」)。

‎dsh-mneme/lib/api.js‎

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -142,7 +142,11 @@ export function createApi(ctx, service, settings, commands, embedder, semantic =
142142
"memoryQualityFilter.enabled": ["memoryQualityFilter", "enabled"],
143143
"llmAudit.enabled": ["llmAudit", "enabled"],
144144
"writeAdmission.enabled": ["writeAdmission", "enabled"],
145-
"writeAdmission.enforce": ["writeAdmission", "enforce"]
145+
"writeAdmission.enforce": ["writeAdmission", "enforce"],
146+
// Issue #380:注入前判定。漏登记的后果是 effective 静默缺键、面板盲——
147+
// 上面的 round-trip 测试专门锁这张表与白名单成对。
148+
"preInjectGate.enabled": ["preInjectGate", "enabled"],
149+
"preInjectGate.enforce": ["preInjectGate", "enforce"]
146150
// sensitiveScanEnabled(#164 A2)是顶层扁平键,不需要进这张表——走 configFlagValue
147151
// 的默认分支即可。
148152
};

‎dsh-mneme/lib/client.js‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -493,6 +493,10 @@ window.__ModuleLoader__.load({
493493
"memory.features.writeAdmission.enabled.hint": "写入前判空白/噪声,命中留审计(不拦)",
494494
"memory.features.writeAdmission.enforce": "写入准入拦截",
495495
"memory.features.writeAdmission.enforce.hint": "真拦下命中的写入;关闭时只留审计不拦",
496+
"memory.features.preInjectGate.enabled": "注入前判定",
497+
"memory.features.preInjectGate.enabled.hint": "注入前判意见/立场记忆,先观察分布(不拦)",
498+
"memory.features.preInjectGate.enforce": "注入前判定拦截",
499+
"memory.features.preInjectGate.enforce.hint": "判定命中的候选在注入时滤除;关闭时只留审计不拦",
496500
// #164 A2:密钥/PII 判据自己的闸。文案要写清它管的是哪一批判据(与上面的
497501
// 空白/噪声分开)、它跑在「写入准入判定」里面(那一项关着就不跑),以及
498502
// 「开着也不拦」——拦是上面那项的事。
@@ -930,6 +934,10 @@ window.__ModuleLoader__.load({
930934
"memory.features.writeAdmission.enabled.hint": "Flag blank / noise writes before storing, with an audit row (never blocks)",
931935
"memory.features.writeAdmission.enforce": "Write admission enforcement",
932936
"memory.features.writeAdmission.enforce.hint": "Actually reject flagged writes; off keeps the audit row only",
937+
"memory.features.preInjectGate.enabled": "Pre-inject gate",
938+
"memory.features.preInjectGate.enabled.hint": "Judge opinion/stance memories before injection, audit-only (never blocks)",
939+
"memory.features.preInjectGate.enforce": "Pre-inject gate enforcement",
940+
"memory.features.preInjectGate.enforce.hint": "Actually drop flagged candidates at injection; off keeps the audit row only",
933941
// #164 A2: its own gate for the secret / PII rules (separate from the
934942
// blank/noise pair above), and it runs inside the write admission checks
935943
// above, so with those off it never runs. Hits are audited only;
@@ -2133,7 +2141,7 @@ window.__ModuleLoader__.load({
21332141
// test/inject-parent-gate.test.js 钉住。
21342142
const FEATURE_CHILDREN = { autoInject: ["injectGuidanceEnabled", "continuityRescueEnabled"] };
21352143
const FEATURE_GROUPS = [
2136-
{ key: "group.core", items: ["autoInject", "autoSummarize", "hotMemoryEnabled", "injectTimePrefix", "memoryQualityFilter.enabled", "llmAudit.enabled", "writeAdmission.enabled", "writeAdmission.enforce", "sensitiveScanEnabled"] },
2144+
{ key: "group.core", items: ["autoInject", "autoSummarize", "hotMemoryEnabled", "injectTimePrefix", "memoryQualityFilter.enabled", "llmAudit.enabled", "writeAdmission.enabled", "writeAdmission.enforce", "preInjectGate.enabled", "preInjectGate.enforce", "sensitiveScanEnabled"] },
21372145
{ key: "group.enhance", items: ["entityExtractionEnabled", "codingRetrospect", "rerankEnabled", "resilientModelDownload", "searchSemanticDedup", "bm25SearchEnabled", "heatEnabled", "documentMemoryEnabled"] },
21382146
{ key: "group.dream", items: ["autoDream", "sleepModeEnabled"] },
21392147
// v0.8.0 A4(issue #17):作用域隔离组——标注总开关 + 严格硬过滤。

‎dsh-mneme/lib/config.js‎

Lines changed: 36 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -653,6 +653,27 @@ export const Config = z.object({
653653
enforce: z.boolean().default(false)
654654
}).default({}),
655655

656+
// --- issue #380: pre-inject gate (opinion/stance judgment before injection) -
657+
// 注入前判定:每帧注入候选出池后、进入 system prompt 前,一次池级 LLM 调用判出
658+
// 「会向本次请求注入意见/立场」的记忆(E12 D1 口径,判定协议同源实验
659+
// protocol-preinject.txt)。两级语义复用 writeAdmission:
660+
// enabled — 跑判定。判定 async prefetch + cache、同步消费(宿主 systemPrompt
661+
// 渲染是同步回调,冷缓存首帧降级为不判定原样注入,下一轮同 key 生效);
662+
// 判定完成落 llm_audit_logs(trigger_source=preInjectGate,真实 token 用量,
663+
// related_memory_ids=被标记记忆)——先在真实负载看意见占比分布。
664+
// enforce — 缓存命中帧真的滤除被标记候选。E12 实测只有过滤过判据(D1 −24.4pp,
665+
// 判定+标记 D2 比它差 +17.6pp——给模型看标记的线已被 E2/E3 关闭,本闸判定
666+
// 结果绝不进模型上下文)。enforce 无 enabled 时无效果。
667+
// 降级路径:判定失败/超时/不可解析 → 本帧原样注入 + 审计行 degraded=true 且不
668+
// 缓存——防线故障永不阻塞注入。判定 LLM 走 agentDefaultModel 当前选择(entity
669+
// adapter 同款装配),不设独立 provider/model 键;llmAudit.enabled=false 时本闸
670+
// 不运行(无账目的判定不可见也不该花钱)。lightMode 强制关(LLM-per-turn 附加
671+
// 路径与低资源档互斥)。
672+
preInjectGate: z.object({
673+
enabled: z.boolean().default(false),
674+
enforce: z.boolean().default(false)
675+
}).default({}),
676+
656677
// --- #164 A2: secret / PII scan at the write boundary ----------------------
657678
// 写入边界的密钥 / PII 判据(src/sensitive-scan.js)自身的闸。与 writeAdmission
658679
// 的 enabled 分开是有意的:那一个管 #254 第 1 级的空白 / 噪声判据,本键管 A2 这
@@ -792,6 +813,10 @@ const LIGHT_MODE_OFF = [
792813
"documentMemoryEnabled",
793814
// 轻量模式不开热计算(heat 属于重型增强;关掉后 sleep 降级也退回纯时间分层)。
794815
"heatEnabled",
816+
// 轻量模式不开注入前判定(#380:LLM-per-turn 附加路径,每帧注入多一次池级
817+
// 判定调用——与低资源档互斥;预设给的默认值,用户显式勾选仍然赢)。点分键
818+
// 由 applyLightModePreset 的嵌套赋值分支处理。
819+
"preInjectGate.enabled",
795820
// #249 N3:轻量档默认不开压缩边缘双落点——它往对话里追加消息(新的注入表面),
796821
// 轻量档(小模型 / 小上下文)最不该再多一份注入物。这是预设给的默认值、不是强制:
797822
// 用户显式勾选仍然赢(合并顺序「用户开关 > 轻量预设 > bundle 配置」,同
@@ -808,7 +833,17 @@ const LIGHT_MODE_OFF = [
808833
export function applyLightModePreset(cfg) {
809834
if (cfg?.lightMode !== true) return cfg;
810835
const preset = { ...cfg, lightMode: true };
811-
for (const key of LIGHT_MODE_OFF) preset[key] = false;
836+
for (const key of LIGHT_MODE_OFF) {
837+
// 点分键(#380 preInjectGate.enabled):对象子键的预设翻转——浅拷贝父对象后
838+
// 改子键,避免直接改到用户 config 里的同一引用。平铺键照旧直赋。
839+
const dot = key.indexOf(".");
840+
if (dot < 0) {
841+
preset[key] = false;
842+
continue;
843+
}
844+
const parent = key.slice(0, dot);
845+
preset[parent] = { ...(preset[parent] ?? {}), [key.slice(dot + 1)]: false };
846+
}
812847
return preset;
813848
}
814849

‎dsh-mneme/lib/index.js‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ import { createWriteAdmission } from "./write-admission.js";
99
import { createSensitiveScan } from "./sensitive-scan.js";
1010
import { createTools } from "./tools.js";
1111
import { createInjector } from "./inject.js";
12+
import { createPreInjectGate } from "./pre-inject-gate.js";
1213
import { createContinuityRescue } from "./continuity.js";
1314
import { createSummarizer } from "./summarize.js";
1415
import { createDreamScheduler } from "./dream.js";
@@ -436,12 +437,24 @@ export const apply = (ctx, config) => {
436437

437438
const disposers = [];
438439

440+
// Issue #380:注入前判定闸门。判定 LLM 走 entity adapter 同款装配(ctx.llm +
441+
// agentDefaultModel 回退),gate 自持 enabled/usable 判定(未启用/llm 缺席/
442+
// llmAudit 关闭时内部恒 off,注入行为与现状逐字节一致)。
443+
const preInjectGate = createPreInjectGate({
444+
llm: ctx.llm,
445+
agentDefaultModel: ctx.agentDefaultModel,
446+
service,
447+
config: cfg,
448+
logger: ctx.logger
449+
});
450+
disposers.push(() => preInjectGate.clear());
451+
439452
// #118: never let a pending embedder init retry fire after unload and touch
440453
// a torn-down context.
441454
disposers.push(() => semantic.dispose()); // #118 重试计时器 + boot 回填计时器(搬入 semantic.js 后由它自持)
442455

443456
ctx.inject(["systemPrompt"], (promptCtx) => {
444-
if (cfg.autoInject) disposers.push(createInjector(promptCtx, service, settings, cfg));
457+
if (cfg.autoInject) disposers.push(createInjector(promptCtx, service, settings, cfg, preInjectGate));
445458
});
446459

447460
// #249 N3:压缩边缘双落点。触发靠宿主自己落的压缩事件(订阅 + pre-step 追加),

0 commit comments

Comments
 (0)