硬核 DIY：我用 AI 搞了个中医“五运六气”推算引擎，附完整知识库
最近把《黄帝内经》里那套玄之又玄的“五运六气”理论搬到了代码里，搞了个 AI Agent 技能包。简单来说，这就是一个中医运气学说推算引擎，专门用来预测年度气候规律和疾病流行趋势，顺便还能结合当下的天气数据看看准不准。
作为技术人，咱们不谈虚的，今天就拆解一下这个项目到底能干什么，以及它的技术架构是怎么搭建的。
一、 为什么要做这个？
老祖宗留下的这套理论，实操起来其实非常“硬核”：
- 计算量巨大：需要查岁运、司天、客气、客主加临等一堆表格，手工算极易出错。
- 知识点太散：病机分散在《素问》七篇大论里，临床想查阅简直是大海捞针。
- 缺乏工具链：虽然有历代注家解释，但少有能把“理论、计算、数据、推导”串起来的自动化工具。
这个项目就是用代码把这些痛点全解决了，让 AI 帮你查表、推理、写报告。
二、 核心技术栈：RAG + ReAct
这不仅仅是一个计算器，它是一个具备推理能力的智能体。核心跑分思路如下：
用户输入 → 路由分发 → 推算引擎 + RAG知识库 → ReAct 辨证推理 → 结构化报告
- RAG 五层知识库：项目内置了 104 个关键键值的向量检索库，覆盖了经典原文、历代注家、运气方剂、地域修正等内容，确保 AI 有“书”可查。
- ReAct 推理工作流：不像普通 Chatbot 那样瞎编，AI 会根据计算结果（比如今年的火运太过），去知识库里检索对应的病理特征，然后一步步推导出治则治法。
- 自进化引擎：这玩意儿还能记录自己的推算盲区，通过反馈日志不断迭代。
三、 功能矩阵：它能算什么？
1. 基础推算（自动化查表）
这部分全是代码逻辑实现的硬核计算，不用人脑死磕：
- 干支推算：年干支、六十甲子序号、生肖生成。
- 五运推算：主运、客运、大运的太过不及与平气判断。
- 六气推算：司天、在泉、主气六步、客气六步的精确计算。
- 客主加临：分析客主之气是“相得”还是“不相得”，判断顺逆。
2. 高级对齐（理论联系实际）
这是最有趣的部分，它引入了外部数据：
- 天气对齐：接入实时气象数据，与理论上的运气格局做交叉分析，看看“天”和“地”是不是合拍（判断内外邪是相合还是相背）。
- 体质三维分析：结合你的出生年运气体质 + 当前岁运 + 实际天气，给出一个立体的调理建议。比如你是“湿热体质”，偏偏赶上“湿气”重的年份，系统就会提示你要加强去湿。
3. 报告与可视化
- 一键生成 Markdown 或 HTML 报告，适合学生、临床或研究用途。
- 支持终端 ASCII 图和可视化页面，看起来既极客又专业。
四、 怎么玩？（接入与部署）
这个技能包设计得非常解耦，支持多种方式调用，非常适合折腾各种 AI 工具流：
- 直接跑脚本：Python 为主链路（
scripts/calculate_yunqi_api.py），同时也提供了 Node.js 接口，方便前端集成。 - AI 客户端集成：Claude Code、Cursor、Cline、Codex CLI 等主流本地开发环境都能直接挂载这套技能。
- 想象一下，你在 Cursor 里问一句：“帮我分析一下今年的五运六气格局，并生成一份针对南方地区的养生建议”，它直接调取这套引擎，给出一份带数据支撑的报告。
项目还内置了全套的校验脚本（health_check、full_regression_test），跑不通直接报错，不用担心配置环境踩坑。
五、 写在最后
⚠️ 重要提示： 临床、方药及针灸相关内容仅供中医爱好者学习和研究参考，绝对不构成医疗诊断或治疗建议。身体不舒服还得去正规医院找执业医师。
这个项目本质上是一次传统算法与现代 AI 技术的碰撞。它把中医里那些模糊、复杂的逻辑，变成了可执行、可推理的代码。如果你对中医感兴趣，或者想钻研 RAG 知识库的搭建，这个仓库非常值得 clone 下来研究。
项目已开源，有兴趣的去 GitHub 搜 dhicoc/wuyun-liuqi-skills star 一下。
评论已关闭