# 项目步骤记录

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

## 文档规则

- `STEP_RECORD.md` 必须使用中文
- 后续新增输出文档必须使用中文
- 后续新增审计报告必须使用中文

## 当前固定基线

唯一固定使用的视觉审计页面：

- `http://192.168.200.184/newpec/navsea-compare-karatsu-20nm.html`

当前页面版本：

- `HTML: compare-r18-20260402-1156`
- `Style: karatsu-final-style-r14-20260402-1145`
- `PBF: karatsu-final-pbf-20nm-20260402-1156-fullrefresh1`

当前仍使用同一张 HTML 做两个 profile：

1. 唐津 20 海里
   - `style.navsea-delivery-karatsu-20nm-final.json`
   - `pbf-delivery-karatsu-20nm-final`
2. 九州
   - `style.navsea-delivery-kyushu.json`
   - `pbf-delivery-kyushu-reencoded`

## 当前结论

- 当前主视觉问题不再优先怀疑 compare HTML 切错。
- 当前主问题分成两类：
  - `style` 过滤条件写错或过宽
  - 线上仍在使用较早生成的 `20nm final` 瓦片，部分关键对象没有 `class_code / display_code`

## 2026-04-02 本轮关键发现

### 1. 航标紫色圈“又回来了”的原因

- 问题层：`nav-light-flare`
- 根因：这一层的过滤条件写得过宽，几乎所有带 `light_color_code` 的对象都会被套上 flare。
- 直接表现：
  - 一些本来不该带圈的航标、浮标又被画成紫色圈
  - 例如 `31300003` 这类脚手架浮标不应再命中 flare
- 现已修正：
  - `nav-light-flare` 只对原始样式允许的那几类灯标生效
  - 不再给普通浮标乱套圈

### 2. “眼睛”图标回来的原因

- 问题层：`anchor_caution_hazard_point`
- 根因不是对象丢失，而是线上旧 `20nm final` 瓦片里很多对象没有 `class_code`。
- 一旦 `class_code` 缺失，样式只能退回：
  - `chart_icon_image = symbol-daytime-428`
- 直接表现：
  - `420` 这类投锚注意危险物又被画成眼睛图标
- 实际核对结果：
  - 用当前 builder 只重建 `11/1765/820` 这一张瓦片后，同一批对象已经恢复：
    - `class_code = 420`
  - 同时对应浮标对象也恢复：
    - `display_code = 31300003`
    - `chart_icon_image = symbol-daytime-327`

### 3. 为什么会出现“我们改过了，怎么又错了”

- 之前改对的是 `style` 逻辑
- 但 compare 页底下继续使用的是较早生成的 `20nm final` 瓦片
- 这批旧瓦片缺少关键码值字段
- 所以一旦样式依赖这些字段，就会退回错误兜底图标

一句话总结：

- 这次回退不是“代码白改了”
- 而是“新 style 压在旧 PBF 上跑”，导致修正无法完整生效

## 当前已落地的修正

- 已修正 `nav-light-flare` 过滤逻辑
- 已上线新的 compare 页版本号显示
- 已完成 `20nm final` 全量重生并切到线上
- 当前整套 `20nm final` 都是当前 builder 生成的新版本，不再是只修单瓦片

## 当前未完成项

- 继续按同一张 compare 页回扫其他依赖 `class_code / display_code` 的细分类图标
- 继续做热点截图复核，确认没有新的样式回退

## 下一步

1. 在固定 compare 页上复查：
   - 浮标不再被错误套圈
   - `420` 不再回成眼睛图标
2. 继续清理其他依赖 `class_code / display_code` 的细分类图标问题

## 快速续接提示

下次继续时，先做这几件事：

1. 确认页面顶部版本仍然是 `compare-r18 / style-r14 / pbf-fullrefresh1`
2. 继续从博多港和中央航路这类热点回扫细分类图标
3. 优先检查仍依赖 `display_code / class_code` 的对象组