# 健康管理规则与可解释性台账（监管与审计备查）

| 属性 | 值 |
| --- | --- |
| **文档用途** | 统一登记系统内所有「指标标准归类、国标体检项目覆盖、异常提示抽取、跨年复查覆盖消解、趋势斜率预警、目标与待办裁剪」规则及其历次修正记录，确保每一条展示给用户的结论**有出处、可解释、可回溯、可审计** |
| **适用范围** | `packages/core/src/indicatorCatalog.ts`、`checkupGuidelineCatalog.ts`、`analyzer.ts`、`platform.ts` |
| **上位依据** | 国家卫健委《健康体检基本项目（2025年版）》（附件1/2/3/5）、《GB/T 47801-2026 陪诊服务规范》、《医疗器械分类目录》非医疗器械健康管理软件边界 |
| **当前版本** | v1.0（2026-10-27） |

---

## 一、 合规总红线（非医疗诊断声明）

1. **信息归集与原文溯源优先**：系统展示的任何「异常提示（FindingCard）」必须绑定至少一条用户已上传报告的**原文摘录（Quote）、医疗机构名称、检查日期及原件附件链接**。无原文依据的条目不得作为活跃异常展示。
2. **随访提醒严格依附医院结论**：所有「复查类待办（`category = "recheck"`）」均标注「依据医院诊疗结果/医嘱生成提醒（本系统不作医疗判读）」，不自行捏造诊断或处方。
3. **趋势提示与医疗复查解耦**：跨年指标在正常参考范围内的单调走高（斜率变化）仅作为生活方式与下次常规体检的**对照提示（`concern = "watch"`）**，**绝不自动生成去医院复查的待办任务**，避免过度医疗与焦虑。

---

## 二、 核心规则清单（5 大模块）

### 1. 标准指标库与院内别名归一规则（`R-CAT-IND`）
* **代码位置**：`packages/core/src/indicatorCatalog.ts`
* **权威依据**：`/data/医疗健康/guidelines/` 下《基本体检项目（2025年版）》《慢性病风险筛查项目（2025年版）》《常见慢性病风险评估指标（2025年版）》
* **规则说明**：
  - 收录 **54 项**标准定量/体格指标，统一以 2025 国标名称作为标准展示名（`displayName`，如统一使用「尿素氮」「丙氨酸氨基转移酶」「细胞角蛋白19片段」「总前列腺特异性抗原」）。
  - 收录 **220+ 个**医院常见异名与英文缩写（如 `尿素 / BUN / UREA` → `urea`；`ApoB / 载脂蛋白 B` → `apob`；`脂蛋白α / Lp(a)` → `lpa`；`CYFRA21-1` → `cyfra211`）。
  - **单侧/双侧方向定义（`higherIsWorse`）**：
    - `higherIsWorse: true`：越高越需关注（如血压、血糖、糖化、尿酸、总胆固醇、LDL-C、ApoB、Lp(a)、转氨酶、肌酐、肿瘤标志物）；
    - `higherIsWorse: false`：越低越需关注（如 HDL-C、载脂蛋白A1、白蛋白、血红蛋白、血清蛋白电泳α2）；
    - `higherIsWorse: undefined`：**双侧异常指标**（如促甲状腺激素 `TSH`、游离甲状腺素 `FT4`、白细胞 `WBC`、血小板 `PLT`、血钾 `K`、血钠 `Na`），过高或过低均可能异常，禁止在未超参考范围时套用单向斜率预警。

