[REQ-085][CODE] Render distinct Home project-loading, offline, and sidecar-not-ready states

[jinjunnn]

AC:Home 区分加载/离线/sidecar 未就绪态。

来源:2026-07-14 逐需求审计(alpha-work/governance/audits/2026-07-14-s40-s49-per-requirement-audit.md)。父需求 Refs #200(v2:实现/验证票不 Fixes 父;父需求由验收 owner 手工关)。

[jinjunnn]

W0 存量普查复核:PARTIAL(保持 OPEN,置信度 high)

票面要的用户可观察效果
用户站在首页时,能分辨自己处在「项目还在加载」「网络离线」「引擎(sidecar)还没起来」这三种情况中的哪一种,并知道下一步该干什么 —— 而不是三种都塌成同一个「加载中/连接异常」。

这件事今天由谁负责
三种态今天分属三个不同的负责方,没有一个是 AlphaHome:①「引擎连不上」归上游 ConnectionGate(packages/app/src/app.tsx:483 起,不健康时整屏渲染 ConnectionError:554,健康检查中渲染 splash:545),它是替换掉 Home 渲染的,不是 Home 的一个态;②冷启动阶段归 alpha 自己的 splash(packages/ui-mac/src/renderer/index.tsx:427-432,一次性 resource,起来之后不再复现);③引擎自愈放弃后归 RecoverySurface 的 engine-stopped 分区(packages/ui-mac/src/main/recovery-adapter.ts:81-91)。而「项目列表加载中」与「离线」在 AlphaHome 里完全没有对应负责方 —— AlphaHome.tsx 全文 149 行只有两个横幅:store.error(100-107)与 configHealth.broken(108-115)。

实读证据

• packages/ui-mac/src/renderer/alpha-ui/AlphaHome.tsx:100-107 — Home 的唯一 readiness 相关横幅,文案是 projectsFailed + engineUnavailable,一条横幅盖住「项目拉取失败」与「引擎异常」两件事
• packages/ui-mac/src/renderer/i18n/zh.ts:917 — "alpha.home.engineUnavailable": "引擎连接异常或尚未就绪";这一条字符串本身就把「离线/连不上」与「sidecar 尚未就绪」合并成一句,是票面所说「塌成一个态」的直接书证
• packages/ui-mac/src/renderer/sidebar/use-projects.ts:132 — store 初值 { projects: [], ready: false, error: false };loading 语义存在于数据层
• packages/ui-mac/src/renderer/sidebar/alpha-sidebar.tsx:664,1211 — store.ready 的全部消费点都在侧栏(侧栏用它区分「加载中」与「真空项目」);AlphaHome 一次都没读它 ⇒ 首页在加载中与真空项目两种情况下渲染完全一致
• packages/ui-mac/src/renderer/alpha-ui/AlphaHome.tsx:49-51 — 首页只用 defaultWs.loading 去抑制一个错的工作区(给 undefined 让 composer 走「需要工作区」路径),没有据此渲染任何加载态
• packages/app/src/app.tsx:483-551 — 上游 ConnectionGate:健康检查中→整屏 splash(545),不健康→整屏 ConnectionError(526-540 的 fallback),健康→才渲染 Home;这就是今天「sidecar 未就绪」唯一真实可见且可操作的态
• packages/app/src/app.tsx:554-598 — ConnectionError 有 1s 自动重试与「其它服务器」列表,是可操作、不误导的;但它是整屏替换 Home,不是 Home 的一个态
• packages/ui-mac/src/renderer/index.tsx:427-432 — alpha 自己的启动 splash(alpha.engine.starting),挂在 awaitInitialization 这个一次性 createResource(391)上,启动之后不再复现

什么会推翻本结论
①在 AlphaHome(或它挂载的子组件)里找到一处按 store.ready / 引擎 generation / 在线性分别渲染的分支,使三种情况在首页上给出不同文案或不同可点动作;②或者拿出一条 owner 已批的裁决,说明「offline 与 project-loading 不做 Home 级区分、统一由上游 ConnectionGate 与 composer 失败路径承担」—— 那样这张票应改判 SUPERSEDED 而不是补做。

交叉验证用的两条独立检索轴

• 符号/API 轴:rg -an --glob '!node_modules' 'store\.ready|\.ready\b' packages/ui-mac/src/renderer/alpha-ui packages/ui-mac/src/renderer/sidebar → AlphaHome 零命中,只有 alpha-sidebar.tsx:664/1211;再 rg -an --glob '!node_modules' -i 'navigator\.onLine|\bofflin' packages/ui-mac/src → 全仓无任何离线探测(命中全是 automation 文案与 ext 目录名)。该命令先用已知存在的 rg -an 'a-home-stage' packages/ui-mac/src 自检过,能正常命中。
• 文件名/键名枚举轴:find packages/ui-mac/src -iname '*home*' -o -iname '*readiness*' -o -iname '*offline*' -o -iname '*network*' -o -iname '*connectivity*' → 只有 home.css 与 AlphaHome.tsx,不存在任何 home 状态机模块或离线模块;再 rg -an '"alpha\.home\.' packages/ui-mac/src/renderer/i18n/zh.ts 枚举首页全部 17 条文案键 → 没有 loading / offline / notReady 任何一条,唯一涉及就绪的是把两者合并的 engineUnavailable。

---

出处:2026-08-10 W0 存量普查第二轮。方法 = 12 个子系统批各自实读代码给出裁决,再对每一条会导致关票的裁决单独派对抗方证伪。本批 6 条关票候选全部被推翻(5 条从 DONE/SUPERSEDED 降为 PARTIAL,1 条方向相反),所以本票保持 OPEN。

[jinjunnn]

随父需求 alpha-code#200(REQ-085) 一并关闭(owner 2026-09-17 裁决不做):父需求 AC2 已改写为「项目加载失败 / 配置损坏 / 引擎连不上 / 区域崩溃各有可操作提示」,今天已成立;首页不是冷启动落点,「加载中」与「引擎未就绪」的细分提示不再做。

何时重开:出现因首页提示不够细而误操作的真实情况时,按现象开新票。