# Task: NavSea_DisplayProductReadabilityTuning
Version: codex6
Architecture: NavSea V11
Domain: weather-display-server
Status: planned

---

## 1. 任务名称

`NavSea_DisplayProductReadabilityTuning`

---

## 2. 任务目标

对 NavSea 服务端天气显示产品生成链进行可读性改进，解决当前 Display Product 存在的以下核心问题：

- 图层发糊
- 格网块感明显
- 色带对比不足
- 底图被脏化
- 海岸线附近显示不干净
- 地名、标注、底图细节可读性下降

该任务不是前端样式调整任务，而是**服务器端显示产品生成质量改进任务**。

目标是让服务端输出的天气显示产品达到如下效果：

- 连续但不模糊
- 平滑但不发灰
- 有梯度但不脏底图
- 海区信息清晰
- 陆地区域不过度染色
- 更接近成熟气象图层，而不是低分辨率半透明遮罩

---

## 3. 问题定义

当前天气显示图层存在以下典型表现：

### 3.1 粗格网直接暴露
表现为：
- tile 内部出现明显方块
- 放大后格子边界可见
- 海上场层缺少连续性

根因方向：
- 服务端显示栅格分辨率不足
- 直接对粗网格着色输出
- 未在服务端完成足够细的显示级重采样

### 3.2 过度平滑导致发糊
表现为：
- 图层像一层雾
- 局部梯度被抹平
- 海岸附近过渡模糊
- 场层“连续”但不可读

根因方向：
- 依赖 blur / 强平滑伪造连续感
- 输出后重采样策略过软
- 服务端未区分“插值连续”与“视觉模糊”

### 3.3 色带功能对比不足
表现为：
- 值域差异不明显
- 蓝灰一片
- 用户无法快速判断强弱变化
- 叠到底图后视觉信息被稀释

根因方向：
- 色带饱和度不足
- 中低值区分度不足
- alpha 与色差组合不合理
- palette 设计更像氛围图，而不是功能图层

### 3.4 底图被压脏
表现为：
- 地名变灰
- 海岸线发脏
- 地形层失真
- 地图整体发蒙

根因方向：
- 天气层整体覆盖过重
- 未考虑陆地弱化策略
- 图层输出未考虑与底图混合后的实际视觉效果

---

## 4. 任务范围

本任务只关注**服务端 Display Product 的生成质量改进**，包括：

- 服务端显示栅格精度策略
- 服务端插值与重采样策略
- 服务端平滑策略
- 服务端色带可读性策略
- 海陆差异化输出策略
- 显示元数据中的可读性控制参数
- tile 生成规则调整

本任务不包括：

- 前端图层组件重写
- Analysis Product 数值查询接口
- Offline Package 设计
- 航线规划算法
- 前端局部滤镜或 shader 补救
- 客户端重新着色

---

## 5. 核心原则

### 5.1 可读性优先于柔和感
天气显示层首先是功能图层，不是背景氛围层。

优先满足：
1. 梯度清楚
2. 海区强弱清楚
3. 底图仍可辨认
4. 再考虑视觉柔和

### 5.2 连续不等于模糊
连续天气场应通过：
- 更合理插值
- 更细显示栅格
- 更稳的色带映射

来实现，而不是通过重 blur 获得。

### 5.3 服务端负责显示质量
前端不负责补救服务器输出质量问题。

本任务必须通过**服务端产品改进**解决：
- 块
- 糊
- 灰
- 脏

### 5.4 海图场景优先
NavSea 是航海场景，显示应优先保障：
- 海区天气阅读
- 港口与沿岸识别
- 航线叠加清晰
- 标注可读

而不是追求整幅陆地区域统一渲染存在感。

---

## 6. 目标效果定义

改进后的服务器 Display Product 应满足：

- 不出现明显粗网格块
- 不形成大面积发灰发糊遮罩
- 海上梯度变化可快速识别
- 底图文字可保持清晰
- 海岸线附近不过脏
- 陆地部分显示影响弱于海区
- 在典型 zoom 下保持视觉稳定
- 相同产品在不同时间帧下风格一致