### 2. 国标建议体检项目表与覆盖判定规则（`R-CAT-CHK`）
* **代码位置**：`packages/core/src/checkupGuidelineCatalog.ts`
* **权威依据**：2025 版国标附件 1（自测问卷）、附件 2（基本体检项目）、附件 3（慢性病风险筛查项目）、附件 5（风险评估指标）
* **规则说明**：
  - **规则 `R-CHK-01`（检查项目与化验数值分层）**：临床检查项目/组合包（如腹部超声、十二导联心电图、胸部低剂量CT、骨密度、肺功能）独立建目，不混入 M3 定量指标库。
  - **规则 `R-CHK-02`（三层结构：底盘 + 年龄/性别门控 + 风险优先加项）**：
    1. **基本底盘**：一般体格、常规科室（内/外/眼底/耳鼻喉/口腔）、三大常规、肝肾功生化、血脂血糖尿酸同型半胱氨酸、甲功、心电图、腹部超声、胸部放射、人体成分；
    2. **年龄/性别门控**：`≥40 岁`自动加入**肺功能检查**与**骨密度检测**；`女性`自动加入**乳腺+子宫附件超声**及适龄宫颈筛查；
    3. **风险优先加项**：仅当命中慢病/家族史/年龄/吸烟风险时，推荐附件 3 中的**「优先推荐」**项目，默认不推销「可选项目」。
  - **规则 `R-CHK-03`（高阶筛查上位替代基础项 `Supersede`）**：当用户因年龄（≥45岁）、吸烟或肺部随访命中「胸部低剂量螺旋CT」时，自动上位替代底盘中的「胸部正侧位片（X线）」，避免用户重复接受放射检查。
  - **规则 `R-CHK-04`（已确诊慢病与未确诊初筛区分）**：已确诊 2 型糖尿病或正在服用降糖药的患者，**排除**初筛性质的「口服葡萄糖耐量试验（OGTT）」，改为推荐靶器官保护与并发症随访项（眼底、尿微量白蛋白/肌酐比值 UACR、颈动脉超声）。
  - **规则 `R-CHK-05`（家庭代管隐私折叠与基因检测剔除）**：适龄女性妇科/宫颈/HPV 等项目标记为 `sensitiveOptional: true`，在家庭代管界面默认温和折叠为「适龄常规选做项」；默认剔除 `_ApoE_`、`_BRCA_` 等消费级基因检测，防止过度医疗。

### 3. 异常提示抽取与否定句排除规则（`R-FIND`）
* **代码位置**：`packages/core/src/analyzer.ts`（`RULES`、`extractConclusionFindings`、`buildFindingCardsFromEntries`）
* **规则说明**：
  - **规则 `R-FIND-01`（指标词与异常标记同句共现）**：检验/标志物类规则要求指标名称与明确异常词（`↑ / ↓ / 升高 / 偏高 / 增高 / 偏低 / 降低 / 阳性`）在同一分句内共现（距离受限），仅出现检查项目名称（如「肿瘤标志物」「尿素」「肌酐」「甲状腺」）或仅出现单位（如 `mmHg`）不得判定为异常。
  - **规则 `R-FIND-02`（正常/否定子句强排除 `isNegatedNormalClause`）**：凡摘录片段含 `多在参考范围 / 均在参考范围 / 在参考范围内 / 未见明显异常 / 未见异常 / 均正常` 且不含 `↑/↓/偏高/升高` 的，一律排除，严禁将正常化验单当成异常出处。
  - **规则 `R-FIND-03`（顿号并列句识别）**：支持社区/基层体检摘要常见的并列写法（如「血压、糖化血红蛋白、总胆固醇、低密度脂蛋白、TPSA偏高」），允许句首并列项跨越顿号（25～28 字符窗口内）绑定句尾的「偏高/升高」。
  - **规则 `R-FIND-04`（年度体检优先取总检结论与阳性行）**：多页 PDF 提取时，优先抽取含 `总检结论 / 主检报告 / 小结与建议 / ↑ / ↓ / 阳性` 的页面，并剥离封面竖排单字水印噪音（「复 旦 大 学……康 体 检 报 告」）。
  - **规则 `R-FIND-05`（模糊图片医院/日期反幻觉拦截）**：视觉读单 Prompt 严禁在表头裁切或模糊时猜测机构与日期（必须输出「未注明」）；解析层若检测到模型返回「图片模糊…看不清 / 具体关键数值多数看不清」，自动置空其输出的机构名与日期并打上 `uncertainReason` 提示人工核对或并入同日记录，严防大模型脑补外地医院名（如「泰康同济（武汉）医院」）。

