City-Lifeline-Cockpit/.scratch/cockpit-primary-area-guardrails/prototypes/fog-review.md

视距雾气：可丢弃原型与人工验收入口

Status: awaiting-human-review

回答的问题

「18/42 km 世界射线距离雾 + 浅蓝灰地平线 + 进入时 60/20 km 高度带 + 退出 0.8 秒淡出」能否保留归位视角可读性、遮住浅俯角远景，并避免把天空压成夜空？

本原型属于「视距雾气的实现规格」的决策证据，不是生产实现，不承诺全视角遮缝或性能已达标。视觉分支以实际驾驶舱地图为背景，三种方案区别在合成方式，不另建 GIS 数据与渲染器。

首次人工反馈

维护者已选 B（仅地物距离雾），认可颜色和距离基本没有问题。进入演示未通过：雾出现太晚，未能及时遮挡矩形边缘；正式交付必须解决。C 不作为当前选择，但保留其代码供历史对照。

维护者在第 4 轮答复“全部按推荐来”，确认 B 按原型默认 18/42 km 与 #bdcdd6 固化；此为人工确认，不是自动采集快照。雾规格已按决策范围收口，进入演示失败仍待下游完整交接修正；未提供性能数据，不能判定 15% 预算通过。继续复现时使用 variant=B，本次未修改原型运行代码。

位置与打开方式

• 入口：src/pages/cockpit/index.vue，只增加 DEV + route query 显式选择的动态加载。
• 控制台：src/modules/cockpit/prototypes/FogPrototype.vue。
• 后处理：src/modules/cockpit/prototypes/fog-prototype-stage.js。
• 普通应用使用仓库现有 yarn dev（Fes），不使用 pre.dev；本会话未执行启动命令。
• 在该命令输出的现有应用地址打开 /#/cockpit?fogPrototype=1&variant=B。项目使用 hash 路由，query 在 #/cockpit 后。不预设本机端口，也不另起替代服务器。
• 先点击原页面「点击进入系统」，再点击原型底栏「归位观察」。初始原型 phase=global（无自建雾），原型不会偷改真实进入按钮。
• 没有 fogPrototype=1 或非 DEV 时不挂载原型；删除该 query 即卸载、恢复内置视觉雾；不修改运行配置文件，不保存参数。

三种方案

• A：关闭自建雾的基线。默认同时关闭内置雾的视觉贡献，但保留其剔除开关与既有天空大气；并非关闭所有大气效果。
• B：只处理有效几何深度的世界射线距离雾，背景保持原样。用于观察地平线断层是否明显。
• C：B + 无有效深度背景的地平线渐变 + 小幅太阳方向暖色。默认首版色 #bdcdd6 仅为可调起点，不是已验收终色；该背景分支也可能影响无自身深度的透明内容，必须检查。

用底栏按钮或左右箭头切换，输入框聚焦时不劫持箭头。切换更新 route query。可调起雾/遮蔽距离与基础色；参数仅驻内存。

操作与验收清单

1. 归位观察：切 A/C 对比，主体街区仍应可读，近处建筑不应蒙成一片。分别看 B/C 的远地物与天空衔接。
2. 浅俯角 −10°：观察地平线、山体与影像边缘，检查天空不是夜空、没有雾墙/色带。手动旋转到其他方向，结论不能只基于一个方向。
3. 进入演示：原型立即回到全景，稍后调用现有 goHome；高度从 60 km 到 20 km 驱动雾强度。此按钮演示门控，不实现正式进入状态机或完整影像交接。
4. 退出演示：现有相机向全景过渡，雾 0.8 秒淡出后禁用。连续进入/退出不应被旧计时器反向关闭。
5. 管线视图（原型局部）：调用现有地图服务的管线显示，不改正式 filterStore 选择；检查透明地表/近处管线是否被错误浓雾覆盖。可切 A 暂关自建雾对照，按已确认“可读性优先”决定是否需要正式降级。
6. 性能参考：固定视角、尺寸与内置视觉雾开关，等加载稳定并预热，按 A→C→A 收集三段各 10 秒帧间隔。控制台显示配置、画布尺寸、tilesLoaded 和各段 P95，最多保存六段。不要在采样中移动相机/改参数/切视图/切标签页。

性能读数是渲染事件间隔，不是 GPU 时间。A 保留禁用 stage，因此这组对照不能单独测清“完全不装 stage”的基线额外开销；帧同步也可能掩盖 GPU 增量。目标仍是确认的 P95 帧耗时增幅 ≤15%，正式验收还需无原型基线、同条件重复测量与首次启用/切换卡顿检查。本原型不自动显示通过结论。

已执行与未执行

• 已执行：源文件读回、接线 diff 检查、独立只读复核。
• 已修复：hash query 入口读错位置；采样结果递归嵌套历史；内置视觉雾混入 A/B/C 对照。
• 未执行：构建、dev、shader 编译、浏览器截图、GPU/帧耗时采样；遵守 AGENTS.md 的显式验证授权要求。
• 待维护者：实际打开原型，记录偏好、可读性缺陷和性能结果；不能凭代码存在关闭 HITL 决策票。

清理与保全

结论确认前保留为未提交的可丢弃源文件，工作区有大量并行改动，不自动切分支或提交。原型被验收后，将这两个原型文件与入口接线的独立补丁保存在 throwaway 分支，生产实现另行整理；移除入口动态挂载与整个 prototypes 雾目录即可撤除。不把未验证原型直接当正式交付。