chore: 提交调试文档与模拟器改动

This commit is contained in:
2026-04-01 13:12:39 +08:00
parent 3ef841ecc7
commit 175a16001e
14 changed files with 1695 additions and 315 deletions

View File

@@ -2,22 +2,22 @@
## 目标
在不破坏现有老版面板的前提下,新增一套新版控制面板,用于承接更复杂的开发调试工作流。
在不增加第二套历史 UI 负担的前提下,整理出一套新版控制面板,用于承接更复杂的开发调试工作流。
重构目标:
- 保留老版入口,确保已有使用习惯不受影响
- 新增工作台式面板,提升连接、控制、观察、排障效率
- 继续复用现有模拟器脚本和 websocket 协议,避免维护两套逻辑
- 最终只保留新版入口,避免长期双份维护
## 设计原则
1. 新旧并行
1. 单入口维护
- 新版入口使用 `/`
- 旧版入口保留在 `/v1/`
- 模拟器只保留一个工作台入口
2. 逻辑复用
- 两个页面共`simulator.js`
-通过不同 HTML 布局和 CSS 风格区分
- 继续复`simulator.js`
-维护一套 HTML 布局和 CSS 风格
3. 面向调试流程
- 连接优先
- 控制第二
@@ -44,7 +44,6 @@
- 心率模拟连接状态
- 调试日志连接状态
- 一键连接开发调试源
- 新旧面板切换入口
### 2. 左侧控制区
@@ -83,26 +82,16 @@
- 面积更大
- 便于边看地图边看日志
## 与旧版的关系
旧版和新版应同时可用:
- 新版作为默认工作台
- 旧版继续作为稳定基线
- 问题排查时可快速回退旧版
## 实施顺序
1. 根路径切换到新版工作台
2. 新增新版样式 `workbench.css`
3. 复用现有 `simulator.js`
4. 旧版页面迁移到 `/v1/`
5. 在旧版和新版之间互相添加跳转入口
6. 更新 README 和调试文档索引
4. 清理历史入口和旧文案
5. 更新 README 和调试文档索引
## 验收标准
- 老版页面继续正常工作
- 新版页面可完整使用现有 GPS、心率、日志、路径、网关能力
- 两个页面共用同一套 websocket 协议和数据逻辑
- 用户可以在两个版本之间切换
- 模拟器只保留一个工作台入口
- websocket 协议和调试逻辑继续复用