# 《中医入门》理论依据调用指南（应用层）

> 生成日期: 2026-09-08 ｜ 定位: **应用中随时调用的理论依据层**（用户定级: 重要理论基础）
> 数据: ../02_加工数据/理论依据库.json ｜ 接口: ../05_脚本工具/theory_api.py

## 一、定位

《中医入门》在资料库体系中是**理论依据层**：当体质调理、药膳推荐、处方分析、配伍核查等应用场景需要理论支撑时，通过本接口实时调用，返回**原文引文 + 行号**（可溯源至 02_加工数据/中医入门.md）。区别于 03_关联融合 的静态标注——那里是"大医网实体→锚点"的预计算快照，这里是应用期的动态查询。

## 二、数据范围（理论依据库）

| 板块 | 内容 | 数量 |
|------|------|-----:|
| 八法 | 汗吐下和温清消补，各含定义原文+行号 | 8 |
| 治法72 | 每条含名称/适应症/药如/行号（编号连续无缺号） | 72 |
| 七方 | 大小缓急奇偶复，各含定义+书内举例方 | 7 |
| 效能分类 | 15类，各含定义+代表药 | 15 |
| 功效药组 | 扶正7系+祛邪各类，含药味清单 | 42组 |
| 示例方40 | 组成/主方定位/主治/行号 | 40 |
| 脉象主症 | 27脉主症（长脉仅见总括韵文，原书编排） | 27 |
| 用药安全 | 十八反3组(+通行扩展)/十九畏10对/妊娠禁忌45味 | — |

## 三、接口用法

```python
import sys; sys.path.insert(0, "05_脚本工具")
from theory_api import TCMTheory
t = TCMTheory()

# 1. 药材理论依据（支持炮制品/别名归一: 炒白术→白术、参三七→三七）
t.herb("黄芪")
# → 滋补药(效能分类) + 治法10.固表祛邪法 + 治法64.补益中气法 + 用药安全, 均含原文与行号

# 2. 方剂理论依据（40示例方逐味给出组成理论；非示例方给剂型理论提示）
t.formula("大承气汤")
# → 主方定位:泻下, 主治:实热便闭, 七方归属:大方, 组成理论(逐味), 行号:1230

# 3. 配伍安全核查（应用前置检查；十八反含通行扩展并标注来源）
t.safety_check(["半夏", "附子"])
# → 十八反冲突[来源:通行扩展](附子为乌头子根), 结论:存在配伍禁忌须调整
t.safety_check(["甘草", "大戟", "茯苓"])
# → 甘草反大戟(书列) + 大戟妊娠禁忌

# 4. 治法查询（名称/适应症双向模糊）
t.method("补中")      # → 治法64.补益中气法 + 八法·补法

# 5. 体质调理依据（同义词展开: 阴虚→补阴/滋阴/养阴）
t.constitution("阴虚")
# → 药组:扶正类·脾者·补阴(熟地/山萸肉/天冬...), 治法:61.养阴退蒸法
```

## 四、依据分级约定

| 级别 | 含义 | 示例 |
|------|------|------|
| 书列 | 《中医入门》原文明确记载 | 人参反藜芦（散文） |
| 通行扩展 | 通行本有而本书未明列，安全核查必含并标注 | 附子反半夏、丹参反藜芦 |
| 未收录 | 本书为入门纲要未覆盖，不代表无理论依据 | 冷背药材 |

用药安全内容（十八反/十九畏/妊娠禁忌）在核查中**按"书列∪通行扩展"从严执行**，扩展项一律标注[通行扩展]以保证溯源透明。

## 五、维护

- 理论依据库由 `build_theory_basis.py` 从清洗成品重建；原文修订后重跑即可
- 行号与 02_加工数据/中医入门.md 同步；若原文增删行需重建
- 别名/炮制归一表与 reverse_tag_dayi_with_theory.py 保持一致（只剥炮制前缀，产地限定词不剥——土人参陷阱）