回放并入主窗口，并修掉开场尖峰 / 录制时长 / 录制帧率 / 回放被摄像头覆盖等 9 项评审问题 - What: 回放不再是独立窗口——删除 PlaybackDialog，拆成 replay.py::ReplayController（读盘、游标、深度重算，只发信号）与 ui/replay_bar.py（录制选择、可拖拽进度条、单位、重算深度、提示行），品牌轨「历史回放」直接换主窗口布局，文件菜单两条入口都切到该视图，曲线改读 RecordingCurveSource（区间按需读盘 + 缓存包络），2D 面板切「原始图像 / 深度图」；传感器与标定合并到 SensorDialog（类型/配置下拉 + 当前生效标定 + 最近导出系数），标定面板加纵向滚动区、九按钮两行、六列表头 ResizeToContents。评审 9 项：1) 开场尖峰两个根因——push() 遇单位变化只记 _unit 而保留旧单位样本（raw 计数被画在牛顿轴上），改为「切换即换单位」：清缓冲按新单位重建、触发切换的那一帧仍刷数值卡；_start_run 先 session_store.reset() 再 set_store()，新会话不再带上次的尾巴（复现脚本 .repro/probe_item1.py：旧 39 样本峰值 9.841 → 新 37 样本峰值 2.390）。2) 箭头页脚改为「箭头按位移放大 ×{factor}」。3) 表头单位芯片由只读 QLabel 改为可点按钮，一次点击同时改曲线、数值卡与设置区下拉。4-6) 全程总览/框选/返回最新 改为 ui/icons.py 按主题令牌运行时绘制的图标，tooltip 与 accessibleName 保留文字，全程总览区域名仍是文字。7) stats() 在录制进行中即返回 _last_t - _t0，记录条开始计时（此前只在 _finalise 写、整场停在 00:00.0）。8) 容器 fps 改用传感器配置的速率（packet.fps 是"每秒完成多少帧"的计数器，突发/文件源会读到 48），视频按 1/fps 节流并把超前的帧计入 resampled_video（frames.csv/forces.csv 一行不少，报告写明原因），session.json 同时记 fps 与 measured_fps。9) _replay_owns_image() 让回放视图独占 2D 面板，实时帧不再覆盖；push() 在录制源挂载时连单位都不切，曲线/数值卡/单位一并归录制。附带：数值卡改读游标处样本（_readout_at_cursor）、回放按录制实际有的单位打开（_replay_unit_for + ReplayController.set_unit，避免 raw-only 录制在 newton 偏好下画三张空图）、视频速率下限。 - Why: 用户评审 9 点，其中 1/7/8/9 是代码缺陷（开场尖峰、录制时长不更新、录制 48fps 与实际 30fps 不符、回放时 2D 面板仍被摄像头刷新），2-6 是可读性问题（×2 含义不明、单位与视图控制应可点/应符号化）。 - Verification: ui_check.py 524 项 0 失败（新增 chart header and unit chip / acquisition correctness / replay owns the 2D pane 三段）、test_ui_smoke.py 69 项 0 失败（新增 7 个回归用例：单位切换不混单位、单位芯片、图标语义、录制中时长、传感器帧率+节流、回放独占面板、回放游标读数与单位回退）、drive_shared.py 146 项 0 失败、locale_studio.py（268 键齐全、zh==en、prefs 对齐）、reproduce.py、ui_snapshot.py 四张复核图（深色实时/回放、浅色 1280x720 实时与标定）。 - Not in this change: 录制文件格式（forces.csv 列序、frames.csv、session.json 路径与分段规则）不变，节流只影响"哪些帧进视频"，并显式计数上报；三维面板仍是占位符。
This commit is contained in:
ykcheungab
@@ -178,22 +178,24 @@ flow_ramp = 画布色, #6E4AD0, #FA02F3, #FF8A6B, #D8FF00
|
||||
| 轨 | 高度 | 承载 |
|
||||
|---|---|---|
|
||||
| 品牌轨（`QFrame#brandBar`） | 28 px | logo + 字标 + 三个顶层视图（实时监测 / 历史回放 / 标定）+ 右侧产品名 |
|
||||
| 状态轨（`ToolbarWidget` 的 rail） | ~30 px | **传感器 / 传感器配置**、阶段、采集来源、标定状态、数据有效性、记录状态、记录/运行/重置/设置 |
|
||||
| 设置区（默认收起） | 0 / ~40 px | 来源、摄像机编号、视频文件、单位、**记录模式** |
|
||||
| 状态轨（`ToolbarWidget` 的 rail） | ~30 px | **传感器摘要按钮**、阶段、**当前视图的来源选择**（摄像机编号 + 搜索 / 使用摄像机）、标定状态、数据有效性、记录状态、记录/运行/重置/设置 |
|
||||
| 设置区（默认收起） | 0 / ~40 px | 单位、记录模式、预览 |
|
||||
| 回放条（仅历史回放视图） | ~50 px | 录制选择、录制信息、进度条、位置、单位、重算深度、提示行 |
|
||||
|
||||
三点规则：
|
||||
四点规则：
|
||||
|
||||
1. **传感器选择在状态轨最左侧，且两个下拉都带标签**。`box / mini / finger` 是产品
|
||||
（传感器）类型，它决定后面可选的配置文件；原来只有一个「配置」下拉，看不出在切什么。
|
||||
现在写成「传感器」+「传感器配置」两个带 tooltip 的下拉，产品型号另有一个徽标
|
||||
（`FINGER` 不得被截断成 `INGE`，所以徽标只有最小宽度）。
|
||||
2. **导航按钮在品牌底上取品牌前景色**。`navButton` 用 `brand_bar_fg_muted`，当前视图用
|
||||
1. **传感器区是一个摘要按钮，不是两个下拉**。轨上只有 `BOX · box/sensor.json`；类型、配置
|
||||
与「当前生效的标定 / 最近导出的系数」都在它打开的 `SensorDialog` 里（见
|
||||
`docs/shell-lifecycle.md` §1.2）。摘要按钮属于状态轨，因此文本必须完整显示（见第 5 条）。
|
||||
2. **来源选择随视图**：实时视图显示摄像机编号 + 搜索；用视频文件采集时显示「使用摄像机」；
|
||||
回放视图不占位（回放条里有录制选择）。没有「来源」下拉，因此没有"先选来源才能用"的状态。
|
||||
3. **导航按钮在品牌底上取品牌前景色**。`navButton` 用 `brand_bar_fg_muted`，当前视图用
|
||||
`brand_bar_fg` + `navActive="true"`；两者都在 §2 的品牌底对比度审计里（7.67 / 12.94），
|
||||
不新增色值。
|
||||
3. **状态轨上的语义色一律算在 `toolbar_bg` 上审计**。记录状态（`status_idle` /
|
||||
4. **状态轨上的语义色一律算在 `toolbar_bg` 上审计**。记录状态（`status_idle` /
|
||||
`status_running` / `status_connecting` / `status_error`）、丢帧提示（`warning`）与数据
|
||||
有效性（`success` / `warning`）此前只检查 `panel_bg`，而它们实际画在顶栏底色上。
|
||||
4. **同一时刻只有一个实心按钮**（`ToolbarWidget._refresh_emphasis`）：
|
||||
5. **同一时刻只有一个实心按钮**（`ToolbarWidget._refresh_emphasis`）：
|
||||
|
||||
| 状态 | 实心 | 描边 |
|
||||
|---|---|---|
|
||||
@@ -202,18 +204,22 @@ flow_ramp = 画布色, #6E4AD0, #FA02F3, #FF8A6B, #D8FF00
|
||||
| 采集中 | `开始记录`（`primaryButton`） | `停止`（`dangerOutline`） |
|
||||
| 记录中 | `停止记录`（`dangerButton`） | `停止`（`dangerOutline`） |
|
||||
|
||||
`dangerOutline` 是新增样式：透明底 + `danger` 文字与描边，hover/pressed 才填充
|
||||
`danger_fill`；`:checked`（即"采集正在跑"）仍保持描边——否则一圈红边会在会话开始后
|
||||
悄悄变成整块红色，那正是这次要修掉的观感。
|
||||
`dangerOutline`：透明底 + `danger` 文字与描边，hover/pressed 才填充 `danger_fill`；
|
||||
`:checked`（即"采集正在跑"）仍保持描边——否则一圈红边会在会话开始后悄悄变成整块红色。
|
||||
|
||||
原反馈里"提高停止按钮优先级"的诉求没有丢：停止始终是红色、始终一键可达，只是不再
|
||||
与当前主操作争夺同一时刻的唯一实心位置。
|
||||
|
||||
5. **状态轨上的事实不得被压缩**（`ui_check.rail_squeezed`）。中文、英文、1280 与 1440
|
||||
6. **状态轨上的事实不得被压缩**（`ui_check.rail_squeezed`）。中文、英文、1280 与 1440
|
||||
四种组合下，轨上的按钮与下拉都必须显示完整文本；只有带 tooltip 的 `ShrinkableLabel`
|
||||
允许在窗口极窄时被裁切。这也是"记录模式"下拉被挪进设置区的原因：英文的
|
||||
`Start recording` + `Sensor config` 与它挤在同一行时，第一个被压缩的就是按钮文字。
|
||||
|
||||
7. **曲线表头只有符号，符号的颜色仍来自令牌**。全程总览 / 框选 / 返回最新三个按钮是
|
||||
纯图标（`QPushButton[iconOnly="true"]`），图标由 `ui/icons.py` 用 `text_secondary`
|
||||
实时绘制、切主题时按新令牌重画，因此配色审计的结论对它们同样成立，也不需要新增色值。
|
||||
单位芯片 `QPushButton#unitBadge` 用 `card_bg` 底 + `card_border` 描边 + `text_secondary`
|
||||
文字，hover 才换成 `text_primary` 文字与 `accent` 描边，它是"可点的状态"而不是实心主
|
||||
按钮，所以不参与 §6.5 的"同一时刻只有一个实心按钮"计数（`QLabel#unitBadge` 仍是通道
|
||||
徽标与传感器缩略图的样式，两者靠控件类型区分）。
|
||||
|
||||
---
|
||||
|
||||
## 7. 三个顶层视图 = 同一窗口的三套布局
|
||||
|
||||
Reference in New Issue
Block a user