[Bug]: quick-start 用例间歇失败，随机染红无关 PR

[johnnyzhang-eng]

现象

src/pages/quick-start/index.test.tsx > QuickStartPage > reports add-action failures inside the existing Quick Start run 在 CI 上间歇失败：

TestingLibraryElementError: Unable to find role="button" and name "确认并生成"

2026-08-28 在 #853 上撞到（run 33154079839）。判据：

• 该 PR 改的 9 个文件里零个前端文件（全是 backend + openapi.json）
• 同一提交本地跑 npx vitest run src/pages/quick-start/index.test.tsx → 130 passed
• 分支落后 main 0 个 commit
• 同一时刻 main、以及 feat(character): 体型存在角色上，让三道按体型分流的判据不再是死代码 #846 / fix(ops): 模型弃用但库里还非空的遗留列，放宽为可空（否则线上建不了项目） #865 / feat(gateway): P0 凭证池稳定身份与统一快照 #849 / feat(quick-start): persist agent conversations #837 的 Frontend checks 全绿

所以不是那个 PR 引入的，也不是过期基座 —— 是这条用例本身不稳。

为什么值得单独修

它随机染红无关 PR。红了之后每个人都要先花时间排除「是不是我改坏的」，而排除的过程就是上面那四条。#723 是同一类问题的前一次（workflow-editor 的图片错误态用例），修法是把 getByRole 换成 findByRole —— 等那个按钮真的出现再断言，而不是假设它已经渲好。

这条大概率同因：确认并生成 这个按钮要等异步流程推进才出现。

建议

把这条用例里对 确认并生成 的查询换成 findByRole（或在断言前 await waitFor）。同时值得扫一遍 quick-start/index.test.tsx 里其它同形状的 getByRole —— 130 条用例里可能不止这一处。

相关

• [Bug]: workflow-editor 图片错误态用例间歇失败，随机染红无关 PR #723：workflow-editor 图片错误态用例间歇失败（同类，已修已关）

[johnnyzhang-eng]

2026-08-29 现状：今晚撞过两次，都靠重跑过掉。

• fix/903-rig-master-tpose 上挂的是 workflow-editor/index.test.tsx > 图片加载失败时在原位显示错误状态，本地全量跑两轮 1363 全过，CI 重跑即绿
• feat/871-render3d-motion-ui 上挂的是 playtest 与 quick-start 两条，同样重跑即绿

两次挂的都不在当次 PR 改动的文件里。最近 12 次 Frontend CI 全绿，所以不是持续失败，是间歇。

本 issue 记录的现象仍然成立，只是这两天频率不高。