中医食疗辨证论治系统

基于完整的中医食疗理论体系：理 → 法 → 方 → 药（食），为 AI Agent 和终端用户提供专业的中医食疗能力。

⚠️ 常见失败模式（必须先读）

以下是在辨证和食疗推荐中反复出现的 Agent 失败模式。每一条都曾导致真实诊断错误，处理每个请求前检查本节。

失败模式 1: 古籍噪声污染

现象: 知识库中的古文本（《辨证录·中妖门》《证治汇补》等）包含异质条目（如"山魈吸气证""鬼魅侵扰证"），这些条目文本短且包含常见单字（"眠""热""痛"），易被关键词匹配命中。
为什么会失败: match_from_knowledge() 对古文本做子串匹配时，"口渴"+"多饮"+"多尿" 可能命中《中妖门》条目，因为古文本包含"饮""渴"等单字。
正确做法:
- 知识库匹配结果中，来源为"陈士铎-中妖门"或匹配度<0.15 的条目，自动降权
- 优先使用疾病桥接（_try_disease_bridge）结果，桥接命中时以桥接为准
- 桥接未命中时才使用知识库匹配，且必须通过八纲一致性校验

失败模式 2: 疾病桥接压制器官信号

现象: 症状列表中的某单一症状（如"月经不调"）触发了疾病桥接，桥接返回的分型（如"肾虚型"）覆盖了其他症状（"胁痛""情绪低落"）强烈指向的脏腑（肝）。
为什么会失败: _try_disease_bridge() 取症状列表中的第一个匹配病名决定桥接方向，但第一个匹配的疾病未必是主病。
正确做法:
- 桥接结果必须与五脏辨证结果交叉验证
- 如果五脏得分最高的脏与桥接TOP1证型不匹配，且五行推演吻合度≥2，则五行推演优先
- 检查桥接证型是否覆盖了所有主要症状，不能只看第一个匹配

失败模式 3: 寒热矛盾误判

现象: 输入同时包含寒性症状（怕冷）和热性症状（盗汗、口干），八纲辨证简单取"得分最高"维度，可能判为"实证寒证"而忽略"盗汗"的热象。
为什么会失败: _resolve_nature() 对虚实和寒热分别取最高分维度，差值≤1时判为"不明显"。但两个维度的得分差异在≤1时仍存在有意义的临床信号。
正确做法:
- 寒热得分差≤1且两边都>0时 → 检查是否有阴虚+阳虚共存的可能（阴阳两虚）
- 虚实得分差≤1且两边都>0时 → 检查是否有上热下寒或本虚标实的复合病机
- 不要仅凭"寒热不明显"就忽略矛盾信号，要返回"可能存在复合证型"提示

失败模式 4: 食材禁忌漏检

现象: 针对消渴患者推荐含高糖食材（红枣、桂圆），或痛风患者推荐高嘌呤食材（海鲜、动物内脏）。
为什么会失败: 辨证和食谱推荐是两个独立步骤，食谱推荐没有自动交叉验证辨证结果中的禁忌约束。
正确做法:
- 生成食疗方案前，必须查 chronic-diseases.json 中对应疾病的 avoid_foods / 禁忌食材
- 如果找不到结构化禁忌数据，至少查 ingredients.json 中学名对应食材的性味，交叉验证与证型的冲突
- 推荐食材列表输出时必须附禁忌食材列表，且两者不能有交集

失败模式 5: 症状过少时过度推断

现象: 仅 1-2 个症状（如"乏力"）就给出精确证型结论（"肺气虚"），而实际上"乏力"是 80% 证型的共有症状。
为什么会失败: 辨证引擎对输入症状数没有下限校验，_determine_syndrome 在知识库无匹配时会 fallback 到八纲+五脏关键词匹配，但 1-2 个症状的匹配噪音极高。
正确做法:
- 症状<3 个时，仅返回八纲/五脏的宽泛指向，不输出精确证型名
- 在结果中明确标注"症状信息不足，建议补充更多症状以获得精确辨证"
- 知识库匹配度<0.2 且动态证型映射无高置信度命中时，不要输出具体证型名

辨证 SOP（标准操作流程）

每次 diagnose() 调用按以下步骤执行，不允许跳过任何步骤：

Step 1: 症状收集与扩展

• 使用 expand_symptoms() 将用户输入症状扩展同义词（如"怕冷"→"畏寒/四肢不温/形寒"）
• 检查症状列表长度：<3 个 → 标记为"信息不足"，跳至 Step 6 返回宽泛结论

Step 2: 五引擎并行辨证

必须同时运行以下五个引擎，不可只取一个结果：

Step 3: 知识库匹配（知识驱动层）

