chore(hygiene): P3 报告归档 docs/reports + scripts 收敛 + lab 清理 + CSS/README 约定
正式 scripts 仅保留 README 自测清单;根目录报告迁入 docs/reports; lab 采样 dump 出库;CSS 注明 btn/toast 所有权并 bump ?v=。
This commit is contained in:
@@ -30,11 +30,29 @@ tabs.html 标签外壳 = 工具入口(GET / 会 302 到这里)
|
||||
pages/ 主功能页,各自引用 ../css 与 ../js
|
||||
lab/ 自包含实验页,零外部依赖,删文件即可移除
|
||||
css/ js/ 共享样式与 ES module
|
||||
scripts/ 构建辅助脚本
|
||||
scripts/ 正式自测/测量脚本(清单见下;一次性探针不入库)
|
||||
docs/compose/spec/ compose 功能规格
|
||||
docs/reports/ 历史调研报告(原根目录 ECAT_*/REPORT_*)
|
||||
esp32_server.py 本地页面服务 + 桌面窗口外壳
|
||||
esp32_app.vbs esp32_web.vbs serve.bat 三个启动入口
|
||||
```
|
||||
|
||||
## scripts/ 正式清单(仅保留这些)
|
||||
|
||||
| 脚本 | 用途 |
|
||||
|------|------|
|
||||
| `build_mem.bat` | Git Bash 下构建 ESP32_COMM |
|
||||
| `test_motor_transport.mjs` | 双链路传输契约 |
|
||||
| `test_motor_refresh.mjs` | 刷新速度每链路一份(纯逻辑) |
|
||||
| `test_ecat_autostart.mjs` | 自动接入链条(stub) |
|
||||
| `test_app_lease.py` / `test_app_lease_e2e.mjs` | 关窗停总线 |
|
||||
| `test_esf_pack.py` | PDO 快发 ESF1 打包 |
|
||||
| `check_esf_latency.py` / `check_latency_breakdown.py` / `check_e2e_click_motion.py` | 快发与点击延迟测量 |
|
||||
| `browser_check_{refresh,tick,floor,period}.mjs` | 浏览器侧 DOM/节拍实测 |
|
||||
| `probe_ecat_slot_atomicity.py` / `probe_ecat_vs_wifi.py` | 可复用采样器(gitignore 白名单) |
|
||||
|
||||
现场 `_tmp_*` / `skip_*` / `anal_*` 等一次性脚本**不入库**;历史报告在 `docs/reports/`。
|
||||
|
||||
## 页面
|
||||
|
||||
`tabs.html` 是单窗口多标签外壳,用**多 iframe 常驻保活**承载下列功能页:每个标签一个懒创建 iframe,切换只改可见性、不销毁文档(否则页内 WebSocket/轮询会随导航全灭)。激活标签记忆在
|
||||
@@ -51,7 +69,12 @@ esp32_app.vbs esp32_web.vbs serve.bat 三个启动入口
|
||||
## 目录约定
|
||||
|
||||
- `css/` —— `base`(变量/基础)、`layout`、`components`、`can`、`motor`、`responsive`。
|
||||
- `js/common/` —— 跨页公用:`base-url`(设备 IP)、`connection`、`polling`、`log`、`toast`、`utils`、`heap-low-history`。
|
||||
**所有权**:`.btn` 共享 chrome 在 `layout.css`;`components.css` 管跨页 `.toast`
|
||||
(居中单条);`motor.css` 的 `.btn` / `.toast-container` 是电机页主题覆盖与
|
||||
堆叠 Toast,**不要**再往 layout/components 抄一份电机专用规则。
|
||||
- `js/common/` —— 跨页公用:`base-url`(设备 IP)、`connection`、`polling`、`log`、
|
||||
`toast`(居中)、`toast-stack`(容器堆叠,电机页)、`ecat-bus`(ECAT 接入策略单点)、
|
||||
`device-link`、`utils`、`heap-low-history`。
|
||||
- `js/ota/`、`js/ble/`、`js/can/`、`js/motor/` —— 按功能域拆分的 ES module,跨域引用只走 `js/common/`。
|
||||
- 子系统配色:ESP32 = 青绿 · GD32 = 琥珀 · BLE = 蓝 · CAN = 绿 · 内存/调试 = 紫。
|
||||
|
||||
|
||||
Reference in New Issue
Block a user