6. 踩过的坑（静默失效清单，务必延续）
0.8k 字 ·
源文件 SESSION_STATE.md 第 177 行起 ·
discipline arch optim read selfcorrect
| # | 症状 | 真因 |
|---|---|---|
| 1 | HUD 全 — | Python 把 NaN 写进 JSON，JS 严格解析器拒绝 |
| 2 | 页面显示旧数据 | 旧录制文件冒充实时数据源 |
| 3 | 3D 空白 | 实时数据缺 charset/screen_w 等渲染必需字段 |
| 4 | 动态控制无效 | 面板写 control.json，训练进程根本没读 |
| 5 | [object Object] | /api/runs 回对象数组，前端当字符串用 |
| 6 | 页面永久卡住 | fetch 无超时，服务器重启时永久挂起 |
| 7 | 曲线只有 1 点 | 轮询失败后不再重试 |
| 8 | 训练整进程崩 | Windows os.replace 遇文件锁抛 WinError 5 |
| 9 | 修了还崩 | 忘了删旧的 os.replace，它在 try 块外 |
| 10 | THREE is not defined | three.js r150+ 移除 UMD；须用 r128~r147 |
| 11 | 页面静默失败 | let SCENE 在 loop() 之后声明（暂时性死区），错误在 rAF 回调里不传播 |
| 12 | 学习率不是启动参数 | control.json 跨会话持久，旧指令静默覆盖启动参数 |
| 13 | 无头截图时好时坏 | 无头浏览器 WebGL/虚拟时间不稳定（非页面问题） |
| 14 | 帧维度虚高一倍 | ROWS*SCREEN_H 应为 SCREEN_H |
| 15 | 实验结论不可靠 | 单种子 + 后台进程抢 GPU |