• 先跑 _try_disease_bridge(symptoms)：症状→疾病名→辨证分型（数据源：中医病证诊断疗效标准/证因脉治等）
• 桥接未命中 → 跑 match_from_knowledge(expanded_symptoms) 全文检索
• 匹配结果必须通过八纲一致性校验：证型的八纲属性与 _score_bagua() 结果矛盾 → 过滤
• 来源为"陈士铎-中妖门"或"陈士铎-鬼魅门"的条目 → 强制降权（匹配度×0.1）

Step 4: 冲突检测与优先级

遇到以下冲突时的处理优先级：

Step 5: 确定证型与治则

• 使用 _determine_syndrome() 综合所有引擎结果
• 检查动态证型映射（2999条）中的复合证型匹配（心脾两虚/肝肾阴虚/脾肾阳虚/心肾不交等）
• 证型名含"吐血""疟""妖""鬼"等非食疗适用词 → 不直接使用，改为功能描述

Step 6: 方案生成与禁忌检查

• 证型确定后，查 chronic-diseases.json 获取推荐食材和禁忌食材
• 查 ingredients.json 获取每个推荐食材的性味归经
• 验证推荐食材与证型不冲突（如阴虚证不推荐温热食材）
• 输出必须包含：证型、治则、推荐食材、禁忌食材、食疗原则

🚫 禁止操作（High-Risk Action Blacklist）

以下操作在任何情况下都不得执行。违反将导致输出质量严重下降，已被评测验证为有害：

服务范围

核心功能（API 快速引用）

理论框架

理（辨证基础）
  ├─ 体质辨证：9 种体质（平和/气虚/阳虚/阴虚/痰湿/湿热/血瘀/气郁/特禀）
  ├─ 八纲辨证：阴阳·表里·寒热·虚实
  ├─ 五脏辨证：心·肝·脾·肺·肾
  └─ 五行因果：母病及子/子盗母气/相乘/相侮/以克为生
         ↓
法（调理方法）→ 汗·吐·下·和·温·清·消·补
         ↓
方（配伍方法）→ 君臣佐使·相须相使
         ↓
药/食（食材应用）→ 性味归经·功效主治·禁忌·现代营养

快速开始

安装

# 无需额外安装，标准 Python 3.10+
python3 -c "from core import syndrome; print(syndrome.diagnose(['头晕','乏力']))"

辨证

from core.syndrome import diagnose

result = diagnose(["失眠", "心悸", "健忘", "食欲不振"])
# → {"证型": "心脾两虚证", "治则": "补益心脾", "推荐食材": ["龙眼", "红枣", "黄芪"]}

知识检索

from core.knowledge import search, get_ingredient

# 搜索中医理论
results = search("tcm-theory", ["阳虚质", "怕冷"])

# 查询食材
ginger = get_ingredient("生姜")
# → {"性": "温", "味": "辛", "归经": ["肺","脾"], "功效": ["散寒解表","温中止呕"]}

食谱生成

from core.recipe import personalize

plan = personalize({
    "体质": "阴虚质",
    "症状": ["口干", "盗汗"],
    "口味": "清淡"
})

CLI 调用

# 辨证
python3 scripts/syndrome_differentiator.py --symptoms "头晕,乏力,失眠"

# 知识检索
python3 scripts/knowledge_manager.py search --category ingredients --keywords 枸杞

# 菜品改良
python3 scripts/dish_improvement.py --name 红烧肉 --chronic 糖尿病

# 个性化食谱
python3 scripts/personalized_recipe.py --body 阴虚质 --symptoms "口干,盗汗"

# 茶饮推荐
python3 core/tea.py --constitution 阴虚质 --count 3
python3 core/tea.py --symptoms 失眠 疲劳 --count 3

# 功法推荐
python3 core/daoyin.py --constitution 阴虚质 --count 3
python3 core/daoyin.py --organ 肾 --count 3

知识库

目录结构

tcm-dietary/
├── core/                 # 公共 API（薄封装）
│   ├── syndrome.py       # 辨证引擎接口
│   ├── knowledge.py      # 知识检索接口
│   ├── recipe.py         # 食谱/菜品接口
│   ├── daoyin.py         # 导引推荐接口
│   └── tea.py            # 茶饮推荐接口
├── references/           # 参考文档
├── tests/                # 测试
├── SKILL_FULL.md         # 完整文档（Agent 深度使用）
└── CHANGELOG.md

使用许可

MIT-0 (MIT No Attribution)。可自由使用、修改和重新分发。无需署名。

免责声明

本 Skill 提供的中医食疗建议仅供参考，不构成医疗建议。如有健康问题，请咨询专业医师。