按关节槽位驱动 13 个五轴案例的三维模型

关节契约扩为槽位制：以 LinuxCNC 联合号标识关节，轴字母降为槽位属性，
重复轴（bridge-mill 的两个 Y）、并联杆长（hexapod/pentapod）和被动槽位
（max5 第 6 关节）都能表达。v1 规则保持不变并合成 jointOrder，已保存
GLB 与既有测试不受影响。

13 个结构 GLB 由 scripts/generate_physical_case_glbs.mjs 统一重建，
可动关节均为按槽位命名的 Group 并写 userData.linuxcncJoint，共 71 个
关节，槽位数与运行目录的 joint_count 逐条一致。

新增 machine-visual-bindings.json 与纯函数模块，以 machine id 为键：
坐标字母不能作键，因为三个案例共用 XYZAB、三个共用 XYZABC。主界面切换
案例时自动装载对应模型，失败时保留内置模型并显式提示。

消除前端五关节截断：visual 适配器的 joints 改为数组并新增
jointsAuthoritative；allHomed 按 joint_count 判断；面板按 worker 断言的
machine id 查找机型。

管理器解锁：坐标与案例下拉以"存在完整视觉绑定"为启用条件，13 案例全部
可选；machine-urdf.ts 新增 generic-wasm/1 profile，AC/BC 严格校验路径
不变；新增 machine-kinematics-specs.json 保存逐关节限位，INI 未声明的
限位保持 null 而不编造。

修复三个真实缺陷：构建漏发 woodpecker/gmoccapy/qtdragon 配置目录（
DEFECT-02 根因）；案例切换沿用"装载需要已上电"的门控，导致关机状态下
第二次切换被静默拒绝；重复轴机型上 React 列表键冲突。

验收：13 案例逐个切换装载成功、槽位键与绑定定义逐一一致、浏览器错误 0；
typecheck 与生产构建通过；视觉绑定、GLB 命名、关节契约、投影、store、
双画布、运动学规格漂移、11 案例 Worker 闭环、管理器浏览器回归全部通过。
证据在 coverage/glb-machine-manager/physical-drive/。

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

docs/user-manual/build_manual.mjs

@@ -0,0 +1,35 @@
+// 把 manual-content.html 中的截图内联为 data URL，输出可离线单文件阅读的使用说明书。
+//
+// 运行：node docs/user-manual/build_manual.mjs
+// 输出：docs/user-manual/LinuxCNC-Web-使用说明书.html
+
+import { readFile, stat, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const contentPath = resolve(here, "manual-content.html");
+const outputPath = resolve(here, "LinuxCNC-Web-使用说明书.html");
+
+const source = await readFile(contentPath, "utf8");
+const references = [...source.matchAll(/src="(screenshots\/[^"]+\.png)"/g)].map((match) => match[1]);
+const unique = [...new Set(references)];
+
+let html = source;
+let totalBytes = 0;
+for (const reference of unique) {
+  const file = resolve(here, reference);
+  const info = await stat(file).catch(() => null);
+  if (!info) throw new Error(`缺少截图：${reference}`);
+  const base64 = (await readFile(file)).toString("base64");
+  totalBytes += info.size;
+  html = html.replaceAll(`src="${reference}"`, `src="data:image/png;base64,${base64}"`);
+}
+
+const remaining = [...html.matchAll(/src="(screenshots\/[^"]+)"/g)];
+if (remaining.length) throw new Error(`仍有未内联的图片：${remaining.map((match) => match[1]).join(", ")}`);
+
+await writeFile(outputPath, html);
+const outputSize = (await stat(outputPath)).size;
+console.log(`内联 ${unique.length} 张截图（原始 ${(totalBytes / 1024 / 1024).toFixed(2)} MiB）`);
+console.log(`已生成 ${outputPath}（${(outputSize / 1024 / 1024).toFixed(2)} MiB）`);