nihaixia-app

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

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

🤖 问倪师AI（可选）｜本地讲义检索 + 自配模型，让倪师讲义开口回答

离线优先 · 数据全本地 · 无需注册 · 开箱即用（不开启 AI 时完全离线）

简体中文 · 繁體中文 · English

🌐 在线网页版 · 🤖 问倪师AI · 免费 API · 📥 下载 APK · 📖 快速上手 · 🏗️ 技术架构 · 🗺️ Roadmap · 🤝 贡献指南 · 📄 开源许可

📖 项目简介

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

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

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

核心价值主张

🌐 在线网页版：免安装，点开就用

不想装 APK？浏览器直接打开，功能与 APK 一致（六经问诊、方剂本草穴位、经典全文检索、问倪师AI）：

👉 jangviktor-web.github.io/nihaixia-app/web

三点实话：收藏与对话记录只存当前浏览器（IndexedDB，换浏览器 / 清缓存即丢，不与 APK 互通）；首次打开约 75MB（渲染引擎 + 离线古籍，建议 Chrome / Edge）；繁简转换首次需联网（OpenCC 走 CDN），其余断网可用。长期使用仍建议装 APK。

🤖 问倪师AI：把倪师讲义，交给你的模型

「问倪师AI」是 App 里唯一可选的联网功能。它不是把问题直接丢给一个通用大模型， 而是先在本机讲义库检索，再把命中的原文片段连同出处一起交给你自己配置的模型作答； 讲义里没有的，它会明说「讲义里没有」，而不是替倪师编一段。

[!TIP] 💰 零成本起步：免费 API，5 分钟就能用 App 不内置任何端点，也不代收费用。注册一个 OpenAI 兼容服务的免费 Key， 填进「设置 → AI 讲义问答」即可。首选智谱 GLM-4.7-Flash： 国内直连、免费、响应快，文本问答综合最优。智谱 / 书生 / Agnes 三家的端点、 模型名、注意事项与逐项步骤见 免费模型配置指南。

它和「直接问通用 AI」有什么不同

一次提问，App 做了什么

1. 本地检索：按病名古今／中西医叫法、方名、关键词三级优先级，在本机讲义库找片段。
2. 组装上下文：把命中原文 + 出处 + 病名对照 + 相关方剂的禁忌要点一起交给模型。
3. 按结构作答：回答按「主证表格 → 辨证结论 → 方剂思路」组织，底部固定免责框；方剂名、药材名、穴位名都能点开详情。
4. 出处审计：核对回答里的方名是否真的出现在讲义片段中，缺的列出来提醒，避免把模型自带知识当成倪师原话。

能力一览

• 多会话与续接：对话存本机 SQLite，退出页面、杀进程后重开还在；历史会话按「今天 / 昨天 / 7 天内 / 更早」分组，可切换、重命名、删除
• 方剂禁忌进上下文：辨到某个方时，连禁忌与要点一并给模型，能回答「什么情况不能用这个方」，而不只是「这个方治什么」
• 病名对照自动注入：古今病名、中西医叫法对照进上下文，回答下方可展开查看命中条目
• 回答内跳转：方剂、药材、穴位、参考片段都能点进对应详情页，边答边查
• 一键拉取模型列表：设置里可直接读取端点的模型列表，不用手敲模型名
• 任何兼容端点都能接：OpenRouter、本地 Ollama 等 OpenAI 兼容服务同样可用

三步开启

1. 按 免费模型配置指南 挑一家免费服务，注册并创建 API Key
2. 「设置 → AI 讲义问答」填入 接口地址 / API Key / 模型名（可一键拉取模型列表）
3. 打开开关，回到知识库点右上角「问倪师AI」提问

[!IMPORTANT] 隐私边界：该功能默认关闭，关闭时 App 不发出任何网络请求；开启后也只有你主动提问时才联网， 发送的是「检索到的讲义片段 + 你的问题」，不上传病史、不上传诊断记录；API Key 只存本机 SQLite。 任何辨证结果与方剂建议均不可替代执业医师的诊断与治疗。

完整配置项见 ⚙️ 详细配置选项说明 · 第 2 节， 免费方案的 Key 获取路径、逐项截图与常见报错见 免费模型配置指南。

📷 截图

① 知识库入口 —— 右上角「问倪师AI」，未开启时按钮不出现。

② 设置 → AI 讲义问答 —— 端点地址 / API Key / 模型名全部由你自己填，开关默认关闭；关闭即完全不联网。

③ 问答过程 —— 先把本地讲义片段喂给模型，回答按「主证表格 → 辨证结论 → 方剂思路」组织，底部固定免责框；回答里的方剂名、药材名、穴位名都能点开详情。

④ 症状自查入口 —— 「辨证」Tab 右上角的清单图标。

⑤ 症状自查 —— 寒热总纲（必选）→ 进阶线索（选填）→ 十一问，选满 3 项即可出结论，方剂可继续点进详情。

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

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

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

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+ 「问倪师AI」为可选功能：端点与 Key 由你自填，默认关闭，关闭时不发出任何网络请求（详见 PRIVACY.md） 通用版 APK 约 82MB，分架构版 34–38MB 自 V1.11.9 起由 GitHub Actions 自动构建发布，推送 v* tag 即出包 最后更新：2026-11-07（v1.11.32）

