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

> 🔮 八字神煞扩展 · 黄历神仙节日/生肖相冲/潮汕节俗 · 玉匣灵兆
> 发布日期：2026-09-05 · 离线优先 · 完全免费 · Apache 2.0

---

## ✨ 这一版带来了什么

读八字时，命盘上的神煞越多，越能看出一个人的性情与际遇；翻黄历时，除了宜忌，还想知道今天是谁的圣诞、今天冲什么生肖。这一版做的，就是往这两处各添一把「传统的标尺」：**八字排盘补齐 11 种神煞，每日黄历接入神仙节日、生肖相冲与潮汕地方节俗三张新卡**，再把散落在《玉匣记》里的身体兆占整理成独立模块「玉匣灵兆」。

### 1. 八字神煞扩展 —— 命盘落位更完整

在原有 10 种神煞（天乙贵人、文昌、禄、刃、驿马、桃花、华盖、将星、天德、月德）基础上，新增 **11 种**：

- **按日干 / 月支起**：太极贵人、国印贵人、金舆、福星贵人、德秀
- **按年支起**：红鸾、天喜、孤辰、寡宿、劫煞、亡神

口径沿用传统取法：金舆为禄前二位，天喜为红鸾对冲（红鸾 +6），孤辰寡宿随年支三会组，劫煞为三合绝位、亡神为三合临官位。命盘页面无需额外操作，神煞自动落位渲染。

### 2. 黄历三张新卡 —— 传统节日、神仙圣诞、地方节俗各归其位

- **神仙节日（玉匣记）**：收录三元五腊圣诞（114 条）、十殿阎君诞辰（10 条）与斋期，共 125 个农历日、138 条，独立成卡并标注「玉匣记」出处。
- **生肖相冲**：依据每日地支经六冲推算当日相冲生肖（如子日冲马），一眼看清今日冲什么。
- **潮汕节俗**：94 个农历日的地方拜神节俗（含每月固定拜神日），地方条目标注地名。

三套节日数据源**运行时双向去重**（春节、元宵、端午等不会重复出现），与既有传统节日互不覆盖，各占各的卡片。

### 3. 新模块「玉匣灵兆」—— 玉匣记身体兆占

《玉匣记》中的兆占法整理成独立模块（工具页新增入口）：

- **十二时辰兆占**：眼跳、耳鸣、面热等 12 类，每类十二时辰各有占断；当前时辰自动高亮，可展开查看完整详表。
- **特殊占法**：鸦鸣鹊噪方向占、占灯花法。

模块顶部附民俗文化免责声明。

---

## 🔧 工程改进与稳定性

- **测试**：全量 `flutter test` 390/390 通过；`flutter analyze` 0 error / 0 warning。
- **数据生成**：三个数据源（玉匣记神仙节日 / 潮汕节俗 / 身体兆占）均由 `tool/gen_*.py` 脚本从原始 JSON 生成 Dart 常量表，避免手写录入出错。
- **出包门禁**：aapt2 校验四包 `1.11.13（versionCode 5）` 一致；签名指纹与线上已装版相同；changelog 已确认打进包内。

---

## 📦 安装说明

- 与已装版本**同签名**（HanTang 正式钥匙，v2 方案），直接覆盖安装，无需卸载旧版。
- versionCode 单调递增（5），任何旧版本可平滑升级。
- 通用版约 64.8MB；**arm64-v8a 分架构包约 24.3MB**，新款手机推荐。

---

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

本 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)。