一个面向课堂演示的静态网页实验库，可直接发布到 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，它是自动生成的发布文件。
需要通过 HTTP 检查完整实验库时，在仓库根目录运行：
npm run preview然后打开 http://localhost:8766/。这个预览服务禁用缓存，适合检查刚修改的 CSS 和浏览器脚本。
- 实验库首页支持手机竖屏：实验卡片使用紧凑列表，整张卡片均可点击。
- 需要精细拖动、接线或三维操作的实验在手机上采用横屏工作区；竖屏时给出明确旋转提示，不把完整实验强行压缩进狭窄画面。
- 高频操作固定在拇指容易触及的位置，次要操作收进“更多”；按钮和接线柱应提供至少约 44–48 px 的触控命中区。
- 面板在手机横屏中作为互斥抽屉使用，避免资料与元件箱同时遮住实验台。
- 新实验应同时检查
390×844竖屏入口、844×390横屏操作和桌面端回归；不能只靠桌面浏览器缩窄窗口判断手机体验。
- 将
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）：学生从窄图标栏快速选择元件，在台面点按放置，并通过拖线或依次点击两个接线柱完成接线。再次点选元件才显示参数与红色删除按钮；导线也支持点选删除。实物图可一键转换为按连接拓扑重新排版的教材式电路图，导线横平竖直、元件间距统一。
界面坚持“先探索、后提示”：不提供预设演示电路和复杂资料卡片；短路路径用红色高亮、未接的必要接线柱用黄色高亮，电表超量程或用电器过功率用橙色提示。手机端采用窄元件栏与横屏工作台，并保持约 48 px 的接线柱/导线触控区。
物理模型为初中理想模型（电表无内阻、电源无内阻、参数全可调），直流稳态用改进节点分析（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启动本地预览后，还可以运行桌面与手机浏览器冒烟测试：
npm run test:circuit-bench:browser
npm run test:circuit-bench:mobile