---

## 7. 必须改进的服务端方向

---

## 7.1 显示栅格分辨率提升

### 目标
避免“粗网格直接着色输出”的方块感。

### 要求
服务端在生成 raster display tile 前，必须先将天气场转换为足够细的显示级栅格。

### 明确要求
- 不允许直接对粗规则网格做简单颜色映射后输出 tile
- 必须存在 display-oriented resampling / interpolation 步骤
- 输出分辨率需以视觉连续性为目标，而不是以原始数据点数量为目标
- 需要针对不同 zoom 设计显示级栅格策略

### 预期效果
- tile 放大后块感显著下降
- 连续场更接近参考图风格
- 后续不再依赖重 blur 补救

---

## 7.2 插值与重采样策略修正

### 目标
通过更合适的插值获得连续感，而不是用后处理模糊掩盖粗糙输入。

### 要求
- 审查当前服务端插值方式
- 区分“数值场插值”和“图像后处理”
- 优先提高插值质量，而不是提高 blur 强度
- 显示产品必须以插值结果为基础，不得以图像模糊为主要连续手段

### 不允许
- 简单依赖高斯模糊作为主平滑方法
- 先粗糙上色，再模糊成“柔和图层”

### 推荐方向
- 更细显示网格
- 合理双线性/双三次/场级重采样
- 按 zoom 自适应重采样精度

---

## 7.3 限制过度平滑

### 目标
避免场层发雾、发灰、局部梯度消失。

### 要求
- 明确平滑策略的上限
- 将 blur 从主手段降为可选轻量辅助
- 若存在平滑，必须以“不损失局部结构”为前提
- 海岸线附近不得出现明显雾化边缘

### 输出要求
服务端需能区分：
- interpolation smoothing
- image blur smoothing

并优先保留前者，抑制后者。

---

## 7.4 色带可读性重构

### 目标
让天气层成为可读功能层，而不是半透明灰蓝遮罩。

### 要求
服务端 palette / legend 配置必须重新评估以下指标：

- 值域层次区分度
- 色相迁移清晰度
- 中值区与低值区可分离性
- 高值区视觉警示性
- 与底图叠加后的可读性
- alpha 与底图混合后的实际效果

### 改进方向
- 提高有效对比
- 减少灰化区间
- 保留风/浪场常见直觉映射
- 让用户一眼看出强弱变化
- 避免整幅图“蓝灰糊一片”

### 注意
色带配置属于服务端产品定义的一部分，必须在服务端正式配置，不得依赖前端临时猜测。

---

## 7.5 海陆差异化输出

### 目标
减少陆地被整体染色导致的“底图发脏”。

### 要求
服务端 Display Product 生成需考虑海陆差异化策略。

### 推荐方向
- 海域正常输出天气层
- 陆地区域降低存在感
- 陆地可采用更低 alpha 或更弱显示权重
- 海岸过渡区需平滑但干净
- 避免整片内陆都被天气层压灰

### 场景理由
NavSea 的核心使用场景是海图 / 航海气象，不应让陆地渲染强度干扰海区判断。

---

## 7.6 No-Data 与边界处理优化

### 目标
避免边缘发脏、异常色块、无数据区域污染。

### 要求
- 明确 no-data 颜色与透明规则
- tile 边界拼接必须稳定
- 海岸 / 数据边界不得产生脏边
- 不允许无数据区域被错误平滑扩散成虚假值

### 必须注意
- no-data 不能简单当低值色
- 边界外推必须受控
- 显示层边缘必须尽量干净

---

## 7.7 Display Meta 增强

### 目标
把显示质量控制正式产品化，而不是靠隐性实现细节。

### 建议新增元数据字段
- paletteId
- displayMin
- displayMax
- suggestedOpacity
- landAttenuationMode
- noDataMode
- supportedZoomMin
- supportedZoomMax
- renderResolutionClass
- smoothingClass

