Files
linuxcncWebWASM/web/react/vite.config.ts
wangdequan db29ae625f 按关节槽位驱动 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>
2026-10-30 06:09:12 +08:00

67 lines
4.1 KiB
TypeScript

import { cpSync, createReadStream, existsSync, statSync } from "node:fs";
import { extname, relative, resolve } from "node:path";
import { fileURLToPath } from "node:url";
import { defineConfig, type Plugin } from "vite";
import react from "@vitejs/plugin-react";
import tailwindcss from "@tailwindcss/vite";
const repoRoot = fileURLToPath(new URL("../../", import.meta.url));
const sourceRoot = resolve(repoRoot, "linuxcnc");
const contentTypes: Record<string, string> = {
".json": "application/json; charset=utf-8", ".ini": "text/plain; charset=utf-8", ".hal": "text/plain; charset=utf-8", ".inc": "text/plain; charset=utf-8", ".tbl": "text/plain; charset=utf-8", ".var": "text/plain; charset=utf-8", ".tcl": "text/plain; charset=utf-8", ".ngc": "text/plain; charset=utf-8", ".js": "text/javascript; charset=utf-8", ".mjs": "text/javascript; charset=utf-8", ".gif": "image/gif", ".png": "image/png", ".svg": "image/svg+xml",
};
function linuxcncAssets(): Plugin {
return {
name: "linuxcnc-exact-path-assets",
configureServer(server) {
server.middlewares.use((request, response, next) => {
const requestPath = request.url?.split("?", 1)[0] ?? "";
const mounts: Record<string, string> = { "/linuxcnc/": "linuxcnc", "/worker/": "web/worker", "/workspace/": "web/workspace", "/build-wasm/": "build-wasm" };
const mount = Object.keys(mounts).find((prefix) => requestPath.startsWith(prefix));
if (!mount) { next(); return; }
const mountRoot = resolve(repoRoot, mounts[mount]);
const relativePath = decodeURIComponent(requestPath.slice(mount.length));
const target = resolve(mountRoot, relativePath);
const safe = relative(mountRoot, target);
if (safe.startsWith("..") || safe.includes("\\") || !existsSync(target) || !statSync(target).isFile()) { response.statusCode = 404; response.end(); return; }
response.statusCode = 200;
response.setHeader("Content-Type", contentTypes[extname(target).toLowerCase()] ?? "application/octet-stream");
createReadStream(target).pipe(response);
});
},
writeBundle(options) {
const output = options.dir ? resolve(options.dir) : resolve(repoRoot, "web/react/dist");
const copies = [
["linuxcnc/configs/sim/axis", "linuxcnc/configs/sim/axis"],
// Every case entrypoint in machine-catalog.json must exist in the build.
// These three live outside configs/sim/axis and used to 404 in the
// deployed bundle, leaving the controller stuck in PENDING.
["linuxcnc/configs/sim/woodpecker", "linuxcnc/configs/sim/woodpecker"],
["linuxcnc/configs/sim/gmoccapy", "linuxcnc/configs/sim/gmoccapy"],
["linuxcnc/configs/sim/qtdragon", "linuxcnc/configs/sim/qtdragon"],
["linuxcnc/configs/sim/gmoccapy/non_trivial_kinematics/table-rotary-tilting/examples", "linuxcnc/configs/sim/gmoccapy/non_trivial_kinematics/table-rotary-tilting/examples"],
["linuxcnc/configs/nc_files", "linuxcnc/configs/nc_files"],
["linuxcnc/nc_files", "linuxcnc/nc_files"],
["linuxcnc/linuxcnc.gif", "linuxcnc/linuxcnc.gif"],
["linuxcnc/share/axis/images", "linuxcnc/share/axis/images"],
["linuxcnc/lib/hallib", "linuxcnc/lib/hallib"],
["linuxcnc/src/hal/user_comps/vismach/xyzac-trt-gui.py", "linuxcnc/src/hal/user_comps/vismach/xyzac-trt-gui.py"],
["linuxcnc/src/hal/user_comps/vismach/xyzbc-trt-gui.py", "linuxcnc/src/hal/user_comps/vismach/xyzbc-trt-gui.py"],
["linuxcnc/configs/sim/qtvcp_screens/qtaxis_lathe/qtaxis/images", "linuxcnc/configs/sim/qtvcp_screens/qtaxis_lathe/qtaxis/images"],
["docs/user-manual/LinuxCNC-Web-使用说明书.html", "manual/index.html"],
];
for (const [from, to] of copies) cpSync(resolve(repoRoot, from), resolve(output, to), { recursive: true, dereference: false });
},
};
}
// 生产构建会把使用说明书一起复制到 dist/manual/index.html。
export default defineConfig({
plugins: [linuxcncAssets(), tailwindcss(), react()],
base: "./",
worker: { format: "iife" },
server: { fs: { allow: ["../.."] } },
build: { outDir: "dist", emptyOutDir: true },
});