fix(web): recover the home screen when the bundle never runs

2026-09-22 12:13:17 +08:00
parent 6ac61be07d
commit 337d820076
18 changed files with 882 additions and 22 deletions
@@ -650,6 +650,22 @@ Agent 的 live 标记只有 `InlineSpinner` 一种。曾经并存的 canvas 小

 首页只揭幕一次。揭幕前的加载屏分两阶段：先取账户、模型目录与会话列表，再并行取今日星语与校正入口摘要，并预热校正分包；全部就绪或 4 秒预算到期（`BOOTSTRAP_PREPARE_TIMEOUT_MS`）才揭幕。揭幕后不得再出现任何阻塞等待或组件级 spinner：今日星语未到显示静态文案「今天的星语还没写出来。」（不带 `aria-busy`），校正卡用无摘要文案，内容到达后静默替换。登录后的空首页只剩问候语、今日星语卡、生时校正卡和输入框，没有主题卡。切换到消息尚未缓存的会话时消息区留白并只给 `sr-only` 文案，不转圈；揭幕后按侧栏顺序后台预取最近 5 条会话（`SESSION_PREFETCH_COUNT`）让常见切换零等待。轨道环消失后不得再换一套动效继续等。

+### 首屏死屏兜底
+
+首页揭幕前的轨道环是纯 CSS。客户端 bundle 没执行、关键 chunk 没加载或没解析成功时，8 秒的云端超时和 4 秒揭幕都不会发生，轨道会一直转。
+
+根 layout 里有一段与 bundle 无关的内联经典脚本。它只在同时满足这两条时换掉 `.app-loading-content`：页面上仍有 `.app-loading`，且 `<html data-hydrated>` 不是 `"1"`。时限是 13 秒，大于载入账户的 8 秒加上准备阶段的 4 秒，正常揭幕不会闪出这一屏。应用揭幕（`hydrated` 为真）后，现有首页装配 hook 写下 `data-hydrated="1"`。
+
+出现时复用 `.app-loading-error` 的卡片，不新增第二套转圈、骨架或自动刷新。
+
+| 位置 | 文案 |
+| --- | --- |
+| 标题 | 这个页面没能加载完 |
+| 正文 | 网络中断或浏览器版本过旧都会这样。可以重新加载试一次；如果反复出现，请在 Safari 设置里清除本站数据，或把系统升级到 iOS 16.4 以上。 |
+| 唯一动作 | 「重新加载」，只在点击时 `location.reload()` |
+
+接口超时仍是原来的「暂时无法进入 Jyotisha / 连接云端服务超时」，不要把脚本没跑起来写成云端慢。
+
 ### 报告生成等待态

 个人报告要写几分钟，属于"等到有实质进度可报"的一类，因此在上表三类之外单独规定：**只有准备阶段用 `InlineSpinner`，进入写作阶段后换成分章进度，不再转圈。**