jangviktor-web/nihaixia-app

---

📖 项目简介

「中医很简单，就是阴阳气血。你搞懂了，一通百通。」—— 倪海厦

汉唐中医 是一款以倪海厦《人纪》系列（伤寒论、金匮要略、黄帝内经、针灸大成、神农本草经）为理论根基的中医经方辅助工具。它将经典六经辨证体系工程化，帮助你：

• 循证辨证：以六经为纲，叠加《金匮》证候族鉴别，引导式问诊自动推导证型与主方；
• 即查即用：方剂、本草、穴位、针灸处方、医案、经典著作全部离线收录，随时随地检索；
• 有据可查：1257 例倪师医案与方剂双向联动，辨证思路可回溯；
• 素养提升：黄帝内经知识卡、紫微/易经/四柱等民俗文化工具，构建完整传统文化视野。

核心价值主张

维度	说明
🔒 离线优先	所有知识库打包进 App，无网络也能用，隐私数据不出本机
📚 经典还原	严格遵循倪师"生附子、炮附子不可取代"等口径，附子按体系拆分，方剂组成零死链
🧠 引擎驱动	自研六经辨证状态机 + 双轨鉴别树，257 首方剂可达，诊断逻辑可验证
🆓 完全免费	Apache 2.0 开源协议，无广告、无内购、无追踪
🧪 测试守护	关键辨证路径与筛选逻辑均有回归测试，修复即写测试，防止复发

---

📷 截图

---

✨ 核心功能与特性亮点

功能	说明	数据规模
🩺 六经辨证诊断	智能问诊引导，自动判断太阳/阳明/少阳/太阴/少阴/厥阴，并支持合病并病	6 经
💬 患者口语画像	辨证结果页展示「患者会怎么说」——大白话主诉 + 辨证指针 + 治法 + 原文条文，可逐句自核；并让"怕冷/怕风"等现代症状词召回古文方剂（增强分上限 < 1，保证不打乱原有正确排序）	170 首
📋 完整处方生成	自动显示组成、剂量、煎服法、禁忌，推荐经方加减	23 条规则
🔍 鉴别诊断	自动对比相似证型的关键区别，辅助精准辨证	26 对
📚 方剂速查	搜索 + 六经筛选 + 分类筛选，离线查阅	322 首
🌿 药物速查	搜索 + 分类/性味/归经三筛选，覆盖《神农本草经》全量，附子按倪师体系拆分生/炮两条	465 味
📍 针灸穴位速查	十四经脉 + 经外奇穴，含定位/针刺/灸法/禁忌/临床心悟，穴位↔处方双向关联	408 穴
💉 穴位处方·透针	14 类针灸处方（257 条）+ 31 条透针透穴，组成穴可点按跳转	14 类
⏰ 子午流注取穴	输入时间自动推算开穴	361 穴
🔧 经方剂量换算	古代度量衡（两/升/铢）→ 现代克数	—
📖 黄帝内经	脏象 12 卡 + 望诊（五色/眼诊）+ 脉诊（平人/死脉）+ 73 篇阅读库 + 全文搜索；新增「结构化条目检索」52 条 / 10 维度，原文·出处·白话·倪师解读四字段分离，支持六字段搜索 + 维度 + 标签交叉检索	73 篇 + 52 条
📜 伤寒论 · 金匮要略 条文库	伤寒论 380 篇 + 金匮要略 453 篇拆到条文级逐条阅读；正文方剂/药材名一点即跳详情，方剂详情「见于经典」反向标注出处条文	833 条
📚 倪师医案库	1257 例检索 + 闭门课重症临床模块，医案 ↔ 方剂双向联动	1257 例
🎲 六爻铜钱摇卦	三枚铜钱逐爻摇卦，多动爻自动变卦	民俗参考
📜 易经六十四卦	时间/数字/手选起卦，解本卦·动爻·变卦·互卦，集成人间道 64 卦讲课文稿	64 卦
☯️ 四柱命卦	先天/后天卦推算（天地数法），附倪师四柱命卦讲义库	64 卦
🔮 紫微斗数排盘	十二宫/主星/四化/大限/流年盘可视化，杂星全中文，支持真太阳时+经度；排盘后自动生成整体运势/十年大运/流年总结，并给流年疾厄宫健康提醒（民俗文化参考）	115 星
📊 八字详批	神煞/格局/日主强弱/五行分布/用神忌神，一键详批	民俗参考
💾 我的命盘库	紫微排盘结果可命名收藏，列表管理、左滑删除、点击回看（回填生辰与城市重排），省去反复输入	—
🍂 节气养生板块	独立 24 节气板块，每条附健康养生要点 + 倪师节气解析（非原文标注【推断】），与本草库解耦	24 节气
👆 每日黄历手势	黄历支持上/下滑切日、左/右滑切月，单手翻看更顺手，保留日期选择器兜底	—
🔁 大运对宫解析	大限空宫时自动附对宫主星/煞星提示，紫微「借星安宫」惯例可视化	—
🔔 应用内更新	设置中一键检测 GitHub 新版本，支持下载安装	—
⚙️ 诊断设置	默认性别/诊断详细度/自动复制处方，个性化问诊体验	3 项
💾 数据管理	清除历史/导出收藏/清理缓存，本地数据完全掌控	—

