一句话

跑 Playwright 冒烟测试，失败就看 trace 和日志定位根因，上最小修复后重跑到稳定。

何时用

• 适合：改动前后需要端到端冒烟验证；smoke 红了要定位和修。
• 不适合：验证 UI 细节但仓库没有 smoke 套件（可借鉴 ctk-control-ui 搭一次性探针）；单元测试层面的问题。

怎么用

跑一下 smoke 测试，挂了的话找出原因修掉

1. 先备好目标应用的构建前置条件。
2. 跑相关套件或单个测试文件：npm run smoketest [-- path/to/test.spec.ts]；构建产物就绪时用 smoketest-no-compile 提速。
3. 失败就查 trace 和日志定位根因，上最小修复重跑到稳定。

产出

• 测试结果摘要、根因和修复、残留的 flake 风险。

要点与坑

• 用确定性等待和断言，不靠易碎的超时。
• 修好后重跑几次降低 flake 假阳性；只有明确要求并记录在案时才隔离测试。

关联

• 同类：ctk-control-ui、ctk-check-compiler-errors
• 所属：00-ctk-概览