跳转至

English | 中文

B-803 MVP 端到端走查(任务书 §成功标准)

依赖:B-801..802、B-805 全部代码级完成(CI 绿)后,在一台 Windows 机器上执行。 成功标准(任务书 §MVP):开机自启 → 桌面角落一直看到状态 → 一键 Run/Retry 成功,全程不开浏览器不登 GitHub。 铁律细项见 acceptance-B705-L0-behavior.md(真机手动清单 5 项在 B-803 内逐条勾选)。 产出:录屏/截图归档 + 发现问题修复或开 Issue;B-804 需在此之上补一台干净 Win11 VM。

0. 准备(5 分钟)

  • [ ] 下载 beacon-nightly-windows-x86_64-setup.exe(或便携 zip),校验 SHA256SUMS
  • [ ] 开始录屏(全程不间断;问题点单独截图)
  • [ ] 一台有 GitHub 仓库权限的机器 + 一个 PAT(用于连接录入与 Retry)
  • [ ] 备好一个可控的 workflow(可手动失败→重跑,如仓库内测试 workflow)

1. 脚本主链(任务书成功标准逐环)

# 步骤 操作 通过标准 结果
1 安装/解压 跑 setup.exe(或解压 zip) 无报错;开始菜单出现 Beacon(zip 方式直接见到 Beacon.App.exe 图标) ☐
2 首启反馈 启动 Beacon 启动通知气泡 + 托盘图标 + 右下角状态胶囊;无主窗口、不进任务栏/Alt-Tab ☐
3 开机自启 检查 HKCU\Software\Microsoft\Windows\CurrentVersion\Run 有 Beacon 项指向安装路径(设置里可关) ☐
4 录入连接 托盘菜单 → 设置 → 连接 → 类型 github → 填 Id + Token 「✓ 已保存」;测试连接返回 Healthy ☐
5 token 红线 打开 %AppData%\Beacon\connections.json 全文搜索 PAT 本体 搜不到明文 token,只有 credentialRef ☐
6 添加组件 设置 → 组件:github.actions.runs + github.pull_requests(选连接、必填字段) 列表出现两条;L2 面板出现对应行与计数 ☐
7 钉桌面 组件行「钉」开关打开 L0 出现 tile(状态灯 + 标签) ☐
8 制造失败 让可控 workflow 失败一次 胶囊变红/计数变化 + 托盘着色 + Toast 弹出(按规则带声音) ☐
9 下钻详情 点 Toast(或 L2 行)进 L3 详情窗显示状态/仓库/阶段/错误摘要;不打断 L0 ☐
10 一键 Retry L3 点 [Retry](全程不开浏览器) workflow 重跑成功 → Success Toast + 灯变绿 ☐
11 设置即时性 改级别色 / 动效档 / 透明度 / 胶囊开关 即刻生效(主题重启生效属预期);重启后仍生效 ☐
12 导入导出 设置 → 导出配置;改乱后导入 行为复原;导出文件无 token;提示重录密钥 ☐
13 断网降级 断网 tile 灰空心灯 + Last update;无异常弹窗;恢复自动复位 ☐

2. 四层交互清单(RFC §6)

  • [ ] L0 tile 单击 → L2 打开并聚焦;ESC 关;失焦自动关
  • [ ] L2 行单击 → L3 详情;L3 关闭回到 L0 常驻
  • [ ] L0 悬停/拖动/收起-展开不激活窗口、不打断当前输入焦点
  • [ ] 托盘菜单全部入口可用(面板/设置/通知/刷新/退出);热键 Ctrl+Alt+B 呼出面板
  • [ ] B-705 铁律真机手动清单 5 项全部勾选(见该文档)

3. GLM 额度端到端(验收反馈阻断级:连源→加组件→板上出真实数字)

# 步骤 操作 通过标准 结果
G1 录入 GLM 连接 设置 → 连接 → 类型 bigmodel → Id + PAT(或裸 Key) 测试连接返回 Healthy;提示「在下方组件向导选该连接,或用『一键添加』即可上板」 ☐
G2 一键示例 设置 → bigmodel 模块 →「一键添加 GLM 额度组件(示例)」 组件列表出现 bigmodel.usage:GLM;Pinned=true 自动钉选;右下角 L0 胶囊出现 数值卡 + 进度条 ☐
G3 首数出屏 等待 ≤10s(CI/Ci 档) 胶囊显示「GLM 额度 · 已用 XX% · 剩 YY tokens · MM-DD HH:MM 重置」;进度条按已用%填充;右键 L2 行可见 Source: GLM 标注 ☐
G4 字段映射自验 设置 → 组件 bigmodel.usage:GLM → 编辑 → 确认 total_path/used_path/reset_path 映射正确 字段路径与 GLM quota/limit 响应结构一致($.data.total / $.data.used / $.data.reset_at) ☐
G5 手动强刷 托盘菜单 → Refresh All 数值/进度条实时刷新;日志 %APPDATA%\Beacon\logs\beacon-*.log 有逐跳行(一键添加→拉取→字段映射→渲染) ☐

⚠️ 截图必须在 Windows 真机产出(Linux 仅能跑单测/构建,WinUI 3 无法在此环境运行)。请在完成上述 G1–G5 后,对 L0 胶囊与 L2 面板各截一张,存入 docs/img/ 并在 PR/回复中附上。

4. 归档

  • [ ] 录屏/截图存 docs/img/(大录屏可放 Release 附件,README 链接)
  • [ ] 每个不通过项:当场修复(走门禁推送)或开 Issue
  • [ ] B-804:同一脚本在干净 Win11 VM 复跑一遍(下载→运行→本清单),记录 VC++/SmartScreen 等首装环境表现