# 装配模型与信号曲线讲解

这两张交互图使用本次提供的 `HALLPOS/model/HALLPOS.step` 和 `ENCODER.step`，包含 PCB、元件和测试机构。左侧按实际装配看结构，右侧保留磁铁示意、三条完整曲线和联动游标。

## 打开与操作

- [直线浅色版](linear/index-light.html) · [直线深色版](linear/index.html)
- [旋转浅色版](rotary/index-light.html) · [旋转深色版](rotary/index.html)
- [直线 20 秒视频](09-linear-anatomy.mp4) · [SRT](09-linear-anatomy.srt)
- [旋转 20 秒视频](10-rotary-anatomy.mp4) · [SRT](10-rotary-anatomy.srt)

建议通过 [本地服务](../../../deploy/README.md) 打开完整网站，首次进入交互页时等待模型加载完成。页面也可独立打开，使用新版 Edge 或 Chrome；模型、代码和 Logo 已包含在 HTML 内，不依赖外部字体或模型网站。

拖动模型改变观察方向，Shift 加方向键调整视角；普通方向键调整运动位置或角度。滑条和曲线上的点击也能改变设定值，空格播放或暂停。“分开看”是观察用的移开效果，“原始位置”恢复源文件位置。选择 PCB、结构或载体按钮可以对照部件。减少动态效果时保持手动操作，离开视口时暂停更新。

## 模型与信号的依据

- 完整装配原文件保存在 [mechanical/models/rendering](../../../mechanical/models/rendering/README.md)，原来的两份可打印夹具文件也保留。装配展示模型不能直接作为一个零件整体打印。
- 直线模型导出 93 个源实体，旋转模型导出 96 个，保留原毫米坐标、装配变换和表面颜色。实体数包含电子封装内部的小零件，不是采购 BOM 数量。来源和检查记录见 [cad/manifest.json](cad/manifest.json)。
- 直线 PCB 和导向固定，只有滑动载体沿 +Y 移动。几何零参考取槽中心在 U2 封装中心方向上的投影，源文件姿态对应约 −12.11 mm；动画范围约 −12.11 到 +15 mm。曲线仍展开 ±15 mm。两者都不表示已经验证的测量量程。
- 旋转版的支架、PCB 和电子元件固定，只转动源模型中的轴载体。展示起点不提供磁极方向，也不是已经校准的机械零位。
- 项目磁铁规格为直线 Φ10 × 3 mm 轴向充磁、旋转 Φ6 × 3 mm 径向充磁；源装配没有独立磁铁实体。真实气隙、配合和磁场效果需要装配后检查。
- 理想响应、游标、响应点和读数共用 [model.mjs](model.mjs)，不读取串口，不输出实际 ADC，也不执行固件解算。公式与版本说明见 [MODEL.md](MODEL.md)。

## 修改与重新导出

在仓库根目录执行：

```sh
node media/animation/anatomy/model-check.mjs
node media/animation/anatomy/cad-check.mjs
node media/animation/anatomy/linear/build.mjs
node media/animation/anatomy/linear/build.mjs --light
node media/animation/anatomy/rotary/build.mjs
node media/animation/anatomy/rotary/build.mjs --light
```

修改装配 STEP 后，先使用 [导出脚本](cad/export_step.py) 重新生成网格和来源记录，再构建页面。网格是显示用的离散几何，不能代替原 STEP 作为制造文件。

视频录制需要 Python Playwright、已安装的 Edge 或 Chrome，以及 PATH 中的 FFmpeg/ffprobe：

```sh
python media/animation/anatomy/render_video.py
```

两段无声视频均为 1920 × 1080、24 fps、20 秒，按固定设定值逐帧录制。每段通过规格和完整解码检查后替换成品，SRT/VTT 单独提供。网页发布执行 `python scripts/build_site.py`，四份交互页发布到 `experiments/`，完整 Wiki 随网站一起部署。

## 来源和许可

页面沿用 [Anatomy](https://github.com/wheresryan22/anatomy) 的等距展示与交互方法；工具包保留在 [vendor/anatomy](vendor/anatomy/UPSTREAM.json)，使用 MIT License，Copyright (c) 2026 Ryan。[许可证全文](vendor/anatomy/LICENSE) 随源文件和生成页面保留。三维几何来自本项目 STEP。Logo、固件、图纸和 STEP 的权利范围按主仓库说明处理。