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:
cbb
2026-09-21 02:26:42 +08:00
parent 261caf50b7
commit beeae8a382
48 changed files with 170 additions and 6438 deletions
+25 -2
View File
@@ -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 = 绿 · 内存/调试 = 紫。