特别说明：紫微斗数、易经、四柱、六爻等模块为中国传统民俗文化参考，非医疗诊断用途，与经方医疗模块在界面与文案上清晰分隔。

---

📱 下载安装

汉唐中医 nihaixia‑app 完全离线｜无需联网｜无需注册｜Android 6.0+ 通用版 APK 约 68MB，分架构版 25–28MB 自 V1.11.9 起由 GitHub Actions 自动构建发布，推送 v* tag 即出包 最后更新：2026-09-14（v1.11.23）

📥 方式一：下载预编译 APK（V1.11.23）

⚠️ 升级须知：签名密钥已统一，通常可直接覆盖安装

自 V1.11.9 起，APK 改由 GitHub Actions 云端构建；但我们已经把发布签名密钥（release-key.jks，别名 nihaisha）配置为 GitHub Secrets，因此云端构建与您本机的 V1.11.8 及更早版本使用同一套签名。升级时可直接覆盖安装，一般无需卸载旧版本。

版本范围	构建环境	签名来源
V1.11.8 及更早	开发者本地机器	本地正式签名（release-key.jks，别名 nihaisha）
V1.11.9 及以后	GitHub Actions 云端	同一套正式签名（已作为 GitHub Secrets 配置，与本地完全一致）

唯一例外：如果您在签名密钥配置完成之前就下载过 V1.11.9 的早期版本（那批用的是云端临时调试签名），由于与当前正式签名不同，覆盖安装会被系统拒绝并提示「应用未安装」。解决办法：先卸载该早期版本，再安装当前最新版即可。

建议：无论采用哪种方式，升级前都可在 App「设置」中导出收藏与诊断历史，以防万一。

安装包	大小	适用说明
通用版 app-release.apk	67.9MB	全CPU架构，绝大多数安卓设备直接选这个
arm64‑v8a app‑arm64‑v8a‑release.apk	27.0MB	新款64位安卓手机，体积更小
armeabi‑v7a app‑armeabi‑v7a‑release.apk	25.1MB	老旧32位安卓设备
x86_64 app‑x86_64‑release.apk	28.4MB	安卓虚拟机、模拟器使用

