# 3412切图延迟优化（v4）

> v4性能及历史证据保留。当前交互已升级为[v5保存完成后下一条](pallet_mask_taxonomy_complete_navigation_v5.md)，D会真实提交；不要沿用旧v4生产D切图测试。

原网址、访问码、namespace、任务binding及逐目标本机草稿键保持。刷新原页面加载前端优化；已有人工事件与原模型/配额不改写。

公网：<https://vehicle-active-cancellation-honolulu.trycloudflare.com/>；本地：<http://127.0.0.1:3412/>。

## 实测前后对比

| 指标 | 优化前中位数 | 优化后中位数 |
|---|---:|---:|
| 本机目标详情接口 | 3,359ms | 26ms |
| 本机实际浏览器切图 | 3,402ms | 79ms |
| 公网目标详情接口 | 3,997ms | 624ms |

优化前正常浏览器缓存下曾出现7,532ms切图，其中7,479ms在等待目标接口。优化后的公网时间仍包含测量网络路径和临时隧道时延；79ms是本机浏览器结果，不冒充用户设备上的公网切图速度。真实公网GUI/MacOS/iPhone Safari实机未测试；公网UI资源逐字节核验、实际生产A/D往返分别通过HTTP及localhost完成。

## 后端：全量核验按来源代际复用

旧目标接口每次调用离线级全量校验：81份历史清单约136MB反复JSON解析、11个SQLite库全行指纹、87份文件SHA。单次约3.3秒，多请求并发还会放大。

新`SourceGuard`：

1. 启动先做完整文件哈希与原始SQL逻辑行指纹校验。
2. 每次读取和保存仍同步检查源库/任务清单的成员集合、文件设备/inode/模式/大小/mtime_ns/ctime_ns，以及每个只读SQLite持久连接的`PRAGMA data_version`。没有“若干秒内忽略变化”的TTL。
3. 来源代际不变才复用已通过的结果；出现变化时由锁保护的一次全量核验确认，其他请求不并发重复核验。错误、缺失、核验中继续变化都拒绝视为有效来源。
4. 清单一致性只需比较哈希，不为向空字典收集目标成员再解析JSONL；重叠文件只哈希一次。
5. WAL同时观察身份、模式、长度和mtime；其ctime不单独作为数据变化，因为SQLite只读连接打开也可能通过fchmod改变WAL的ctime。实际数据库提交由持久连接data_version捕捉，WAL提交、checkpoint及文件替换均有测试。

代际探测在本机约7ms，首次完整核验约1.3–1.5秒。在两个视口的完整临时库流程中均只做了一次全量核验。

`FastTaxonomyEditor`复用原store/binding/cookie；每次切换重新查询**当前人工修订与历史**。保存前后各作来源探测，仍使用原`BEGIN IMMEDIATE`、expected_revision比较与追加事件，不自动重定旧草稿基线。逐类K、有效多边形、可选备注、历史恢复及所有GT/自动训练/机器人false字段与旧保存载荷一致。导出仍沿用原完整校验逻辑，不把交互优化扩展成资格豁免。

## 前端：只预取原图，元数据保持实时

- 目标详情与原图并行请求；两者成功且尺寸符合后才原子切换画布/类别/版本。
- 打开后只预取相邻两张原图，LRU最多保留6张解码图。
- **不预取/缓存人工修订和revision**：预取图片之后另一个窗口保存，实际切图仍取得最新SQL修订。
- 预取失败不改变当前标注；真实切换时重试，持续失败保留原目标和草稿。接口失败也不能只凭缓存图片切换。
- 类别未变时不重建类别样例DOM。A/D、Ctrl/Cmd保存、完成、撤销/重做及输入/繁忙保护保留。

## 发布边界与证据

- 新模块：`pallet/mask_taxonomy_source_guard.py`、`pallet/mask_taxonomy_fast_review.py`、`pallet/mask_taxonomy_fast_ui.py`。
- 独立UI：`outputs/pallet_mask_taxonomy_requests_v1/ui_fast_v4/`及`ui_fast_v4.json`。
- 激活指针：`outputs/pallet_mask_taxonomy_managed_v1/fast_navigation_active.json`。
- 成功回执：`outputs/pallet_mask_taxonomy_managed_v1/checks_fast_v4_retry1/acceptance.json`、`app_reload.json`、`HANDOFF.json`。
- 270项回归通过，涵盖WAL提交、文件同大小且恢复mtime、数据库替换、删除/新增来源、核验中变化、并发只核验一次、来源保存前变化拦截、旧版本409及旧/新保存payload一致。
- 1400/390宽真实Chromium临时库验证约81ms切图、预取失败恢复、冷图并行、预取后人工新修订仍实时读取、K重检、快捷键和旧草稿409保护。全部模拟保存仅在临时库。
- 只重载3412应用，保留监督进程/隧道/URL；重载前33条真实人工事件前缀逐字保留，后续用户真实保存允许正常追加。未向生产库提交测试标注，3406–3411保持。
- 首轮单测暴露了只读SQLite打开也会改变WAL的ctime，修正了误失效判定后全部通过；首轮GUI测试错误地要求已有本机草稿被服务器新修订覆盖，调整为对尚未打开目标测试“原图预取不缓存修订”，并保留原失败回执。旧草稿仍坚持旧基线并返回409。

新旧任务manifest均保持`b650c24ed32572b9b5e204f5458a580634b8fe636277677453fabcd370bbe7e0`。没有训练、改类、覆盖人工轮廓、提交或推送。
