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

当前固定基线

• 视觉人工审计页：
  • 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 做最终人工审查

2026-04-18 full 最终审计状态

• 已完成：
  • 全国分片重建
  • 全国根目录合并
  • 几何 / extent / native 审计
  • 全国固定 AOI 截图对比审计
• 当前结论：
  • full 根目录已可用于继续做人工视觉审查
  • extent=1048576 的高精度 tile 仍然是统一口径
  • AOI 高 diff 主要仍是和原始 newpec 的整体视觉差异，不是旧坏片那种几何炸裂
• 备注：
  • 全量 extent shift 长扫耗时过大，已暂停，后续如需可改成更小范围抽样或直接复用几何审计结论