pbf/STEP_RECORD.md

# 项目步骤记录

最后更新：`2026-04-18`
仓库：`/root/sourceserver/pbf`
远端：`ssh://git@nas:2222/tei/pbf.git`

## 保留原则

- 只保留最近 3 天里真正会反复回看的内容
- 重点保留三类信息：
  - pickup 相关
  - 图标改进相关
  - 所有审计的方法
- 详细过程、反复试跑、临时中间值尽量不写，统一指向报告或脚本
- 详细审计结论索引：
  - [`report/REPORT_INDEX_2026-04-18.md`](/root/sourceserver/pbf/report/REPORT_INDEX_2026-04-18.md)

## 当前固定基线

- 视觉人工审计页：
  - `http://192.168.200.184/newpec/navsea-compare-karatsu-20nm.html`
- 全国 full/semantic 审计页：
  - `http://192.168.200.184/newpec/navsea-compare-full-audit.html`

## 最近 3 天摘要

### 2026-04-16 图标改进与语义迁移

- 完成了新旧 sprite / 图标键的梳理与迁移准备
- 形成了语义版图标映射和审计材料：
  - `src/pbf/semantic_sprite_key_map_2026-04-16.json`
  - `src/pbf/style.navsea-delivery-full-semantic.json`
  - `tasks/pbf/NavSea_Sprite_Audit_2026-04-16.*`
  - `tasks/pbf/NavSea_Sprite_Audit_newpec_style_with_pbf_2026-04-16.*`
- 相关目标：
  - 让 full / semantic 的图标来源、命名和可审计性对齐
  - 方便后续对比新旧 style 时追查具体 icon 差异

### 2026-04-17 pickup 相关

- 补了 pickup 解释链与点击定位链路：
  - `src/pbf/navsea-pickup-interpreter.ts`
  - `src/pbf/navsea-pickup-interpreter.js`
  - `src/pbf/navsea-pickup-rules.v1.json`
  - `src/pbf/navsea-click-target-karatsu-20nm.html`
  - `src/pbf/navsea-pickup-test-karatsu-20nm.html`
- 目标：
  - 让当前点选对象的解释、迁移、回放更稳定
  - 方便把 pickup 规则直接纳入人工审计页

### 2026-04-18 全国审计与重建

- 建了全国 full / semantic 的几何、extent、native 风险审计
- 建了全国固定 AOI 的截图对比审计
- 把全国人工审计页改成可切换 `variant=full / semantic`
- 支持右侧 `deliveryTileUrl` 覆盖，便于直接拿 rebuild 产物做对比
- 已确认并修掉两类问题：
  - `extent=4096` 的错退片
  - 旧坏 tile 的几何坐标漂移
- 已做 AOI 固定点：
  - 博多港中心 `10nm`
  - 东京湾 `10nm`
  - 大阪 `10nm`
  - 冲绳 `10nm`
  - 唐津 `5nm`

## 审计方法

### 1. 物体保全审计

- 脚本：
  - `navsea_object_preservation_audit.py`
- 用法要点：
  - 优先看对象是否被保留、合并、丢失
  - delivery 侧尽量用可追溯字段做比对
- 经验基线：
  - `Karatsu 10nm`
  - `--fid-key 'thisMyWorld@2026'`
  - `--match-on-fid-only`

### 2. render 审计

- 脚本：
  - `navsea_render_audit.py`
- 作用：
  - 看 delivery 与 source 的渲染结果是否一致
  - 先排除对象被错误合并/丢失，再看视觉

### 3. AOI 截图对比审计

- 脚本：
  - `navsea_full_aoi_visual_audit.py`
- 页面：
  - `src/pbf/navsea-compare-full-audit.html`
- 方法：
  - 左右截图
  - 取固定 AOI
  - 计算图像 diff
  - 重点看 `zoom 10 / 12`

### 4. extent / native 风险审计

- 脚本：
  - `navsea_geometry_native_audit.py`
  - `navsea_extent_shift_audit.py`
  - `navsea_tile_reencode_guard.py`
- 目的：
  - 先抓 `extent=1048576` 相关回退、错重编码、几何越界
  - 再把视觉差异与真正的几何风险分开

### 5. 热点重建审计

- 脚本：
  - `navsea_rebuild_hotspot_tiles.py`
- 目的：
  - 对固定 AOI 热点先重建 full，再刷新 semantic
  - 用来确认坏 tile 是历史产物还是当前 builder 问题

## 当前结论

- `full / semantic` 的 `z12 extent` 错退问题已修正
- 旧坏 tile 的几何漂移已定位并重建
- 当前 AOI 高 diff 主要是 full / semantic 与原始 `newpec` 的整体表达差异
- 视觉审计继续优先看：
  - 图标是否对
  - pickup 是否对
  - AOI 截图是否仍有几何级异常

## 继续工作的保留点

- pickup 相关文件优先看：
  - `src/pbf/navsea-pickup-interpreter.ts`
  - `src/pbf/navsea-pickup-rules.v1.json`
  - `src/pbf/navsea-click-target-karatsu-20nm.html`
- 图标相关文件优先看：
  - `src/pbf/style.navsea-delivery-full-semantic.json`
  - `src/pbf/semantic_sprite_key_map_2026-04-16.json`
  - `tasks/pbf/NavSea_Sprite_Audit_2026-04-16.*`
- 审计相关文件优先看：
  - `navsea_object_preservation_audit.py`
  - `navsea_render_audit.py`
  - `navsea_geometry_native_audit.py`
  - `navsea_extent_shift_audit.py`
  - `navsea_full_aoi_visual_audit.py`
  - `navsea_rebuild_hotspot_tiles.py`

## 2026-04-18 full 全国版状态

- 已合并完成：
  - `/home/wwwroot/pbf-delivery-full-20260418-rebuild`
- 合并后总瓦片数：
  - `65148`
- zoom 分布：
  - `z0=1`
  - `z5=10`
  - `z6=27`
  - `z7=76`
  - `z8=230`
  - `z9=813`
  - `z10=3156`
  - `z11=12279`
  - `z12=48556`
- 当前可继续做的事：
  - 全量 extent / native 审计
  - 全量 AOI 截图对比审计
  - 需要时再把该目录切换给 compare page 做最终人工审查