一个面向课堂演示的静态网页实验库，可直接发布到 GitHub Pages。
当前发布流程采用“仓库先保存、网页后公开”：main 保存已确认的稳定版本，较大修改先在独立分支预览，验收后再合并并更新 GitHub Pages。正式网址保持不变，必要时可以回退到之前的提交。
physics-lab/
├─ index.html # 实验库首页
├─ assets/ # 全站共用主题、图标与资源
└─ experiments/
└─ eclipse/ # 每个实验一个独立目录
├─ index.html
├─ style.css
└─ app.js
后续实验继续放在 experiments/实验英文短名/ 中，并在首页新增实验卡片。视觉变量沿用 assets/lab-theme.css：深空背景、低饱和青蓝色、细边框、克制的发光效果。
发布版本已将 Three.js 打包到本地脚本中，可以直接双击 index.html，再进入日月食实验；不需要等待 CDN，也不会受到本地 ES Modules 跨域限制。
开发时修改 experiments/eclipse/app.js 后，需要重新生成浏览器使用的 app.bundle.js：
cd physics-lab
npm install
npm run build不要直接编辑 app.bundle.js，它是自动生成的发布文件。
- 将
physics-lab文件夹内容放在仓库根目录。 - 推送到 GitHub。
- 在仓库
Settings → Pages中选择Deploy from a branch。 - 选择发布分支与根目录
/ (root)，保存后等待生成网址。
- 天体运行方向、月球约 5.1° 轨道倾角和日月食遮挡关系按物理关系表达。
- 所有影锥都沿太阳光传播方向、背向太阳延伸；不会为了画面对齐而弯向目标天体。
- 日全食表现为月球本影到达地球；日偏食表现为本影偏离地球、半影扫过地球；日环食表现为本影尖端未到地球、伪本影继续到达地球。
- 月食时地球位于日月之间；月全食进入地球本影后，月面用穿过地球大气层的红橙光表现。
- 为了让三颗天体同时清晰出现在屏幕上，空间模式的天体大小和距离采用教学可视化比例，不是统一真实比例。
- 地面模式重点表达太阳与月球视圆面的相对运动、食甚与复圆的连续过程。
- Three.js 已打包进发布脚本，不依赖第三方 CDN；直接打开和 GitHub Pages 使用同一份三维代码。
- 地球、云层和月球使用 NASA 真实影像；桌面端自动选择 4K，较弱设备自动降至 2K，也可以在实验面板手动切换。
experiments/galaxy/ 提供银河系、银河中心人马座 A*、重点恒星系统、太阳系八大行星和地月系的分层探索。银河系远景采用科学重建而非外部照片；太阳系使用近似 J2000 轨道参数和开普勒求解器推进到当前日期。行星贴图、观测数据与程序化可视化的区别记录在 experiments/galaxy/SOURCES.md。
银河系实验的纹理作为独立文件按页面需要加载，不会内嵌进 app.bundle.js。修改 experiments/galaxy/app.js 或 data.js 后运行：
npm run build:galaxy物理关系参考：NASA 日月食几何、NASA 日月食与月球、NASA 月球轨道参数。
纹理来源、处理方法和署名见 assets/textures/SOURCES.md。
experiments/circuit-bench/ 是面向初中电学的自由搭建实验台（EXP.003）：拟真实物元件 + 拖线/点按接线，一键把实物图转换成横平竖直的标准电路图；附带电流与电子流向演示、电势标尺（两点电势差测量）、水路类比视图、数据记录与 I-U 描点图。内置 8 个正确示范与 7 个错误排查演示电路（短路、断路、电表接反、串错电压表等）。
物理模型为初中理想模型（电表无内阻、电源无内阻、参数全可调），直流稳态用改进节点分析（MNA）求解，非线性灯泡采用经验 R(U) 模型。理想化清单、元件数据与教学依据见 experiments/circuit-bench/SOURCES.md。
修改 experiments/circuit-bench/app.js、data.js 或 src/ 后运行：
npm run build:circuit-bench物理引擎可脱离浏览器独立测试（欧姆定律、串并联、短路、熔断、二极管、非线性灯泡、预设实例化等 18 个用例）：
npm run test:circuit-bench