Files
nexu-io__open-design/docs/testing/e2e-coverage/desktop.md
nettee 6b90486c97 docs: reconcile stale documentation with current code (#5829)
* fix(docs): align question guidance with form flow

* docs: reconcile stale documentation with current code

* fix(docs): remove retired template metadata from guides

Generated-By: looper 0.10.6 (runner=fixer, agent=codex)

* fix(e2e): stabilize visual workspace helper

Generated-By: looper 0.10.6 (runner=fixer, agent=codex)

* fix(docs): align localized template guide metadata

Generated-By: looper 0.10.6 (runner=fixer, agent=codex)
2026-07-18 03:41:08 +00:00

3.3 KiB
Raw Permalink Blame History

桌面端模块

覆盖范围

  • 受环境变量控制的 mac 桌面端 smoke
  • mac 打包产物安装/启动/探活生命周期
  • Linux headless 与 AppImage 打包产物生命周期
  • 从 desktop shell 进入设置页的关键路径

对应测试文件

  • e2e/specs/mac.spec.ts
  • e2e/specs/linux.spec.ts

已自动化

Desktop shell smoke

ID 场景 Gate 来源
DESK-001 Desktop shell 可以打开当前 API 配置,并展示正确的 provider/model OD_DESKTOP_SMOKE=1 mac.spec.ts
DESK-002 在桌面端设置里切换 API protocol 时,legacy provider tracking 保持一致 OD_DESKTOP_SMOKE=1 mac.spec.ts
DESK-003 桌面端外观设置里预览 Dark 模式,并在保存后持久化 OD_DESKTOP_SMOKE=1 mac.spec.ts
DESK-004 Desktop shell 可以打开 Local CLI 设置,并在 BYOK / Local CLI 间切换而不丢失已保存字段 OD_DESKTOP_SMOKE=1 mac.spec.ts
DESK-005 Desktop shell 可以打开 Connectors catalog,并打开、关闭 connector 详情抽屉 OD_DESKTOP_SMOKE=1 mac.spec.ts
DESK-006 Desktop shell 可以打开 Orbit,覆盖主页面、artifact 链接和未配置时跳转 Connectors 的 gate OD_DESKTOP_SMOKE=1 mac.spec.ts
DESK-007 Desktop shell 可以打开 Media providers 并看到 provider controls OD_DESKTOP_SMOKE=1 mac.spec.ts
DESK-008 Desktop shell 可以打开 About,并显示版本详情或 daemon offline 占位 OD_DESKTOP_SMOKE=1 mac.spec.ts

打包运行时 smoke

ID 场景 Gate 来源
DESK-101 构建出的 mac 安装包可以完成安装、启动、健康检查、停止和卸载 OD_PACKAGED_E2E_MAC=1 mac.spec.ts
DESK-102 全新 mac 打包应用的 onboarding 会同时呈现 Open Design Cloud、Local CLI 与 BYOK 路径 OD_PACKAGED_E2E_MAC=1 + OD_PACKAGED_E2E_MAC_ONBOARDING_SMOKE=1 mac.spec.ts
DESK-201 Linux headless 打包运行时可完成安装、启动、status/logs 检查、停止、卸载和 cleanup OD_PACKAGED_E2E_LINUX_HEADLESS=1 linux.spec.ts
DESK-202 Linux AppImage 可完成安装、启动、eval/截图探活、日志检查、停止和卸载 OD_PACKAGED_E2E_LINUX_APPIMAGE=1 linux.spec.ts

自动化候选

ID 场景 原因
DESK-C01 Windows desktop smoke 值得补,但要等对应平台 smoke 文件和执行基础设施准备好
DESK-C02 其余桌面端设置分区,例如 notifications、language Connectors、Local CLI、Orbit、Media、About 与 Appearance 已有 mac desktop smoke;其余分区仍可按风险补齐
DESK-C03 更深入的 packaged runtime 校验 成本较高,适合在发布链路更稳定后逐步扩展

手工保留

ID 场景 原因
DESK-M01 真机安装体验、系统权限弹窗体验 强依赖真实机器环境和人工判断
DESK-M02 不同 macOS 版本下的界面细节与交互质感 自动化覆盖成本高,更适合人工回归

说明

  • mac desktop shell smoke 保持在 e2e/specs/mac.spec.ts;打包运行时 smoke 按平台分别维护在 mac.spec.ts 与 linux.spec.ts。
  • e2e/lib/desktop/** 只放 helper,不放独立可执行用例。