V1.11.23 伤寒论 / 金匮要略 条文级阅读库 · 方剂⇄条文双向联动：知识库新增「伤寒金匮」Tab，伤寒论 380 篇、金匮要略 453 篇由「一章一个大文件」拆到条文级逐条阅读；正文里的方剂名/药材名一点即跳详情，方剂详情「见于经典」反向列出专门介绍该方的伤寒论/金匮条文；同时修复 Markdown 阅读页正文链接点击无反应。详见 Release Notes。 V1.11.22 黄历神诞检索 · 记梦/身兆记录 + 民俗命理工具集：自 v1.11.19 起三重增强——工具箱入驻「袁天罡称骨 / 受生债查询 / 轩辕黄帝四季歌」三大民俗参考，并按中医/玄学区划清晰分区（修复日期选择器英文回退）；黄历与周公解梦/玉匣灵兆新增「神诞检索 / 记梦 / 身兆记录」随身入口，全部复用 Bookmark 体系、零新表零迁移。详见 Release Notes。 V1.11.19 内经结构化条目检索 · 深色模式正文修复 · 早晚子时农历校正：新增「《黄帝内经》结构化条目检索」页（52 条 / 10 维度，原文·出处·白话·倪师解读四字段分离，六字段搜索 + 维度 + 标签交叉检索）；修复 Markdown 阅读页深色模式白字压浅蓝底不可读（对比度 1.09→9.50）；修复早晚子时 × 真太阳时下农历落后一天、时柱落亥时。详见 Release Notes。 V1.11.17 周公解梦 · 小儿关煞 · 早晚子时校正约束落地：新增「周公解梦」模块（412 条梦境民俗解读，关键词/分类检索，吉凶标注）；新增「小儿关煞」模块（36 关 + 18 扩展煞，支持测算与百科检索，附民俗文化参考免责声明）；紫微排盘早晚子时校正重构，原始出生时间只读、农历显示跟随校正后的干支。详见 Release Notes。 V1.11.15 命盘库双排盘入口 · 黄历通胜要览 · 本命相冲预警：命盘库点击已存命盘可选「紫微 / 八字」排盘，生辰自动带入立即排盘；八字排盘页补上「添加到命盘库」入口（与紫微共用命盘库）；每日黄历新增「通胜要览」卡（黄道吉时 + 财神/喜神/福神方位）与本命相冲预警；切日手势改横向拖拽防误触；宜忌双栏合并。详见 Release Notes。 V1.11.13 八字神煞扩展 · 黄历神仙节日/生肖相冲/潮汕节俗 · 玉匣灵兆：八字排盘新增 11 种神煞（太极贵人/国印/金舆/福星贵人/德秀/红鸾/天喜/孤辰/寡宿/劫煞/亡神）；每日黄历新增三张卡片——玉匣记神仙节日（125 个农历日）、生肖相冲（当日地支→相冲生肖）、潮汕节俗（94 个农历日），三源运行时去重互不覆盖；新增民俗模块「玉匣灵兆」（玉匣记身体兆占：十二时辰兆占 + 鸦鸣鹊噪 + 占灯花）。详见 Release Notes。 V1.11.12 本草一键通 · 详情页三级结构：药库列表/搜索每行可点进详情；医案与闭门课正文药材名（含异名）可点直达药物页；药物详情页相关内容改为「关联医案/关联闭门课/含此药方剂」三个入口 → 简洁列表 → 详情，页面更清爽。详见 Release Notes。 V1.11.11 同药异名合并 · 异名检索修复：18 组异名同种条目归一（479→461），检索收敛到唯一入口 matchesQuery，按旧名（如「茈胡」）也能命中「柴胡」；三盘合参与八字补全（十神/旬空/刑冲合害/长生十二神）落地。详见 Release Notes。 V1.11.10 命盘随身 · 节气养生：新增「我的命盘库」（生辰存一次、随时回看）、独立「节气养生」板块（24 节气健康要点 + 倪师节气解析）、每日黄历滑动手势（上/下滑切日、左/右滑切月），以及大运空宫自动附对宫星情解析。四项民俗文化参考增强，全部离线、可测、不引入医疗诊断断言。详见 Release Notes。 V1.11.9 让条文说人话：为 170 首经方补齐「患者会怎么说」口语画像（大白话 + 辨证指针 + 治法 + 原文条文），辨证结果页新增口语卡片可逐句自核；同时让引擎听懂"怕冷""怕风"等现代症状词——原先这些词字面打不中古文条文、关联不到方剂的老毛病，已由口语语料兜底召回，并以「增强分上限 < 1」的非劣化不变式确保原有正确排序不被打乱。 含 V1.11.8 健康人基线判定、寒热真假八维法、六经公式分型速查等全部历史修复。 历史版本：V1.11.8（GitHub Release）https://github.com/jangviktor-web/nihaixia-app/releases/tag/V1.11.8

🔨 方式二：本地从源码构建

需预先配置好 Flutter 开发环境（见快速上手）。

