# working 索引

本目录记录 `xyzbc-trt` Web 数控系统仿真推进资料，用于按任务矩阵继续开发和验收。

文件：

- `01-项目功能内容.md`：目标功能、LinuxCNC 对标点、WASM/OPFS 满足度。
- `02-项目程序开发详细步骤.md`：从源码对标到 Web 实现、构建、验证的步骤。
- `03-推进台账.md`：每轮做了什么、改了哪些文件、验证了什么、下一步。
- `04-任务矩阵.md`：任务编号、状态、验收标准，防止重复做。
- `05-验收证据.md`：命令、输出、页面、证据路径和当前阻塞。
- `06-决策记录.md`：关键决策及理由。
- `07-全量对标追踪矩阵.md`：逐项映射 `xyzbc-trt-runtime-files.md` 的真实 LinuxCNC 功能到 Web 对标目标、JSON 证据和缺口。
- `08-xyzbc-trt-界面与图标分析.md`：面向 Web 界面开发的页面区域、PyVCP/SWITCHKINS、Vismach、业务页面和 gmoccapy 图标资产清单。
- `09-设计任务书与技术方案整合.md`：从 DOCX 设计任务书整合出的 Markdown 版本，保留任务书、技术方案、程序逻辑分析、状态联锁和图片引用。
- `11-LinuxCNC源码与真实执行严格对标任务.md`：以 `/home/mes123456/cnc_wams/linuxcnc` 为唯一 native 权威源，整理源码、配置、HAL、Vismach、AXIS、PyVCP、解释器、task/HAL、真实运行采样和 Web 复现的新增严格对标任务。
- `12-20260704-真实执行复验与缺失功能工作计划.md`：记录 2026-07-04 18:12 EDT 重新真实执行 native/Web/compare 后的缺失功能分析和后续工作计划。
- `18-20260707-AXIS主控制按钮调用链与Web完善指南.md`：在两份 `项目分析/AXIS...` 文档和 LinuxCNC 源码复核基础上，整理急停、上电、Home、Run、Pause/Resume、Step 的 task/motion 调用链、状态机制、Web/WASM 完善清单和验收矩阵。
- `19-20260707-AXIS按钮LinuxCNC-task-motion状态机制源码分析.md`：从 LinuxCNC C++ task/motion/homing 源码角度整理 AXIS 按钮真实调用链、状态记录和 Web 对标字段。
- `20-20260707-AXIS按钮LinuxCNC真实C++对标实施步骤.md`：由 19 号源码分析拆分出的详细实施步骤，要求以 LinuxCNC C++ 真实状态机为准，不以 `compare 60/60 pass` 作为完成依据。
- `21-20260707-AXIS按钮LinuxCNC真实C++对标验收测试.md`：由 19 号源码分析拆分出的验收测试文档，定义功能级硬检查、非法命令矩阵、真实程序执行验收和 `functionalSummary` 通过标准。

当前新增关注点：

