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

首页 / 子午流注 / 文章

子午流注网页版 使用教程

最后更新:2026-11-19 12:47:08 · 子午流注

一句话简介:这是“子午流注针灸”桌面工具的纯静态网页版(站点 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 正式部署(宝塔)

部署说明要点:

  1. DNS:zhenjiu.csh.space 的 A 记录指向 43.154.109.213。
  2. 再部署网页:本目录 python deploy_zhenjiu_web.py。
  3. 打开 https://zhenjiu.csh.space 强刷验证。
  4. 远程目录:/www/wwwroot/zhenjiu.csh.space。
  5. 若 SSL 未签发,确认 DNS 生效后重新运行网页部署脚本。
静态站架构与同站群其它网页版一致:网页服务器无需 Python,计算在后端 API 完成。

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

  1. 首次若提示填 API Key:在设置中填入有效 Key(演示 Key 已内置,存浏览器 localStorage 键 zhenjiu_web_api_key)。
  2. 在开穴计算页选择日期/时辰,按需设置城市与“真太阳时”开关(默认开启,与桌面版城市时差表一致),点计算查看开穴结果。
  3. 切换到细法取穴,选择 kind(养子时刻 yangying / 移光定位 yiguang / 十二原穴 shier_yuan / 天时记忆 tianshi / 全部 all)查看细分结果。
  4. 需要空间阵、全天开穴表时,分别在对应页签生成。
  5. 通过穴位搜索/详情、经络、处方查询穴位与配伍;到理论目录、候气指南、病例页阅读资料。
  6. 需要最新数据时点“刷新数据”(POST /refresh)。

四、核心功能详解

4.1 接口清单(README + api.js)

统一前缀 /api/v1/tools/zhenjiu:

功能方法路径
探活 / 元信息GET/health、/meta
开穴计算POST/calculate
真太阳时/calculate、/extra/calculate 入参city、use_solar_time(默认 true,与桌面城市时差表一致)
细法 kindPOST/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,无专项更新日志。以下依据文档、接口代码与目录结构整理,推断处标注。
  1. 网页版上线,覆盖桌面版子午流注能力
  • 依据:README 接口表列出开穴计算、真太阳时、细法、空间阵、全天表、穴位/经络/处方、理论/病例等完整能力。
  • 对用户操作的影响:无需安装桌面软件,浏览器打开 zhenjiu.csh.space 即可做开穴与知识查询。(依据文档)
  1. 一键部署脚本 deploy_zhenjiu_web.py 与 SSL 自动化
  • 依据:脚本中 DOMAIN = "zhenjiu.csh.space"、REMOTE_ROOT = "/www/wwwroot/zhenjiu.csh.space",并用 acme.sh 自动签发证书、成功后恢复 HTTPS 强制跳转。
  1. 细法与内容体系接口化
  • 依据:api.js 中 extraCalculate(四种细法 kind)、dayTable、spaceArray、prescription、houqi、articles、cases 等。
  1. 项目整体更新(依据索引时间戳推断)
  • 依据:索引 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 与宝塔部署体系;本项目另有“时空针灸”桌面版项目。
← 返回子午流注文章列表

同栏目其它文章