<div align="center">

# 黄元御skill · 气机升降中医AI

**将清代医宗黄元御的"土枢四象·一气周流"完整医学体系注入 AI Agent**

`15个诊断公式` · `8棵决策树` · `10问诊协议` · `273条关键词索引` · `10则医案` · `11部医书全文` · `周易·道德经跨经典内化`

[![GitHub Stars](https://img.shields.io/github/stars/jangviktor-web/huangyuanyu?style=for-the-badge&color=yellow&label=Stars)](https://github.com/jangviktor-web/huangyuanyu/stargazers)
[![版本](https://img.shields.io/badge/版本-v2.8.0-blue?style=for-the-badge)](https://github.com/jangviktor-web/huangyuanyu/releases)
[![License](https://img.shields.io/badge/协议-MulanPSL--2.0-green?style=for-the-badge)](LICENSE)
[![Claude Code](https://img.shields.io/badge/Claude%20Code-Ready-orange?style=for-the-badge&logo=anthropic&logoColor=white)]()
[![内容](https://img.shields.io/badge/内容-三书同源-purple?style=for-the-badge)](#核心知识体系)

</div>

---

> 「中气者，和济水火之机，升降金木之轴，道家谓之黄婆。」—— 黄元御《四圣心源》

### 一句话介绍

将黄元御（1705-1758，乾隆御医，尊经派领袖）的气机升降辨证体系、一基四方方剂、崇阳抑阴心法蒸馏为可激活的 Agent Skill，使 AI 能以黄元御的视角进行中气辨证、升降定位、经方选药。

**直接激活词**：`黄元御` / `一气周流` / `土枢四象` / `水寒土湿` / `中气为轴` / `玉楸子`

> ⚠️ **本技能仅用于学习研究目的，不构成医疗建议。** 出方前须确认学习研究目的，真实病症请就医。

---

## 快速安装

<details open>
<summary><b>ClawHub / OpenClaw（推荐）</b></summary>

```bash
openclaw skills install @jangviktor-web/huangyuanyu
```
</details>

<details>
<summary><b>手动安装</b></summary>

```bash
git clone https://github.com/jangviktor-web/huangyuanyu.git
cp -r huangyuanyu/ ~/.claude/skills/huangyuanyu/
```
</details>

<details>
<summary><b>手机端（腾讯 IMA APP）</b></summary>

下载腾讯 IMA APP，在技能市场搜索"黄元御"即可使用（IMA skill id：7487883782931678）。

</details>

---

## 功能矩阵

| 能力 | 覆盖范围 | 说明 |
|:---|:---:|:---|
| **气机升降辨证** | ✅ | 中气为轴、左升右降、土枢四象完整模型 |
| **诊断公式** | ✅ | 15个公式：水寒土湿/中气败绝/升降四法/上热真伪/预后三窗口等 |
| **诊病十问** | ✅ | 一问中气→二问升降→三问寒热→…→十问病史（断生死第一关） |
| **IF-THEN决策树** | ✅ | 8棵：首诊定性/升降定位/上热真伪/中气预后/不寐/二便/咳喘/妇人 |
| **一基四方** | ✅ | 黄芽汤（参甘苓姜）+天魂/地魄/乌肝/兔髓，中气治本 |
| **方证速查** | ✅ | 专病专方+六气治法方+核心药对+方证鉴别表 |
| **六经速查** | ✅ | 六经标本中气从化表+气化用药规律 |
| **误治禁区** | ✅ | 禁滋阴/禁纯清/禁大下15条+误治急救6条+传变预警6条 |
| **古今病名映射** | ✅ | 150+条现代病→古代病名（糖尿病→消渴/痛风→历节…） |
| **三书同源** | ✅ | 《周易悬象》《道德悬解》《四圣心源》逐句互证（v2.1+新增） |
| **医案参考** | ✅ | 10则素灵微蕴完整医案（证-机-方-效四段链） |
| **文言文回答** | ✅ | 黄元御口吻文言作答+括号白话文版（v2.8新增） |

---

## 使用示例

**中气辨证**
> **Q**：我常年大便稀溏，吃凉的就拉肚子，手脚凉
> **A**：「凡病先断水寒土湿。便溏者，脾阳下陷也；手足厥冷者，中阳不足也。法宜理中汤温运中土，使脾阳升达，清浊复位。」
> （白话：先判断是不是水寒土湿。大便稀是脾阳下陷，手脚凉是中焦阳气不足。用理中汤温补中焦，让脾阳升起来，清浊之气各归其位。）

**真假热鉴别**
> **Q**：总是口腔溃疡，是不是上火？喝凉茶有用吗？
> **A**：「上热之证，皆甲木之不降。究之火不胜水，则上热不敌下寒之剧。尔之溃疡，恐是相火浮越，非真火也。凉茶寒凉伐阳，愈饮愈浮。」
> （白话：上火的病都是胆木之气不降。火压不住水，上热往往敌不过下寒。你的口腔溃疡恐怕是虚火浮越，不是真火。凉茶伤阳气，越喝火越浮。）

**三书同源**
> **Q**：您的"一气周流"跟《周易》"太极生两仪"什么关系？
> **A**：「阴阳未判，是为太极。太极判剖，分而为二，是生两仪。两仪升降，是生四象。吾于《四圣心源》云'阴阳未判，一气混茫'——同一句宇宙论与人体论之两端，易书止于八卦，医书收摄为四象+中气，一理贯之。」
> （白话：易经讲阴阳未分时是太极，太极分出阴阳两仪，两仪升降生出四象。我在《四圣心源》里说"阴阳未分，一气混茫"——这是同一句话用在宇宙和人体两个层面，易经止于八卦，医书收拢为四象加中气，道理是相通的。）

---

## 核心知识体系

### 一气周流模型

```
           中气（土·枢轴）
          /        \
    左升（木火）  右降（金水）
    肝脾升发      肺胃沉降
          \        /
        清浊复位·阴阳调和
```

**辨证铁律**：凡病先断水寒土湿 → 中气是否败绝（预后） → 定升降（左升/右降/中运） → 选方基（黄芽/理中/泻心/麻黄升麻） → 脏腑加减 → 避禁忌。

### 一基四方

| 方 | 组成 | 主治 |
|:---|:---|:---|
| **黄芽汤** | 人参三钱、甘草二钱、茯苓二钱、干姜二钱 | 中气虚寒（一切方之基） |
| 天魂汤 | 甘草、桂枝、茯苓、干姜、人参、附子 | 阳虚（左路不升） |
| 地魄汤 | 甘草、半夏、麦冬、芍药、五味子、牡蛎、玄参 | 阴虚（右路不降） |
| 乌肝汤 | 甘草、人参、茯苓、干姜、附子、桂枝、首乌 | 阳脱（精遗） |
| 兔髓汤 | 甘草、人参、茯苓、半夏、五味子、龙骨、牡蛎、麦冬、芍药 | 阴脱（神惊） |

### 跨经典三书同源（v2.1+核心）

```
《道德悬解》章一注："无者，天地之太极。太极包含阴阳，阴阳之内有中气焉。"
《周易悬象》系辞注："阴阳未判，是为太极……两仪升降，是生四象。"
《四圣心源》天人解："阴阳未判，一气混茫……清浊之间，是谓中气。"
结论：三书共享同一套"太极→中气→四象→脏腑"宇宙模型
```

---

## 数据来源

<details>
<summary><b>点击查看完整数据来源清单</b></summary>

| 素材 | 形态 | 说明 |
|---|---|:---:|
| 《黄元御医书十一种》 | modules/06 全文（3.37MB） | 11部著作全量收录，格式优化版 |
| 《四圣心源》 | modules/04 全文 | 独立单行本，高频引用 |
| 《长沙药解》 | modules/05 全文 | 独立单行本，药物心法 |
| 《周易悬象》 | modules/10 原文+07蒸馏本 | 40处医理关联段落+易-医推导链 |
| 《道德悬解》 | modules/09 原文+08蒸馏本 | 81章+中气/黄婆/谷神源头 |
| 《素灵微蕴》医案 | cases/01 | 10则完整医案（证-机-方-效） |

</details>

<details>
<summary><b>点击查看仓库目录结构</b></summary>

```
huangyuanyu/
├── SKILL.md                    # 主技能文件（695行，AI 直接读取）
├── modules/                    # 10 个知识模块
│   ├── 01_yian.md              # 医案
│   ├── 02_theory.md            # 理论
│   ├── 03_existing_skill.md    # 原skill
│   ├── 04_sishengxinyuan.md    # 四圣心源全文
│   ├── 05_changshayaojie.md    # 长沙药解全文
│   ├── 06_yishu_11zhong.md     # 医书十一种全文
│   ├── 07_zhouyi-xuanxiang-distilled.md  # 周易悬象蒸馏本
│   ├── 08_daode-xuanjie-distilled.md     # 道德悬解蒸馏本
│   ├── 09_daode-xuanjie-original.md      # 道德悬解原文
│   └── 10_zhouyi-xuanxiang-original.md   # 周易悬象原文
├── references/                 # 36 个分析文档
│   ├── 30-tensions.md          # 内在张力7组
│   ├── 31-intellectual-lineage.md  # 智识谱系（跨经典三支）
│   ├── 32-faq.md               # FAQ 21问
│   ├── 33-clinical-safety.md   # 临床安全层
│   ├── 34-keyword-index.md     # 关键词索引273条
│   ├── 35-if-then-trees.md     # IF-THEN决策树8棵
│   ├── 36-zhouyi-enhancement.md    # 周易悬象增强
│   ├── 37-zhouyi-knowledge-map.md  # 易-医-道三角链路
│   └── 38-daode-enhancement.md     # 道德悬解增强
└── cases/
    └── 01_suling_weiyn_cases.md    # 素灵微蕴10则医案
```

</details>

---

## 更新日志

<details>
<summary><b>点击展开完整更新日志（v1.0 → v2.8）</b></summary>

### v2.8.0（2026-08-03）
- **P0-P3增量训练**：争议回应五步模板、穴位边界声明、19映射补4条（甲状腺/乳腺/肺结节/脱发）、FAQ 18→21问（梅核气/更年期/脱发）
- **表达风格升级**：文言文回答+末尾括号白话文版（黄元御乃清代名医）

### v2.7.0（2026-08-03）
- **100题热度测试训练**：2026互联网热度题库+全量实答（覆盖率98%→100%，评分9.4/10）

### v2.6.0（2026-08-03）
- **知识网络体检**：死链修复+引用连通性验证

### v2.5.0（2026-08-03）
- **覆盖度补遗**：周易悬象5处遗漏（大衍之数/剥卦/坤用六/同人/鼎）

### v2.4.0（2026-08-03）
- **06格式优化**：48,102→38,738行（清页码3564/书眉947/LaTeX 1248/页脚773）

### v2.3.0（2026-08-03）
- **原文全文收录**：道德悬解（modules/09）+周易悬象格式优化版（modules/10）

### v2.2.0（2026-08-03）
- **道德悬解内化**：modules/08蒸馏本+38增强+三角对照+道德经关键词15条+三书闭环

### v2.1.0（2026-08-03）
- **周易悬象内化**：modules/07蒸馏本+36/37链路+张力七+易学关键词25条+核心工作流易学溯源

### v2.0.0（2026-08-03）
- **V2.2四维补齐**：内在张力6组/智识谱系/FAQ 18问/临床安全层/关键词200+/决策树8棵/学习研究确认协议

### v1.0.0（初始版）
- 黄元御医书十一种基础技能

</details>

---

## 协议

本项目以 [MulanPSL-2.0（木兰宽松许可证第2版）](LICENSE) 协议开源。内容为清代古籍（作者已过世数百年）之整理与蒸馏，无版权争议；仅供学习研究，不构成医疗建议。

---

**相关项目**：[倪海厦skill](https://github.com/jangviktor-web/nihaixia) · [胡希恕skill](https://github.com/jangviktor-web/huxishu) · [苏华仁skill](https://github.com/jangviktor-web/suhuaren)
