梧桐空间
东湖论彩 · 少量开放,精准服务

首页 / 时空针灸 / 文章

时空针灸 使用教程

最后更新:2026-11-19 12:47:08 · 时空针灸

一款基于中医“子午流注八法”的开穴推算与穴位理论查询工具,提供桌面版(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 可直接安装。

三、快速上手(第一次怎么用)

以桌面版为例:

  1. 启动 python desktop_app.py 或双击 exe。
  2. 顶部填「日期」「时间」(默认当前时刻),点「此刻」可回填当前时间,点「查询」刷新结果。
  3. 需要真太阳时:在「真太阳时」下拉选城市或手填经度,程序自动换算(东经为正,-180~180)。
  4. 勾选「生僻字注音」可为穴位生僻字自动标注拼音。
  5. 查看各标签页结果:总览、纳甲、纳子、飞腾、灵龟八法、十二原、养子时刻、移光定位,以及穴位数/时间表/处方/理论页。
  6. 首次使用有试用期,状态栏显示授权状态;长期用点「注册激活」(见 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)

  1. 桌面版启动报错:确认 Python 3 环境;桌面版本身无第三方依赖,若用了 Web API 再装 fastapi/uvicorn。cryptography 缺失时注册功能降级但主程序仍可用。
  2. 真太阳时结果异常:经度范围为 -180~180(东经为正);城市名需在 core.CITY_LONGITUDES 收录列表内,否则 API 返回 400 并列出可用城市。
  3. 时间格式错误(API):应为 2026-11-13 10:30 或 2026-11-13T10:30;不支持的格式返回 400。
  4. 授权状态异常:点底部「注册激活」按流程导入授权;状态栏实时显示授权状态。
  5. 网页打不开:静态页部署在 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/(梧桐空间)。
  • 说明:本工具为中医时间开穴的推算与资料查询,内容供学习研究,不作为医疗诊断/治疗依据。
← 返回时空针灸文章列表