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

> 📿 命盘随身 · 节气养生 · 黄历手势 · 大运对宫
> 发布日期：2026-08-31 · 离线优先 · 完全免费 · Apache 2.0

---

## ✨ 这一版带来了什么

这一版把紫微斗数的「随身化」与节气养生的「体系化」往前推了一步。四项增强**全部离线、可测**，并明确标注为**中国传统民俗文化参考，非医疗诊断**。

### 1. 我的命盘库 —— 生辰存一次，随时回看

排盘页新增「添加到命盘库」按钮，可命名收藏你的命盘。命盘库页支持列表管理、**左滑删除**、**点击回看**：回看时自动回填生辰与城市、重新排盘，无需再次手动输入。

- 数据库仅保存生辰与地点（`user_charts` 表），回看时由排盘引擎重新计算，避免持久化整盘带来的数据失准。
- 常用命盘一键收藏、跨会话回看，省去反复录入。

### 2. 节气养生独立板块 —— 24 节气，逐条附倪师解析

新建「节气养生」板块：顶部当前节气卡（节气名 + 距下一节气倒计时 + 养生要点 + 倪师解析），下方 24 节气竖向列表，每张卡片可展开健康知识与倪师节气解析。

- 内容源自新建 `solar_term_knowledge.json`（24 节气养生常识 + 基于倪海厦先生公开讲座原则整理的解析；凡非逐字原文均标注【推断】），统一免责语「倪师原话请以《人纪》《天纪》等著作为准」。
- **移除旧版本草推荐联动**，健康知识改用节气 JSON，与本草库彻底解耦，更易维护。

### 3. 每日黄历滑动手势 —— 单手翻看更顺手

每日黄历新增手势操作：上/下滑切日、左/右滑切月，抖动返回 `null` 不误触；保留右上角日期选择器作为兜底。跨年切月已正确处理。

### 4. 大运对宫解析 —— 空宫不再只丢一句"借对宫"

大限空宫（无主星）时，逐限评语后自动追加**对宫**（相隔六宫）主星与煞星提示；对宫亦空则明确注明。紫微「借星安宫」惯例可视化，一眼看清对宫星情。

---

## 🔧 工程改进

- 数据库版本 4 → 5，并补齐 `onCreate` 建表，避免全新安装（首装即 version 5）漏建 `user_charts` 表。
- 新增 / 更新测试：`ziwei_opposite_palace_test`、`swipe_resolve_test`、`saved_chart_repository_test`、`solar_term_service_test`，保障上述能力可回归、不退化。

---

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

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