From 535db43b5b37262d8cc063ebaa9d4bd368f4fdba Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B0=8F=E5=94=AF?= Date: Sun, 22 Nov 2026 22:42:30 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20DESIGN=20v3.9=20=E2=80=94=20=E5=AE=9E?= =?UTF-8?q?=E9=99=85=E6=9E=B6=E6=9E=84=E4=B8=8E=E7=9B=AE=E6=A0=87=E5=B7=AE?= =?UTF-8?q?=E8=B7=9D=EF=BC=88=E8=AE=BE=E8=AE=A1=E6=98=AF=E7=9B=AE=E6=A0=87?= =?UTF-8?q?=E4=B8=8D=E6=98=AF=E7=8E=B0=E7=8A=B6=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit v3.8 把设计目标和实现现状写成同一件事,导致读文档的人以为: 图谱扩展在跑(实际默认停)、四层模型齐全(实际 3.5 层)、 namespace 严格隔离(实际全库跨 ns)。 v3.9 用三标记分开:✅ 现状(有实测读数)/ 🎯 目标 / ⚠️ 差距。 新增章节: - §2.1 表结构(40 列,v3.8 误写 41) - §3.3 跨 ns 隔离未实现(🔴 老偏差) - §3.4 audit 域三重语义(新维度) - §4 FTS 通道参数与计分公式(v3.8 无此层) - §5 写入三通路(2 条曾断线) - §6 自优化分级 L0-L3(L3 执行权留人) - §8 v3.8→v3.9 差异清单(🔴3 黄5 绿4) - §10 方法论 15 条(判据/结构/归因/流程) 所有数字带读数时刻——库在持续写入,次日必然不同。 --- DESIGN-v3.9-实际架构.md | 442 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 442 insertions(+) create mode 100644 DESIGN-v3.9-实际架构.md diff --git a/DESIGN-v3.9-实际架构.md b/DESIGN-v3.9-实际架构.md new file mode 100644 index 0000000..1d3da11 --- /dev/null +++ b/DESIGN-v3.9-实际架构.md @@ -0,0 +1,442 @@ +# 织忆 (MemoryWeave) — 实际架构与目标差距 v3.9 + +> 生成日期:2026-11-22 +> 上一版:DESIGN.md v3.8(2026-09,1,602 行) +> **本版原则:设计是目标,不是现状。** + +--- + +## 0. 怎么读这份文档 + +v3.8 把「设计目标」和「实现现状」写成了同一件事。结果是:读完 v3.8 的人会以为图谱扩展在跑、四层模型齐全、namespace 严格隔离——三件都不成立。 + +**v3.9 把三样东西分开标:** + +| 标记 | 含义 | +|---|---| +| ✅ **现状** | 代码里真实跑的,有实测读数 | +| 🎯 **目标** | 设计想要的,尚未实现 | +| ⚠️ **差距** | 现状与目标之间,附原因 | + +**没有读数的「现状」,一律不算现状。每个数字都带着它的时刻。** + +> ⚠️ **本文所有计数均为 2026-11-22 23:0x–23:1x 实测。** +> 库在持续写入(今日 llm_distill +133 条),次日读数必然不同。 +> **引用本文数字时,请连同时刻一起引用,或重新实测。** + +--- + +## 1. 系统定位(未变) + +织忆是**记忆层**,不是行为层。只负责存储、检索、蒸馏、共享、质量审核,不干预 Agent 行为决策。 + +``` + 织忆 (:7821) + ┌────────────┼────────────┐ + ▼ ▼ ▼ + Hermes OpenClaw 未来 Agent + (飞书对话) (代码项目) (任意) +``` + +**做**:存储 / 检索 / 蒸馏 / 冲突检测 / 遗忘 / 知识图谱 / 跨 Agent 共享 / 质量自优化 +**不做**:行为干预 / 任务调度 / 权限控制 / Agent 决策 + +--- + +## 2. 记忆分层:实际 3.5 层 + +| 层 | 目标(v3.8) | 现状(实测 2026-11-22) | 差距 | +|---|---|---|---| +| **L0 Episodes** | 原始对话,不可变审计锚点 | ✅ **143,538 行**(2026-11-22 23:1x),`episodes.lance` ~1.97G,**40 列** | 无 | +| **L1 Distilled** | 蒸馏事实/决策/偏好,向量检索主层 | ✅ **50,334 行活**(同上时刻),`memories.lance` 690M,**40 列** | 无 | +| **L2 Patterns** | 跨任务重复模式(聚类产出) | ⚠️ **仅 10 条**,端点 `/api/v1/patterns` 活着但产出极少 | 聚类引擎在跑(consolidate sidecar 约 15 分钟一轮),但只产出 10 条模式 | +| **L3 World Model** | ℰ/ℐ/C 三元组,被动观察驱动 | ❌ **无实现** | 代码里没有这个模块 | + +**⇒ 实际是 2 层满 + 1 层半 + 1 层空。** + +**L2 为什么少**:`consolidate` sidecar 日志实测 `clusters=44 noise=9733` —— 44 个簇里只有极少数达到 pattern 生成阈值。噪声占比 99.5%。 + +--- + +### 2.1 表结构(实测 40 列,v3.8 写 41 列) + +`memories` 与 `episodes` **都是 40 列**,字段完全一致(同一 models.MemoryRecord 结构): + +``` +id, agent_id, namespace, content, category, vector, tier, importance, +quality_score, recall_count, useful_count, not_useful_count, freshness, +version, version_history, source, volatile_flag, is_deleted, depends_on, +derived_from, last_recalled_at, created_at, updated_at, embedding_model, +script_version, confidence, confidence_source, human_not_useful_count, +dedup_downweight_count, recall_seen_count, recall_verified_count, +delete_reason, source_events, supersedes, superseded_by, valid_from, +valid_to, provenance, human_useful_count, expires_at +``` + +**关键列语义**: +| 列 | 含义 | 备注 | +|---|---|---| +| `vector` | `fixed_size_list[1024]` | FTS 命中记录此列置空 ⇒ 不能混入向量重排 | +| `derived_from` | 指向来源 episode | **溯源链的关键**,可反查 `source_events` | +| `provenance` | 来源类型 | `inferred` / `explicit` 等 | +| `is_deleted` | 软删标记 | `/stats` 的 `tombstone_count` 数的是它(物理 `tombstones` 表实际 0 行) | +| `confidence` | 置信度 | NULL = 未测(非 0) | + +**⚠️ 口径陷阱**:`/stats` 报 `tombstone_count=2,083`,但物理 `tombstones` 表 `to_arrow()` 读是 **0 行**。前者数的是 `memories.is_deleted=true`。**报数时用活库(`total_memories - tombstone_count`)做分母。** + + +## 3. Namespace 体系:7 类 30 个(v3.8 只有 3 类) + +### 3.1 实际分布(2026-11-22 实测) + +``` +a06-main 17,136 ← 主 brain +hermes-main 14,324 +hermes 12,085 +domain:OPS 2,090 ← 域知识 +shared 2,008 +domain:DEV 1,609 +domain:STOCK 653 +prof-cloud-main 516 ← 分身 +domain:intel 491 +prof-dev-main 427 +wiki 190 +soulful-xiaowei 141 ← 情感层 +audit 137 ← 🆕 2026-11-22 新增 +prof-intel-main 85 +domain:BIZ 93 +domain:QA 49 +domain:verify 47 +prof-stock-main 44 +domain:INSIGHT 40 +eval-bench-* 34 +prof-qa-main 24 +openclaw-main 22 +domain:ORCHESTRATOR 19 +prof-biz-main 18 +prof-verify-main 15 +domain:CREATIVE 14 +domain:HUB 12 +research-main 11 +domain:qa 11 +``` + +### 3.2 七类语义 + +| 类别 | 命名 | 用途 | +|---|---|---| +| 主脑 | `{agent}-main` | 单 agent 私密工作记忆 | +| 共享 | `shared` | 跨 agent 可见(牧尘偏好、系统事实) | +| 域知识 | `domain:{NAME}` | 按职能域组织(OPS/DEV/STOCK/BIZ/QA…) | +| 分身 | `prof-{name}-main` | 各 profile 独立 | +| 灵魂 | `soulful-xiaowei` | 人侧数据(画像/心迹/牵挂/偏好) | +| 词典 | `wiki` | 从笔记/技能提取的规则 | +| **审计** | **`audit`** | **🆕 系统自身修复史/判据/案卷(隔离域)** | + +### 3.3 ⚠️ 差距一:跨 ns 召回规则未实现 + +**目标(v3.8 §1.3)**:「默认只搜自己的 namespace + shared,显式 `include_namespaces` 才跨域」 + +**现状**:`namespace=""` ⇒ **全库跨 ns 召回**。实测: + +``` +query="牧尘生日" ns=空 → hermes-main:2 / a06-main:2 / prof-intel-main:2 / domain:OPS:1 +``` + +**⇒ 跨了 4 个域。任何 agent 都能看到别人的私密记忆。** + +**唯一补丁(2026-11-22)**:`ZHIYI_RECALL_EXCLUDE_AUDIT=1` 剔除 audit 域。**只补了一类,其余 29 个 ns 仍然全通。** + +### 3.4 audit 域的三重语义(新增) + +| 属性 | 值 | +|---|---| +| 写入 | `t_audit_ns_guard`:蒸馏内容命中 ≥2 审计标记词 ⇒ 强制改道 `audit` | +| 读取 | `t_audit_ns_exclude`:跨库查询默认剔除;显式 `ns=audit` 可查 | +| 门禁 | 豁免元笔记过滤(`t_audit_meta_exempt`)——它装的就是「关于系统自身」 | +| 现状 | 137 条(案卷摘要 1 + 误诊修正 3 + 今晚蒸馏改道) | + +**语义**:挡污染的门,同时是元认知的家。 + +--- + +## 4. Recall 链路:实际 9 步(v3.8 只有 7 步) + +``` +query 进入 + ↓ +Step 1 bge-m3 编码(1024 维,L2 归一化,本地 :8001) + ↓ +Step 2 ANN 粗检索(自有 ns + shared 两路,200 候选)← v3.8 写 50 + ↓ +Step 2.2 FTS 词面通道 ← 🆕 v3.8 无 + 内存 TF-IDF 倒排(ASCII 词 + CJK bigram),IDF 加权 + ↓ +Step 2.5 过滤原始对话(category=episodes/raw 剔除) + ↓ +Step 3.5 BM25 关键词分(candidates 上) + ↓ +Step 3 Rerank(bge-reranker-v2-m3,优先 API,失败回退 cosine) + ↓ +Step 3.5 🆕 C2 复审:过门槛的 FTS 命中送 cross-encoder 打分, + 与向量候选 append 进同一池 + 按分排序(位置由分定) + ↓ +Step 3.6 关键词分融入最终排序(V2) + ↓ +Step 3.7 来源加权偏置(SOURCE_TIER_BIAS=0.2) + ↓ +Step 3.8 尾部位追加(落选的 FTS 命中兜底,TAIL_HEAD=5 保护头部) + ↓ +Step 4 MMR 多样性去重(jaccard bigram,非向量) + ↓ +Step 5 图谱扩展(⚠️ ZHIYI_GRAPH_EXPAND 默认 0 = 停算) + ↓ +返回 top-k +``` + +### 4.1 ⚠️ 差距二:图谱扩展默认停 + +**目标(v3.8 §2.6)**:「结果 < 5 条时,双向 BFS 扩展 1 跳」 + +**现状**:`ZHIYI_GRAPH_EXPAND` 默认 `0`。**2026-11-02 因噪声率 88.5% 主动关闭**(`ZHIYI_GRAPH_AUTO_SYNTH=0` 同理)。 + +⚠️ **这是「有理有据地偏离设计」**——但 v3.8 没记录,读文档的人会以为它在跑。 + +### 4.2 ⚠️ 差距三:ANN 候选 200 vs 设计 50 + +**现状**:`ann_search` 200 候选。**v3.8 写 50。** 无记录说明何时改、为什么改。 + +### 4.3 FTS 通道的关键参数(v3.8 完全没有这一节) + +| 参数 | 当前值 | 含义 | +|---|---|---| +| `ZHIYI_FTS_BIGRAM_TAIL_GATE` | 0.15 | 1-bigram(2 字 CJK)门槛 | +| ≥2-bigram 门槛 | **公式推导**:`0.32×(1-1/(nb+1)) × RATIO` | RATIO 缺省 0.80 | +| `ZHIYI_FTS_C2_N` | 3 | C2 进池上限(0=关闭) | +| `ZHIYI_FTS_C2_MIN_SCORE` | 0.30(实测分布 0.563–1.256,此值当前空转) | C2 晋升最低分 | +| `ZHIYI_FTS_TAIL_HEAD` | 5 | 尾部位不得吃进前 5 名 | +| `ZHIYI_FTS_REBUILD_WINDOW_MIN` | 5 | 索引重建节流窗口(原 30) | +| `ftsIndexMaxAge` | 6h(硬编码) | 索引最长保鲜期兜底 | + +**FTS 计分公式(实测吻合)**: +``` +v = 0.32 × (1 - 1/(nb+1)) // nb = 命中的 bigram 数 +``` +- 命中 1 个 ⇒ 0.160 +- 命中 2 个 ⇒ 0.2133 +- 命中 3 个 ⇒ 0.240 +- 命中 4 个 ⇒ 0.256 + +**已知缺陷**:滑窗 bigram 产生跨词界假词(「牧尘生日」→ 牧尘/**尘生**/生日),nb 被碎片污染。词级分词是后续手术。 + +--- + +## 5. 写入链路:3 条通路,其中 2 条曾断线 + +**v3.8 只说「蒸馏引擎写入 memories」,没区分通路。实测有三条:** + +| 通路 | 入口 | 触发条件 | 曾断的线 | +|---|---|---|---| +| **A. 蒸馏落库** | `distill.OnDistillComplete` | episode 完成蒸馏 | ✅ 接了 `FtsInvalidate`(server.go:529) | +| **B. 直接写入** | `POST /api/v1/memory/write` | 工具调用 / 显式写 | ❌ **直到 2026-11-22 才补**(core.go 只清搜索缓存,从不标脏 FTS) | +| **C. 合并改写** | `core.go` merge 分支 | 近重复并入 | ❌ 同上,2026-11-22 补 | + +### 5.1 断线的后果(实测) + +**手写记忆最长 6 小时不被索引认识。** +- 12:45 写入的「七题原话」→ 直到 18:31 索引重建才可见 +- 根因不是「Invalidate 没生效」,是**它在这个函数里根本不存在** + +### 5.2 索引重建机制(v3.8 无此节) + +``` +写入 → FtsInvalidate() 置 dirty=true(打日志「脏标记已置」) + ↓ +查询 → FtsSearch → ensureFresh() + ↓ +stale = neverBuilt || dirty || since(builtAt) > 6h +throttled = since(builtAt) < REBUILD_WINDOW (5min) ← 2026-11-22 从 30min 改 +retryTooSoon = since(lastAttempt) < 5min ← 失败退避 + ↓ +放行 ⇒ 异步 rebuild(全量 ScanAll,实测 ~1 秒 / 50k 文档) +``` + +**关键设计**:节流基准是 `builtAt`(上次**成功完成**),不是 `lastAttempt`(上次**尝试**)。 +**2026-11-22 修**:旧实现每次 `ensureFresh` 都刷新 `lastAttempt` ⇒ 高频查询下永久 `throttled` ⇒ 重建饿死(实测间隔 1h14m–4h46m 无界)。 + +**⚠️ 已知缺口**:`lastAttempt` 与 `builtAt` 都是**内存态**,重启归零 ⇒ 部署后首个 FTS 查询必然同步重建,与节流无关。 + +--- + +## 6. 自优化与自升级:分四级 + +**v3.8 §3.2 只写了「自优化引擎」,没分级,也没说边界。** + +### 6.1 已在工作的(L0-L1) + +| 级别 | 内容 | 现状 | +|---|---|---| +| **L0 自动整理** | distill 蒸馏、dedup/merge、decay/TTL 遗忘 | ✅ 在跑(consolidate sidecar 约 15min/轮) | +| **L1 参数自调** | `gap_threshold`、`decay_rate`、`diversity` 等 | ⚠️ 部分(`selfoptimize.go` 1,220 行在调 gap 阈值,其余是静态配置) | + +**`/api/v1/tuning/status` 实测**: +```json +{"config":{"consolidate_after":50,"decay_rate":0.015, + "distill_interval":5,"diversity":0.1,"gap_threshold":3}, + "history":null, "last_skipped":null} +``` + +**⇒ `history: null` ⇒ 从来没有真正调过参数。自优化引擎「装好没接线」。** + +### 6.2 目标分级(尚未实现) + +| 级别 | 内容 | 前置条件 | 执行权 | +|---|---|---|---| +| L1 | 热调参数(MIN_SCORE、C2_N、窗口、distill 频率) | bench30 趋势稳定 | 系统自调,人验收 | +| L2 | 策略自调(merge 阈值、MMR lambda、蒸馏节奏) | 度量体系跑稳 | 系统自调,人验收 | +| **L3** | **结构变更(改 schema、改代码)** | — | **系统只做提案者:产出 diff + 预期判据 + 预期读数,人按部署键、人验收** | + +**L3 不放权的证据就是 2026-11-22 当天**:判据 5 用旧二进制测新机制的假通过、单 grep 找到读路径漏了写路径、补丁落在错误通路对面——**连清醒的判官都需要「测的是哪只二进制」这道防线**。 + +### 6.3 自优化的启动条件(2026-11-22 排定) + +1. **审计边界** ✅(`t_audit_ns_guard`) +2. **可信度量** ⚠️(bench30 稳定读数——当前 fp=0 是一次判决,不是一个性质) +3. **然后才是度量驱动的参数自调** + +**次序**:先跑通 → 再可信 → 再自省 → 最后自我修改。顺序反了,就是 2026-11-22 的样子:一个努力整理着判词、却不知道自己在污染什么的系统。 + +--- + +## 7. 关键配置旋钮(当前生效值) + +``` +# 检索 +ZHIYI_FTS_BIGRAM_TAIL_GATE=0.15 1-bigram 门槛 +ZHIYI_FTS_C2_N=3 C2 进池上限(0=关) +ZHIYI_FTS_C2_MIN_SCORE=0.30 C2 晋升门槛(实测空转,分布 0.563+) +ZHIYI_FTS_TAIL_HEAD=5 尾部位头部保护 +ZHIYI_FTS_REBUILD_WINDOW_MIN=5 重建节流窗口 +ZHIYI_RERANK_API_MAX_DOCS=50 单次送排上限 +ZHIYI_RERANK_N_FLOOR=100 重排深度下限 +ZHIYI_RERANK_TIMEOUT_MS=4000 API 硬超时 + +# 排序偏置 +ZHIYI_CONFIDENCE_LAMBDA=0.1 置信度加权 +ZHIYI_CONFIDENCE_MEAN=0.7 置信度基准 +ZHIYI_SOURCE_TIER_BIAS=0.2 来源分档 +ZHIYI_FEEDBACK_BIAS=0.2 反馈加权 +ZHIYI_FEEDBACK_K=3 + +# 门控 +ZHIYI_RECALL_EXCLUDE_AUDIT=1 跨库剔除 audit 域 +ZHIYI_AUDIT_NS_GUARD=1 审计内容改道 +ZHIYI_GRAPH_AUTO_SYNTH=0 图谱合成停写 +ZHIYI_META_FILTER=1 元笔记门禁(audit 豁免) +ZHIYI_STANDING_ANSWER=1 常设答案 +ZHIYI_SUPERSEDE_MODE=soft 版本取代(⚠️ 门控 ZHIYI_SUPERSEDE 未设 ⇒ 实际 off) +``` + +**⚠️ 一个已知死锁**:`ZHIYI_SUPERSEDE`(门控,off/shadow/apply)与 `ZHIYI_SUPERSEDE_MODE`(模式)是**正交变量**。当前门控 `off` ⇒ 模式 `soft` 空转。11 月还在提交「确定性 supersede」代码,运行时门却锁着——**研究线活着,手术线停着**。 +**观察期没有出口判据,等于无限期挂起。** + +--- + +## 8. v3.8 → v3.9 差异清单 + +| # | 项 | v3.8 说 | 实际 | 性质 | +|---|---|---|---|---| +| 1 | 跨 ns 召回 | 默认只搜自己+shared | **全库跨 ns** | 🔴 未实现的隔离 | +| 2 | L3 World Model | ℰ/ℐ/C 三元组 | **无实现** | 🔴 缺件 | +| 3 | L2 Patterns | 跨任务模式 | 仅 10 条(噪声 99.5%) | 🟡 产出极低 | +| 4 | 图谱扩展 | <5 条时 BFS 1 跳 | **默认停**(88.5% 噪声,主动关) | 🟡 有理有据的偏离 | +| 5 | ANN 候选 | top_k=50 | **200** | 🟡 无记录 | +| 6 | FTS 词面通道 | 无 | **有**(11-14 加) | 🟢 设计外增益 | +| 7 | C2 cross-encoder 复审 | 无 | **有**(11-22 加) | 🟢 设计外增益 | +| 8 | namespace 类别 | 3 类 | **7 类 30 个** | 🟢 演进 | +| 9 | audit 域 | 无 | **有**(11-22 加) | 🟢 新维度 | +| 10 | 写入通路 | 「蒸馏引擎写入」 | **3 条,2 条曾断线** | 🔴 未文档化 | +| 11 | 自优化 | 「自优化引擎」 | 引擎在,`history:null`(没调过) | 🟡 装好没接线 | +| 12 | supersede | 版本取代 | **门控 off,模式空转** | 🟡 死锁 | + +**统计:🔴 3 红 / 🟡 5 黄 / 🟢 4 绿。** + +--- + +## 9. 目标态:下一步该做什么 + +### 9.1 短期(本周) + +| 项 | 理由 | +|---|---| +| **判官定标** | bench30 是所有参数工作的护栏;判官是橡皮尺的话,护栏自己在晃。实测检索 10 遍 0 浮动、判官同证据翻供 ⇒ 方差源已定位 | +| **管道治理立案** | 7,564 条 llm_distill、今日 +133、dedup 只吸收约 18% ⇒ 容量是生存问题,不是卫生问题 | +| **−14 与 45/37/8 结案** | merge 去向,一行 grep,别再过夜 | + +### 9.2 中期 + +| 项 | 前置 | +|---|---| +| 跨 ns 隔离真正实现 | 需先定义「agent 如何声明自己的 ns」 | +| L3 World Model | 需先定义 ℰ/ℐ/C 三元组的实际形态 | +| L2 Patterns 提产 | 需先解决 consolidate 99.5% 噪声 | +| 词级分词(杀假 bigram) | 需中文分词器 | +| supersede 死锁拆解 | 需先写观察期出口判据 | + +### 9.3 长期 + +- L1 参数自调试点(bench30 趋势为唯一依据) +- L3 提案制自升级(系统产出 diff + 预期判据,人按部署键) + +--- + +## 10. 方法论(本案五周产出,比代码更值钱) + +### 10.1 判据类 + +1. **注释不作数,environ 才作数**——文件写的和进程跑的是两张皮 +2. **摘要不作数,线上请求才作数**——交付文档里的参数值可能是错的 +3. **「修了」不作数,作用于真断点的修才作数**——两个 token 对照(1.000 / 0.000) +4. **「测的是哪只二进制」是每轮验收固定首行**——health=200 与 running new code 是两回事 +5. **退出码 0 证明语法,panic 证明契约**——编译通过不等于接线正确 + +### 10.2 结构类 + +6. **append 一个数组,审它的全家**——`candidates`/`reranked`/`dbQuality` 三兄弟,查两个就 panic +7. **引入新维度当天,grep 旧路径对它的一切隐式假设**——尤其那些「不用考虑」的 +8. **写侧隔离不配读侧剔除,就是把卷宗搬进密室、门却不上锁** +9. **看不见是否 = 不知道有没有**——C2 晋升标记丢失,全靠 channel 字段才发现 + +### 10.3 归因类 + +10. **测量与模型矛盾时,先列变量表,再猎机制**——可能模型错、测量错、或第三变量动了 +11. **冻结一端才能判另一端**——判官不稳还是检索不稳?检索 10 遍 0 浮动,答案自明 +12. **误诊史比 bug 史值钱**——bug 告诉系统哪里坏过,误诊告诉系统自己会怎么错 + +### 10.4 流程类 + +13. **预注册:动之前先写预期**——没有它,事后任何变动都能被合理化成「参数起效」或「纯属噪声」 +14. **执行与判读分开排期**——深夜适合跑代码,关键结论留给清醒的头脑 +15. **只按最坏情形校准的护栏,拦住的不只是事故,还有进度** + +--- + +## 附:一次完整的诊断链(2026-11-22,作为范例) + +``` +现象:问「牧尘生日」搜不到 + ↓ +假说一:索引陈旧 → 半对(rebuild 后部分恢复) +假说二:DF 剔除高频词 → 死(实测 DF=1,建索引零 DF 过滤) +假说三:rebuild 是分水岭 → 死(被 k 混淆) +假说四:k=5 零席位 → 销案(用户路径实为 k=20) + ↓ +终稿:写路径断线 —— distill 接了 FtsInvalidate,direct write / merge 没接 + ⇒ 手写记忆最长 6 小时不被索引认识 + ↓ +修复:core.go 补线 + 门槛分档 + C2 同池 + audit 隔离 + 元笔记豁免 + ↓ +验收:牧尘生日 top1(1.022)→ fp=0 → p50 210ms +``` + +**五稿死因链,每稿都有证据,每稿都被下一稿推翻。最后定谳的那行证据小得可笑:`core.go` 里少一行 `FtsInvalidate()`。**