- 2026-07-08 17:26 EDT 已按用户要求全面执行目标项目功能测试，并新增 `npm run smoke:buttons` 全按钮浏览器测试入口：覆盖 `AXIS_BUTTON_PARITY` 的 63 个按钮/动作条目，逐项检查 DOM 控件、LinuxCNC 来源元数据和点击后的状态效果；本轮同时修复 M428/M429/M430 MDI 后 task/HAL 状态回写覆盖 `kinsType` 的问题，并修正旧默认机型/旧项目根测试口径。完整 Node 测试集、WASM status contract、Task/HAL SDK、build、browser smoke、全按钮 smoke、Web evidence 和 compare 均通过；最新 `compare.status=pass`、`surfaceSummary=60/60 pass`、`functionalSummary=8/8 pass`、`requiredImprovements=[]`。
- 2026-07-08 10:42 EDT 已按用户要求在目标 Web 项目中删除顶层旧字段：`taskHalStatus` 正常形态不再输出或消费 `task`/`motionStatus`，store、policy、feedback、evidence 采集统一读取 `emcStatus` 和 `ui`；旧字段只保留在拒绝输入的负向测试和错误提示中。Node smoke、WASM status JSON contract、Task/HAL SDK、build、browser smoke、Web evidence 和 compare 均通过；最新 `compare.status=pass`、`surfaceSummary=60/60 pass`、`functionalSummary=8/8 pass`、`requiredImprovements=[]`。
- 2026-07-08 10:01 EDT 已按用户要求移除旧字段兼容：`normalizeTaskHalStatus()` 现在缺少 `StandaloneEmcStatus`/`emcStatus.task`/`emcStatus.motion` 时直接失败，不再从旧 `status.task` 或 `status.motionStatus` 回退；旧格式拒绝检查、Node smoke、browser smoke、WASM status JSON contract、Task/HAL SDK、Web evidence 和 compare 均通过。
- 2026-07-08 09:50 EDT 已完成新版 `wasm-port` task/HAL WASM 状态合同适配：Web runtime 以 `StandaloneEmcStatus`/`emcStatus` 为唯一输入合同，拒绝旧 `task`/`motionStatus` 输入字段；目标 Node smoke、WASM status JSON contract、SDK smoke、Web evidence 和 compare 均通过；最新 `compare.status=pass`、`surfaceSummary=60/60 pass`、`functionalSummary=8/8 pass`、`requiredImprovements=[]`。
- 2026-07-07 19:03 EDT 已按“完成 working 中全部工作”重新执行当前收口复验：native LinuxCNC evidence、Web evidence、compare、Node smoke、build、Task/HAL 状态矩阵、Task/HAL WASM/SDK smoke、browser smoke 均通过；最新 `compare.status=pass`、`surfaceSummary=60/60 pass`、`functionalSummary=8/8 pass`、`requiredImprovements=[]`。
- 2026-07-07 18:57 EDT 已完成 20/21 号文档要求的功能级 compare 增强：`compare-xyzbc-trt-evidence.json` 现在同时输出 `surfaceSummary` 和 `functionalSummary`；最新结果为 `surfaceSummary=60/60 pass`、`functionalSummary=8/8 pass`、`requiredImprovements=[]`，硬规则覆盖 `cppTaskStateMachineParity`、`cppModeGateParity`、`cppHomingParity`、`cppRunGateParity`、`cppPauseResumeParity`、`cppStepParity`、`illegalCommandParity`、`realProgramExecutionParity`。
- 2026-07-07 18:35 EDT 已将 19 号源码分析拆分为 20 号实施步骤和 21 号验收测试。后续结论必须区分 `surfaceSummary` 和 `functionalSummary`；`compare 60/60 pass` 只代表表面规则通过，真实通过必须证明 Web 行为符合 LinuxCNC C++ `emctaskmain.cc`、`emctask.cc`、`taskintf.cc`、`motion/command.c`、`control.c`、`homing.c` 的状态机和真实程序执行结果。
- 2026-07-07 18:18 EDT 已完成 AXIS 主控制按钮状态链路收敛：`ESTOP/RESET/Power/Home/Run/Pause/Resume/Step` 统一以 LinuxCNC `task.state + task.mode + interpState + motion/home status` 为事实来源；Web policy、store、Task/HAL WASM、evidence 采集和 smoke/compare 已同步，最新 compare 为 `60/60 pass`、`blockers=[]`、`requiredImprovements=[]`。
- 2026-07-06 00:22 EDT 新任务：完全对标 `/home/mes123456/cnc_wams/linuxcnc` 中 `xyzbc-trt` 的 AXIS/task 状态联锁，重整 Web 仿真系统 `解除 ESTOP`、`上电`、`Home All`、`Run`、`暂停/继续` 功能逻辑；要求修复当前混乱状态流，并通过源码对照、自动化 smoke、browser 验证和 evidence/compare 严格复验。
- 2026-07-05 18:57 EDT 已按 LinuxCNC AXIS 源码修复 Pause：工具栏按钮恢复为 `.toolbar.program_pause -> task_pauseresume` 语义，运行中点击暂停、暂停中点击继续；菜单 Pause/Resume 仍为独立命令。Node smoke、browser smoke、build、native/Web/compare 均通过，最新 compare 为 `60/60 pass`。
- 2026-07-05 18:18 EDT 已按 `working/12-20260704-真实执行复验与缺失功能工作计划.md` 的 P-002 规则再次执行全量复验：native LinuxCNC、Web evidence、compare、build、Node smoke、browser smoke 均通过；最新 `compare-xyzbc-trt-evidence.json` 为 `60/60 pass`、`blockers=[]`、`requiredImprovements=[]`。
- 2026-07-05 18:08 EDT 已按用户要求重新执行“除硬件相关外完全对标”复验：native LinuxCNC、Web evidence、compare、build、Node smoke、browser smoke 均通过；最新 `compare-xyzbc-trt-evidence.json` 为 `60/60 pass`、`blockers=[]`、`requiredImprovements=[]`。
- 当前 native 权威源为 `/home/mes123456/cnc_wams/linuxcnc/configs/sim/axis/vismach/5axis/table-rotary-tilting/xyzbc-trt.ini` 及其直接引用的 LinuxCNC 源码、配置、HAL、PyVCP、Vismach、remap、NGC、tool table、parameter file、rtlib 和启动入口；用户所述“linuxcnc源程序”的本工作区实际路径为 `/home/mes123456/cnc_wams/linuxcnc`。
- “硬件相关除外”的边界仅排除真实伺服驱动、电气 I/O、现场总线、实体主轴/冷却/刀库等物理设备接入；Web 仿真仍必须对标 LinuxCNC `xyzbc-trt` 的软件运行语义、状态联锁、HAL/task 反馈、AXIS/PyVCP/Vismach 等效界面、刀路和 JSON 证据。
- 2026-07-04 18:22 EDT 已按 P-002 重新执行 native LinuxCNC、Web evidence、compare、Node smoke 和 browser smoke；最新结果仍为 `60/60 pass`、`blockers=[]`、`requiredImprovements=[]`。
- 2026-07-04 18:12 EDT 已重新执行 native LinuxCNC、Web evidence、Node smoke、browser smoke 和 compare；最新结果仍为 `60/60 pass`、`blockers=[]`，按当前硬检查未发现新增缺失功能，详见 `12-20260704-真实执行复验与缺失功能工作计划.md`。
- 2026-07-04 已完成 T-051 到 T-075：对标基线已从“整理过的 runtime-files 文档与已生成 evidence”提升为“直接从 `/home/mes123456/cnc_wams/linuxcnc` 源树和 LinuxCNC `xyzbc-trt` 真实执行采集事实生成证据”；最新 `compare-xyzbc-trt-evidence.json` 为 `60/60 pass`、`blockers=[]`，详见 `11-LinuxCNC源码与真实执行严格对标任务.md`。
- 针对 `working/screenshots/web-simulation-full-process-20260703T051258Z` 的截图问题，已新增 T-047 到 T-050：页面截图真实 G 代码执行过程、实时刀具执行路径/刀位、刀头与刀杆方向一致、逐行执行过程 UI。
- 页面新增 `programUiExecution` 作为截图层实时执行对象；程序区和 LinuxCNC 监控面板会显示展开后的 `sourceFile:line`、operation、sample、step 和当前语句。
- Three.js 刀头 marker、刀轴线和 Vismach 刀杆方向统一使用当前样本 `toolAxis.i/j/k` 派生的 `state.toolAxisVector`，browser smoke 已断言 canvas dataset 与 state 一致。
- DOCX 任务书已整合到 `working/09-设计任务书与技术方案整合.md`，后续开发和验收优先以 `working` 下 Markdown 文件为可检索工作入口。
- `working` 文档必须完全对标 `doc/xyzbc-trt-runtime-files.md`，不仅覆盖文件 staging，也覆盖 AXIS、PyVCP、POSTGUI HAL、basic_sim、Vismach、switchkins、Ngcgui、tool-offset、kinematics pins 和加载顺序。
- native/Web evidence JSON 后续必须包含刀具预览路径 `previewPath` 和刀具执行路径 `executionPath`。
- 路径曲线对比暂定统一使用 `samplePeriodMs = 50`，通过相同 `sampleIndex/timeMs` 对齐。
- compare JSON 后续必须输出 `pathComparison`，覆盖预览对预览、执行对执行、预览对执行的一致性误差统计。