又称「时空针灸开穴通」,是一款基于朱勉生教授“时空针灸学”理论的中医针灸开穴辅助软件,覆盖纳甲法、纳子法、灵龟八法、飞腾八法等 8 种按时开穴方法,兼具穴位查询、病例查询与理论学习功能,面向针灸临床医生、中医院校师生与研究者(计算结果仅供参考,临床请咨询专业医师)。
医学声明:本软件基于传统中医理论开发,所有开穴计算与处方建议仅供参考,不构成医疗诊断或治疗建议,临床使用请咨询专业医师。
一、这是什么 / 适用场景
- 按中国传统“子午流注”按时取穴理论,输入日期时间与城市(用于真太阳时换算),计算当日当时应开的穴位。
- 覆盖 8 种开穴方法:纳甲法、纳子法、灵龟八法、飞腾八法、养子时刻、移光定位、十二原穴、时空针灸。
- 辅助功能:真太阳时换算、空间穴位生成(九宫阵/八卦阵)、穴位详情库(含高清穴位图)、针灸病例查询(25 例)、针刺手法指导、气血流注图、经络循行图、干支文化与宇宙论理论(14 专题)。
- 适用人群:针灸临床医生快速查穴、院校师生教学、子午流注研究者算法验证、中医文化爱好者学习。
二、环境准备与安装启动
- 环境:Python 3.7+;桌面版用 tkinter(Python 自带);API 需
flask、flask-cors;生产部署可选 gunicorn + nginx。 - 安装 API 依赖:
pip install flask flask-cors。 - 启动方式(详见
DEPLOYMENT.md): - 桌面版(推荐普通用户):
python shikong_zhenjiu.py(兼容保留版),或python quick_start.py一键启动。 - Web 界面:先启动 API 服务,再用浏览器打开
web_interface/index.html,确认“连接正常”。 - API 测试客户端:
python api/test_api.py。 - 启动前建议校验数据:
python validate_tcm_data_fixed.py(通过后显示“所有数据验证通过”);架构自检python test_new_architecture.py。
三、快速上手(第一次怎么用)
- 运行
python shikong_zhenjiu.py打开桌面版(或python quick_start.py)。 - 选择开穴方法(快捷键 Alt+1~8 可在 8 种针法间秒切)。
- 输入日期时间(默认取当前时间),必要时选择城市以换算真太阳时。
- 按 Enter 一键查询,得到该时辰的开穴结果。
- 查看穴位详情(定位、文献、图示)、气血流注图等辅助信息;需要时用“全天开穴”查整日 12 时辰结果。
- 结果可一键导出 TXT 或打印;常用配方用收藏夹保存,历史查询(最近 10 条)双击可恢复。
四、核心功能详解
8 种开穴方法
入口:主界面方法选择区 / 快捷键 Alt+1~8。各方法依据不同古典理论:纳甲法(日干定经、时干定穴)、纳子法(按时辰配脏腑、补母泻子)、灵龟八法(洛书九宫推八脉交会穴)、飞腾八法(先天八卦配时干)、养子时刻、移光定位、十二原穴、时空针灸(时间与空间双维度集大成)。
真太阳时换算
将北京时间按城市经纬度换算为当地真太阳时,保证“按时取穴”的时间精度。API 中通过 city 参数传入城市。
穴位查询与辅助资料
- 穴位详情库:含基本定位、经典文献详解、穴位图示三标签页,配 112 张高清穴位参照图。
- 时穴记忆:6 类时穴(就诊、精神心理创伤、意外事故、治疗、疾病发作、生辰),支持任意历史日期回溯。
- 针灸病例查询:25 个精选案例,支持关键词模糊搜索。
- 气血流注图 / 经络循行图、针刺手法指导、干支文化与宇宙论 14 专题。
Web API 接口(模块化 2.0 版)
GET /api/health健康检查;GET /api/methods获取计算方法。GET /api/calculate?method=naijia&datetime=...&city=北京&bu_xie_type=平:计算开穴,method支持 naijia/nazi/linggui/feiteng/all。GET /api/xuewei/足三里、GET /api/xuewei/search?q=头痛(支持 meridian、attribute 过滤)。POST /api/prescription:按时或按症状生成处方(JSON),含临床建议与禁忌。GET /api/validate、GET /api/jingluo、GET /api/common-xuewei。
数据来源与结构
数据以 JSON 存放于 data/:xuewei_details.json(穴位详情)、clinical_data.json(手法/补泻/母子穴/实例)、xuewei_book_details.json(穴位书籍)。核心算法在 core/(nazi.py、linggui.py 等),服务层在 services/(tcm_calculation_service.py、prescription_service.py)。
五、近期更新功能(重点)
本项目的核心文档与代码均在 2026-05 之后,主要内容为一次大版本重构(v1.1.0 桌面 → 模块化专业版 2.0.0):
- 数据验证系统(2026-08-06,PROJECT_SUMMARY 第一阶段):新增
tcm_data_validator.py,校验纳甲法表完整性、经脉-五行对应、时辰-经脉对应、灵龟八法数据与穴位库,并生成 HTML 报告(项目内有data_validation_report.html)。同时修正中医理论错误:五行生克算法、灵龟八法八卦对应、统一“心包”经络名(原“包络”)、扩展奇经八脉。对用户影响:开穴计算基于更准确、经过验证的中医数据,结果更可信。 - 模块化分层架构(第二阶段):把原来的单体桌面程序拆成
core/(算法)+data/(数据仓库)+services/(计算/处方服务)三层。对用户影响:普通用户操作不变,但为后续多端(Web/API/桌面)提供基础。 - 新增 RESTful API 与 Web 界面(第三阶段,2026-08-06):新增 Flask API(
api/app.py,端口 5000)与现代化 Web 界面。对用户影响:从“只能装桌面软件”变成可选浏览器访问,开发者可把开穴/穴位/处方能力接入其他系统。 - 部署与维护文档(第四阶段):新增
DEPLOYMENT.md、PROJECT_SUMMARY.md。另有quick_start.py一键启动工具。 - 桌面功能说明文档(
时空针灸开穴通_功能说明与营销软文.txt,2026-08-01)仍标注 v1.1.0,描述 8 大开穴法与全部辅助功能,是用户操作的主要依据。 - 注:项目内还有大量
ocr_*.py脚本与pages/、pdf_images/目录,时间戳多为 2026-08-06,据此推断这批脚本用于把穴位书籍 PDF(如《针灸学》类扫描件)OCR 成图片/文本以补充穴位资料库,属于资料整理工作,对用户功能无直接影响。
六、常见问题与排错(FAQ)
- API 连接失败:检查 API 服务器是否运行、端口 5000 是否被占用(
netstat -tulpn | grep :5000)、检查防火墙。 - 数据验证失败:检查 JSON 数据文件格式,运行
python tcm_data_validator.py查看详细验证。 - 模块导入错误:确保 Python 路径包含项目根目录,检查模块依赖,运行
python test_new_architecture.py自检。 - 计算结果如何解读 / 能否直接用于临床:本软件基于传统理论,结果仅供参考,临床使用请咨询专业医师。
- 真太阳时为什么要填城市:古人以日晷计时,按时取穴需用当地真太阳时;填城市后软件按经纬度自动换算。
七、补充信息
- 原著理论:朱勉生教授(旅法中医针灸学家,“时空针灸学”创始人);软件作者:摸球校尉陈八七;微信 moqiuxiaowei。
- 相关项目:《API化实施方案》将其列为“已自带 Web API、中医领域独立”项目;与「时空针灸」为同一理论体系的不同目录实现。
- 生产部署:推荐 gunicorn + nginx 反代,或 Docker(文档
/api/*路由见 DEPLOYMENT.md)。