git clone https://github.com/jangviktor-web/nihaixia-app.git
cd nihaixia-app
flutter pub get
flutter build apk --release

构建产物位于 build/app/outputs/flutter-apk/。如需分架构构建：

flutter build apk --release --target-platform android-arm64      # arm64-v8a
flutter build apk --release --target-platform android-arm        # armeabi-v7a
flutter build apk --release --target-platform android-x64        # x86_64

---

🚀 快速上手

环境要求

依赖	版本要求	说明
Flutter SDK	≥ 3.12.0	项目 pubspec.yaml 指定
Dart SDK	≥ 3.12.0	随 Flutter 一同安装
Android SDK	API 21+（Android 6.0）	最低运行版本；编译用最新 compileSdk
操作系统	Windows / macOS / Linux	用于开发构建
设备/模拟器	Android 6.0+	真机或模拟器运行

安装步骤

1. 安装 Flutter：参考 Flutter 官方安装指南，并运行 flutter doctor 确认环境就绪。
2. 克隆仓库：

   git clone https://github.com/jangviktor-web/nihaixia-app.git
   cd nihaixia-app
   

3. 安装依赖：

   flutter pub get
   

4. （可选）配置签名：将发布签名密钥信息填入 android/key.properties（参考 android/key.properties.template）。调试构建无需此步。

运行方法

# 连接设备或启动模拟器后，以调试模式运行
flutter run

# 运行测试套件
flutter test

# 静态分析
flutter analyze

---

⚙️ 详细配置选项说明

1. 应用内诊断设置（用户侧）

在 App「设置」中可调整：

选项	说明
默认性别	预设男/女/不设置，问诊时自动跳过性别选择
诊断详细度	简单模式（六经/证型/方剂/组成）或详细模式（完整处方、鉴别诊断、脉舌矛盾、用药铁律、汗法禁忌、传经预警、调护建议）
自动复制处方	诊断完成时自动复制处方到剪贴板，便于抓药
暗黑模式	跟随系统或手动切换，六经六色与状态色自动适配亮/暗档
字体大小	调整阅读字号

2. 工程配置（开发者侧）

文件	作用
pubspec.yaml	依赖与资源清单，版本号 X.Y.Z+N 的单一来源（+N 即 Android versionCode）
android/gradle.properties	Gradle 堆内存等构建参数（Windows 上已设为 -Xmx1024M + org.gradle.daemon=false 以规避本机 OOM；CI 内由 workflow 临时覆盖为 -Xmx4g + G1GC，不影响本地）
android/settings.gradle.kts	仓库源配置，已做 CI 感知：CI 直连 google()/mavenCentral()，本地保持阿里云镜像优先
.github/workflows/build-apk.yml	自动构建发布：推送 v* tag 即编译并发布四个 APK 到 Release（约 6 分钟）
android/key.properties	发布签名配置（不入库，参考 template）
assets/data/changelog.json	结构化更新日志，驱动「关于」页与更新弹窗
assets/data/formula_oral_hints.json	患者口语语料库（170 首方：口语 / 辨证指针 / 治法 / 原文条文）
lib/theme/app_colors.dart	39 个语义色 Token（品牌棕/暖调中性/状态色/六经六色），全站硬编码颜色清零

版本号规则：对外展示采用 1.11.9 格式，每次发布自增第三位（patch）；内部 build 号 +N 单调递增作为 versionCode。

发版方式：推送 tag 即自动出包——git tag v1.11.10 && git push origin v1.11.10，GitHub Actions 约 6–12 分钟产出通用版 + 三个分架构 APK 并发布到同名 Release。

---

🗂️ 项目目录结构

