docs(plans): 浠艾福平台程序修改计划 v1.0（guhe_v2 兼容·知识库低侧口径·专家同步）——入池溯源锚点

docs/superpowers/plans/2026-11-08-浠艾福平台程序修改计划.md

@@ -0,0 +1,96 @@
+# 浠艾福平台程序修改计划（guhe_v2 兼容 · 知识库低侧口径 · 专家同步）
+
+> **文档版本**: v1.0
+> **状态**: 待评审（C 档平台侧确认后转实施）
+> **日期**: 2026-11-08
+> **功能**: 平台程序对接 2026-11-08 三项变更——① 采集器 guhe_v2（32 键 + 分页残段清洗）② 统一知识库 `+guhe2026.2`（含 `条件致病菌低侧判读补充（人工）` 补丁块 + 既有键补齐）③ 归因教练专家 §5.1.1 低侧口径四条
+> **依赖**: 工作区《浠艾福-报告归因方案-总体设计修改方案-v1.1.md》（六层架构基准，2026-11-06 定稿）；三项变更已在工作区完成并回归验证（`_verify_guhe_v2.py` 全 PASS）
+
+---
+
+## 一、变更范围（一句话结论）
+
+三项变更**不改变** v1.1 的六层架构与 P0–P3 分期，而是升级其 L1/L2/L4 三层的「输入资产」。平台程序必须跟进的落点四个：**L1 新增 guhe_v2 指纹路由、L2 感知 `谷禾2026新版扩展知识` 新键与低侧补丁、L4 新增条件致病菌偏低侧判读规则、横切合规门禁新增低侧红线组**。
+
+**优先级判断**：本轮仅「低侧判读口径」为 **P0** 级——它直接拆平台最易产生的误导链（条件致病菌越低越好 → 引导补菌）。其余（guhe_v2 路由、KB 新键、既有键补齐）为 P1/P2 级结构升级，随 v1.1 原分期自然落位。
+
+| 层 | 修改点 | 优先级 |
+|---|---|---|
+| **L1 接入归一化** | ① guhe_v2 指纹路由（`aidefansi→beijing→guhe_v2→standard`）② 分页残段清洗下沉 + 校验断言 ③ 新旧分流（旧 21 键不走增量）④ 32 键空壳率防错 | P1 |
+| **L2 事实与知识** | ① KB 版本感知 `+guhe2026.2` ② **低侧补丁块可查询** ③ 既有键新字段（菌属功能库 [40]/[72]/[73]、菌种综合信息、艾德范思）暴露 ④ 个人层双断言（键名级 + 内容级） | **P0（②④）** / P1 |
+| **L4 归因引擎** | ① 低侧四机制判读入库（关联非因果）② U 型双向口径（越低越好不成立、参考下限 0）③ **偏低不推荐补菌**（禁缺X→补X桥接）④ 五维 no_path 映射 | **P0（①②③）** / P1 |
+| **合规门禁（横切）** | ① 低侧红线组（association_only 强制、禁处方化措辞）② 16S 粒度拦截菌株级推荐 ③ 证据码隔离（COM 不进推荐依据） | **P0（①②）** / P1 |
+
+---
+
+## 二、输入变更基线（2026-11-08 已验证，A 档）
+
+### 2.1 采集器：`extract_guhe_v2.py`
+- **新增 guhe_v2 格式**：谷禾 2026-11 新版标准报告 = 旧 21 键打底 + 11 增量键 = **32 键**；判定顺序 `aidefansi → beijing → guhe_v2 → standard`，旧三类路由不变。
+- **分页残段清洗**：`_PAGE_TAIL` / `_strip_table_tail()` 根治「与健康相关菌评估」分页表拼接（如 `34/167 0.0033 参考 0-0.1746% ND`），个人层丰度不再混入知识层；清洗后 76 条、残段 0 命中；四副本 MD5 一致。
+
+### 2.2 知识库：`统一知识库.json`（`+guhe2026.2`）
+- 三份同步（工作区主库 / 专家 cache / 市场源），版本 `3.0+guhe2026.2`（主）/ `3.1+guhe2026.2`（专家），扩展块 11 子键逐字段一致。
+- **新增子键** `条件致病菌低侧判读补充（人工）`：判读铁律（U 型双向 / 参考下限 0 / 16S 粒度 / 不推荐补菌 / 关联非因果）+ 大肠杆菌偏低侧四机制 + 报告原文口径引用（个人值剥离）。
+- **既有键补齐**（只填空、不覆盖，幂等）：菌属功能库 [40] 埃希氏菌属 / [72] 大肠杆菌 / [73] 脆弱拟杆菌（8 字段）、菌种综合信息「埃希氏菌属」`偏低侧影响`、艾德范思大肠杆菌 `健康定植说明`。
+
+### 2.3 归因教练专家：`socratic-coach.md` §5.1.1
+- 新增「条件致病菌偏低侧口径」四条：① 并非越少越好 ② 参考下限 0、`ND` 只是低于检出丰度 ③ 16S 只到属/种、菌株×宿主情境 ④ **偏低不推荐补菌**。cache 与市场源已同步（MD5 一致）。
+
+---
+
+## 三、任务分解（TODO）
+
+### P0 · 红线先行（先止血，不动架构）
+
+- [ ] **T1 低侧补丁块接入 KB 查询（L2-2）**：`条件致病菌低侧判读补充（人工）` 作为独立可查询子键（判读铁律 / 四机制 / 报告口径），供 L4 归因引擎与合规门禁直接取用
+- [ ] **T2 个人层双断言（L2-4）**：写库前键名级（`_PERSONAL_KEYS`）+ 字符串内容级（页码残段 / `ND 参考` 扫全文）；正样本「大肠杆菌改善方式以『苦丁茶』开头」
+- [ ] **T3 低侧判读规则入库（L4-1/L4-2）**：条件致病菌偏低侧按四机制解释，全部标「关联非因果」；U 型双向口径；参考下限 0 的菌不标「偏低超标」
+- [ ] **T4 低位补菌红线（L4-3）**：无成熟证据支持「缺大肠杆菌→补大肠杆菌」；⛔ 禁「报告缺 X → 买含 X 菌株产品」桥接（叠加 §5.2 16S 粒度声明）
+- [ ] **T5 低侧红线组（G-1）**：新增合规规则——`association_only == true`；禁写「缺 X→致病/需补充」；禁把调整建议写成处方；措辞白名单「相关联/报告提示/可能与…有关」
+- [ ] **T6 16S 粒度拦截（G-2）**：`granularity != strain` 时禁生成含菌株号的商品推荐
+
+> 验收：平**任意「偏低」归因节点 `association_only==true`；存量无「缺大肠杆菌→补菌」措辞；低侧机制证据全部标 PUB/KB。（对齐 v1.1 验收 3/5/6）**
+
+### P1 · IR 与双轨（打通主因维）
+
+- [ ] **T7 guhe_v2 指纹路由（L1-1）**：判定顺序 `aidefansi→beijing→guhe_v2→standard`；触发词「疾病相似评估 / 厚壁菌比拟杆菌比值 / 亚健康及营养饮食不合理」；键数自检 32 键
+- [ ] **T8 新旧分流（L1-3）**：按 `报告格式版本` 分流；旧 21 键走原 v5 流程；**禁把 32 键误判成路由错误**、**禁把旧 21 键强套 guhe_v2**
+- [ ] **T9 KB 版本感知（L2-1）**：KB 服务读取并暴露 `谷禾2026新版扩展知识`（11 子键）；升级脚本幂等（重复运行只覆盖不累积）
+- [ ] **T10 既有键新字段暴露（L2-3）**：菌属功能库 [40]/[72]/[73] `偏高影响`/`偏低影响`、菌种综合信息「埃希氏菌属」`偏低侧影响`、艾德范思大肠杆菌 `健康定植说明` 入 L2 查询返回
+- [ ] **T11 证据码隔离（G-3）**：低侧机制证据标 PUB/KB；COM 只作存在性记录；未核实编号标「未核实」
+
+> 验收：guhe_v2 报告 32 键校验通过；KB 返回 11 子键含低侧补丁块；两代报告同家族各自独立判读、不拼时间趋势。（对齐 v1.1 验收 1/2/4/8）
+
+### P2 · 引擎与产品化（解次生维）
+
+- [ ] **T12 分页残段清洗下沉（L1-2）**：Adapter 调用 `extract_guhe_v2()` 自动获得清洗；校验层断言物种库条目不含 `\d{1,3}/16\d`
+- [ ] **T13 空壳率防错（L1-4）**：guhe_v2 解析后校验增量 11 键齐全；空壳（曾误用艾德范思提取器产 26 键）→ 换正确提取器
+- [ ] **T14 五维映射（L4-4）**：菌群观测对「富/行」自动标 `no_path`；心/智介导链自动加 ⚠ 并锁关联措辞；低侧口径归身维主战场
+
+> 验收：换一份 guhe_v2 家庭数据，Adapter 零改动出全套；任一新库字段在 L2 查询可反查。（对齐 v1.1 验收 7/9/10）
+
+### P3 · 沉淀与协同
+
+- [ ] **T15 跨案例聚合**：低侧口径并入既有 P3 聚合口径，可检索「同条件致病菌低侧」应对方案
+
+> 验收：跨案例可按低侧判读口径聚合同策略。
+
+---
+
+## 四、待确认项（C 档 · 平台侧确认后转 A 档，不据此改动现有文件）
+
+| # | 待确认 | 影响 |
+|---|---|---|
+| 1 | **Adapter 实现形态**：平台是否已封装统一 Adapter 接口 | L1-1 是「新增 guhe_v2 分支」还是「重写路由」 |
+| 2 | **KB 服务加载方式**：`统一知识库.json` 文件直读 or 服务层 | L2-1/L2-3 是「文件升级」还是「服务接口新增」 |
+| 3 | **L4 引擎存在性**：专家 prompt 驱动 or 已有规则引擎 | L4-1～L4-3 是「补规则」还是「新建规则表」 |
+| 4 | **合规门禁挂载点**：平台是否已有门禁框架 | G-1 低侧红线组落在哪个拦截点（L4 出结论前 / L5 出文档前） |
+
+---
+
+## 五、边界声明
+
+- 本计划为**平台侧程序修改建议稿**；事实基础为 A 档（工作区已验证），线上实现相关判断（第四节）为 C 档待确认。
+- 三项变更均已在工作区完成并通过 `_verify_guhe_v2.py` 回归（32 键端到端、三库一致、专家同步、技能四副本一致）。
+- 不构成对任何人的健康评估、诊断或干预建议；所有低侧机制表述为「关联非因果」。