# Web LinuxCNC 三维机床管理器

本目录是“三维机床管理器”专项的唯一接续入口。工作顺序固定为：

1. 阅读 [04-任务矩阵](04-任务矩阵.md)，选择首个未完成且依赖满足的任务。
2. 阅读 [03-推进台账](03-推进台账.md) 最新一轮和 [06-决策记录](06-决策记录.md)。
3. 按 [02-项目程序开发详细步骤](02-项目程序开发详细步骤.md) 实施。
4. 验收后把命令、报告、截图写入 [05-验收证据](05-验收证据.md)，同步任务状态和推进台账。

专项目标是在 Web LinuxCNC 机床预览区提供“三维机床管理”对话框，支持 GLB 部件导入、AC/BC 两条机械链装配、部件原点和姿态编辑、原点辅助显示、RTCP 几何参数及物理零点定义，并保证模型运动与 LinuxCNC WASM 的实际关节坐标一致。

现有整机 GLB + 内嵌 URDF 导入能力继续保留。新管理器生成与现有 `linuxcnc.machine/1` 相同的严格结构，再通过已有配置、Worker、WASM 和 Three.js 投影链运行。

当前状态：MGR-20 机型程序一致性 verified；MGR-19 对话框选择机型/整机保存已 verified；MGR-17、MGR-18 已 verified；MGR-01 至 MGR-16 已完成历史验收，MILL700 实测覆盖照明、Z-up、132 节点树、拖放、节点原点、关节局部坐标系、节点相对父级平移旋转、模型删除、轴绑定、XYZ/AC 层级运动和 WebGL 资源降级。最新台账 R14，证据 `GLB-MGR-E01/E02/E05/E07/E08/E09/E10/E12/E13/E14/E15/E16` 位于 `coverage/glb-machine-manager/`。

文档：

- [01-项目功能内容](01-项目功能内容.md)
- [02-项目程序开发详细步骤](02-项目程序开发详细步骤.md)
- [03-推进台账](03-推进台账.md)
- [04-任务矩阵](04-任务矩阵.md)
- [05-验收证据](05-验收证据.md)
- [06-决策记录](06-决策记录.md)

相关旧专项：[GLB / URDF 五轴机床子项目](../glb-machine/README.md)。旧专项已完成整机导入、AC/BC 识别、几何参数同步和实际关节驱动，本专项不重复这些底层能力。

- [07-单自由度JSON与实时驱动](07-单自由度JSON与实时驱动.md)
- [关节 JSON Schema](joint-model.schema.json)