diff --git a/javaTest/README.md b/javaTest/README.md index 83b2e18..1a3d7ef 100644 --- a/javaTest/README.md +++ b/javaTest/README.md @@ -92,17 +92,23 @@ mvn compile exec:java \ ## 运行真实历史负载全链路调度仿真 -240 条历史记录按 `create_date` 生成到达事件,默认按 `100x` 加速。调度中心重新选车和 +历史数据包含 240 条原始扫描快照、98 个唯一队列 GUID、142 条重复快照、76 个业务父任务和 +17 个车辆运行作业。默认 `business` 模式按生产源码语义组装 76 个父任务,再按 `create_date` +生成到达事件;`raw` 模式才按旧口径逐条运行 240 条快照。两种模式都由调度中心重新选车和 规划路径,经过 SHADOW 交通裁决、模拟 PLC/ACK、逐节点移动、资源释放、完成归档和 幂等 WMS 回调。历史 `agv_id/path_info/finish_date/完成状态` 仅用于对照。 ```bash -mvn compile exec:java \ +mvn -q -DskipTests compile exec:java \ -Dexec.mainClass=com.ft546.wcs.shadow.history.simulation.HistoricalDispatchSimulationApplication \ - -Dexec.args="outputs/wcs-history-driven-center-dispatch-local 100" + -Dexec.args="outputs/wcs-history-business-dispatch-local 100 business" + +mvn -q -DskipTests compile exec:java \ + -Dexec.mainClass=com.ft546.wcs.shadow.history.simulation.HistoricalDispatchSimulationApplication \ + -Dexec.args="outputs/wcs-history-raw-dispatch-local 100 raw" ``` -第二个参数只允许 `10` 或 `100`。Java 原始证据包括 `summary.json`、`route-decisions.json`、 +第二个参数只允许 `10` 或 `100`,第三个参数只允许 `business` 或 `raw`。Java 原始证据包括 `summary.json`、`route-decisions.json`、 `task-results.csv`、`tick-events.csv`、`invariant-results.json` 和 `manifest.sha256`,回答完成/等待/失败、 每车完成数、车辆和路径差异、资源安全、平均/P95/P99、HOLD/重试原因、历史耗时差异、 归档和 WMS 幂等情况。正式验收证据目录另包含由这些原始证据生成的 @@ -144,15 +150,24 @@ mvn compile exec:java "-Dexec.mainClass=com.ft546.wcs.shadow.history.visualizer. 直接显示 Java 返回的候选和最终选中项。成功 REROUTE 事件保存换路前后剩余路径及同一交通快照的 质量,选择重规划记录后会在完整地图上同时叠加两条路线。页面不重新规划,也不自行推断地图邻接。 -“240 条历史任务”会重新执行全部历史负载并列出完成、等待、失败、重新选车和路径变化; +“历史任务回放”默认使用“业务任务”口径,运行 76 个业务父任务,并同时显示 240/98/142/76/17 +五项输入审计计数。右侧按真实执行顺序列出空车取货、载货回源通道前端、载货入位和空车回目标 +通道前端等阶段;点击任一阶段,完整地图只叠加后端返回的该阶段 `plannedPath`。检查器还显示货物 +状态、源/目标通道前端、业务完成时间、车辆释放时间和归并后的原始 GUID。 + +切换到“RAW 快照”后,会执行 240 条兼容任务并恢复历史 `path_info` 与新规划路径的共同边、专属边 +和无效段对照。跨层过程始终以换层入口、出口和独立作业事件表达,页面不会在两个楼层之间画一条 +虚假的普通地图边。 + “安全审计”集中显示节点双占、资源超容量、对向换边、死锁、归档完整性和 WMS 回调幂等。 导出的 JSON 是本次内存仿真的页面证据。 服务严格绑定 `127.0.0.1`,只读取打包的历史与地图资源,不接收任意文件路径,不连接数据库、 真实 PLC 或 WMS。按 `Ctrl+C` 停止服务。该页面用于离线上线前检查,不能替代现场 HIL/ACTIVE 验收。 -服务运行时可在另一个终端执行真实 Chromium 验收;脚本会运行 A→B 和 240 条接口,并检查完整地图、 -图层开关、视口、候选证据、桌面/移动布局、横向溢出及控制台错误: +服务运行时可在另一个终端执行真实 Chromium 验收;脚本会运行 A→B、76 个业务父任务和 240 条 +RAW 快照,并检查完整地图、业务阶段切换、跨层端口、历史路径差异、图层开关、视口、候选证据、 +桌面/移动布局、横向溢出及控制台错误: ```bash python scripts/visualizer_browser_qa.py http://127.0.0.1:18084 outputs/browser-qa