lib/
├── engine/                          # 引擎层（辨证/命理核心逻辑）
│   ├── diagnostic_engine.dart       #   六经辨证状态机
│   ├── diagnostic_rules.dart        #   诊断规则（合病·鉴别·加减）
│   ├── rule_engine.dart             #   规则引擎（双轨鉴别树）
│   ├── formula_rules.dart           #   方剂规则（113 方鉴别）
│   ├── formula_matcher.dart         #   方剂匹配器（基线 + 口语/指针加权，增强分上限 0.9 非劣化）
│   ├── meridian_formula_types.dart  #   六经公式分型（6 经 × 分型）
│   ├── yijing_engine.dart           #   易经六十四卦起卦引擎
│   ├── minggua_engine.dart          #   四柱命卦（先天/后天卦）引擎
│   └── bazi_analysis.dart           #   八字详批（神煞/格局/强弱/用神忌神）
├── models/                          # 数据模型
│   ├── diagnosis.dart               #   诊断结果 + 处方 + 加减
│   ├── formula.dart                 #   方剂模型
│   ├── formula_oral_hint.dart       #   患者口语语料模型（oral / indicators / treatment / sourceText）
│   └── herb.dart                    #   药物模型
├── data/                            # 数据层（仓库 + 离线数据源）
│   ├── formula_repository.dart      #   方剂仓库（4 级匹配策略，幂等加载）
│   ├── formula_oral_hint_repository.dart # 口语语料仓库（幂等加载，按方剂 id 索引）
│   ├── herb_repository.dart         #   药物仓库（别名归一）
│   ├── acupoint_repository.dart     #   穴位仓库
│   ├── acupuncture_repository.dart  #   针灸处方仓库
│   ├── disease_repository.dart      #   西医病名词典（约 150 正名 + 简繁别名）
│   ├── medical_case_data.dart       #   倪师医案库（1257 例）
│   ├── neijing_data.dart            #   黄帝内经知识卡
│   ├── yijing_data.dart             #   易经六十四卦数据
│   ├── minggua_data.dart            #   四柱命卦讲义数据
│   ├── changelog_repository.dart    #   更新日志仓库
│   ├── settings_repository.dart     #   设置仓库
│   └── database_helper.dart         #   SQLite 持久化
├── services/                        # 第三方引擎封装 / 服务
│   ├── ziwei_engine.dart            #   紫微斗数排盘引擎封装（ziwei_core）
│   ├── update_service.dart          #   GitHub 版本更新检测
│   └── whats_new_service.dart       #   更新弹窗服务
├── theme/                           # 设计系统
│   └── app_colors.dart              #   39 个语义色 Token
├── widgets/                         # 可复用组件
│   ├── medical_case_list_card.dart  #   医案卡片（含西医病名徽标）
│   ├── oral_hint_card.dart          #   「患者会怎么说」卡片（Token 化配色 + Material Icons）
│   └── meridian_icons.dart          #   六经图标统一收敛
├── screens/                         # UI 界面
│   ├── chat_screen.dart             #   对话式诊断
│   ├── knowledge_screen.dart        #   方剂/药物/针灸/内经速查
│   ├── medical_case_library_screen.dart # 医案库（四行筛选）
│   ├── tools_screen.dart            #   实用工具集
│   ├── neijing_*_screen.dart        #   黄帝内经（知识卡/阅读库/搜索）
│   ├── yijing_*_screen.dart         #   易经/四柱命卦
│   ├── ziwei_*_screen.dart          #   紫微斗数排盘/案例
│   └── ...                          #   本草/针灸/子午流注/剂量换算等
└── assets/
    ├── data/                        #   离线 JSON（方剂/药物/穴位/针灸/医案/口语语料/更新日志）
    ├── yijing/                      #   人间道 64 卦讲课文稿
    ├── yijing_minggua/              #   四柱命卦讲义
    ├── ziwei/                       #   天纪紫微案例 + 十二宫详解
    └── neijing/                     #   黄帝内经阅读库（73 篇）

---

🏗️ 技术架构

核心技术栈

层级	技术	用途
UI	Flutter + Material Design 3	跨平台界面，六经六色语义化主题
语言	Dart 3.x	强类型，空安全
状态管理	StatefulWidget / IndexedStack	轻量状态管理，Tab 切页保状态
存储	SQLite (sqflite)	本地数据持久化
数据	离线 JSON 资源	方剂/药物/穴位/医案/经典著作
引擎	自研 DiagnosticEngine	六经辨证状态机 + 双轨鉴别树
方剂匹配	自研 FormulaMatcher	基线字面匹配 + 口语/指针加权（非劣化）
命理	ziwei_core (Dart)	紫微斗数排盘（纯离线，MIT）
构建发布	GitHub Actions	推送 v* tag 自动编译并发布四个 APK 到 Release

