继续完成 web-rtcp-5axis-sim-plan

结论：完成 LinuxCNC kinematics WASM ABI 覆盖，并将 web-rtcp-5axis-sim-plan 的 RTCP frame/boundary adapter 接到 xyzac-trt kinematics SDK；Node、build、browser smoke 验证通过。

web-rtcp-5axis-sim-plan/docs/linuxcnc-gui-reference-gallery.md

@@ -0,0 +1,226 @@
+# LinuxCNC 原始界面参考图册
+
+生成时间：2026-06-20 CST
+
+## 1. 目的
+
+本图册收集 LinuxCNC 源码树自带的实际界面截图，用于选择 Web 五轴数控系统仿真界面的视觉和布局方向。
+
+图片来源：
+
+```text
+linuxcnc/docs/src/gui/images/
+```
+
+已复制到本项目：
+
+```text
+web-rtcp-5axis-sim-plan/assets/reference/linuxcnc-gui/
+```
+
+这些图片只作为界面参考，不代表 Web 项目会直接移植 LinuxCNC 原生 GUI runtime。
+
+## 2. 优先参考图
+
+### 2.1 QtVCP Vismach 5 Axis Gantry
+
+![QtVCP Vismach 5 Axis Gantry](../assets/reference/linuxcnc-gui/qtvismach_5axis_gantry.png)
+
+原始文件：
+
+```text
+linuxcnc/docs/src/gui/images/qtvismach_5axis_gantry.png
+```
+
+推荐用途：
+
+- 五轴机床模型参考优先级最高。
+- 可参考其 3D 机床视图、动态轴显示和仿真模型表达。
+- 适合作为 Web 版 Three.js 五轴机床主视口的方向。
+
+建议选择程度：高。
+
+### 2.2 gmoccapy 5 Axis
+
+![gmoccapy 5 Axis](../assets/reference/linuxcnc-gui/gmoccapy_5_axis.png)
+
+原始文件：
+
+```text
+linuxcnc/docs/src/gui/images/gmoccapy_5_axis.png
+```
+
+推荐用途：
+
+- 操作员界面参考。
+- 大按钮、DRO、运行控制、状态区、手动操作面板可以借鉴。
+- 适合触控屏或工业操作台风格。
+
+建议选择程度：高。
+
+### 2.3 AXIS
+
+![AXIS](../assets/reference/linuxcnc-gui/axis.png)
+
+原始文件：
+
+```text
+linuxcnc/docs/src/gui/images/axis.png
+```
+
+推荐用途：
+
+- 经典 LinuxCNC 操作布局参考。
+- 菜单、工具栏、G-code、预览、DRO、状态栏结构清晰。
+- 适合作为第一版 Web 五轴仿真工作台的主布局骨架。
+
+建议选择程度：高。
+
+### 2.4 AXIS + PyVCP
+
+![AXIS PyVCP](../assets/reference/linuxcnc-gui/axis-pyvcp.png)
+
+原始文件：
+
+```text
+linuxcnc/docs/src/gui/images/axis-pyvcp.png
+```
+
+推荐用途：
+
+- 右侧 PyVCP 面板参考。
+- `SWITCHKINS`、joint value、offset/rot-point、RTCP 状态面板可以采用类似侧栏。
+- 适合把五轴专用控件放在主预览旁边。
+
+建议选择程度：高。
+
+## 3. 现代操作屏参考
+
+### 3.1 QtDragon
+
+![QtDragon](../assets/reference/linuxcnc-gui/qtdragon.png)
+
+原始文件：
+
+```text
+linuxcnc/docs/src/gui/images/qtdragon.png
+```
+
+推荐用途：
+
+- 现代化大屏 CNC 操作界面参考。
+- 面板区、状态区、按钮区和探测/刀具相关布局可借鉴。
+- 如果目标是更接近工业触控屏，可参考此方向。
+
+建议选择程度：中高。
+
+### 3.2 QtDragon HD
+
+![QtDragon HD](../assets/reference/linuxcnc-gui/qtdragon_hd.png)
+
+原始文件：
+
+```text
+linuxcnc/docs/src/gui/images/qtdragon_hd.png
+```
+
+推荐用途：
+
+- 大屏布局参考。
+- 适合后续做宽屏 Web 版操作台。
+
+建议选择程度：中。
+
+## 4. Vismach 机床仿真参考
+
+### 4.1 Vismach
+
+![Vismach](../assets/reference/linuxcnc-gui/vismach.png)
+
+原始文件：
+
+```text
+linuxcnc/docs/src/gui/images/vismach.png
+```
+
+推荐用途：
+
+- Python `vismach.py` 原始机床仿真窗口参考。
+- 可参考机床模型、坐标轴、视角控制和独立仿真窗口表达。
+
+建议选择程度：中。
+
+### 4.2 QtVismach
+
+![QtVismach](../assets/reference/linuxcnc-gui/qtvismach.png)
+
+原始文件：
+
+```text
+linuxcnc/docs/src/gui/images/qtvismach.png
+```
+
+推荐用途：
+
+- QtVCP 嵌入式机床仿真面板参考。
+- 适合思考 Three.js 视口如何嵌入主操作界面。
+
+建议选择程度：中。
+
+## 5. 推荐界面方案
+
+用户已选择 `gmoccapy_5_axis.png` 作为目标界面风格。建议第一版 Web 五轴 RTCP 仿真界面以 gmoccapy 5 轴界面为主风格，再吸收 QtVismach 5 Axis Gantry 的机床模型表达和 PyVCP 的五轴状态控件。
+
+```text
+主风格：gmoccapy_5_axis.png
+3D 机床视口：QtVCP Vismach 5 Axis Gantry
+五轴专用状态：PyVCP SWITCHKINS / joint values
+经典布局参考：AXIS
+后续大屏扩展：QtDragon / QtDragon HD
+```
+
+具体布局建议：
+
+```text
+顶部：gmoccapy 风格标题栏 + machine/session/run state
+左侧：黑底 Three.js 五轴机床和刀路预览
+右上：大号绿色 DRO，显示 X/Y/Z/A/B/C、TCP、RTCP、DTG
+中右：G-code 当前行列表和运行进度
+右侧：竖向模式按钮栏，参考 gmoccapy 大按钮
+中下：tool info / G-code properties / RTCP diagnostics tabs
+下方：velocity、rapid/feed override、coolant、spindle 面板
+底部：open、reload、run、stop、pause、step、home、fullscreen
+```
+
+## 6. 图片清单
+
+```text
+assets/reference/linuxcnc-gui/qtvismach_5axis_gantry.png
+assets/reference/linuxcnc-gui/gmoccapy_5_axis.png
+assets/reference/linuxcnc-gui/axis.png
+assets/reference/linuxcnc-gui/axis-pyvcp.png
+assets/reference/linuxcnc-gui/qtdragon.png
+assets/reference/linuxcnc-gui/qtdragon_hd.png
+assets/reference/linuxcnc-gui/vismach.png
+assets/reference/linuxcnc-gui/qtvismach.png
+```
+
+## 7. 选择建议
+
+当前选择：
+
+```text
+gmoccapy 5 Axis + QtVismach 5 Axis Gantry + PyVCP SWITCHKINS
+```
+
+如果后续需要更经典 LinuxCNC 桌面风格，可退回：
+
+```text
+AXIS + PyVCP + QtVismach 5 Axis Gantry
+```
+
+如果后续需要更现代大屏触控风格，可扩展：
+
+```text
+gmoccapy + QtDragon HD
+```