# Web RTCP 五轴联动数控系统仿真方案

生成时间：2026-06-20 CST

本目录是新的独立方案目录，用于规划一个基于 Web 的、带 RTCP 功能的五轴联动数控系统仿真界面。

项目目标不是开发真实机床控制器，也不是在浏览器中替代 LinuxCNC 实时内核；目标是做一个面向 Web 的数控系统仿真产品：浏览器中完成机床配置加载、G-code 执行仿真、五轴/RTCP 运动展示、DRO/状态面板、刀路预览、会话持久化和可验证的 LinuxCNC 源码参考链路。

界面设计也参考 LinuxCNC 使用 Python 编写的图形界面和机床仿真程序，包括 AXIS、vismach、PyVCP、QtVCP/QtDragon、gmoccapy 以及 5 轴 vismach 示例。Web 项目不直接运行这些 Python GUI，而是参考其操作布局、HAL 绑定、机床模型层级、DRO/MDI/预览结构和五轴可视化表达方式。

当前先交付这些文档：

- [实现方案](docs/implementation-plan.md)
- [技术路线](docs/technical-roadmap.md)
- [程序具体实施文档](docs/program-implementation-guide.md)
- [编写过程接续文档](docs/development-continuation.md)
- [实现追溯文档](docs/traceability-matrix.md)
- [LinuxCNC Python 图形界面参考](docs/linuxcnc-python-gui-reference.md)
- [LinuxCNC 原始界面参考图册](docs/linuxcnc-gui-reference-gallery.md)

核心原则：

```text
LinuxCNC 源码和配置案例作为 CNC 语义与五轴运动学参考源；
Web 侧负责 UI、文件会话、可视化、运行编排和仿真状态展示；
前端界面采用原生 HTML/CSS + TypeScript/JavaScript ES modules，不引入 React/Vue 等 UI 框架；
RTCP/五轴运动学必须通过 LinuxCNC source-derived 的 C/WASM 边界或等价验证链路落地；
不得用浏览器脚本随意重写 G-code、刀补、参数、重映射、规划器或运动学语义。
```