diff --git a/doc/debug/模拟器控制面板重构方案.md b/doc/debug/模拟器控制面板重构方案.md new file mode 100644 index 0000000..9e650da --- /dev/null +++ b/doc/debug/模拟器控制面板重构方案.md @@ -0,0 +1,108 @@ +# 模拟器控制面板重构方案 + +## 目标 + +在不破坏现有老版面板的前提下,新增一套新版控制面板,用于承接更复杂的开发调试工作流。 + +重构目标: + +- 保留老版入口,确保已有使用习惯不受影响 +- 新增工作台式面板,提升连接、控制、观察、排障效率 +- 继续复用现有模拟器脚本和 websocket 协议,避免维护两套逻辑 + +## 设计原则 + +1. 新旧并行 + - 新版入口使用 `/` + - 旧版入口保留在 `/v1/` +2. 逻辑复用 + - 两个页面共用 `simulator.js` + - 只通过不同 HTML 布局和 CSS 风格区分 +3. 面向调试流程 + - 连接优先 + - 控制第二 + - 观察第三 + - 日志独立 + +## 新版布局 + +新版面板采用工作台布局: + +- 顶部:连接状态条 +- 左侧:控制区 +- 中间:地图与路径预览 +- 右侧:状态摘要与快捷观察 +- 右下:调试日志浮层 + +## 功能分区 + +### 1. 顶部连接条 + +包含: + +- 定位模拟连接状态 +- 心率模拟连接状态 +- 调试日志连接状态 +- 一键连接开发调试源 +- 新旧面板切换入口 + +### 2. 左侧控制区 + +包含: + +- 资源加载 +- 定位实时发送 +- 路径回放 +- 心率模拟 +- 新网关桥接 + +采用折叠分组,默认展开高频项。 + +### 3. 中间地图区 + +保留现有 Leaflet 地图和轨迹预览能力,作为核心观察区。 + +### 4. 右侧状态摘要 + +包含: + +- 当前经纬度 +- 当前航向 +- 当前路径点数 +- 最近发送状态 +- 最近心率发送状态 +- 资源加载摘要 +- 网关桥接摘要 + +### 5. 日志区 + +日志继续做成浮层: + +- 默认悬浮在地图右下 +- 可清空 +- 面积更大 +- 便于边看地图边看日志 + +## 与旧版的关系 + +旧版和新版应同时可用: + +- 新版作为默认工作台 +- 旧版继续作为稳定基线 +- 问题排查时可快速回退旧版 + +## 实施顺序 + +1. 根路径切换到新版工作台 +2. 新增新版样式 `workbench.css` +3. 复用现有 `simulator.js` +4. 旧版页面迁移到 `/v1/` +5. 在旧版和新版之间互相添加跳转入口 +6. 更新 README 和调试文档索引 + +## 验收标准 + +- 老版页面继续正常工作 +- 新版页面可完整使用现有 GPS、心率、日志、路径、网关能力 +- 两个页面共用同一套 websocket 协议和数据逻辑 +- 用户可以在两个版本之间切换 diff --git a/doc/debug/调试文档索引.md b/doc/debug/调试文档索引.md index ba2724f..f77af8d 100644 --- a/doc/debug/调试文档索引.md +++ b/doc/debug/调试文档索引.md @@ -9,6 +9,8 @@ ## 当前主文档 +- [模拟器控制面板重构方案](/D:/dev/cmr-mini/doc/debug/模拟器控制面板重构方案.md) + 用于说明新版模拟器工作台布局、新旧并行策略和重构目标。 - [平台能力说明](/D:/dev/cmr-mini/doc/debug/平台能力说明.md) 用于记录主体能力、`web-view`、传感器等平台边界。 - [模拟器调试日志方案](/D:/dev/cmr-mini/doc/debug/模拟器调试日志方案.md) @@ -21,9 +23,10 @@ ## 推荐阅读顺序 1. [platform-capability-notes.md](/D:/dev/cmr-mini/doc/debug/平台能力说明.md) -2. [sensor-current-summary.md](/D:/dev/cmr-mini/doc/debug/传感器现状总结.md) -3. [mock-simulator-debug-log-proposal.md](/D:/dev/cmr-mini/doc/debug/模拟器调试日志方案.md) -4. [compass-debugging-notes.md](/D:/dev/cmr-mini/doc/debug/罗盘排障记录.md) +2. [mock-simulator-control-panel-proposal.md](/D:/dev/cmr-mini/doc/debug/模拟器控制面板重构方案.md) +3. [sensor-current-summary.md](/D:/dev/cmr-mini/doc/debug/传感器现状总结.md) +4. [mock-simulator-debug-log-proposal.md](/D:/dev/cmr-mini/doc/debug/模拟器调试日志方案.md) +5. [compass-debugging-notes.md](/D:/dev/cmr-mini/doc/debug/罗盘排障记录.md) ## 使用建议 @@ -31,4 +34,3 @@ - 看“现在系统是什么状态”,优先看传感器现状总结。 - 看“以后日志怎么打”,优先看模拟器日志方案。 - 看“为什么罗盘以前坏过”,再去看罗盘问题记录。 - diff --git a/doc/文档索引.md b/doc/文档索引.md index e37f17c..61b84da 100644 --- a/doc/文档索引.md +++ b/doc/文档索引.md @@ -26,6 +26,7 @@ ## 调试 - [调试文档索引](/D:/dev/cmr-mini/doc/debug/调试文档索引.md) +- [模拟器控制面板重构方案](/D:/dev/cmr-mini/doc/debug/模拟器控制面板重构方案.md) ## 网关 @@ -40,4 +41,3 @@ - 长期保留的少量工作便签见 [notes](/D:/dev/cmr-mini/doc/notes)。 - 历史方案稿和阶段性讨论稿已移到 [archive](/D:/dev/cmr-mini/doc/archive/归档索引.md)。 - 正式阅读建议优先从本页和配置索引进入,不再直接平铺浏览全部文档。 - diff --git a/tools/mock-gps-sim/README.md b/tools/mock-gps-sim/README.md index f28b4ce..156f851 100644 --- a/tools/mock-gps-sim/README.md +++ b/tools/mock-gps-sim/README.md @@ -10,7 +10,8 @@ npm run mock-gps-sim 启动后: -- 控制台页面: `http://127.0.0.1:17865/` +- 新版工作台: `http://127.0.0.1:17865/` +- 旧版面板: `http://127.0.0.1:17865/v1/` - 小程序定位模拟地址: `ws://127.0.0.1:17865/mock-gps` - 小程序心率模拟地址: `ws://127.0.0.1:17865/mock-hr` - 小程序调试日志地址: `ws://127.0.0.1:17865/debug-log` @@ -88,6 +89,12 @@ ws://127.0.0.1:17865/debug-log http://127.0.0.1:17865/ ``` +如果需要旧版稳定界面,打开: + +```text +http://127.0.0.1:17865/v1/ +``` + 在“新网关桥接”区域可以直接配置: - 是否启用桥接 diff --git a/tools/mock-gps-sim/public/index.html b/tools/mock-gps-sim/public/index.html index 7ff2a23..452a1b5 100644 --- a/tools/mock-gps-sim/public/index.html +++ b/tools/mock-gps-sim/public/index.html @@ -3,226 +3,284 @@
-