### 4. 时间线复查覆盖与历史异常消解规则（`R-RES`）
* **代码位置**：`packages/core/src/analyzer.ts`（`applyFindingTimelineResolution`、`laterLabExplicitlyClearsTrack`）
* **规则说明**：
  - **规则 `R-RES-01`（后续年度体检未见同项异常自动覆盖）**：若某项异常（如 2023 年 `CYFRA21-1 升高`）在更晚日期的年度体检（如 2024、2025 年）中未再出现，自动将该异常卡片状态置为 `status: "resolved"`，并注明 `已被 YYYY-MM-DD 某某医院体检覆盖，后续报告未见该项异常`。
  - **规则 `R-RES-02`（后续专项检验正常自动覆盖前次偏高）**：若某项异常（如 2026-06 社区体检 `TPSA偏高`）之后，有更晚的医院检验单（如 2026-10 三甲医院检验页）明确记载该类项目（如「肿瘤标志物」或「肾功能」）`在参考范围，未见明显异常`，则自动将该异常置为 `resolved`，注明 `已被 YYYY-MM-DD 某某医院检验覆盖（所测项目在参考范围，未见明显异常）`。
  - **规则 `R-RES-03`（可追溯不删档）**：置为 `resolved` 的历史异常不从数据库删除，收折在「查看近年已缓和的历史异常」下，保留原件链接供随时复核。

### 5. 跨年指标趋势与目标/待办裁剪规则（`R-TREND` & `R-PRUNE`）
* **代码位置**：`packages/core/src/analyzer.ts`（`buildMetricTrendsFromEntries`）、`packages/core/src/platform.ts`（`getPersonDashboard`、`getArchive`）
* **规则说明**：
  - **规则 `R-TREND-01`（完整文本持久化抽点）**：导入报告确认入档时，除保存短摘要 `summary` 外，持久化完整文本 `extractedText`；趋势计算同时扫描 `summary` 与 `extractedText`，避免正常范围内的历年数值丢失。
  - **规则 `R-TREND-02`（正常值内安静恶化的防假阳性门槛）**：当某单侧定量指标（`higherIsWorse` 为布尔值）历年均未标 `↑/↓` 超标时，必须满足以下条件之一才标为 `concern: "watch"`：
    1. **连续 ≥3 个不同时间点严格单调恶化**（每步变化幅度 > 2% + 0.01）；
    2. **跨年恶化且总变动幅度 ≥ 12%**；
    3. **跨年恶化且最新值已进入高正常临界区（High-Normal）**（如空腹血糖 `≥5.6 mmol/L`、糖化 `≥5.7%`、血尿酸 `≥380 μmol/L`、收缩压 `≥130 mmHg`、总胆固醇 `≥5.0 mmol/L`、LDL-C `≥3.1 mmol/L`、BMI `≥24`）。
  - **规则 `R-PRUNE-01`（目标与待办必须锚定当前活跃异常）**：所有由规则生成的专题目标（`goals`）与复查待办（`todoActions` / `archive.inbox`），若其对应的异常已被后续检查覆盖（`resolved`）或在当前活跃异常（`activeFindingCards`）中无支撑，自动隐藏；同名目标自动去重。
  - **规则 `R-PRUNE-02`（用户主动预约与手动待办豁免裁剪）**：凡用户主动点击生成的国标体检预约待办（`reason = "annual_checkup_booking"`）或手动添加的待办（`source = "manual"`），不受异常过滤规则影响，且在后续上传体检报告入档时自动核销为 `done`。
  - **规则 `R-PRUNE-03`（剔除条件观察句与空泛总述）**：以「若…加重/不适」开头的条件句不进入待办列表；当存在具体优化目标或具体复查项时，自动隐藏「跟进本次检查结果与医嘱落实」「复查相应检验项目」等空泛兜底句。
  - **规则 `R-TRACK-01`（按疾病/问题归类的词边界保护）**：「门诊处方与用药调整」专题仅匹配明确剂型与用法（`缓释片 / 肠溶片 / 分散片 / 薄膜衣片 / N片/次`），禁止用单字 `片` 匹配，防止将「细胞角蛋白19片段」「胸部正位片」误归为处方药。

