chore: 全量快照提交以防磁盘风险

NavSea_九州_Delivery_双用途图层分类_2026-04-05.md

@@ -0,0 +1,266 @@
+# 九州 Delivery 图层双用途分类
+
+## 目的
+
+本文把当前 `kyushu delivery` 实际使用的图层，按两个业务方向重新整理：
+
+1. 航海用
+2. 钓鱼用
+
+这里的“分类”不是按历史样式命名分，而是按使用目标分：
+
+- 航海用：
+  - 用于大范围危险早察觉
+  - 用于碰撞风险检测
+  - 用于航行实时检测
+  - 用于航线设计
+  - 原则上弱化过细水深细节，强化危险物、障碍物、净空、导助航信息
+- 钓鱼用：
+  - 用于看海底细节
+  - 用于看鱼礁、穴、底质、海底起伏
+  - 原则上强化海底信息与渔场相关信息
+
+## 当前实际图层来源
+
+本次整理基于当前 [`style.navsea-delivery-kyushu.json`](/root/sourceserver/pbf/src/pbf/style.navsea-delivery-kyushu.json) 中实际消费的 source-layer：
+
+- `baseline_area`
+- `anchor_caution_hazard_area`
+- `navigation_hazard_area`
+- `fixed_fishing_gear_area`
+- `anchorage_area`
+- `facility_boundary_area`
+- `submerged_reef_area`
+- `bridge_structure`
+- `onshore_structure_area`
+- `land_area`
+- `hole_area`
+- `bathymetry_line`
+- `depth_contour`
+- `depth_contour_overview`
+- `seabed_line`
+- `baseline_line`
+- `onshore_structure_line`
+- `depth_zone_739`
+- `depth_zone_741`
+- `clearance_limit_line`
+- `baseline_outline`
+- `hazard_boundary_outline`
+- `navigation_hazard_outline`
+- `anchor_caution_hazard_outline`
+- `anchorage_outline`
+- `facility_boundary_outline`
+- `clip_outline_754`
+- `navigation_hazard_point`
+- `anchorage_point`
+- `anchor_caution_hazard_point`
+- `navigation_marks`
+- `facility_boundary_point`
+- `pilot_station_point`
+- `onshore_structure_point`
+- `seabed_text_point`
+- `clearance_limit_point`
+- `place_label_sea`
+- `place_label_land`
+
+## 一、航海用
+
+## 定义
+
+航海用图层的目标是：
+
+- 让危险尽早出现
+- 让障碍物易检测
+- 让通航辅助信息明确
+- 让碰撞、净空、航线设计所需信息优先
+
+## A. 航海用核心层
+
+这些层建议作为“航海用”的主显示层，优先级最高。
+
+| 图层 | 作用 | 归类理由 |
+| --- | --- | --- |
+| `land_area` | 陆地区域 | 航行安全的绝对边界。 |
+| `baseline_area` | 基础海陆/岸线容器 | 当前样式里承载海面、水域、浅滩、未测区等安全底图。 |
+| `navigation_hazard_area` | 航行危险区域 | 直接通航危险。 |
+| `navigation_hazard_outline` | 航行危险边界 | 让危险范围更早被看见。 |
+| `navigation_hazard_point` | 航行危险点 | 暗礁、沉船、危险障碍点等碰撞检测核心对象。 |
+| `anchor_caution_hazard_area` | 注意障碍区域 | 虽是“投锚注意”命名，但实际含鱼礁、障碍、险恶物等，应纳入危险感知。 |
+| `anchor_caution_hazard_outline` | 注意障碍边界 | 让范围型障碍物更容易提早察觉。 |
+| `anchor_caution_hazard_point` | 注意障碍点 | 对航线绕避也重要，不能只放在钓鱼用。 |
+| `fixed_fishing_gear_area` | 定置渔具区 | 对航行规避很重要，是碰撞/缠绕风险层。 |
+| `submerged_reef_area` | 潜堤/潜礁区 | 本质是危险地形。 |
+| `navigation_marks` | 航标/灯标/浮标 | 实时航行检测、定位、航线设计的核心参考。 |
+| `bridge_structure` | 桥梁等结构物 | 通航结构风险与通道判断核心。 |
+| `clearance_limit_line` | 净空限制线 | 航线设计、通过性判断核心。 |
+| `clearance_limit_point` | 净空限制点 | 直接承载净空值与限制提示。 |
+| `facility_boundary_area` | 设施/边界区域 | 港区、设施边界、禁近范围对航行有约束。 |
+| `facility_boundary_outline` | 设施/边界线 | 轮廓比填充更适合早察觉。 |
+| `facility_boundary_point` | 设施符号点 | 港湾设施、边界点对避让和定位有用。 |
+| `anchorage_area` | 锚地区域 | 航线设计、航泊决策要素。 |
+| `anchorage_outline` | 锚地边界 | 区域边界比填充更重要。 |
+| `anchorage_point` | 锚地符号点 | 图面识别有帮助。 |
+| `pilot_station_point` | 引航站 | 航海服务信息。 |
+
+## B. 航海用辅助层
+
+这些层应该保留，但视觉权重应低于危险层和航标层。
+
+| 图层 | 作用 | 建议 |
+| --- | --- | --- |
+| `depth_contour_overview` | 概略等深线 | 保留整体深浅趋势，不必太密。 |
+| `depth_contour` | 等深线 | 只保留关键层级或降低对比度。 |
+| `bathymetry_line` | 海底辅助线 | 仅作地形参考，不应压过危险层。 |
+| `depth_zone_739` | 水域边界线 | 可作背景辅助。 |
+| `depth_zone_741` | 规则/边界线 | 可作背景辅助。 |
+| `onshore_structure_area` | 岸边结构物面 | 近岸定位参考。 |
+| `onshore_structure_line` | 岸边结构物线 | 近岸定位参考。 |
+| `onshore_structure_point` | 陆标点 | 对近岸定位有帮助。 |
+| `place_label_sea` | 海上地名 | 保留基础定位语义。 |
+| `place_label_land` | 陆上地名 | 保留基础定位语义。 |
+
+## C. 航海用建议弱化或隐藏层
+
+这些层不是不能存在，而是对“危险早察觉”不是第一优先。
+
+| 图层 | 原因 |
+| --- | --- |
+| `depth-contour-labels` / `bathymetry-depth-labels` | 过密时会压住危险点、障碍点、航标。 |
+| `bottom-material-labels` | 对通航安全不是第一优先。 |
+| `hole_area` | 对航海是补充信息，不是主风险提示层。 |
+| `seabed_line` | 更偏海底阅读，不是碰撞检测核心层。 |
+
+## 二、钓鱼用
+
+## 定义
+
+钓鱼用图层的目标是：
+
+- 让海底起伏更清楚
+- 让鱼礁、穴、底质、海底结构更容易被发现
+- 让选点时更容易判断地形与鱼群聚集可能性
+
+## A. 钓鱼用核心层
+
+这些层建议作为“钓鱼用”的主显示层，优先级最高。
+
+| 图层 | 作用 | 归类理由 |
+| --- | --- | --- |
+| `depth_contour` | 等深线 | 看坡、脊、沟、坎的核心。 |
+| `depth_contour_overview` | 概略等深线 | 看大地形趋势、找整体结构。 |
+| `bathymetry_line` | 海底地形辅助线 | 对细看海底很有帮助。 |
+| `bathymetry-depth-labels` | 水深数字 | 直接判断具体水深。 |
+| `depth-contour-labels` | 等深线文字 | 帮助快速读线。 |
+| `seabed_text_point` | 底质标注点 | 泥、沙、砾、壳等底质是钓点判断核心。 |
+| `seabed_line` | 海底线 | 海底细节辅助。 |
+| `submerged_reef_area` | 潜堤/潜礁区 | 渔场相关高价值信息。 |
+| `anchor_caution_hazard_point` | 鱼礁/障碍/注意点 | 这里面实际包含鱼礁与障碍类点，是钓鱼用关键层。 |
+| `anchor_caution_hazard_area` | 注意障碍区域 | 相关鱼礁/障碍区域也应被看清。 |
+| `hole_area` | 穴/凹地区域 | 明确属于你提到的钓鱼用重点。 |
+| `fixed_fishing_gear_area` | 渔具区 | 与渔业活动分布高度相关。 |
+
+## B. 钓鱼用辅助层
+
+这些层应保留，用于定位和安全感知，但不应压过海底信息。
+
+| 图层 | 作用 | 建议 |
+| --- | --- | --- |
+| `land_area` | 陆地背景 | 保留基本定位。 |
+| `baseline_area` | 海面/岸线底图 | 保留基础背景。 |
+| `navigation_marks` | 航标定位参考 | 便于回点、识别位置，但权重低于海底层。 |
+| `navigation_hazard_point` | 危险点 | 保留安全底线提示。 |
+| `navigation_hazard_area` | 危险区 | 保留安全底线提示。 |
+| `facility_boundary_area` | 港区设施 | 近岸定位参考。 |
+| `facility_boundary_point` | 设施点 | 近岸定位参考。 |
+| `onshore_structure_point` | 陆标点 | 回点/定位参考。 |
+| `place_label_sea` | 海上地名 | 位置参考。 |
+| `place_label_land` | 陆上地名 | 位置参考。 |
+
+## C. 钓鱼用建议弱化层
+
+| 图层 | 原因 |
+| --- | --- |
+| `clearance_limit_line` / `clearance_limit_point` | 对钓点选择不是核心。 |
+| `pilot_station_point` | 对钓鱼不是重点。 |
+| `anchorage_area` / `anchorage_outline` / `anchorage_point` | 可保留但不应抢视觉。 |
+| `bridge_structure` | 只在局部近岸场景有帮助。 |
+
+## 三、按产品方向的最终建议
+
+## 1. 航海用建议
+
+如果目标是：
+
+- 危险碰撞检测
+- 航行实时检测
+- 航线设计
+
+建议采用：
+
+- 强化：
+  - `navigation_hazard_*`
+  - `anchor_caution_hazard_*`
+  - `fixed_fishing_gear_area`
+  - `submerged_reef_area`
+  - `navigation_marks`
+  - `bridge_structure`
+  - `clearance_limit_*`
+  - `facility_boundary_*`
+- 保留但降权：
+  - `depth_contour`
+  - `bathymetry_line`
+  - `seabed_text_point`
+  - `hole_area`
+
+一句话总结：
+
+- 航海用应该是“危险物优先、导助航优先、深度细节退后”。
+
+## 2. 钓鱼用建议
+
+如果目标是：
+
+- 找地形
+- 找鱼礁
+- 看底质
+- 看海底细节
+
+建议采用：
+
+- 强化：
+  - `depth_contour`
+  - `depth_contour_overview`
+  - `bathymetry_line`
+  - `bathymetry-depth-labels`
+  - `depth-contour-labels`
+  - `seabed_text_point`
+  - `seabed_line`
+  - `submerged_reef_area`
+  - `anchor_caution_hazard_*`
+  - `hole_area`
+- 保留但降权：
+  - `navigation_marks`
+  - `navigation_hazard_*`
+  - `facility_boundary_*`
+  - `clearance_limit_*`
+
+一句话总结：
+
+- 钓鱼用应该是“海底信息优先、鱼礁穴位优先、安全层保底但不抢主视觉”。
+
+## 四、建议的后续实施方式
+
+下一步如果要真正落产品，我建议不要继续只维护一套 style，而是拆成两个 profile：
+
+1. `delivery-navigation`
+   - 面向航海安全、碰撞检测、实时航行
+2. `delivery-fishing`
+   - 面向钓点、海底结构、鱼礁/穴/底质阅读
+
+优先级建议：
+
+1. 先保持同一套 PBF
+2. 只分两套 style
+3. 先做视觉权重拆分，不急着拆数据
+
+这样改动最小，但业务方向会清楚很多。