在线体验：https://guizhengliu.github.io/yuanjing/ 源码：https://github.com/guizhengliu/yuanjing
一个将四柱、十神和传统神煞呈现为「内景宇宙」的互动网页。中央为固定二维盘坐灵体；透干、藏干各沿一条三维轨道环绕，神煞分布在两条不共面的轨道。
- 公历生日、当地时间、UTC 偏移及可选传统排盘性别输入。
- 四柱、十神、八字表层五行计数。
- 51 种常用神煞规则，重复项按柱位分别显示，可查看完整清单。
- 星环自动运动，支持拖拽、滚轮与双指缩放，点击星符查看来源。
- 出生时刻的太阳系近似星图，支持播放与命盘 JSON 导出。
- 「解读元境」：先确认娱乐声明，再查看整体画像与五个主题的具体解读。正文说明核心特点、具体表现、优势、压力下的盲点、适合的方式和调整建议。组合规则须满足所有命局条件，每段可查看实际柱位与来源，支持完整导出。
这是纯静态网站，没有后端，也无需安装依赖。安装 Node.js 后，在此目录运行：
npm run dev打开终端显示的 http://localhost:4173。完整文件下载后可断网运行本地服务。请通过 HTTP 服务打开，不要直接双击 HTML；三维模块使用 ES modules。
npm run check此检查验证脚本语法、本地资源、解读规则结构、重复命中、组合条件、来源类型、规则优先级与叙事选择，并使用实际排盘条目验证整合；不替代浏览器视觉与手势实测。
编辑 dist/interpretation-rules.json 即可调整主题、个人叙事、命局组合条件与来源权重。具体示例见 解读规则说明.md。提交到 main 后由 Pages 自动发布。解读是浏览器内的确定性计算，不需要大模型、API Key 或后端。组合和基础匹配只用于生成娱乐叙事，不是能力、人格、命运的测量，未经科学验证。
输入的生辰信息只在浏览器内存中计算；应用没有将生辰上传的接口，也没有应用级追踪代码。选择导出后，JSON 保存到用户本机。访问在线站点本身会访问托管平台。
- 四柱采用 lunar-javascript 的节气与默认子时换日口径，不校正真太阳时。
- 神煞为 chxb/shensha 的 51 种常用规则，并非问真官方算法，尚未与问真逐项对齐。未指定传统排盘性别时不计算元辰。天赦与德秀在适配层只记录一次，避免按整盘条件重复挂载四柱。
- 行星使用 NASA/JPL 1800–2050 年开普勒近似轨道要素；地球以地月质心代替。显示距离压缩、大小不按比例。
- 神煞为传统文化的艺术表达；星环动画不改变命盘或出生时刻。
- 不支持 WebGL 的设备保留二维星图。三维效果、自动运动和手机手势需在实际浏览器检查。
dist/：可独立部署的全部网页与资源。
tools/：本地预览与发布前检查。
.github/workflows/pages.yml：GitHub Pages 自动部署。
见 THIRD_PARTY_NOTICES.md。所附 MIT 许可只适用于对应的第三方库，不自动为项目自编代码与图片授予开源许可。