22
Desktop · workflow

desktop-real-user-smoke-report

22-desktop-real-user-smoke-report.md
🖥️
P1 source: codex-sessions created: 2026-06-13
◉

WHAT IS THIS

定位

桌面端真实用户 smoke 和测试报告 workflow。适合 Electron、macOS app、desktop renderer、local executor、本地回调服务等真实用户路径。

它的重点不是“测试脚本通过”，而是像用户一样启动、登录、点击、输入、切换、观察，并把自动化限制和真实产品问题分开。

⚡

TRIGGERS

触发场景
▸用户要求“从实际用户角度测试这个 app”。
▸Desktop 登录、聊天、历史、设置、local executor、开发者模式有改动。
▸自动化测试通过，但用户仍看到异常。
▸需要输出测试报告或问题清单。
▸报告里的问题需要二次验证，避免误报。
↹

INPUT & OUTPUT

输入 / 产出
↘ INPUT
  • Desktop repo 路径。
  • Dev 启动命令。
  • 测试账号或现有登录态。
  • 关键用户路径。
  • 后端 endpoint 和环境说明。
  • 是否允许使用真实写操作。
↗ OUTPUT
  • 用户路径 smoke 报告。
  • 截图/日志/命令证据。
  • 问题清单，按 P0/P1/P2。
  • 自动化限制清单。
  • 可复验步骤。
  • 可选 patch 或后续修复计划。
🪜

STEPS

编排步骤
  1. 1
    启动真实 dev app
    运行项目约定命令，确认 renderer、main process、backend 端口和窗口都起来。
  2. 2
    验证首屏
    截图确认不是空白页、错误页、旧窗口或错误 app。
  3. 3
    登录路径
    优先真实 UI 登录；如果 UI 自动化受限，可验证 authorize/callback/token 落盘，并标清不等价范围。
  4. 4
    核心用户路径
    至少覆盖聊天、历史会话、会话切换、设置页、关键入口卡片。
  5. 5
    Desktop 专属路径
    覆盖 local executor、IPC、文件权限、回调服务、菜单或开发者开关，按改动范围选择。
  6. 6
    观察运行时
    收集 renderer console、main logs、network、SSE、toast、loading 和 timeout 体验。
  7. 7
    二次验证问题
    报告中的 bug 必须能复现。无法确认的写成 risk 或 automation limitation。
  8. 8
    停止 dev 进程
    不留下无用后台进程，并记录未能停止的进程。
⚙

AGENT ROLES

Agent 分工
⚙
App Runner
启动和停止 dev 环境。
⚙
UI Operator
按用户路径点击输入。
⚙
Log Auditor
抓 renderer/main/backend 日志。
⚙
Issue Verifier
二次验证问题。
⚙
Report Agent
输出报告和问题表。
✓

ACCEPTANCE GATE

验收 gate
⊘

FAILURE HANDLING

失败处理
⊘
如果窗口无法自动化，改用 renderer URL 或 CDP，但必须标明覆盖差异。
⊘
如果登录受阻，验证 token/callback 链路并报告阻塞点。
⤳
如果 smoke 发现成功/失败展示不一致，转 →#19。
⤳
如果问题来自 auth token 流程，转 →#23。
⌘

TEMPLATE

报告模板
TEMPLATE
## Desktop Smoke Report

- App:
- Command:
- Environment:
- Login result:
- Paths tested:
- Passed:
- Findings:
- Automation limitations:
- Follow-up: