nihaixia-app

汉唐中医 · 倪海厦六经辨证中医诊断助手

一款离线优先、完全免费的中医经方学习与辅助诊断 App，忠实还原倪海厦人纪体系

离线可用 · 数据全本地 · 无需注册 · 开箱即用

简体中文 · 繁體中文 · English

📥 下载 APK · 📖 快速上手 · 🏗️ 技术架构 · 🗺️ Roadmap · 🤝 贡献指南 · 📄 开源许可

v1.11.31 伤寒论模块排版更新 · 全部宋本伤寒论排序 · 简繁体切换

从左到右：① 伤寒论阅读库 —— 全部条文按宋本 1–390 顺序排列，列表名统一「宋本N·」，篇名 / 条文 / 正文可搜。 ② 宋本1 条文卡 —— 原文块 +「倪海厦解读」，脉法阴阳等表格完整呈现，右上角简繁切换。 ③ 桂枝加厚朴杏仁汤方剂详情 —— 组成 / 适应证 / 禁忌 / 煎服法 / 倪海厦解读与底部「见于经典」分组，繁体显示同步生效。 ④ 宋本54 条文卡 —— 繁体模式下的原文与解读排版。

📁 历史版本截图（v1.11.30 → v1.11.0，按版本从新到旧）· 点击展开

v1.11.30 条文卡讲解全覆盖（839 张）· 繁体显示开关 · 繁体输入可搜 · 医案简体化

• 条文卡讲解覆盖 100%：伤寒 384 + 金匮 433 共 839 张条文卡全部配有讲解正文（合并 22 组「问曰/师曰」问答卡，金匮 455→433 条）
• 繁体显示：阅读页 / 药材详情 / 方剂详情右上角 translate 图标一键切换，OpenCC 词典级转换（干姜→乾薑、郁金→鬱金），链接仍可点跳
• 繁体输入可搜：搜「當歸」「麻黃湯」不再空结果（三处检索入口繁简归一）
• 医案库整备：全文简体化、药材异名映射 135 条、处方药材解析率 94.1%
• 新增药材「石菖蒲（九节菖蒲）」；方剂 327→314 条（净合并 13 组同方异名）

v1.11.29 针灸讲稿阅读库（72 篇）· 讲稿⇄穴位双向联动（当前最新截图）

从左到右：① 针灸讲稿入口 —— 知识库「针灸」页穴位筛选行新增「讲稿」按钮，与「经络图」并列。 ② 针灸讲稿 · 篇目录 —— 《人纪·针灸》72 篇按章节排列（针灸使用时机 / 针刺深浅 / 十二经络与奇经八脉 / 针刺手法 / 从头到脚治症系列），篇名即时搜索。 ③ 讲稿正文阅读 —— 书面整理版排版，正文中的穴位名（头维 / 本神 / 神庭）、方剂名、药材名自动成链，一点直达详情。 ④ 穴位详情 ·「讲义讲解」卡 —— 穴位详情页新增讲义卡，显示讲稿中提及本穴的篇数（如神庭 7 篇提及），无命中自动隐藏。 ⑤ 神庭 · 讲义提及列表 —— 底部弹层按提及次数排序列出各篇（督脉经穴篇 7 次 / 足太阳膀胱经 6 次 / 治鼻病 2 次……），点按直达该篇。 ⑥ 节气卡可隐藏 —— 设置 → 外观新增「知识库顶部节气卡片」开关，关闭后知识库首屏更清爽，节气养生仍可从「工具」进入。

v1.11.27 三山国王灵签 · 小六壬 · 梅花易数 · 排盘存图分享长图 · 摇一摇起卦

从左到右：① 三山国王灵签 · 求签 —— 收录广东揭西三山国王祖庙传承 92 签，每签含签号 / 签题 / 签诗原文 / 吉凶等级；默念所问之事后摇取签文，可反复再求。② 梅花易数 · 排盘结果 —— 随机起卦得「泽山咸」，动爻、卦辞、动爻爻辞与体用生克推演一屏看全；AppBar 图片入口进入长图预览页，「保存图片」（存本机、无需存储权限）与「分享长图」（调起系统面板，可转存相册 / 文件 / 微信）两个出口。③ 梅花易数 · 摇一摇起卦 —— 输入区「摇一摇随机起卦」开关默认开启，摇动手机即自动切随机起卦并重摇一卦（不动已输入的时间 / 数字），触觉反馈确认；一次摇动只出一卦，缓慢倾斜不误判。④ 小六壬 —— 时间起课，月 / 日 / 时三宫顺数定大安 / 留连 / 速喜 / 赤口 / 小吉 / 空亡，配主事六神与歌诀；术内对「月初一落宫」本有分歧，「通行掌诀」与《多能鄙事》双口径并列由使用者自选，推算过程完整展示。⑤ 三山国王灵签 · 签谱 —— 92 签全量列表，按吉凶（上 42 / 中 31 / 下 17 / 无事 2）筛选 + 签题与签诗全文检索，点按弹出完整签文。三个模块均标注民俗文化参考免责声明，与经方医疗模块清晰分隔；存图长图同适用于八字排盘 / 紫微斗数 / 五运六气结果页。

v1.11.26 耳穴国标定位图 · 十四经循行穴位图 · 五运六气三图排版修复

从左到右：① 耳穴国标定位图 —— 耳穴地图内嵌 GB/T 13734-2008《耳穴名称与定位》附录 A 标准图，「正面 84 穴 / 背面 9 穴」两页签，双指放大细看穴名，页内标注「仅供学习参考」；配套「耳穴」库 93 穴按国标分区（HX/SF/AH/CO……）筛选，穴名 / 拼音 / 代码均可检索。 ② 十四经循行穴位图 —— 穴位讲解新增「经络图」入口，十二正经 + 任督二脉共 14 张循行图，经络走行、所属穴位与该经「预防及主治的疾病」一图看全，双指放大 6 倍看清穴名。 ③–⑤ 五运六气三图排版修复 —— 运气五行图五宫半径与间距重新配比，徽章不再横跨压字；五运图主客运分色、步界日期清晰；六气图「外环客气 / 内环主气 / 步名」三层文字改沿扇区切线排布，3 点与 9 点方向不再叠压；任选日期三图即时重绘、当前步自动高亮（图为 2026 丙午年）。

v1.11.25 易经 64 卦卦象插画 · 中医时辰开穴四法 · 五运六气三图

从左到右：① 易经 64 卦卦象插画 —— 每卦详情页卦名下方显示该卦的传统典故版画（乾为天 = 云中取鹿、地天泰 = 梯上取鹿），64 卦全覆盖，与卦名数据一一对应，缺图静默收起不影响页面。 ② 中医时辰开穴综合计算器 · 四法并排 —— 纳子法 / 纳甲法 / 灵龟八法 / 飞腾八法四个 Tab，点选或按「当前时间」即时给出日干支与时干支，并显示开穴（纳甲正开 · 太渊「肺经·输穴」、飞腾八法 · 后溪、灵龟八法 · 照海配列缺），附「返本还原」还原取原穴、干支→脏腑/经络对应歌诀、推算步骤与说明。 ③ 五运六气三图 —— 运气五行图（十字五宫夹中央，司天/在泉与五行圆形联动）、五运图（单环十扇区，主运/客运分色并标出步界日期）、六气图（双环）；任选一天（如生日）三图随之重绘，当前步高亮，下方给出岁运（中运）病候、司天/在泉、客气加临与《内经》大论原文。

v1.11.24 穴位筛选新增六奇经分组 · 国标穴序

