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 等首装环境表现