docs(home): record slow-network acceptance

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
jesse-ux
2026-09-24 18:22:44 +08:00
co-authored by Claude Code
parent 25e32fe6fd
commit 1d1983b484
10 changed files with 159 additions and 21 deletions
+28
View File
@@ -13560,6 +13560,34 @@
- 复发自:BUG-715/723 的失败分档未覆盖按需层投影与组件出口;旧测试仅验主盘错误和端点不可用说明,未串联真实 busy 层响应到 hook。
- 修复版本:`1420471a`(staging 已部署、health 核对一致)
## BUG-1021 | 慢网首页半揭幕,模型与账户状态脱节
- 状态:resolved(本地 Windows/Node 20 定向合同与 TypeScript 验证通过;浏览器 Slow 3G、staging health 与部署证据待产品/协调方完成)
- 首次发现 / 最近更新:2026-09-24。
- 影响面:首页账户、会话、模型目录、咨询状态 bootstrap 与重试。
- 现象 / 触发:Slow 3G 强刷首页,原 8 秒串行预算先显示云端超时;SessionListProvider 后到仍写账户/会话,页面可能揭幕为模型不可用、发送禁用并重新询问称呼的半成品。
- 根因:Home 自有 8 秒 AbortController 与 SessionListProvider 独立请求脱节;模型目录失败只写 composer 提示却仍允许账户提交;渲染门未要求模型目录存在。
- 修复:引入 20 秒 `HOME_BOOTSTRAP_SLOW_MS`;模型、咨询状态与 provider 并行启动;必要数据齐全前统一等待,模型/必要请求失败保持全屏错误;重试取消旧请求、reload provider 并局部重跑;provider 使用可重入读取和旧 generation/controller 防护;首屏 ES5 fallback 调为 25 秒。
- 验证:`tsc --noEmit` 通过;首页与 fallback 定向合同通过;完整 lint 有 0 error、既有 warnings;浏览器与部署验收未在本地宣称通过。
- 防复发:保留一次等待一次揭幕、错误屏要求 `account` 与 `modelCatalog`,禁止 React 错误屏使用 `location.reload()`;provider 旧请求不得提交状态。
- 相关记录:BUG-479、BUG-927、BUG-936;`TASK-home-slow-network-20260924.md`。
- 复发自:无;BUG-927 引入的 provider/Home 时序脱节首次在本单补齐门控。
- 修复版本:`659bd9600`(待 staging 推送与部署核对)。
## BUG-1022 | 账户与点数首次打开慢且离线预取会误触发刷新
- 状态:resolved(本地 Node 20 定向合同通过;浏览器与 staging 验收待完成)
- 首次发现 / 最近更新:2026-09-24。
- 影响面:账户菜单、BillingPanel 动态分包、套餐接口与支付/兑换余额同步。
- 现象 / 触发:首次打开账户与点数需等待懒加载 chunk 和套餐请求;面板挂载还会重复请求完整 `/api/account`;指针悬停离线时动态 import reject 可能被全局 stale-client recovery 当作 ChunkLoadError 并整页刷新。
- 根因:账单 chunk 无预取/静态占位;套餐零缓存;挂载账户请求结果被 Home 传入账户覆盖;prefetch reject 未隔离。
- 修复:账户菜单 pointer enter/down 预取 chunk 和套餐;chunk 未到时显示静态占位;套餐结果模块缓存 60 秒并后台刷新;独立 route 查询并行;删除挂载 `/api/account`,兑换和支付直接用响应 `credits` 通过既有共享事件同步;prefetch 显式 catch 隔离失败。
- 验证:账单、membership、epay、首页 bootstrap/fallback 定向合同共 65/65;TypeScript 通过;定向 lint 通过;完整 lint 0 error、既有 warnings;浏览器/部署验收待完成。
- 防复发:合同锁定无 `/api/account`、响应 credits 同步和 prefetch catch;动态 import 预取失败不得冒泡到全局刷新逻辑。
- 相关记录:BUG-479、BUG-1021、`TASK-home-slow-network-20260924.md`。
- 复发自:BUG-554(账户与点数离开首页的旧入口已修复);本单是性能与慢网回归,不改变设置弹窗入口。
- 修复版本:`1fbe14995`、`6a097b6a3`(待 staging 推送与部署核对)。
## BUG-1020 | CRLF 普通报告下载保留图盘 JSON 围栏
- 状态:investigating(产品 2026-09-24 批准 D5 有限例外 D14,修复单待领取;未修复前不得标 resolved)