穴位讲解的经络筛选从 15 组扩到 21 组：十二正经 + 督任之外，新增冲脉 / 带脉 / 阴维脉 / 阳维脉 / 阴跷脉 / 阳跷脉六个奇经分组；57 条交会穴补齐所属经脉标注，多脉穴忠实出现在所有所属脉分组（如公孙同时在「脾经」与「冲脉」），搜「冲脉」等可直接命中其交会穴。随版带出：十二正经 / 督任组内按国标穴序排列、同名并列穴位次键修复、「子宫」解剖语境禁链。

v1.11.23 伤寒论 / 金匮要略 条文级阅读库 · 方剂⇄条文双向联动

从左到右：① 知识库新增「伤寒金匮」Tab —— 伤寒论 380 篇（条文级 + 五经概述）与金匮要略 453 篇两个入口。 ② 伤寒论 · 阅读库 —— 23 大模块拆到条文级逐条排列（太阳·总纲 / 太阳病中风(桂枝汤证) / 太阳病伤寒(麻黄汤证) / 太阳病传经判断 ……）。 ③ 方剂「见于经典」 —— 以桂枝汤为例，分「伤寒论 / 金匮要略」两组列出专门介绍该方的条文，点按直达原文。 ④ 金匮要略 · 阅读库 —— 25 篇杂病按条文排列（藏府经络先后病、痉湿暍病、疟病 ……）。正文里的方剂名 / 药材名一点即跳对应详情，经方正文与方剂·药物首次双向联动。

v1.11.19 内经结构化条目检索 · 节气养生

从左到右：① 知识库首页 —— 顶部「六经 / 方剂 / 本草 / 针灸 / 内经 / 搜索」六大入口，「当前节气」卡直显节气名、距下一节气天数、太阳黄经与三候，下方「黄帝内经·速查」脏象 / 望诊 / 脉诊三入口一览。 ② 内经条目 · 十维度 —— 52 条结构化条目按 10 个维度（脏象 / 望诊 / 脉诊 / 病因病机 / 经络循行 / 气血津液 / 辨证体系 / 治则方药 / 病证举例 / 误治宜忌）检索，支持六字段搜索（标题 / 原文 / 出处 / 白话 / 倪师解）、按篇名检索与标签交叉筛选；每条卡片显式标注篇名出处（如《素问·灵兰秘典论》第一节）。 ③ 节气养生详情 —— 24 节气逐条给出气候 / 起居 / 饮食 / 穴位 / 不适五类养生要点，并附「倪师解析」卡片，非原文直引处统一标注【推断】，一眼可分「经典原文 vs 解读」。

v1.11.17 周公解梦 · 小儿关煞 · 紫微早晚子时校正

新增「周公解梦」模块（412 条梦境民俗解读，关键词/分类检索，吉凶标注）；新增「小儿关煞」模块（36 关 + 18 扩展煞，支持测算与百科检索，附民俗文化参考免责声明）；紫微排盘早晚子时校正重构，原始出生时间只读、农历显示跟随校正后的干支。

v1.11.13 每日黄历 · 生肖相冲 / 玉匣记神仙节日 + 潮汕节俗 / 玉匣灵兆模块

从左到右：① 每日黄历 · 生肖相冲 —— 依每日地支经六冲推算当日相冲生肖（如子日冲马），一眼看清。 ② 每日黄历 · 玉匣记神仙节日 + 潮汕节俗 —— 玉匣记收三元五腊圣诞（114 条）、十殿阎君（10 条）与斋期，共 125 个农历日；潮汕地方条目单列（如「司命帝君」「灶公生」），与既有传统节日运行时去重互不覆盖。 ③ 玉匣灵兆 · 占面热法 与 ④ 玉匣灵兆 · 占眼皮法 —— 玉匣记身体兆占，十二时辰各占断，当前时辰自动高亮，可展开十二时辰详表（左眼跳财、右眼有女思等）；工具页新增入口，附民俗参考免责声明。

倪师医案库 · 闭门课重症临床 · 六爻铜钱摇卦 · 实用工具

黄帝内经：脏象 · 望诊 · 脉诊 · 73 篇阅读库

问诊引导 · 六经速查 · 方剂速查

