docs(pbf): archive Full production provenance and engineering history

NavSea_海底地形解读_钓鱼参考.md

@@ -0,0 +1,439 @@
+# NavSea 海底地形解读与钓鱼参考
+
+最后更新：`2026-04-11`  
+项目根：`/root/sourceserver/pbf`
+
+## 1. 文档目的
+
+本文把当前 `NavSea PBF` 里与海底情况相关的图层、字段和可推断信息整理成一份面向业务的中文说明。
+
+目标是回答 4 件事：
+
+1. 当前 PBF 里，哪些层真的和海底形态有关
+2. 这些层分别表达什么
+3. 是否能看出“槽、脊、坎、坑、突起”等海底形态
+4. 这些信息对钓鱼有什么实际帮助
+
+## 2. 最重要的结论
+
+先直接收口：
+
+- 当前 `NavSea PBF` **没有一个现成字段直接告诉你“这里是槽”“这里是脊”**
+- 但它已经提供了足够的海底相关表达，可以让我们**基于等深线和辅助线去推断海底形态**
+- 对钓鱼最有价值的，不是单独某个字段，而是：
+  - `depth_contour`
+  - `depth_contour_overview`
+  - `bathymetry_line`
+  - `seabed_text_point`
+  这几类信息组合后的判断
+
+一句话说：
+
+**当前 PBF 已经可以帮助识别海底形态，但主要是“判读型能力”，还不是“对象已明确定义为槽/脊/坎”的能力。**
+
+## 3. 当前最相关的海底图层
+
+### 3.1 `depth_contour`
+
+- 含义：
+  - 普通等深线
+- 当前作用：
+  - 判断海底起伏最核心的线层
+- 常见字段：
+  - `least_depth_m`
+  - `chart_label_text`
+- 对钓鱼价值：
+  - 最适合看：
+    - 坡折
+    - 坎
+    - 小沟
+    - 浅深交界
+
+### 3.2 `depth_contour_overview`
+
+- 含义：
+  - 概略等深线
+- 当前作用：
+  - 适合看大尺度地形轮廓
+- 常见字段：
+  - `least_depth_m`
+- 对钓鱼价值：
+  - 更适合看：
+    - 大坡面
+    - 脊状隆起
+    - 主槽走向
+
+### 3.3 `bathymetry_line`
+
+- 含义：
+  - 海底地形支撑线
+- 当前项目口径：
+  - 它现在更像 `support`
+  - 不是正式业务主对象
+- 对钓鱼价值：
+  - 可以当作海底变化的辅助参考
+  - 但不要单独把它直接解释成：
+    - 海沟
+    - 山脊
+    - 坎线
+
+### 3.4 `seabed_text_point`
+
+- 含义：
+  - 底质标注点
+- 常见内容：
+  - 泥
+  - 砂
+  - 岩
+  - 混合底质
+- 对钓鱼价值：
+  - 很重要
+  - 因为很多鱼不是只看深度，也会明显依赖：
+    - 岩底
+    - 砂泥交界
+    - 底质变化带
+
+### 3.5 `hole_area`
+
+- 含义：
+  - 当前更偏透明挖空/支撑区域
+- 当前口径：
+  - 不建议直接解释成真实“海底坑”
+- 说明：
+  - 名字容易误导
+  - 现阶段不应拿它直接给钓鱼业务做坑位判断
+
+### 3.6 当前 PBF 可直接消费的相关字段
+
+如果只站在当前 `Karatsu 20nm final PBF` 的实际消费角度，和海底判读最相关的字段主要是下面这些：
+
+- `depth_contour`
+  - `least_depth_m`
+  - `depth_value_m`
+  - `chart_label_text`
+  - `class_code`
+  - `canonical_object_type`
+- `depth_contour_overview`
+  - `least_depth_m`
+  - `depth_value_m`
+  - `chart_label_text`
+  - `class_code`
+  - `canonical_object_type`
+- `seabed_text_point`
+  - `chart_label_text`
+  - `canonical_object_type`
+  - `class_code`
+- `submerged_reef_area`
+  - `least_depth_m`
+  - `canonical_object_type`
+  - `class_code`
+- `fixed_fishing_gear_area`
+  - `canonical_object_type`
+  - `name_ja`
+  - `class_code`
+- `bathymetry_line`
+  - `canonical_object_type`
+  - `class_code`
+- `seabed_line`
+  - `canonical_object_type`
+  - `class_code`
+
+实际理解时可以这样看：
+
+- `least_depth_m / depth_value_m`
+  - 提供深度值或等深线对应深度
+- `chart_label_text`
+  - 提供图面上真正显示出来的文字
+- `canonical_object_type`
+  - 提供当前 NavSea 体系下的对象细类
+- `class_code`
+  - 提供与原体系对回时仍然有价值的原生细分类码
+
+也就是说，当前做海底判读时，真正应该优先依赖的是：
+
+- 深度值
+- 图面标签
+- 等深线形状
+- 礁体/渔具/底质等周边对象
+
+而不是只盯住某一个“神奇分类字段”。
+
+### 3.7 一个容易误解的点：`seabed_line` 不等于“只有海底电缆”
+
+当前 style 里有一个叫 `subsea-cables` 的渲染层，但它消费的是：
+
+- `source-layer = seabed_line`
+
+这不表示 `seabed_line` 里的所有对象都严格等于“海底电缆”。
+
+当前 builder 的实际口径是：
+
+- 原始 `L海底線` 会统一归到 `seabed_line`
+- 渲染上暂时复用 `subsea_cable` 这一类线样式
+- 其中确实可能包含：
+  - 海底电信电话线
+  - 海底电力线
+  - 以及其他仍被归在海底线表达里的对象
+
+所以对业务解释来说，当前更稳妥的说法应是：
+
+- `seabed_line = 海底线表达`
+
+而不是直接说：
+
+- `seabed_line = 海底电缆`
+
+## 4. 现在能看出哪些海底形态
+
+下面这些不是当前 PBF 已经明确定义好的“对象类名”，而是**可以通过当前图面去推断的形态**。
+
+### 4.1 槽 / 沟 / 下切带
+
+典型图面特征：
+
+- 等深线向深水方向形成狭长下切
+- 线形像：
+  - `V`
+  - 狭长带
+  - 手指状深入
+- 两边线密，中间向更深处延伸
+
+可推断含义：
+
+- 水流容易集中
+- 饵料可能沿槽边或槽底移动
+- 槽边往往比槽底更值得重点看
+
+对钓鱼的价值：
+
+- 找鱼道
+- 找回游边缘
+- 找流线集中位置
+
+### 4.2 脊 / 隆起 / 海底包
+
+典型图面特征：
+
+- 较浅值被较深值包围
+- 线形围出高起区
+- 如果形状细长，更像“脊”
+- 如果接近圆形，更像“包”或“小山”
+
+可推断含义：
+
+- 是典型的结构位
+- 容易形成：
+  - 流切
+  - 藏鱼边
+  - 掠食等待位
+
+对钓鱼的价值：
+
+- 很高
+- 尤其是：
+  - 孤立小包
+  - 包边
+  - 脊顶与脊侧
+
+### 4.3 坎 / 坡折 / 落差边
+
+典型图面特征：
+
+- 等深线间距突然变密
+- 从平缓区一下进入陡坡
+- 同一片区域线距变化明显
+
+可推断含义：
+
+- 海底坡度在这里突然变陡
+- 是典型的“边界结构”
+
+对钓鱼的价值：
+
+- 非常高
+- 常见有效点位：
+  - 坎顶
+  - 坎脚
+  - 坎线拐点
+
+### 4.4 凹坑 / 小坑 / 洼地
+
+典型图面特征：
+
+- 闭合线往更深方向收敛
+- 或局部深值嵌在周围较浅区域内部
+
+可推断含义：
+
+- 可能形成局部积流、积沙、积饵
+- 小坑边缘通常比坑中心更值得看
+
+### 4.5 突起 / 小台 / 局部高点
+
+典型图面特征：
+
+- 闭合线往更浅方向收敛
+- 周围较深，局部突然浅起来
+
+可推断含义：
+
+- 是非常典型的鱼站位
+- 尤其是高点边缘和迎流面
+
+### 4.6 浅滩边缘
+
+典型图面特征：
+
+- 一圈较浅区外面包着更深等深线
+- 外缘一带线距明显变化
+
+可推断含义：
+
+- 浅滩本体不一定最好
+- 但浅滩边缘、出入通道、尖角、缺口都很关键
+
+## 5. 当前不能直接下结论的部分
+
+下面这些目前不能直接靠一个字段稳定下结论：
+
+- “这里就是海沟”
+- “这里就是海底脊”
+- “这里就是坡折点”
+- “这里就是坑”
+
+原因不是数据完全没用，而是：
+
+- 当前 PBF 还没有把这些形态正式物化成独立对象
+- 现在更多还是：
+  - 图面表达
+  - 人工或算法判读
+
+所以当前正确说法应是：
+
+- `可推断`
+- `高度怀疑`
+- `疑似坡折/疑似槽边`
+
+而不是：
+
+- `系统已确认`
+
+## 6. 对钓鱼最有用的实战看法
+
+如果站在钓鱼使用角度，我建议优先看下面 6 种位置：
+
+### 6.1 坡折线
+
+- 最值得优先关注
+- 因为：
+  - 结构明确
+  - 流态变化明显
+  - 藏鱼概率高
+
+### 6.2 浅深交界
+
+- 例如：
+  - `5m -> 8m`
+  - `8m -> 12m`
+- 常常比纯平底更有价值
+
+### 6.3 孤立小包或小隆起
+
+- 是典型的“单点结构”
+- 很适合做重点打点
+
+### 6.4 小槽边缘
+
+- 槽底未必最好
+- 槽边和槽口往往更有效
+
+### 6.5 礁体边缘
+
+- 如果图上存在：
+  - 鱼礁
+  - 潜提
+  - 礁状危险物
+- 那通常比纯深度变化更值得重视
+
+### 6.6 底质变化带
+
+- 岩到砂
+- 砂到泥
+- 礁边到沙底
+
+这类地方对很多鱼种都很关键。
+
+## 7. 当前 PBF 里哪些内容最值得结合看
+
+如果你是做钓鱼相关分析，建议把下面这些一起看，而不是只看一个层：
+
+- `depth_contour`
+- `depth_contour_overview`
+- `bathymetry_line`
+- `seabed_text_point`
+- `navigation_hazard_point`
+- `anchor_caution_hazard_point`
+- `submerged_reef_area`
+- `fixed_fishing_gear_area`
+
+原因：
+
+- 海底形态只是一个维度
+- 真正有用的位置通常是：
+  - 地形变化
+  - 障碍物/礁体
+  - 底质
+  - 可作钓/不可作钓约束
+  这几个维度叠起来
+
+## 8. 面向后续产品化的建议
+
+如果后面要把这件事做成更稳定的功能，我建议分 3 步。
+
+### 第一步：做 `depth context`
+
+在空白水域点击时，返回：
+
+- 最近深度值
+- 最近等深线
+- 最近概略等深线
+
+这是当前最容易落地的。
+
+### 第二步：做 `terrain hint`
+
+基于等深线密度和形状，给出轻量提示：
+
+- 疑似坡折
+- 疑似小槽
+- 疑似高起
+- 疑似浅滩边缘
+
+这一步最适合先做规则版，不用一开始就做复杂算法。
+
+### 第三步：做 `fishing structure score`
+
+把下面这些因素叠加评分：
+
+- 深度变化
+- 坡折强度
+- 附近礁体/障碍物
+- 底质变化
+- 区域约束
+
+这一步才适合真正做“钓点辅助”。
+
+## 9. 当前一句话总结
+
+当前 `NavSea PBF` 已经能支持你识别很多对钓鱼有价值的海底结构，  
+但方式不是“直接读出槽、脊、坎对象”，而是**基于等深线、海底地形辅助线、底质和礁体信息去综合判读**。
+
+如果后面继续做，我建议优先产品化的是：
+
+- 空白水域返回深度上下文
+- 再往上叠：
+  - 坡折
+  - 小槽
+  - 隆起
+  - 礁边
+  这几类结构提示