tei/weather
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
main
weather/tasks/display/NavSea_DisplayProductReadabilityTuning.md
OpenAI Codex c957fef15b Initial import
2026-03-17 19:52:51 +08:00

11 KiB
Raw Permalink Blame History

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 服务端天气显示产品从“低分辨率半透明糊层”改造成“清晰、连续、可读、不会压脏底图的正式显示产品”。

Reference in New Issue View Git Blame Copy Permalink