### 6. 住院周期识别与就诊事件链规则（`R-STAY`）
* **代码位置**：`packages/core/src/analyzer.ts`（`extractInpatientStaySpan`）、`packages/core/src/platform.ts`（`annotateHospitalizationSpans`）
* **规则说明**：
  - **规则 `R-STAY-01`（出院小结抽出完整住院时段）**：住院/出院小结不得再按单点出院日展示。优先读取「入院日期 / 出院日期」，其次读取「住院日期：入院日至出院日」区间；住院天数优先采用文书中的「住院 N 天」，否则按 `出院日 - 入院日` 计算（同日入出院计 1 天）。同步抽取科室/病区。
  - **规则 `R-STAY-02`（住院期间检查挂链）**：同一医院、落在 `[入院日, 出院日]` 闭区间内的检验/影像/病历，标为「🛏️ 本次住院期间检查」，入院当日额外标注「入院首日检查」。
  - **规则 `R-STAY-03`（出院后 30 天随访挂链）**：出院后第 1～30 天的同院复查或门诊处方，标为「🔄 出院后第 N 天随访复查 / 门诊处方」，并回指本次住院医嘱。超过 30 天或不同医院的记录不挂链。
  - **规则 `R-STAY-04`（时间轴按住院事件带合并）**：`/archive` 与 `/app` 时间轴将住院期内记录收进同一条「入院日 ～ 出院日」事件带，避免入院检查看起来像另一次独立门诊。

---

## 三、 历次规则优化与纠偏审计记录（Audit Changelog）

