# 汉唐中医 v1.11.11 发布说明

> 🌿 同药异名合并 · 异名检索修复 · 三盘合参与八字补全
> 发布日期：2026-09-03 · 离线优先 · 完全免费 · Apache 2.0

---

## ✨ 这一版带来了什么

中药的世界里，同一味药往往身兼数名——茈胡即柴胡，橘皮即陈皮。名不正则言不顺，检索便会迷路。这一版为药库做了一次「正名」：**异名归一，旧名不废**——按任何一个旧名检索，都能找到它的正名条目。同时，民俗参考侧落地了三盘合参与八字补全。

### 1. 同药异名合并 —— 药库归一，正本清源

18 组「异名同种」的药材条目合并为一条正名条目（479→461 条），并在 `herb_repository` 登记 103 条「异名→正名」映射（如 `茈胡→柴胡`、`橘皮→陈皮`）。

- 数据更干净：同名异写的重复条目不再各说各话。
- 名称与别名统一经归一（`canonicalOf`）处理，为后续索引能力打地基。

### 2. 异名检索修复 —— 按旧名，也能找到它

合并之后曾出现 74 个异名在药库页搜不到的回归（按「茈胡」检索命中不了「柴胡」）。本版把散落三处的检索逻辑收敛到唯一入口 `matchesQuery`，全量异名与正名均可命中，并以 `tool/audit_alias_search.dart` 作为可执行的回归审计基线——「用户能不能搜到」从此有了机械化判据。

### 3. 三盘合参 B 方案 —— 紫微 + 八字 + 命卦同源合参

三盘同参落地；晚子时归次日改为**可开关**（默认按当日早子时处理），尊重不同流派的排盘习惯。

### 4. 八字补全 —— 十神 · 旬空 · 刑冲 · 长生

- 十神逐柱 + 旬空（空亡）标注；
- 刑冲合害 / 合会关系检测；
- 长生十二神双口径（火土同宫 / 水土同宫）用户自选。

### 5. UI 统一状态组件 StateView

新增 `StateView`（loading / empty / error），10 处加载与空状态统一、3 处静默加载接入错误重试；设计 Token 体系（间距 / 圆角 / 字号）落地，消除硬编码色值。

---

## 🔧 工程改进

- CI 接入 canonical 签名密钥 `KEYSTORE_BASE64`：GitHub Actions 四架构 APK 与本地**同一套正式签名**，覆盖安装无需卸载。
- 新增 / 更新异名检索与药库数据审计工具，作为可回归的出包门禁。

---

## 📦 安装说明

- 自本版起云端构建与本地同签名，覆盖安装无需卸载。

---

## 🙏 开源致谢（借鉴项目）

本 App 在开发过程中借鉴并使用了以下开源项目，衷心感谢原作者与社区：

- **Wsy-prog/tcm-diagnosis-system**（MIT）—— 核心中医辨证模块结构借鉴（v3.4），为 App 六经辨证问诊增强提供对照参考。
- **ziwei_core**（Dart, MIT）—— 紫微斗数 / 八字 / 命卦排盘引擎，纯离线、无第三方框架依赖。
- **sxwnl_spa_dart**（Dart）—— 历法 / 真太阳时 / 节气计算（农历 · 干支 · 节气）。

---

## ⚠️ 免责声明

本 App 为中医经方**学习与辅助参考工具**，所有辨证结果、方剂建议均不可替代执业医师的诊断与治疗。命理相关模块（紫微斗数、八字、黄历等）为**中国传统民俗文化参考**，与医疗无关。用药请遵医嘱，急重症请立即就医。

---

> 完整工程级变更记录见 [CHANGELOG.md](https://github.com/jangviktor-web/nihaixia-app/blob/master/CHANGELOG.md)。