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