一句话简介:这是“子午流注针灸”桌面工具的纯静态网页版(站点 https://zhenjiu.csh.space),通过浏览器调用 api.csh.space 的子午流注 API,提供开穴计算、真太阳时、空间阵、细法取穴、全天开穴表、穴位/经络查询、处方与理论/病例内容,面向中医针灸爱好与从业者。
一、这是什么 / 适用场景
- 在线开穴计算:把子午流注纳甲纳子、灵龟八法/飞腾八法等开穴计算搬到浏览器,支持真太阳时按城市时差修正。
- 细法取穴:养子时刻、移光定位、十二原穴、天时记忆等细法,以及空间阵、全天开穴表等进阶功能。
- 知识查询:穴位详情/搜索、经络、常用穴、处方,以及理论文章、候气指南、病例列表与详情。
- 适用人群:中医针灸学习者、从业者,以及需要在多设备查阅子午流注开穴与理论的使用者。
二、环境准备与安装启动
2.1 本地预览(开发/验证用)
- Python 3(起静态文件服务器即可,站点本身无需 Python 运行时)。
- 演示 Key 已写在
assets/js/config.js,本地可直接调用。
python -m http.server 5500
2.2 正式部署(宝塔)
部署说明要点:
- DNS:
zhenjiu.csh.space的 A 记录指向43.154.109.213。 - 再部署网页:本目录
python deploy_zhenjiu_web.py。 - 打开
https://zhenjiu.csh.space强刷验证。 - 远程目录:
/www/wwwroot/zhenjiu.csh.space。 - 若 SSL 未签发,确认 DNS 生效后重新运行网页部署脚本。
静态站架构与同站群其它网页版一致:网页服务器无需 Python,计算在后端 API 完成。
三、快速上手(第一次怎么用)
- 首次若提示填 API Key:在设置中填入有效 Key(演示 Key 已内置,存浏览器 localStorage 键
zhenjiu_web_api_key)。 - 在开穴计算页选择日期/时辰,按需设置城市与“真太阳时”开关(默认开启,与桌面版城市时差表一致),点计算查看开穴结果。
- 切换到细法取穴,选择
kind(养子时刻 yangying / 移光定位 yiguang / 十二原穴 shier_yuan / 天时记忆 tianshi / 全部 all)查看细分结果。 - 需要空间阵、全天开穴表时,分别在对应页签生成。
- 通过穴位搜索/详情、经络、处方查询穴位与配伍;到理论目录、候气指南、病例页阅读资料。
- 需要最新数据时点“刷新数据”(
POST /refresh)。
四、核心功能详解
4.1 接口清单(README + api.js)
统一前缀 /api/v1/tools/zhenjiu:
| 功能 | 方法 | 路径 |
|---|---|---|
| 探活 / 元信息 | GET | /health、/meta |
| 开穴计算 | POST | /calculate |
| 真太阳时 | /calculate、/extra/calculate 入参 | city、use_solar_time(默认 true,与桌面城市时差表一致) |
| 细法 kind | POST | /extra/calculate:yangying 养子时刻 / yiguang 移光定位 / shier_yuan 十二原穴 / tianshi 天时记忆 / all |
| 空间元信息 / 生成空间阵 | GET/POST | /space/meta、/space/array |
| 细法元信息 / 细法取穴 | GET/POST | /extra/meta、/extra/calculate |
| 全天开穴表 | POST | /day-table |
| 经络 / 常用穴 | GET | /jingluo、/common-xuewei |
| 穴位详情 / 搜索 | GET | /xuewei/{name}、/xuewei/search(支持 q/meridian/attribute 参数) |
| 处方 | POST | /prescription |
| 理论目录 / 正文 | GET | /content/articles、/content/articles/{id}(methods/clinical/biaoyou/course/about 等) |
| 候气指南 | GET | /content/houqi |
| 病例列表 / 详情 | GET | /cases、/cases/{id}(支持 category/q/method 过滤) |
请求头统一为 X-API-Key。
4.2 真太阳时与城市时差
config.js内置城市时差表cities(如 北京 0、上海 -0.2、广州 -0.8、拉萨 -1.4、乌鲁木齐 -2 等),与桌面版一致。- 计算时可传
city和use_solar_time(默认 true)做真太阳时修正。
4.3 API Key 与限额(依据 api.js)
- 请求头
X-API-Key,未填 Key 前端提示“请先在设置中填写 API Key”。 - Key 优先级:
localStorage>config.js的defaultApiKey;可在设置中修改保存。 - 遇到 429 限额:提示加 QQ 群 1106032332(子午流注) 申请个人 Key,或到“捐助”页扫码开通无限量 Key。
4.4 指南与内容页
guides/含najia-nazi.html(纳甲纳子)、linggui-feiteng.html(灵龟八法/飞腾八法)等说明页;donate.html为捐助页。- 理论正文、候气指南、病例等由后端内容接口提供,前端按 id 读取展示。
五、近期更新功能(重点)
文档(README、宝塔部署说明)时间为 2026-08-23,索引记录项目最近更新为 2026-10-19,无专项更新日志。以下依据文档、接口代码与目录结构整理,推断处标注。
- 网页版上线,覆盖桌面版子午流注能力
- 依据:README 接口表列出开穴计算、真太阳时、细法、空间阵、全天表、穴位/经络/处方、理论/病例等完整能力。
- 对用户操作的影响:无需安装桌面软件,浏览器打开
zhenjiu.csh.space即可做开穴与知识查询。(依据文档)
- 一键部署脚本
deploy_zhenjiu_web.py与 SSL 自动化
- 依据:脚本中
DOMAIN = "zhenjiu.csh.space"、REMOTE_ROOT = "/www/wwwroot/zhenjiu.csh.space",并用 acme.sh 自动签发证书、成功后恢复 HTTPS 强制跳转。
- 细法与内容体系接口化
- 依据:
api.js中extraCalculate(四种细法 kind)、dayTable、spaceArray、prescription、houqi、articles、cases等。
- 项目整体更新(依据索引时间戳推断)
- 依据:索引 latest=2026-10-19,晚于文档 2026-08-23。
- 对用户操作的影响:线上为 10 月后状态;本地旧副本建议用
deploy_zhenjiu_web.py重新部署。(依据索引时间戳推断)
六、常见问题与排错(FAQ)
Q1:提示“请先在设置中填写 API Key”?
在设置中填入有效 Key(演示 Key 已内置)。Key 存于浏览器 localStorage(键 zhenjiu_web_api_key),清浏览器数据后需重填。
Q2:提示 HTTP 429 超限?
按提示加 QQ 群 1106032332(子午流注)申请个人 Key,或到“捐助”页扫码开通无限量 Key。
Q3:真太阳时计算结果和桌面版不一致?
确认 use_solar_time 开关状态与所选城市是否一致;config.js 的城市时差表与桌面版一致,若选错城市会有偏差。
Q4:部署后打不开 / SSL 未签发?
确认 DNS 的 zhenjiu.csh.space A 记录已指向 43.154.109.213;SSL 未签发时确认 DNS 生效后重新运行 python deploy_zhenjiu_web.py,或在宝塔面板手动申请证书并开启强制 HTTPS。
七、补充信息
- API 前缀:
https://api.csh.space/api/v1/tools/zhenjiu/;后端部署脚本见“API总库”项目的deploy_zhenjiu_api.py。 - 文件结构:
index.html主页面;assets/css/(app.css、guides.css)、assets/js/(config.js、api.js、app.js、share.js、qrcode.min.js)、assets/img/qq-group.png;guides/(najia-nazi.html、linggui-feiteng.html);deploy_zhenjiu_web.py部署脚本;donate.html、robots.txt、sitemap.xml、llms.txt、assets/og.png。 - 关联项目:与“SSQDLT高频号码统计工具网页版”“双色球大乐透开奖数据查询系统网页版”同属 csh.space 站群静态工具,均依赖 api.csh.space 与宝塔部署体系;本项目另有“时空针灸”桌面版项目。