City-Lifeline-Cockpit/.scratch/cockpit-real-data-wayfinding/issues/26-26.md

26: 诊断票 —— 主场景等待后画面抽搐的根因定位

Type: research Status: ready-for-agent Label: ready-for-agent Category: frontend-diagnosis

来源

票 18 真人走查第 3 项（2026-10-10）：进入主场景后等待一段时间，整个画面进入抽搐状态，与期望不符。

已知观测

• 现象为「等待一段时间后」出现，说明与时间或后台加载相关，而非首帧。
• 抖动是整个画面级别的，不是单个图层。

纪律

当前不猜成因。 候选方向仅作为待排除清单，不是结论：雾过渡（domain/fog.js 的 altitude 收口与 slew 限速）、主场景区限位（domain/areaLimits.js）、3D Tiles 批次懒加载与渲染节流（services/tilesetLoading.js、requestRenderMode）、影像粗→精交接（domain/imageryHandover.js）、相机控制与动画循环。

必须先建立可复现、可判定的反馈回路，再给结论；不得凭读代码猜一个原因就改。

范围

1. 构建可重复的复现步骤（进入模式、相机动作、等待时长、是否必现、是否与移动/静止相关），并记录可观察指标（帧率、长任务、渲染节流状态、图层批次加载事件）。
2. 逐项排除候选方向，给出证据链；必要时做最小对照实验（关闭单个子系统看抖动是否消失）。
3. 定位到根因后给出修复方案与回归验证方法。

验收

产出：可复现步骤 + 判定依据 + 根因 + 修复建议；若判定为非缺陷（例如加载期正常表现），需用证据说明并给出期望行为的重新定义。

关联

发现于票 18；修复属前端执行票范围，本票只做诊断。

进度

Status: ready-for-agent Type: task Blocked by: #19, #22 Labels: ready-for-agent, frontend-diagnosis, wayfinder:task

Comments

Answer