本草速查 · 针灸穴位 · 实用工具

四柱命卦 · 紫微斗数排盘 · 易经六十四卦

倪师闭门课内容 · 倪师精选医案

添加每日黄历、节气养生模块 · 优化紫微斗数星盘大运、流年月详解功能及“真太阳时”选择地名自动匹配功能

✨ 核心功能与特性亮点

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

📱 下载安装

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

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

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

自 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「设置」中导出收藏与诊断历史，以防万一。

V1.11.31 伤寒论宋本统一版 · 方剂见于经典修复 · 排版规范化：伤寒论资产整体切换为宋本条号命名（390 条文 + 4 附录 = 394 篇），列表名统一「宋本N·」；经典索引 1728 条、方剂索引 279 条重建对齐；补齐 8 个方剂「见于经典」跳转并撤销「杏子汤」误挂；条文卡排版规范化、R1 归零。详见 Release Notes。

V1.11.30 条文卡讲解全覆盖 · 繁体显示 · 医案简体化：伤寒 384 + 金匮 433 共 839 张条文卡全部配有讲解（合并 22 组问答卡）；阅读页/药材详情/方剂详情新增繁体显示开关（OpenCC 词典级）；三处检索支持繁体输入；医案全文简体化 + 药材异名映射 135 条。详见 Release Notes。

V1.11.28 字号 200% · 古籍原文（灵枢/针灸大成）· 经典全文搜索 · 流畅度优化：字号上限由 150% 提到 200%，并修复「只有首页跟随字号」——详情页、设置页与弹窗现在都跟随；新增「古籍原文」书库：《灵枢》82 章 + 明·杨继洲《针灸大成》339 章，章节目录可读可搜，正文方剂/药名可点跳详情；全局搜索新增「经典」分组，贯通伤寒/金匮/内经讲稿与古书原文共 1327 条，点击直达篇章；修掉浅色模式下搜索结果标题几乎看不清的对比度问题；知识库切 tab 与长列表滚动做了保活与过滤缓存优化。详见 Release Notes。

V1.11.26 十四经循行穴位图 · 耳穴国标库 · 五运六气三图排版修复：针灸页新增「经络图」——十二正经 + 任督二脉共 14 张循行穴位图，双指放大 6 倍看清穴名；耳穴全面接入 GB/T 13734-2008《耳穴名称与定位》——93 穴国标库（10 分区筛选 + 穴名/拼音/代码搜索，18 条旧称自动归并国标名）+ 附录 A 标准定位图（正面 84 穴 / 背面 9 穴）直接嵌包；针灸处方数据扩容至 384 条（合并倪师 BBXX 病症配穴 +127 条）；五运六气三图排版修复（六气图三层文字切向排布不再叠压、五行图宫圆重新配比）与引擎经典裁决修正 7 年。详见 Release Notes。

V1.11.25 易经 64 卦卦象插画 · 中医时辰开穴四法 · 五运六气三图：易经每卦详情页新增传统卦象典故插画（64 卦全覆盖，与卦名一一对应，缺图静默收起）；「中医时辰开穴综合计算器」四法并排（纳子法 / 纳甲法 / 灵龟八法 / 飞腾八法），即时给出日干支、时干支与开穴，附返本还原与推算步骤；新增五运六气三张可视化图（运气五行图 / 五运图 / 六气图），任选日期三图重绘、当前步高亮，并带出岁运病候、司天在泉与《内经》大论原文。详见 Release Notes。

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

需预先配置好 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

🚀 快速上手

环境要求

安装步骤

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. 工程配置（开发者侧）

版本号规则：对外展示采用 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 篇）

🏗️ 技术架构

核心技术栈

诊断引擎设计

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

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

❓ 常见问题解答（FAQ）

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

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

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

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）

📄 开源许可

本项目以 Apache License 2.0 发布。

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

© 2026 jangviktor-web

📚 参考资料

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

⚠️ 免责声明

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

🌟 Star History