| 日期 | 触发场景 / 发现问题 | 根因定位 | 规则修正动作 | 对应单测（`platform.test.ts`） |
| --- | --- | --- | --- | --- |
| **2026-10-27** | 4 份中山医院年度体检 PDF（2022–2025）上传后显示「未读出化验内容」或被封面竖排字淹没 | `pdftotext` 仅截取前 2000 字，剛好全是封面「复 旦 大 学……康 体 检 报 告」水印与目录 | 提高单文件抽字上限至 12000 字，按总检结论/阳性标记对页面重排优先级，剥离封面竖排噪音 | `zhongshan annual PDF conclusion beats cover noise for summary and findings` |
| **2026-10-27** | 异常提示看不出是哪年哪份报告说的 | `findings` 原为纯字符串数组，无出处元数据 | 升级为 `FindingCard`，每条绑定 `entryId`、医院、日期、原文 `quote` 与原件 PDF 链接 | `finding cards link each abnormal hint back to archive entry quote and attachment` |
| **2026-10-27** | 2023 年体检 `CYFRA21-1 升高` 在 2024/2025 年正常后仍挂在当前待办里催复查 | 未对跨年同专题异常做时间线消解 | 新增 `applyFindingTimelineResolution`（`R-RES-01`），后续年检未见同项异常自动标 `resolved` 并折叠 | `later annual checkup without the same abnormal track resolves older finding` |
| **2026-10-27** | 待办与目标里出现无依据的「复查超声/CT」「随访肾功能」「若出血加重」及空泛总述 | 正文常规项目名误触旧规则写入 `goals/actions`，且 `goals` 未像 `todos` 一样接入活跃异常过滤 | 收紧异常触发条件（`R-FIND-01`），并对 `goals`、`todoActions`、`archive.inbox` 统一执行活跃异常支撑过滤与兜底句隐藏（`R-PRUNE-01~03`） | `plan hides orphan imaging/renal todos and conditional watch tips without active finding` |
| **2026-10-27** | 跨年趋势把 `蛋白电泳α2` 的数值抽成 `2`，把邻居指标的 `↑` 算到 `ApoB` 头上 | 数值正则在标签前匹配到了指标名里的数字，且全局搜 `↑↓` 跨过了分号 | 限制仅在标签**之后** 48 字符内取数值与局部 `↑↓`；建立 2025 国标 54 项 `indicatorCatalog.ts`（`R-CAT-IND`） | `indicator catalog maps hospital aliases to the same standard code` / `multi-year checkup metrics form ApoB trend across years` |
| **2026-10-27** | 无报告家庭建档冷启动困难，且原体检专区推销 ¥1680/¥880 硬编码套餐 | 缺少国标基本项与风险加项模型，`Observation` 未持久化 `extractedText` | 经独立设计审阅，落地 `S-Checkup-1`、`S-Trend-2`、`S-Book-3`（`R-CAT-CHK`、`R-TREND-01~02`）：国标覆盖卡、LDCT 上位替代胸片、糖尿病排除 OGTT、正常值斜率预警、检后自动核销预约待办 | `S-Checkup-1` / `S-Trend-2` / `S-Book-3` 三项专项测试 |
| **2026-10-27** | 「细胞角蛋白19片段」被误归入「门诊处方与用药调整」；生成的国标体检待办因含「甲状腺功能」字样被过滤隐藏 | 用药正则含单字 `片`；主动预约待办未豁免异常过滤 | 收紧药片正则为明确剂型（`R-TRACK-01`）；对 `annual_checkup_booking` 与手动待办豁免裁剪并支持点击后自动滚屏定位（`R-PRUNE-02`） | `problem tracks do not misclassify 细胞角蛋白19片段 or 胸片 as medications` |
| **2026-10-27** | 父亲档案中 `2026-10-10 第一人民医院`「肿瘤标志物……多在参考范围，未见明显异常」被当成异常出处，且未覆盖 `2026-06-27` 的 `TPSA偏高` | 标志物正则 `|` 优先级未强制要求升高词，且末尾含 `异常` 二字误中「未见明显异常」；专项正常化验单未纳入消解链 | 强制标志物词与 `↑/升高/偏高/增高/阳性` 同句共现并增加 `isNegatedNormalClause` 否定排除（`R-FIND-01~02`）；支持后续正常专项化验单消解前次异常（`R-RES-02`）；支持顿号并列句识别血压/糖化偏高（`R-FIND-03`） | `normal tumor marker lab report does not trigger abnormal finding and resolves earlier TPSA elevation` |
| **2026-10-27** | 导入草稿里问题、目标、计划分成三大块难以核对；父亲一条模糊图片重跑草稿被视觉模型脑补出「泰康同济（武汉）医院」 | 草稿未按单条规则聚合成因果卡；图片表头模糊时视觉模型出现幻觉乱猜外地医院名 | `ReportDraft` 新增 `findingBundles` 将「问题+原文依据+目标+计划」合一展示并支持按卡勾选；新增 `R-FIND-05` 模糊图片反幻觉拦截并清理残留错误草稿 | `draftCheckupImport returns unified findingBundles` / `parsePageExtract strips hallucinated hospital when image is blurry` |
| **2026-10-28** | 母亲体检摘要「糖化血红蛋白6.50%↑，血糖6.6、总胆固醇5.90、甘油三脂1.90↑，血红蛋白114↓；尿隐血+-；B超肝内囊肿」仅识别出1项血糖问题，漏掉血脂、贫血、尿隐血、肝囊肿 | 读报告已完整读出，但 `find_issues` 规则库存在4处缺口：①未兼容「甘油三脂」同音字与 `↑` 符号；②缺血红蛋白偏低/贫血规则；③缺尿常规隐血/蛋白(`+-/阳性`)规则；④缺B超肝肾囊肿/胆囊息肉规则 | 升级 `find_issues` 至 **v1.6**：扩充血脂 `甘油三[酯脂].*↑` 规则；新增「血红蛋白偏低/贫血（用负向先行断言 `(?<!糖化)` 排除糖化血红蛋白混淆）」「尿常规隐血/蛋白异常」「腹部超声肝肾囊肿/胆囊良性病变」3条完整规则及对应目标/待办 | `find_issues v1.6 captures all 5 issues from mother's checkup line` |
| **2026-10-28** | 补齐「生命阶段成长线（0–18岁儿童青少年 & ≥75岁高龄长辈）」国家标准依据体系与专利 `INV-04` 跨代际档案原子移交 | 原国标清单仅覆盖成人（附件2/3），缺乏儿童生长发育百分位、国家免疫规划疫苗、远视储备及高龄防跌倒国标编码，且未实装 18 岁成年档案移交接口 | 在 `checkupGuidelineCatalog.ts` 与 `platform.ts` 中实装：① `WS/T 423—2022《7岁以下儿童生长标准》` 与 `WS/T 612—2018《7～18岁身高发育评价》` P3–P97 百分位评估引擎；② `国卫疾控发〔2021〕10号《国家免疫规划疫苗儿童免疫程序表》` 与 `《儿童青少年近视防控适宜技术指南》` 远视储备阈值；③ `卫办疾控发〔2011〕111号《老年人跌倒干预技术指南》` 与 `《老年失能预防核心信息》`（≥75岁自动激活肌少症/步态平衡/卧立位血压/认知早筛）；④ 专利 `INV-04` 跨家庭档案所有权原子移交（`issueHandoverCertificate` & `acceptHandoverBundle`） | `life-stage national standards: child WS/T 423/612 growth percentiles, 2021 immunization checklist, elderly >=75 fall prevention, and INV-04 atomic handover` |
| **2026-10-28** | 补齐「慢病逆转与稳态线（第 2 条产品研发线）」5 大国家卫健委食养与防治标准评估引擎 | 档案虽识别出高血糖/高血压/血脂/高尿酸/脂肪肝，但未区分「黄金可逆转窗口期（Reversal Window）」与「确诊慢病稳态控制期（Steady State）」，也缺乏带国标文号的个体化达标线与量化食养运动处方 | 新增 `buildChronicDiseasePathways` 与 `applyChronicDiseasePathway`：内置① `国卫办食品函〔2023〕5号《成人糖尿病食养指南》& CDS 2024`（区分糖前逆转窗与2型糖尿病稳态线）；② `《成人高血压食养指南（2023）》& 高血压防治指南 2024`（区分<5g限盐逆转窗与高龄防跌倒血压线）；③ `《成人高脂血症食养指南（2023）》& 中国血脂管理指南`（按合并症动态设定 LDL-C <3.4/<2.6/<1.8 达标线）；④ `国卫办食品函〔2024〕31号《成人高尿酸血症与痛风食养指南》`（控果糖+饮水≥2000ml）；⑤ `WS/T 428—2013《成人体重判定》&《成人肥胖食养指南（2024）》`（减重5%–7%逆转脂肪肝），并在主页与档案页展示可一键启用的评估舱 | `chronic disease reversal & steady-state line: grades 5 national standard pathways and applies goal/tasks` |
| **2026-10-28** | 父亲/母亲主页存在两条同属血糖管理模块的重复目标；慢病改善需要查看历次改进过程；姑妈乳腺癌术后康复需要完整的指南级 5 年全方位管理 | 原目标去重仅按标题字面完全一致比对；目标卡缺乏历次检查与干预进度时间轴；乳腺癌术后仅有一个管理师后台静态挂载壳子 | ① 新增 `classifyGoalDomain` 与 `buildGoalImprovementJourney`：自动合并同专题域目标并在每张目标卡下挂载「📈 查看改进过程」时间轴；② 实装「重大专病术后康复线 · 乳腺癌术后5年全方位康复与伴随疾病管理引擎」（依据国家卫健委《乳腺癌诊疗指南 2022》与《中国抗癌协会乳腺癌诊治指南与规范 CBCS 2024》）：自动识别术后分期（1–2年每3–6月 / 3–5年每6月 / >5年每年）、区分 AI 类（来曲唑等→DXA骨密度+血脂保护）/ SERM 类（他莫昔芬→妇科超声子宫内膜厚度）/ HER2 靶向（曲妥珠单抗→心脏彩超LVEF）伴随疾病防护，并注入「严禁在患侧手臂抽血/量血压」淋巴水肿保护红线 | `deduplicates same-domain goals and attaches chronological improvement journey` / `breast cancer post-op 5-year rehabilitation line (CBCS 2024)` |
| **2026-10-28** | 爷爷金山区中西医结合医院出院小结（2026-07-04 入院 ～ 2026-07-17 出院，住院 13 天）在档案里只显示一个出院日点；入院当天 CT/化验与出院后复查、处方无法看出同属一次住院 | 出院小结此前强制用出院日归档，时间轴按单日散开，未抽出入院日～出院日时段，也未把住院期内检查和出院后随访挂到同一事件链 | 新增 `R-STAY-01~04`：从出院小结抽出入院日、出院日、住院天数与科室/病区；同院 `[入院日, 出院日]` 内检查标「🛏️ 本次住院期间检查」；出院后 1～30 天同院复查/处方标「🔄 出院后第 N 天随访」；`/archive` 与 `/app` 时间轴将住院期内记录收进同一条住院事件带 | `grandpa discharge summary marks inpatient stay, admission tests, and post-discharge follow-up` |
| **2026-10-28** | ① 同批上传 4 张瑞金医院检验单被拆成 2 条记录（1张+3张），且糖化血红蛋白触发了血常规感染轨迹；② 大管家对话称「2025年体检的脂蛋白α尚未录入」 | ① 表头分别为「瑞金医院」与「瑞金医院临床实验诊断中心」，原按字面严格相等分组；② 早期 PDF 导入未存 `extractedText`、`pdftotext` 未加 `-layout`、视觉 Prompt 省略正常范围数值、合并记录丢弃了 `extractedText`，且 `extractNumericNearLabel` 存在前后缀指标名误匹 | ① 新增 `normalizeHospitalName` 与 `hospitalsLikelySame` 自动剥离检验/影像科室后缀合并同院同日单据，血常规关键词改为 `(?<!糖化)血红蛋白`；② 升级 `read_report` 至 **v1.7**（强制逐项列出全部正常/异常数值、`pdftotext -layout` 28000字）、`mergeArchiveEntries` 拼接全文、`extractNumericNearLabel` 增加 `isFalsePrefixMatch` 守卫（防非高密度/糖化/游离PSA及参考值「增高 5.2-6.2」误判） | `batch upload of 4 Ruijin lab pages merges '瑞金医院' and '瑞金医院临床实验诊断中心' into 1 record and HbA1c does not trigger blood routine track` |
| **2026-10-28** | 家庭成员缺少真实姓名、与我关系、性别、出生年月日管理，无法按真实姓名自动认人或移除误建成员 | `Person` 仅有 `displayName` | 扩充 `Person` 支持 `fullName`、`relation`、`sex`、`birthDate`（自动同步 `birthYear`），`matchPersonForReport` 优先按 `fullName` 精准认人，支持移除代管家人并保护本人主档案不可误删 | `family member management: fullName, relation, sex, birthDate, auto report matching by fullName, and removal protection` |
| **2026-10-29** | ① 目标「查看改进过程」混入大管家闲聊记录与日常正常血压（含心率）打卡；② 眼科/心电图目标的历史节点展示出无关的血脂句子；③ 血糖/糖化完全正常却被推荐「糖尿病前期逆转队列」 | ① `buildGoalImprovementJourney` 扫描了含闲聊 `notes` 的全量条目，且心电图正则含宽泛的 `心率`；② `extractMatchingSnippet` 仅在简短 `text` 中搜匹配句，未命中时退回展示整条报告首句；③ `buildCohortPlaybooksForPerson` 用 `/血糖|糖化|空腹/` 匹配全量文本，正常化验单也被触发 | ① 目标轨迹仅扫描正式 `visitEntries` 并通过 `isRoutineDeviceSyncEntry` 将日常血压打卡严格限制在血压目标内，心电图正则移除 `心率`；② `extractMatchingSnippet` 双层扫描 `text` 与 `extractedText` 科室结论，无匹配分句时直接跳过绝不拿首句充数；③ 群体方案库仅锚定 `activeFindingCards` 并要求存在明确升高/异常或慢病用药依据 | `goal improvement journey and cohort playbooks: exclude chat notes, routine BP heart-rate from ECG goal, extract domain-matching clauses, and do not trigger glycemic cohort on normal HbA1c/glucose` |