诊断引擎设计

4 级方剂匹配策略：

1. 精确匹配 name
2. 别名匹配 alias
3. 斜杠分割匹配（如"小柴胡汤/大柴胡汤"取第一个）
4. 子串匹配（如"桂枝加厚朴杏仁汤"匹配"桂枝汤"）

口语增强匹配（V1.11.9 新增）： 在上述基线字面匹配之上，叠加 FormulaMatcher 的口语语料加权命中——辨证指针 indicators 权重 0.4、患者口语 oral 权重 0.15，语料按「、」与句读切分成片段后逐片段比对，并过滤否定词（"无便秘"不计为"便秘"命中）。增强分上限 enhancementCap = 0.9，严格小于 1，从数学上保证基线分更高者永远排前：新语料只负责捞回原本 0 命中的方剂、或在同分层内重排，绝不打乱原有正确排序。

合病检测： 6 经评分 → 精确条件匹配 → 方剂覆盖 鉴别诊断： 经 + 证型关键词 + 问诊答案 → 26 对鉴别 六经公式分型： 主证经 → 分型表（太阳：中风/伤寒/温病；阳明：经热/腑热；少阴：寒化/热化；厥阴：寒热错杂/血虚寒厥…），含脉象/治法/代表方/辨证要点。

---

📜 六经辨证体系

---

🗺️ Roadmap

• [x] 六经辨证智能诊断
• [x] 完整处方生成（组成+剂量+煎服法+禁忌）
• [x] 经方加减法（23 条规则）
• [x] 合病扩展（14 种覆盖）
• [x] 鉴别诊断扩展（26 对场景）
• [x] 诊断历史趋势图（六经传变可视化）
• [x] 方剂/药物/穴位速查增强（搜索+筛选）
• [x] 子午流注取穴计算器
• [x] 经方剂量换算器
• [x] 应用内更新检测（GitHub Releases）
• [x] 黄帝内经模块（脏象/望诊/脉诊 + 73 篇阅读库 + 全文搜索）
• [x] 附子生炮拆分（生附子/炮附子独立条目，组成引用零死链）
• [x] 倪师医案库 1257 例检索 + 闭门课重症临床模块
• [x] 七步问诊十问模块 v3.1（脉象/疼痛/呕吐类型追问）
• [x] 健康人基线判定 + 寒热真假八维法 + 六经公式分型（V1.11.8）
• [x] 患者口语语料接入：170 首方「患者会怎么说」+ 现代症状词召回（V1.11.9）
• [x] APK 交由 GitHub Actions 自动构建发布（V1.11.9）
• [ ] 舌诊 AI 辅助（TFLite 本地模型）
• [ ] 脉诊辅助（脉象分类）
• [ ] 方剂对比功能
• [ ] 导出 PDF 诊断报告

---

❓ 常见问题解答（FAQ）

Q1：App 需要联网吗？ 不需要。所有知识库（方剂、本草、穴位、医案、经典著作）均打包在本地，离线可用。仅"应用内检测更新"功能需要联网访问 GitHub。

Q2：我的诊断数据安全吗？ 诊断历史、收藏等数据全部存储于本机 SQLite，不上传任何服务器，隐私不出设备。

Q3：应该下载哪个 APK？ 绝大多数现代手机选 arm64-v8a（23.9MB，体积最小）；拿不准就选 通用版（64.0MB，兼容所有架构）；老旧 32 位设备选 armeabi-v7a（21.8MB）；模拟器选 x86_64（25.5MB）。

Q4：安装时提示「应用未安装」/「安装失败」怎么办？ 多半是签名不一致导致的覆盖安装被拒。V1.11.9 的云端构建已与本地 V1.11.8 共用同一套签名（已配置为 GitHub Secrets），正常情况下可直接覆盖安装。若仍被拒绝，通常是您手上的是签名密钥配置完成之前下载的早期 V1.11.9 调试签名版——解决办法：先卸载旧版本，再安装新版本（卸载前记得在「设置」中导出收藏与诊断历史）。详见上方「⚠️ 升级须知」。

