# 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-27 已将 11 个非 TRT 案例接入通用 WASM 运动学路径：配置目录、轴/关节数量、参数、限位、WASM planner 和逐采样 `sim_kinematics_inverse` 均由案例机型驱动；13 个案例程序均可进入 Web 控制器，原生 AC/BC TRT 和 11 个通用案例分别使用对应运行链。Worker 回归脚本为 `web/worker/test_generic_machine_cases.mjs`。仍需逐机型浏览器三维模型与原生 HAL/回零语义验收，MGR-24/25 继续覆盖案例模板和大型资产体验。既有证据位于 `coverage/glb-machine-manager/`。

文档：

- [00-三维机床管理详细功能文档](00-三维机床管理详细功能文档.md)
- [00-三维机床管理详细功能文档（HTML 图文版，含 13 项机型案例）](00-三维机床管理详细功能文档.html)
- [HTML 文档接续入口](../../nextTask-glb-machine-manager-doc.md)
- [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)

- [08-保存与重新打开机床](08-保存与重新打开机床.md)

13 个案例的实机参考、结构树、部件拆分和可建模设计方案见：[13 案例真实结构与建模方案](09-13案例真实结构与建模方案.md)，机器可读索引见 [`five-axis-physical-structures.json`](../../web/workspace/five-axis-physical-structures.json)。

13 个可导入的结构 GLB 位于 [`web/react/public/machine-cases/physical/`](../../web/react/public/machine-cases/physical/)，生成器为 [`scripts/generate_physical_case_glbs.mjs`](../../scripts/generate_physical_case_glbs.mjs)。它们包含结构节点和运动学元数据；带 `real-reference` 的文件用于实机结构类比，带 `design-reference` 的文件用于满足原理的设计机。浏览器导入截图和报告位于 [`coverage/glb-machine-manager/physical-cases/`](../../coverage/glb-machine-manager/physical-cases/)。

Blender 安装与建模操作见：[Blender 建模工作流](10-Blender建模工作流.md)，模板脚本为 [`scripts/blender_machine_template.py`](../../scripts/blender_machine_template.py)。