linuxcncWebWASM/docs/trt-parametric/01-项目功能内容.md

项目功能内容

目标与边界

在同一控制界面支持 XYZAC/XYZBC 参数化机床。INI 是机床几何输入的唯一来源；LinuxCNC WASM 是解释器、运动学、轨迹和状态的唯一计算权威。React 负责参数草稿、命令和状态显示，Three.js 负责几何投影。

配置文件位于 linuxcnc/configs/sim/axis/vismach/5axis/table-rotary-tilting/。

参数	XYZAC	XYZBC	单位
x-rot-point / y-rot-point / z-rot-point	支持	支持	mm
x-offset	原生算法不支持	支持	mm
y-offset	支持	原生算法不支持	mm
z-offset	支持	支持	mm

不支持的偏置在界面禁用；不得把无效参数呈现为可影响运动的参数。刀长仍由现有刀具链路管理，不混入这六项几何参数。

用户流程

1. 选择机床，读取对应 INI 的 [HAL] HALCMD 参数及源位置。
2. 结构预览旁按“旋转中心”和“轴间偏置”分组，显示 mm、已生效值及待应用状态。
3. 修改参数，验证有限数字、支持范围和文件一致性。
4. 在机床关闭、程序空闲时应用，重新初始化配置和解析当前 G 代码；应用后重新回零。
5. 保存/导出修改后的 INI；重新读取磁盘文件时使用最新参数。

浏览器虚拟工作区与宿主磁盘须明确区分：应用到 Worker 不等于已写回仓库文件；支持文件句柄的浏览器可保存已选文件，其他环境导出 INI。

验收行为

• 修改有效参数后，Worker 快照参数、结构旋转中心及非零旋转姿态的 WASM 关节解一致变化。
• G 代码文本和编程坐标不必变化；同一程序的机器关节轨迹应随有效参数变化。禁止人为平移 G 代码来伪造结果。
• 参数错误、程序运行/暂停、机床开启时不允许应用；失败不得显示成功或展示过期参数为已生效。
• 两种机床参数相互隔离；保留当前程序；重新加载产生新预览，清理旧运行轨迹。
• 桌面和移动布局无重叠，3D 非空、可交互，保存和重新读取可复现参数。