### 作用
让前端明确知道服务端输出的产品语义与使用方式，也便于后续产品版本控制。

---

## 8. 服务端实施内容

本任务要求服务端至少完成以下工作项：

1. 审查当前 raster display 生成链
2. 定位粗网格暴露点
3. 定位 blur / smoothing 位置与强度
4. 重构显示级重采样策略
5. 重构 palette 可读性配置
6. 增加海陆差异化 compositing 规则
7. 优化 no-data / tile 边界处理
8. 更新 display meta 结构
9. 形成新的显示产品生成基线
10. 形成可对比验证样例

---

## 9. 推荐验证场景

必须至少用以下场景验证：

### 9.1 沿海复杂区域
例如：
- 日本沿岸
- 群岛区域
- 港湾附近

验证：
- 海岸附近不脏
- 港口可辨认
- 海区梯度仍清晰

### 9.2 大范围海区
验证：
- 不出现大面积块状
- 连续场稳定
- 不发雾

### 9.3 不同 zoom 级别
验证：
- 放大后不过度块化
- 缩小时不过度灰化
- 不同 zoom 的视觉风格连续

### 9.4 底图叠加效果
验证：
- 地名仍清楚
- 海岸线仍清楚
- 天气层不盖死底图

### 9.5 多时间帧一致性
验证：
- 不同时刻切换时风格稳定
- 不出现某些帧特别灰或特别糊

---

## 10. 接受标准

任务完成时，必须满足：

- 服务端输出的 Display Product 块感显著降低
- 不再依赖重 blur 获得连续感
- 色带在底图上可读性明显提升
- 底图文字与海岸线不再被明显压脏
- 海陆差异化显示策略已建立
- no-data 与边界处理明确可控
- display meta 已补充显示质量相关语义
- 改进属于服务器端生成线，而不是前端补救方案
- 符合 NavSea V11 非破坏式扩展原则

---

## 11. 非目标

本任务不包括：

- Analysis Product 查询接口
- Offline Package 打包
- 前端图层管理器重构
- 图例面板 UI 重构
- 航线规划天气采样
- 客户端 shader 渲染方案
- 客户端重新着色

---

## 12. 与其它任务的关系

本任务属于：

`Display Product` 生成线内部的质量改进任务

它应作为以下任务的增强子任务或并行任务存在：

- `NavSea_DisplayProductLine`

它不替代：
- `NavSea_AnalysisProductLine`
- `NavSea_OfflinePackageLine`

---

## 13. Codex 执行要求

执行此任务时：

- 必须从服务端显示产品生成链入手，不得把修正责任转嫁给前端
- 优先输出显示生成规则、palette 配置结构、display meta 结构、海陆 compositing 策略
- 如果需要改旧文件，必须等待用户提供现有文件
- 如果新增 `.ts/.tsx` 文件，必须包含 NavSea logger 初始化
- 不引入未知依赖
- 不做与任务无关的服务端大重构
- 保持 V11 wrapper-safe integration

---

## 14. 推荐交付物

建议本任务至少输出以下内容之一或组合：

1. 服务端 Display Product 可读性改进设计文件
2. palette / display meta / render config 类型定义
3. raster display generation policy 文件
4. 海陆差异化 compositing 规则文件
5. no-data / edge handling 规则文件
6. 验证用对比基线说明

---

## 15. 推荐下一步执行顺序

建议后续执行顺序为：

1. 先固化本任务文档
2. 审查当前服务端 display 生成链
3. 先修正显示栅格与重采样
4. 再修正 blur/smoothing
5. 再修正 palette 与 opacity 语义
6. 最后补充海陆差异化与 display meta

---

## 16. 一句话定义

本任务的本质不是“把天气层调柔和一点”，而是：

**把 NavSea 服务端天气显示产品从“低分辨率半透明糊层”改造成“清晰、连续、可读、不会压脏底图的正式显示产品”。**

---

