update at 2026-03-17 10:37:27

dash/docs/kindle-voyage-5.13.6-white-screen-handoff-zh.md

@@ -12,6 +12,12 @@
 - 白屏出现时，dashboard 本身往往没有真正接管成功，更像是 `framework/KUAL` 启动链在中途被打断
 - 当前最稳定的恢复路径，仍然是通过 SSH 执行 `./stop.sh`
 
+补充记录一个当前仍未修住、但边界已经比较清楚的问题：
+
+- 从 `KUAL` 进入 dashboard 后，再尝试回到 dashboard / KUAL 的原生 UI 路径，仍可能落入白屏
+- 这个问题不应再继续归因到背景图、时钟或页面布局
+- 当前更合理的判断，仍然是 `KUAL -> start.sh -> dash.sh` 的切换链路不稳定
+
 这份文档只记录当前交接结论，不再继续尝试修复。
 
 ## 已确认的事实
@@ -290,6 +296,23 @@ ssh kindle 'start webreader'
 
 而不是继续怀疑背景图、时钟绘制或顶栏遮罩。
 
+进一步说，当前建议把这个遗留问题固定表述为：
+
+- “`KUAL -> Kindle Dashboard` 与 `dashboard -> 原生 UI/KUAL` 之间的边界切换不稳定，表现为白屏”
+
+建议的修复方向是：
+
+1. 不要让 KUAL 直接同步执行 `/mnt/us/dashboard/start.sh`
+2. 改成由一个独立 wrapper 先脱离 KUAL / framework 会话，再延迟启动 dashboard
+3. 继续保留 `ssh kindle 'cd /mnt/us/dashboard && DEBUG=true ./start.sh'` 作为唯一已验证稳定的进入方式
+4. 继续保留 `./stop.sh` 作为唯一已验证稳定的退出恢复方式
+
+等 SSH 恢复后，再围绕下面三点做实机验证：
+
+1. KUAL wrapper 是否还能触发 `framework` 被 TERM
+2. `start.sh` 的后台脱离方式是否足够彻底
+3. `stop.sh` 后是否还需要补 `start webreader`
+
 ## 这轮涉及的关键文件
 
 - [dash/src/dash.sh](/Users/gavin/kindle-dash/dash/src/dash.sh)