From a4313f300dbeb32803d0cbae65e77dae24ff671d Mon Sep 17 00:00:00 2001 From: ykcheungab Date: Tue, 6 Oct 2026 14:27:53 +0800 Subject: [PATCH] =?UTF-8?q?=E7=BC=A9=E7=9F=AD=E4=B8=A4=E4=BB=BD=E8=B6=85?= =?UTF-8?q?=E9=99=90=E6=96=87=E6=A1=A3=EF=BC=8C=E5=8E=BB=E6=8E=89=E9=87=8D?= =?UTF-8?q?=E5=A4=8D=E5=86=85=E5=AE=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit replay-panel.md 超出 general 上限 5、shell-lifecycle.md 超出 reference 上限 27。两者超的都是重复：前者的「手动清空/退出清空/导出无代码」在缓存一节已写过，后者重复解释了同一条症状并删掉了已被修复解决的括注。 验证：doc_count 显示 1482/1500 与 3593/3599；doc_lint changed 与 --all 均干净。 --- apps/studio/docs/replay-panel.md | 2 -- apps/studio/docs/shell-lifecycle.md | 10 +++++----- 2 files changed, 5 insertions(+), 7 deletions(-) diff --git a/apps/studio/docs/replay-panel.md b/apps/studio/docs/replay-panel.md index 4dde8ce..569490a 100644 --- a/apps/studio/docs/replay-panel.md +++ b/apps/studio/docs/replay-panel.md @@ -171,8 +171,6 @@ wipe-on-exit preference and result export (≈70 MB per ten minutes). * The render cost (≈1.4 ms) and the PNG estimate (180–540 MB per ten minutes) are the owner's bench; Part B §14's snapshots (4.2–4.9 kB each) suggest the estimate is high. -* The manual clear action, the wipe-on-exit preference and result export have no code in - `orisys-app`; they are decisions. * A chosen calibration can be applied to the **box** chain only (`Sensor(cal_path=…)`). The finger runtime opens its sensor without one, so a non-default curve for a finger profile is refused rather than silently ignored — the SDK has no entry point for it (reported, not diff --git a/apps/studio/docs/shell-lifecycle.md b/apps/studio/docs/shell-lifecycle.md index 7bd9ec9..85388ff 100644 --- a/apps/studio/docs/shell-lifecycle.md +++ b/apps/studio/docs/shell-lifecycle.md @@ -86,20 +86,20 @@ （`ForcePlotsPanel.timeline_taken_over` → `_pause_playback`）。空格键同效。没有独立进度条， 曲线表头也不再放第二个播放按钮（一个运输控制，不会两处打架）。 - **视频解码器常开**：`RecordingReader.video_frame_at` 以前每帧 `VideoCapture` 重开 + seek - （小片段 10 ms，1080p H.264 上百 ms），30 fps 播放时每一拍都卡在 UI 线程上，视频看起来 - 根本不动。现在按分段缓存一个解码器，**顺序帧用 `read()` 步进**（实测 0.5 ms/帧）， + （小片段 10 ms，1080p H.264 上百 ms），30 fps 播放时每一拍都卡在 UI 线程上，视频根本 + 不动。现在按分段缓存一个解码器，**顺序帧用 `read()` 步进**（实测 0.5 ms/帧）， 跳转才 seek，`RecordingReader.close()` 负责释放。 - **数值卡读游标处的那一帧**（`ForcePlotsPanel._readout_at_cursor`）。浏览历史或回放时， 三个大数字是播放头所指的样本；跟随实时时"最新样本就是游标"，不额外读盘。旧写法在回放 时显示实时采集的最后一个样本，于是一张 7.5e5 原始计数的曲线旁边写着实时的 `0.0`。 - **2D 面板归当前视图的来源所有**（`_replay_owns_image()`）：回放视图打开录制后，采集线程 仍然在跑，但 `_on_run_tick` / `_on_preview_tick` 不再把实时帧画进 2D 面板， - `_render_run_image` 直接返回。否则回放画面会被摄像头帧一帧一帧盖掉（"回放时好像用的是 - 摄像头"）。切回实时视图才把面板交还给实时帧。 + `_render_run_image` 直接返回，否则回放画面会被摄像头帧一帧一帧盖掉。切回实时视图才把 + 面板交还给实时帧。 - **回放提示不占位置**：降采样 / 跨版本等说明放在来源摘要的 tooltip 里（状态栏只留一次性 通知，见 §2.2），打开录制时另发一条 6 秒通知。 - 离开回放视图：曲线挂回实时 store 并恢复跟随，来源槽换回摄像机，**已打开的录制保留**， - 摘要里的视频名**不再出现**（这正是"视频文件名残留在实时检测里"的修法）。 + 摘要里的视频名**不再出现**。 - 文件菜单两条入口（`打开录制视频…` / `回放最近一次录制`）都只是切到回放视图并加载录制。 ### 2.1 「由视频重算」：与打开录像同一条分析入口