一款基于中医“子午流注八法”的开穴推算与穴位理论查询工具,提供桌面版(Tkinter)、Web API(FastAPI)与网页版三种形态。按日期/时间推算纳甲、纳子、飞腾、灵龟八法、十二原、养子时刻、移光定位七法开穴,附穴位库、理论文库与参考处方,生僻字自动注音。算法与《子午流注新版》v1.2.7 完全一致。面向中医针灸学习者与从业者。
一、这是什么 / 适用场景
- 七法开穴推算:输入公历日期时间(可选真太阳时/经度),推算纳甲、纳子、飞腾、灵龟八法、十二原、养子时刻、移光定位七种子午流注开穴结果。
- 穴位与理论文库:内置穴位库、理论文库、参考处方、十二时辰总表,可查询穴性、归经、五输穴、原穴等。
- 真太阳时换算:可按城市或经度把北京时间换算为真太阳时(东经为正),辅助按时开穴。
- 多端使用:同名算法同时提供桌面版、Web API(供网页/程序调用)与静态网页,另有 Android APK 分发。
二、环境准备与安装启动
桌面版(推荐普通用户)
- 无需第三方依赖(单文件 Tkinter,标准库)。
- 启动:
python desktop_app.py,或双击打包好的时空针灸-桌面版-1.1.0.exe。 - 窗口标题「时空针灸 · 子午流注」,初始尺寸 1180×720。
Web API(供开发/网页调用)
- 依赖:
fastapi>=0.110、uvicorn[standard]>=0.27(见requirements.txt)。
网页版:web/index.html(静态页,部署于 https://www.csh.space/shikong/)。
Android:目录内 时空针灸-1.0.7.apk 等 APK 可直接安装。
三、快速上手(第一次怎么用)
以桌面版为例:
- 启动
python desktop_app.py或双击 exe。 - 顶部填「日期」「时间」(默认当前时刻),点「此刻」可回填当前时间,点「查询」刷新结果。
- 需要真太阳时:在「真太阳时」下拉选城市或手填经度,程序自动换算(东经为正,-180~180)。
- 勾选「生僻字注音」可为穴位生僻字自动标注拼音。
- 查看各标签页结果:总览、纳甲、纳子、飞腾、灵龟八法、十二原、养子时刻、移光定位,以及穴位数/时间表/处方/理论页。
- 首次使用有试用期,状态栏显示授权状态;长期用点「注册激活」(见 4.3)。
Web API 用户:uvicorn api:app --reload 后访问 /docs 查看接口(参数 dt、city、lon、name 等),可在线试算。
四、核心功能详解
4.1 七法开穴
- 入口:桌面版各法标签页;API
/api/...(najia/nazi/feiteng/linggui/shieyuan/yangzi/yiguang)。 - 计算链路(见
api.py):日期 → 日干支 → 时干支 → 按法调用ziwu.core的najia/nazi/feiteng/linggui/shieyuan/...。 - 输出:各法开穴的穴位、经脉、补泄、卦位等(如纳甲含穴位经、值日经、开穴、补穴、穴性等列)。
- 兼容:算法与《子午流注新版》v1.2.7 完全一致。
4.2 真太阳时与注音
- 真太阳时:
core.to_true_solar(dt, longitude),可按城市名取经度或直接用经度;不填则不做换算。 - 注音:
ziwu/pinyin.py为生僻字注音,桌面与网页均可开关。
4.3 穴位库 / 处方 / 理论
ziwu/xuewei.py(穴位)、prescription.py(处方)、knowledge.py(理论文库),桌面版对应穴位、处方、理论标签页。
4.4 注册激活
- 桌面版底部有「注册激活」「版权信息」按钮;授权模块
registration/(ClientRegistrationManager等),cryptography 缺失时降级不阻断主程序。窗口底部显示授权状态与版本 v1.1.0。
五、近期更新功能
项目无更新日志,2026-05 之后的变更依据文件时间戳与代码结构推断:
- 2026-11-18 知识模块更新:
ziwu/knowledge.py(11-18 21:05)时间戳较新,推断理论文库/内容有补充——对用户的影响:理论文库页内容可能较先前更全。依据文件时间戳,非文档说明。 - 2026-11-18 Android APK 连续迭代:
时空针灸-1.0.4.apk→1.0.5→1.0.6→1.0.7.apk(11-18 19:20~20:12 密集生成),另有子午流注(2026.11.18).apk。对用户的影响:安装请选 1.0.7(最新);依据文件名版本号与时间戳。 - 2026-11-18 网页版更新:
web/index.html(36KB,11-18 21:29)与灵龟八法九宫明细表.xlsx(11-18)更新,推断网页功能/明细表内容调整。依据文件时间戳。
六、常见问题与排错(FAQ)
- 桌面版启动报错:确认 Python 3 环境;桌面版本身无第三方依赖,若用了 Web API 再装 fastapi/uvicorn。cryptography 缺失时注册功能降级但主程序仍可用。
- 真太阳时结果异常:经度范围为 -180~180(东经为正);城市名需在
core.CITY_LONGITUDES收录列表内,否则 API 返回 400 并列出可用城市。 - 时间格式错误(API):应为
2026-11-13 10:30或2026-11-13T10:30;不支持的格式返回 400。 - 授权状态异常:点底部「注册激活」按流程导入授权;状态栏实时显示授权状态。
- 网页打不开:静态页部署在
https://www.csh.space/shikong/;本地 API 网页需先启动 uvicorn。
七、补充信息
- 目录结构:
desktop_app.py(桌面入口)、api.py(FastAPI)、web/index.html(网页)、ziwu/(core/prescription/knowledge/xuewei/pinyin + data)、registration/(注册)、licenses/、dist/(打包产物)、requirements.txt、多个 APK 与桌面 exe。 - 主页:
https://www.csh.space/shikong/(梧桐空间)。 - 说明:本工具为中医时间开穴的推算与资料查询,内容供学习研究,不作为医疗诊断/治疗依据。