[!TIP] 💰 免费 API · 5 分钟启用「问倪师AI」 智谱 / 书生 / Agnes 三家都有免费模型，任选其一即可，不用花钱。 推荐顺序与逐项步骤见 免费模型配置指南， 功能原理与隐私边界见 🤖 问倪师AI。

🌐 不想装 APK？在线网页版免安装试用 →

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

V1.11.32 问倪师AI（本地讲义检索 + 自配端点）· 症状自查 · 回答内跳转 · 类方禁忌进上下文（2026-11-07 发布）

一、问倪师AI：把倪师讲义交给你自己选的模型来答

• 先本地检索、再问模型：提问先在离线讲义库（伤寒 394 条 / 金匮 / 针灸 / 本草 / 医案 1257 例 / 病名对照 48 条）里检索，把命中的原文片段连同出处一起喂给模型，模型只许依据这些片段作答，讲不出就明说「讲义里没有」。不依赖任何云端知识库，也不上传病史。
• 端点由你自己配：设置 →「AI 讲义问答」填写 OpenAI 兼容地址 / API Key / 模型名（可一键拉取模型列表），默认关闭；不开启时应用不发出任何网络请求，Key 只存本机 SQLite。
• 对话可续接：轮次落本地 SQLite（DB v6），退出页面、杀进程后重开都在。
• 多会话：右上角时钟图标唤出历史会话，按「今天 / 昨天 / 7 天内 / 更早」分组，支持切换、重命名、删除；「新对话」保留旧会话不丢。
• 出处审计：回答里出现讲义片段与医案都没有的方名时，下方标注「N 处方名未在讲义片段中出现」并列出，提醒你哪句可能是模型自带知识而非倪师原话。
• 方剂禁忌进上下文：辨到某个方时，把方剂库的禁忌与要点（314 首方）一并给模型，让它能回答「什么情况不能用这个方」，而不只是「这个方治什么」。

二、症状自查（辨证 Tab 一页勾选）

• 原「辨证」Tab 是逐题翻屏的聊天式问诊（十一问要点十一屏），新增一页式自查：寒热总纲（必选）→ 进阶线索（选填多选）→ 十一问，选满 3 项即可出结论。
• 结果弹层给出六经 / 证型 / 置信度 / 命中症状 / 判断依据，方剂名可继续点进详情页。
• 六条健康基线全过时直接给正面反馈（「你是个正常人」），不会硬凑一个方证。
• 结论定位为快速初筛，症状复杂时仍建议用聊天式问诊逐项确认。

三、回答内跳转（问答页与讲义阅读页共用一套）

• 回答里的方剂名 / 药材名 / 穴位名自动变成可点链接，分别跳方剂 / 药材 / 穴位详情页；三类共用一份候选索引，最长优先、方剂优先、穴位带排除名单（避免「太阳」「光明」这类短名误配）。
• 回答下方「参考 N 条本地讲义片段」的每一条都可点开原文，用来核对回答有没有照讲义讲。

四、修复与工程

• 穴位库「消渴穴」与病名「消渴」撞词：问「消渴怎么辨证」曾被误判成针灸提问，导致厥阴篇条文被挤出上下文 —— 已修（全库审计确认仅此一例）。
• 方剂「见于经典」书名号拆词漏挂：宋本 175「甘草『附子汤』」原先只挂到「附子汤」，现正确归到甘草附子汤；同时修对 177 炙甘草汤、112 逆汤。
• 新增回归测试：症状→方证可达率 7/8、链接注入 5 条、会话持久化 3 条、出处审计 3 条、方剂禁忌 5 条；全量 flutter test 868 passed / 2 failed（两红为仓库既有基线）。

详见 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. AI 讲义问答配置（问倪师AI · 用户侧）

「问倪师AI」需要你自行配置一个 OpenAI 兼容端点（接口地址 + API Key + 模型名）， 填在「设置 → AI 讲义问答」，默认关闭，关闭时不发出任何网络请求。

不想花钱买 API？三个免费方案，5 分钟配好， 保姆级步骤见 免费模型配置指南：

三者均为第三方服务，免费政策以官方为准；API Key 只存本机。 App 侧只做 OpenAI 兼容请求（{base}/chat/completions 与 {base}/models）， 因此任何兼容端点（如 OpenRouter、本地 Ollama 等）均可接入。

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

版本号规则：对外展示采用 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；可选的「问倪师AI」需自行配置端点后才会在主动提问时联网，默认关闭。

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

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

Q4：安装时提示「应用未安装」/「安装失败」怎么办？ 多半是签名不一致或安装包损坏导致的覆盖安装被拒。解决办法：先卸载旧版本，再安装新版本（卸载前记得在「设置」中导出收藏与诊断历史）；若仍失败，改用通用版 APK 重试。

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

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

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

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

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

Q10：「问倪师AI」要花钱吗？会不会把我的病历传上去？ 不用花钱。智谱 GLM-4.7-Flash、书生 Atria-Dawn、Agnes agnes-3.0-flash 都是免费模型， 注册拿一个 Key 填进设置即可（详见 免费模型配置指南）。 隐私上，这个功能默认关闭、关闭时零联网；开启后只在你主动提问时发送「检索到的讲义片段 + 你的问题」， 不上传病史或诊断记录，API Key 只存本机 SQLite。详见 🤖 问倪师AI。

🤝 贡献指南

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

行为准则

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

代码规范

• 遵循 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