AstrBot-Desktop/docs/q9-local-acceptance.md
YokiiroBW 1a18a8ac85
一些检测仍在等待运行
ci / Portable quality checks (push) Waiting to run
ci / Windows Tauri build (push) Waiting to run
docs(acceptance): record r1/r2 gate closure and pending hardware steps
The R1 and R2 batches were recorded as gate-verified, but the Tauri
release build and the Playwright suite had never been run against them.
Both were executed here and pass, together with the rest of the stage
gate. Record the measured numbers rather than the previously estimated
ones, and name every step that still needs a live AstrBot container.

F-04 is now verified at the packaging level: the production CSP
containing blob: is present in the release binary. Dev builds do not
inject the CSP, so this was the only automated evidence available for
it; rendering an actual attachment remains a manual step.

Also record two things this run surfaced. Prettier reports 25 files
repo-wide, not the 20 previously written down, and the Playwright 680px
case passes only because that viewport sits exactly on the second CSS
breakpoint, leaving the 681px to 900px icon-only band untested and
without accessible nav labels. The latter is tracked as F-62.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-07-27 00:06:17 +08:00

113 行
6.1 KiB
Markdown

# Q9 Local Stability and Unsigned Installer Acceptance
## Scope
This checklist covers the local Q9 release line only. It does not claim Windows code signing, automatic updates, or Forgejo CI verification.
## Automated checks
- `cargo fmt --all -- --check`
- `cargo clippy --workspace --all-targets -- -D warnings`
- `cargo test --workspace`
- `npm.cmd run typecheck`
- `npm.cmd run lint`
- `npm.cmd run test -- --run`
- `npm.cmd run build`
- `npm.cmd run tauri:build`
## Manual Windows checks
1. Install the unsigned NSIS package into a disposable user profile.
2. Launch the application twice and verify the second launch focuses the existing main window.
3. Configure one Companion and one Operations profile, then verify independent connection status and message history.
4. Close the main window, quick-chat window, bubble, and pet through their supported paths; verify tray recovery and no blank native placeholder remains.
5. Use tray `退出程序`; verify the process, tray icon, pet window, bubble, and quick-chat window all disappear.
6. Move the quick-chat window, switch monitors, restart the app, and verify geometry is restored or safely clamped.
7. Disconnect and reconnect the network; verify the slot transitions through reconnecting without duplicate messages.
8. Force-terminate a disposable run, relaunch, and verify startup remains usable and logs report an unexpected previous session without exposing secrets.
9. Run the foreground-window, process, and single-target network diagnostics; verify invalid targets are rejected and no command execution is exposed.
## Release artifact
- Version: `0.1.0-alpha.2`
- Executable: `target/release/astrbot-desktop.exe`
- Unsigned installer: `target/release/bundle/nsis/AstrBot Desktop_0.1.0-alpha.2_x64-setup.exe`
## 2026-07-21 verification update
- Frontend lint, typecheck, Vitest (9), Vite build: passed.
- Playwright UI polish suite: 4/4 passed, including 1280px, 1024px, and 680px shell checks.
- Rust fmt, Clippy, workspace tests (67), and workspace check: passed.
- Tauri release executable and unsigned NSIS installer: passed.
- Full Prettier check still reports 20 pre-existing files outside this focused fix; broad formatting was intentionally not mixed into the release increment.
## 2026-07-27 verification update (R1 + R2 closure)
The R1 and R2 batches were previously recorded as gate-verified, but the Tauri release build and
the Playwright suite had never been executed against them. Both were run here.
### Gate results
| Command | Result |
| --- | --- |
| `cargo fmt --all -- --check` | passed |
| `cargo clippy --workspace --all-targets -- -D warnings` | passed, no warnings |
| `cargo test --workspace` | 96 passed, 0 failed, 2 ignored (`astrbot-desktop` unit 76, `dual_gateway_integration` 2, `desktop-protocol` unit 9, `protocol_contract` 5, `dual_instance` 4; `windows_dialog_smoke` and `soak` ignored) |
| `npm run typecheck` | passed |
| `npm run lint` | passed (`--max-warnings 0`) |
| `npm run test -- --run` | 19 passed / 4 files |
| `npm run build` | passed |
| `npm run test:e2e` | 5 passed / 5 |
| `npm run tauri:build` | passed, release profile in 3m25s |
This settles a documented conflict: the queue recorded the Rust total as 73 and the status summary
as 76. The measured `astrbot-desktop` unit count is 76, so 73 was stale.
### Release artifact
- `target/release/bundle/nsis/AstrBot Desktop_0.1.0-alpha.2_x64-setup.exe`, 8,867,530 bytes,
built 2026-07-27 00:02:12 +0800.
- F-04 packaging is machine-verified: the production CSP string
`img-src 'self' asset: http://asset.localhost data: blob:` is present in
`target/release/astrbot-desktop.exe`. Dev builds do not inject the CSP, so this is the only
automated evidence available for F-04; that an attachment actually renders still needs the
manual step below.
### Findings from this run
- `src/features/pet/DesktopPetView.tsx` was the only formatting regression introduced by the R1/R2
commits (verified by checking the same file at the pre-push base, where it passed). Fixed.
- `prettier --check .` reports 25 files: 20 pre-existing tracked files, 3 new report documents,
1 untracked machine-local file (`.claude/settings.local.json`, now in `.prettierignore`), and the
pet view regression above. The earlier record of "20" undercounted. A repo-wide formatting sweep
remains deliberately deferred.
- The Playwright suite passes, but the 680px case passes for a reason worth recording: `styles.css`
has two breakpoints. `max-width: 900px` collapses the sidebar to icons and hides the nav label,
and `max-width: 680px` restores it as a mobile top bar. The test viewport sits exactly on the
second breakpoint, so the accessible name is intact. The **681px–900px band is icon-only and
covered by no test**, and in that band the nav buttons have no accessible label at all. That is
the substance of audit P3-11 / F-62 and is not fixed here.
### Pending, requires a live AstrBot container
Not executed, not claimed. Each item names the fix it is the acceptance evidence for.
1. Install the fresh NSIS package, send a message with an image, confirm it renders — F-04.
2. Pet event linkage, dragging, and the context menu — F-03.
3. Three consecutive messages on one connection, each reply complete — F-01.
4. Hold a connection past 30s; take one reply past 120s to completion — F-10.
5. CJK-heavy prompts with no `U+FFFD` in the rendered reply — F-11.
6. Disconnect and restore the network; confirm the **remote** conversation has no duplicated
question or answer — F-12, observable only server-side.
7. Stop generation mid-reply, restart the app, confirm nothing is still marked as generating — F-13.
8. With a long reply in flight, confirm session lists, attachments, and capability lookups still
respond — F-49.
Items 1 and 2 need only the installer, not a container.
## Explicitly pending external acceptance
- HTTPS certificate pinning requires a real HTTPS endpoint and first-trust confirmation.
- Signed updater delivery requires release certificates, updater keys, and an update endpoint.
- Dual-server soak requires a second real AstrBot instance with a distinct server_instance_id.