Q5：紫微/易经/四柱模块是医疗功能吗？ 不是。这些模块为中国传统民俗文化参考，与经方医疗模块在界面与文案上明确分隔，不构成任何医疗诊断或建议。

Q6：附子为什么分"生附子"和"炮附子"？ 遵循倪海厦"生附子是生附子、炮附子是炮附子，不能取代"的严谨口径，App 将其拆分为独立条目，方剂组成 1663 处引用全部精确解析，避免误用。

Q7：医案库"治法/疾病"筛选是怎么分类的？ 治法栏按医案内实际出现的经方方剂名分类（取高频前 12）；疾病栏按西医病名分类（经约 150 个正名词典简繁归一抽取）。筛选逻辑均经回归测试守护。

Q8：辨证结果里的「患者会怎么说」是什么？ 它是本 App 为 170 首经方补上的"口语画像"——把《伤寒论》《金匮要略》的文言条文译回病榻边真实会说的大白话（如桂枝汤：「身上有点发烧，虽然一直微微出汗，但风一吹过来就觉得冷，特别怕风」），并一并给出辨证指针、核心治法与可回溯的原文条文。你可以逐句对照自核"这话像不像我说的"；对引擎而言，它同时充当兜底语料，让"怕冷""怕风"这类现代症状词也能召回对应的古文方剂。

Q9：如何参与贡献？ 欢迎提交 Issue 与 Pull Request。详见贡献指南。

---

🤝 贡献指南

感谢你关注汉唐中医！我们欢迎所有形式的高质量贡献。

行为准则

请保持友善、专业、就事论事。讨论聚焦经典还原与工程质量，尊重倪海厦学术体系的准确性。

代码规范

• 遵循 Dart Style Guide 与 flutter_lints；
• 提交前务必运行 flutter analyze 与 flutter test，确保 0 error；
• 关键辨证路径、筛选逻辑、渲染布局的改动必须补充/更新回归测试；
• UI 功能图标统一使用 Material Icons（唯一例外：八卦符 ☰☱☲☳☴☵☶☷ 为《周易》语义符号，予以保留）；
• 颜色一律通过 lib/theme/app_colors.dart 的语义 Token（context.colors）引用，禁止硬编码；
• 版本号规则：以 pubspec.yaml 的 version: X.Y.Z+N 为单一来源，每次发布自增 patch 与 build 号。

提交流程

1. Fork 本仓库；
2. 创建特性分支：git checkout -b feature/amazing-feature；
3. 提交更改（遵循 Conventional Commits）：git commit -m 'feat: add amazing feature'；
4. 推送分支：git push origin feature/amazing-feature；
5. 创建 Pull Request，并在描述中说明：改动内容、测试结果、对相关辨证/数据的影响。

提交信息规范（Conventional Commits）

前缀	含义
feat:	新功能
fix:	缺陷修复
docs:	文档变更
refactor:	重构（无功能变化）
test:	测试相关
chore:	构建/工具链

---

📄 开源许可

本项目以 Apache License 2.0 发布。

• 许可证全文见 LICENSE；
• 你可以自由使用、修改、分发本软件，包括商业用途，但须保留版权声明与许可声明，并遵循 Apache 2.0 的条款（含变更说明、通告文件等要求）。

© 2026 jangviktor-web

---

📚 参考资料

来源	内容
倪海厦《人纪》	伤寒论、金匮要略、黄帝内经、针灸大成、神农本草经
张仲景《伤寒论》	六经辨证体系
张仲景《金匮要略》	杂病辨证
《神农本草经》	药物性味归经（448 种）
Wsy-prog/tcm-diagnosis-system（MIT）	核心中医辨证模块结构借鉴（v3.4），为六经辨证问诊增强提供对照参考
ziwei_core（Dart, MIT）	紫微斗数 / 八字 / 命卦排盘引擎（纯离线）
sxwnl_spa_dart（Dart）	历法 / 真太阳时 / 节气计算（农历 · 干支 · 节气）

本 App 借鉴并使用了上述开源项目，已按许可证要求标注出处，感谢原作者与社区。

---

⚠️ 免责声明

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

---

🌟 Star History

RepoStars

---