---

## 四、 大管家技能卡版本迭代记录（`DEFAULT_BUTLER_SKILLS`）

系统在 `/ops` 内部运营中台及 `/api/butler/config` 接口中实时公开 6 项核心技能的版本号与迭代日志：

| 技能 ID | 技能名称 | 当前版本 | 历次版本迭代说明（Changelog） |
| --- | --- | --- | --- |
| `read_report` | **读报告** | **v1.7** | **v1.7** 强制逐项抄录全部检验数值（含正常参考范围内项目）与 `pdftotext -layout` 28000字完整抽表，解决跨年正常点漏入系统；<br>**v1.6** 增加模糊图片反幻觉门控（`R-FIND-05`），表头看不清时严禁乱猜外地医院名与假日期；<br>**v1.5** 多页 PDF 总检结论页优先重排并剥离封面竖排水印；<br>**v1.4** 住院/出院小结强制用出院日 |
| `group_records` | **按次归类** | **v1.6** | **v1.6** 自动剥离医院内设科室后缀（如「瑞金医院临床实验诊断中心」归一为「瑞金医院」）合并同院同日检验批，支持按家人真实姓名（`fullName`）精准认人；<br>**v1.5** 出院小结自动抽出入院日～出院日住院周期，同院住院期间检查标为「本次住院期间检查」，出院后 30 天内复查/处方标为「出院后随访」；<br>**v1.4** 全家总览直传报告自动按单据姓名匹配对应家庭成员，并生成「问题-原文依据-目标-计划」四元因果联动卡 |
| `tidy_archive` | **整理档案** | **v1.6** | **v1.6** 合并记录时完整拼接双方 `extractedText` 原文防止跨年定量指标丢失，并收紧糖化血红蛋白不误入血常规感染专题；<br>**v1.5** 重整时默认保护已人工确认记录（`skipConfirmed` 锁），且「细胞角蛋白19片段/胸片」不再误归入处方用药专题；<br>**v1.4** 不同年份年检封面不作重复 |
| `find_issues` | **找出当前问题** | **v1.7** | **v1.7** 定量指标抽取新增前后缀防混淆守卫（防止非高密度脂蛋白误当HDL、糖化血红蛋白误当Hb、游离PSA误当总PSA、参考值「增高 5.2-6.2」误判箭头）；<br>**v1.6** 新增血红蛋白偏低/贫血、尿隐血/尿蛋白(`+-`/阳性)、肝肾囊肿/胆囊息肉超声随访 3 类规则，并支持「甘油三脂」与 `↑/↓/+-` 符号识别；<br>**v1.5** 增加否定子句熔断与后续检验正常自动覆盖前次异常（`R-RES-02`） |
| `draft_plan` | **起草目标和计划** | **v1.6** | **v1.6** 目标改进过程（Journey）严格过滤闲聊记录与日常血压心率打卡、双层精准抽取科室结论句子，且群体实证方案库（Cohort Playbook）严格锚定活跃异常（正常血糖/糖化不再误推糖前逆转队列）；<br>**v1.5** 实装三大产品线（`WS/T 423` 儿童生长与高龄防跌倒、5大卫健委食养慢病逆转、`CBCS 2024` 乳腺癌术后5年康复）；<br>**v1.4** 落地 2025 国标建议体检项目表 |
| `due_reminder` | **到期提醒** | **v1.2** | **v1.2** 居家智能监测设备录入后实时刷新设备栏最近记录与历史流水卡片，并自动核销对应测量待办；<br>**v1.1** 国标体检预约待办精简展示并支持一键跳回查看完整体检项目表；<br>**v1.0** 全家总览首屏与个人焦点卡按到期优先级置顶提醒 |