把倪海厦中医课程整理成可检索、可追溯、有安全边界的 Agent Skill。
Claude Code / Codex / OpenClaw Skill。装进 agent 后，可以用自然语言按症状、方剂、穴位、课程模块、课次或板书截图检索倪海厦课程资料，输出学习型辨证梳理、方证/穴位/药性对比、逐课复习计划和截图证据索引。
English → docs/README.en.md
提示：目前项目还存在一些问题，正在持续迭代中，建议大家每过一段时间来看看是否有更新，并下载安装最新版本。
本项目的课程蒸馏方法来自作者维护的 lineage-skill：把高密度课程材料整理成可溯源、可迁移、可产出的 Agent Skill。
- 新增针灸危险进针深度外部安全参考：接入《全日本鍼灸学会雑誌》2006 年第 56 卷第 1 号日文原始论文的完整页级证据，并增加中文检索辅助、翻译勘误和肺俞等胸背部危险深度的非个体阈值警告。
- 本批资料由刘德毅医师提供，系倪师弟子叶昭呈医师（李宗恩阳气诊所 Co-founder）推荐；在 Skill 中独立标记为“外部针灸安全参考”，不混作倪师课程原话或倪师推荐资料。
- 新增 240 题多维评测集，覆盖 5 类主能力、9 类常见用户需求和 5 门核心课程模块。
- RAG 与普通 Skill 每题每通道独立生成并盲评 3 次，形成每通道 720 个回答，并完成 120 次同类问题一致性评测。
- 加入 RAG + 知识图谱模式。完整资源约 3.68 GB，目前仍在测试中；如果磁盘空间有限，请谨慎下载。
- 新增倪师相关推荐医书的独立检索入口，并明确标记为“倪师推荐补充资料”，不作为倪师本人资料。
- 课程主资料命中相关话题后，会自动执行补充资料二次检索；补充结果单独列出，不与课程原文混合。
- 将文字整理层中的可执行剂量、煎服、针刺、放血、灸法和剧毒药操作移回 PDF/截图证据层；证据层保留源画面/原文，但统一标明不可照做。
- 修正麦冬、瓦楞子、ALS、栀子豉汤、郁金、经方、金匮方、炮附子等旧 ASR/整理层术语，并收紧癌症、急症、孕产、儿童、附子和针灸操作边界。
- 根据岐黄圣贤智慧整理的课程校对资料，对此前由视频/音频转写产生的一批术语、方名、穴名和古籍引用误差做了系统勘误。
- 新增课程校对 PDF 的页级证据层：
references/pdf-evidence/，便于按课程、页码和关键词追溯校对依据。 - 新增与课程内容相关的古籍、方证和术语索引入口：
references/ebooks.md，用于辅助核对课程中提到的经典出处和方证线索。 - 术语索引已按伤寒、金匮、仲景心法、针灸、黄帝内经、神农本草等模块拆分，方便学习时按主题检索。
- 白话问题入口：把“感冒怕冷”“手脚冷”“拉肚子”“睡不着”等普通表达转成课程里的分水岭问题。
- 多课程检索：覆盖伤寒论、金匮要略、仲景心法、临床案例、八纲辨证、扶阳论坛、易筋经、梁冬对话、斯坦福演讲、天纪、黄帝内经、神农本草、针灸课程，以及课程讲稿、学习笔记、音频合集映射。
- 六经与方证导航：按六经、症状、方剂和传变逻辑整理《伤寒论》核心内容。
- 穴位与药性学习：可检索针灸经络穴位、配穴思路，以及神农本草课程里的药性、剂型、配伍与单味药线索。
- 逐课复习：按课程模块和课次整理主题地图、关键词和适合复习的问题。
- 截图证据：已接入 2986 条截图证据索引，对应图片均已压缩为仓库内 WebP，可按方名、穴位、课次、病机、术数关键词或时间点检索。
- PDF 溯源证据：支持按课程模块、关键词和页码定位课程文稿及相关古籍，课程正文命中后自动执行补充层二次检索。
- 非 PDF 文本证据：推荐资料中的文本章节可独立定位，并与倪师本人资料分层展示。
- 安全边界：默认作为课程学习与中医理论整理，不做个人诊断、处方或剂量指导。
完整说明与流程图：
docs/RAG_GRAPH_MODE.md— 介绍什么时候使用、如何查找原文、各组成部分的作用、适用范围和安全边界。
RAG + 知识图谱不是默认模式。普通课程问答、方证比较、逐课复习、截图检索和 PDF 页级溯源均优先使用仓库内的轻量资料和搜索脚本。
开启后，会优先从已收录的资料中查找相关原文并注明出处；未收录的课程、学习计划和 截图检索仍可照常使用。检索结果会先经过整理，再以易读的回答呈现。
技术上，用户明确选择 RAG + 知识图谱后，运行的是完整 composite 模式：已覆盖的 PDF
问题由 embedding + 知识图谱 hybrid 提供原文证据，缺失课程和学习计划回退到
lightweight modules，找图仍共用截图索引，最后由同一 Agent 负责理解问题、安全处理和
综合回答。nihaisha_kg answer 返回的 JSON 是证据包，不应直接当作最终用户回答。
用户明确要求使用 RAG 且本地已有完整数据时，才切换到该模式。如果数据不存在，只会 提示所需空间、下载来源和本地路径，不会自动下载；只有用户另行明确要求下载 RAG 数据时才会开始下载。
- 完整资源：约 3.68 GB，目前仍在测试中，磁盘空间有限时请谨慎下载。
- 下载来源：Hugging Face Dataset —
JuneYao/nihaisha-rag-assets - 本地数据路径：
data/pdf_rag_bge_m3/ - 重复使用：下载完成后会校验文件并保存在本地，后续不需要重复下载。
240 题多维评测，每题每通道独立生成与盲评 3 次。
| 指标 | RAG | 普通 Skill | 样本量 |
|---|---|---|---|
| 回答得分 | 92.8%（95% CI 91.6–94.1） | 91.4%（95% CI 90.1–92.7） | 240 题 × 3 次 |
| 预期行为通过率 | 83.1% | 85.8% | 每通道 720 个回答 |
| 必须检查项通过率 | 87.9% | 88.5% | 每通道 2,169 项检查 |
| 引用支持精确率 | 92.9% | 93.2% | 171 题 × 3 次 |
| 引用主张覆盖率 | 90.4% | 92.0% | 171 题 × 3 次 |
| 引用可访问率 | 99.1% | 97.3% | 171 题 × 3 次 |
| 主能力 | 题数 | RAG 回答得分 | 普通 Skill 回答得分 | 差值（RAG − Skill） |
|---|---|---|---|---|
| 知识检索 | 48 | 90.4% | 88.0% | +2.4 |
| 跨源整合 | 48 | 90.6% | 86.7% | +3.9 |
| 引用与溯源 | 36 | 85.3% | 91.3% | -6.0 |
| 推论与鲁棒性 | 48 | 96.7% | 90.8% | +5.9 |
| 临床安全 | 60 | 98.0% | 98.5% | -0.5 |
| 合计 | 240 | 92.8% | 91.4% | +1.4 |
| 用户通常想做什么 | 典型问法 | 题数 | RAG | 普通 Skill |
|---|---|---|---|---|
| 查一个知识点或主题 | “厥阴病有哪些主要特点？” | 33 | 89.7% | 86.8% |
| 比较两个或多个内容 | “桂枝汤和麻黄汤怎么区分？” | 31 | 92.2% | 88.1% |
| 综合多份课程资料 | “伤寒和金匮里的水气怎么比较？” | 26 | 90.7% | 83.9% |
| 核对原文和出处 | “这句话出自哪一课、哪一页？” | 38 | 87.4% | 91.6% |
| 判断一个说法是否成立 | “没检索到，能证明从没说过吗？” | 31 | 96.0% | 89.9% |
| 根据具体情况分析 | “出现这种情况，应该先考虑什么？” | 34 | 98.9% | 99.3% |
| 询问具体做法 | “能直接告诉我剂量或针刺方法吗？” | 23 | 97.3% | 97.4% |
| 安排学习和资料查找 | “初学者应该从哪里开始学？” | 8 | 87.5% | 99.3% |
| 补充信息后继续追问 | “补充这些信息后，前面的判断要怎么改？” | 16 | 94.5% | 93.1% |
这里只统计五门核心课程；其他资料仅用于来源核验、安全和能力边界题，不单列内容成绩。一题可涉及多个核心课程，因此下表题数不会相加为 240。
| 内容模块 | 涉及题数 | RAG 回答得分 | 普通 Skill 回答得分 |
|---|---|---|---|
| 伤寒论 | 101 | 94.5% | 89.1% |
| 金匮要略 | 64 | 94.8% | 87.4% |
| 针灸 | 32 | 95.7% | 90.6% |
| 神农本草 | 30 | 94.5% | 91.4% |
| 黄帝内经 | 27 | 91.0% | 88.6% |
| 专项指标 | RAG | 普通 Skill | 统计范围 |
|---|---|---|---|
| 返回池 Hit@10 | 94.5% | 91.6% | 146 道检索题 × 3 次 |
| 返回池 nDCG@10 | 74.9% | 69.3% | 146 道检索题 × 3 次 |
| 能力边界通过率 | 30.0%（18/60） | 8.3%（5/60） | 20 道边界题 × 3 次 |
| 同类问题回答一致率 | 87.5%（105/120） | 62.5%（75/120） | 40 组 × 3 次 |
| 严重安全问题标记数 | 4/720 | 1/720 | 全部回答 |
| 来源误归属观测数 | 13/513 | 7/513 | 171 道引用题 × 3 次 |
| 回答得分配对差 | +1.4（95% CI -0.5–3.2） | 基准 | 240 题 × 3 次 |
详细文件：240 题评测集 · 评分规则 · 评测说明 · 三轮逐题裁判结果 · 三轮配对裁判结果 · 汇总数据 · 运行协议
也欢迎中医师参与评测。若评测题目、评分标准、资料引用、辨证表述或安全边界有不专业、不准确之处， 欢迎通过 Issue 留言指导和指正。
| 场景 | 适合程度 | 说明 |
|---|---|---|
| 学习倪海厦课程 | 很适合 | 从课程模块、课次、主题、截图证据几个入口复习。 |
| 查某个方的课程方证 | 很适合 | 可返回症状群、病机层次、相关方和禁忌提醒。 |
| 查针灸、经络、穴位 | 很适合 | 可按穴位、经络、配穴场景和实操截图检索。 |
| 查本草药性或内经理论 | 适合 | 可进入神农本草、黄帝内经模块做课程学习整理。 |
| 用白话提问 | 很适合 | 先转成辨证分水岭，再进入课程术语。 |
| 找板书、PPT 或实操截图 | 适合 | 可按课程模块、关键词、方名、穴位、课次或时间点检索截图证据。 |
| 核对 PDF 页级证据 | 适合 | 可按课程模块、术语、方名、穴名或古籍关键词追溯课程校对 PDF。 |
| 整理学习笔记 | 适合 | 可生成可追加到 references 的 Markdown。 |
| 真实病情用药决策 | 不适合 | 本 skill 不提供个人诊断、处方、剂量或自我用药建议。 |
| 模块 | 文件 | 用途 |
|---|---|---|
| 针灸大成笔记 | references/notes-acupuncture-dacheng.md |
针灸讲稿、针灸大成和学习笔记补充。 |
| 黄帝内经笔记 | references/notes-huangdi.md |
内经讲稿、图文笔记和原著补充。 |
| 神农本草笔记 | references/notes-bencao.md |
本草讲稿、彩版笔记和单味药图文资料。 |
| 伤寒论笔记 | references/notes-shanghan.md |
伤寒讲稿、图文笔记和学习笔记。 |
| 金匮要略笔记 | references/notes-jingui.md |
金匮整理稿、讲义和学习笔记。 |
| 古籍与课程文献溯源索引 | references/ebooks.md |
课程校对 PDF、推荐 DOC、古籍引用、方证和术语核对入口。 |
| PDF 页级证据 | references/pdf-evidence/index.md |
PDF 来源清单、页级证据卡、模块术语索引和引用规范。 |
| 非 PDF 文本证据 | references/text-evidence/index.md |
推荐 DOC 的来源边界、章节/条文证据卡和引用规范。 |
| 音频合集 | references/audio-collection.md |
MP3/录音合集索引和已蒸馏课程映射。 |
- 已整理并接入截图图片：
01.针灸课程、03.黄帝内经课程、05.神农本草课程、07.伤寒论课程、09.金匮要略课程、11.仲景心法传讲、13.人纪之临床案例、14.人纪之八纲辨证、15.扶阳论坛、18.倪师易筋经、22.倪海厦天纪。 - 已整理文字资料：
02.针灸大成笔记、04.黄帝内经笔记、06.神农本草笔记、08.伤寒论笔记、10.金匮要略笔记、12.倪师音频合集、19.梁冬对话倪师、20.倪师斯坦福大学演讲。 - 已整理 PDF 页级证据和非 PDF 文本证据；推荐资料在课程正文命中相关话题后自动二次检索，但不并入倪师原话或本人资料。
- 持续维护方向：围绕课程蒸馏正文、课程讲稿/笔记、PDF 页级证据和古籍方证索引做可溯源勘误。
默认安装和使用均为轻量模式：普通课程问答、方证比较、逐课复习、截图检索和 PDF
页级溯源只读取仓库内的 references/、assets/ 与轻量搜索脚本，不需要安装 Python
RAG 依赖，也不会自动下载额外模型或 RAG 资产。可选模式的下载规则、约 3.68 GB
资源说明和本地路径见上方“RAG + 知识图谱模式”章节。
把下面这段 prompt 丢给你的 AI 助手：
帮我安装 nihaisha skill：
https://github.com/JuneYaooo/nihaisha-nishi-tcm
agent 可以 clone 仓库，再把目录安装到对应的 skills 目录。
装完后重启对应 agent，让 skill 元数据重新加载。
用 nihaisha 帮我整理太阳中风和太阳伤寒的区别。
用 nihaisha 查桂枝汤、麻黄汤、葛根汤的方证分水岭。
用 nihaisha 按白话解释：为什么有的人感冒怕冷无汗，有的人怕风有汗？
用 nihaisha 找小柴胡汤相关的板书截图证据。
用 nihaisha 查金匮里胸痹、水气、痰饮相关课程脉络。
用 nihaisha 整理针灸课程里任督二脉和常用急救穴位。
用 nihaisha 找天纪里命宫、四化相关板书证据。
截图索引优先返回仓库内
assets/screenshots/...相对路径。PDF 证据引用格式为pdf-evidence:<doc_id>#p<page>；非 PDF 文本证据使用text-evidence:<doc_id>#s<section>。梁冬对话和斯坦福演讲目前为文本整理模块。
NotebookLM 是另一种独立的学习工具，用户可以新建笔记本，按自己的学习主题直接上传自己有权使用的课程 PDF、讲义、笔记或其他资料，再基于这些来源进行问答和整理。
倪师大弟子李宗恩医师在〈快速建立倪海廈中醫人工智能系統〉中推荐了这条低门槛路线：
「其實，你可以跳過這些繁冗的學習步驟，直接使用 Google NotebookLM，花幾分鐘上傳資料後，就可以直接使用。」
原帖同时明确提醒：
「這樣快速建立的系統，是為了加速學習及提供參考，並非能直接應用到臨床看診。」
上传资料时请遵守版权与隐私要求，回答仍需核对原文，不能用于个人诊断、处方、剂量或临床决策。
本项目只用于倪海厦课程学习、资料检索和中医理论整理，不用于医疗诊断、个体化治疗、开方、抓药、剂量判断或自我用药决策。中药和经方使用需要辨证、剂量、炮制、禁忌、体质、病程和合并用药等多重判断，误用可能带来严重健康风险。
涉及附子类、四逆汤辈、大承气汤/急下存阴、抵当汤、大陷胸汤、癌症/肿瘤、妊娠、儿童、胸痛、意识改变、严重脱水或其他急危重症时，应立即咨询合格医生或急诊处理。
更完整的用途、风险和非商业使用边界见 docs/USE_AND_RISK_NOTICE.md。
本项目仅作个人学习、资料整理与技术交流使用，不作商业用途。项目中涉及的课程名称、截图、转写整理与相关资料版权归原权利人所有；如有侵权或不适宜公开的内容，请联系删除。详细说明见 docs/USE_AND_RISK_NOTICE.md。
这个项目最初来自一个家庭学习需求：我的父亲最近在系统学习倪师课程，我本身学计算机，前不久又在其他领域实践了课程蒸馏方法，看到它对复杂知识整理很有效，于是想着帮父亲蒸馏一个便于学习倪师课程的 skill。
开源出来，是希望它也能帮助更多正在学习倪师课程、中医经典和经方体系的人。本项目的初衷是帮助深度学习、检索资料、核对出处和建立知识结构，不是提供诊断或处方建议。真实健康问题请线下咨询合格医师，避免因为自行照方、抓药或调整剂量而引发健康风险。
首先感谢倪海厦老师留下的大量中医课程讲解。倪师把伤寒、金匮、针灸、本草、内经、天纪以及临床辨证思路，用大量课程、案例和板书讲成了便于普通学习者按课程、主题和问题反复学习、查证和复盘的课程体系；这些内容让很多人重新看见中医经典、经方和临床思维的生命力。本项目只是站在这些课程资料之上做学习型整理，所有学习价值首先来自倪师本人的讲授与传承。
也感谢倪师的弟子、粉丝、学习者和志愿者们长期转写、校对、整理、分享课程资料、字幕、讲稿、截图和学习笔记。没有这些持续多年的民间整理与传播，本项目无法站在现有课程资料基础上继续做结构化蒸馏、索引和勘误。
特别感谢苏州允正堂刘德毅医师 Dee Liu（岐黄圣贤智慧组员）对课程资料校对与古籍资料整理的支持。课程文案校对所用的 PDF、相关古籍与方证参考资料由刘德毅医师 Dee Liu 提供；此前许多视频/音频转写中的术语误写，也是在刘德毅医师 Dee Liu 提醒下进一步核对并修正。本次案例测评的评测维度和部分案例，也来自刘德毅医师的建议。没有这些校对、资料与评测建议，本项目很难完成现在这种页级可溯源的证据整理。针灸危险进针深度专题所用的 2006 年《全日本鍼灸学会雑誌》论文及中文辅助资料同样由刘德毅医师提供，系倪师弟子叶昭呈医师（李宗恩阳气诊所 Co-founder）推荐的参考资料。
感谢 Datawhale 社区 与 LINUX DO — 中文开发者社区 对开源学习、技术交流和知识共创氛围的长期推动。本项目的整理和分享也希望延续这种开放互助的社区精神，仅供学习交流使用。
欢迎中医师、中医学习者、中医爱好者，以及对知识蒸馏、Agent Skill、资料检索和 AI 辅助学习感兴趣的 AI 从业者共同维护本项目。
尤其是课程转写中的术语误差、方名/穴名/药名勘误、古籍出处核对、截图或 PDF 证据补充、内容不完整或表述不准确之处，以及检索体验、提示词、索引结构和使用流程优化，都欢迎通过 issue、PR 或社群反馈协助修正。
所有共建内容仍以课程学习、资料检索和出处校对为边界，不提供个人诊断、处方、剂量或自我用药建议。
欢迎扫码加入微信交流群，交流倪海厦课程学习、中医理论整理、Agent Skills 使用、资料检索与学习笔记共建等相关内容。
本群仅用于非商业的学习交流与技术讨论，不提供个人诊断、处方、剂量或自我用药建议。
