AstrBot-Desktop/docs/reports/p00-bootstrap-report.md
YokiiroBW 72a16cb0b4
一些检查失败了
ci / Portable quality checks (push) Has been cancelled
ci / Windows Tauri build (push) Has been cancelled
ci / Portable quality checks (pull_request) Has been cancelled
ci / Windows Tauri build (pull_request) Has been cancelled
docs(p00): record Forgejo branch publication
2026-07-18 21:04:16 +08:00

130 行
7.7 KiB
Markdown

# P00 Bootstrap Verification and PR Draft
Date: 2026-07-18
## Delivery status
Local implementation and verification are complete. Git Credential Manager reauthentication succeeded, the `main` baseline was pushed non-forced to Forgejo at `0d12b94`, and `feat/p00-bootstrap` was published and verified at `353a439`.
Implementation, test, CI, and documentation increments are committed on the feature branch. Forgejo CI has not run because runner availability remains unverified; no CI success is claimed.
No merge to `main` has been performed.
## Environment
- Windows NT 10.0.26100.0, PowerShell 5.1.26100.7920
- Git 2.54.0.windows.1
- Node.js 24.17.0, npm 11.13.0, pnpm 11.9.0
- rustc/cargo 1.97.1
- Tauri CLI 2.11.4, Tauri crate 2.11.5
- WebView2 Runtime 131.0.2903.86
- MSVC link environment verified by debug/release and NSIS builds
## Completed scope
- Tauri 2 + React + TypeScript + Vite + Rust skeleton, tray, single-instance, CSP, and minimal capability configuration.
- Two independent companion/operations REST and SSE clients with local profile binding, state, cancellation, reconnect, Last-Event-ID, and deduplication.
- Windows Credential Manager CRUD with generated fake credentials and cleanup.
- Bounded UI Automation, selected-window in-memory PrintWindow capture, closed-window identity rejection, Event Log, process, port, foreground-window, authorized log-tail, configuration parsing, and redaction Spikes.
- Composite-key SQLite isolation.
- Recoverable plan/dry-run/copy/size+SHA-256 verify/atomic commit file transactions with ask/rename/skip and source preservation.
- Provisional desktop-v1alpha1 protocol types, TypeScript exports, ten JSON Schemas, and dual loopback Mock Gateway.
- Frontend, browser, Rust, integration, Windows-provider, soak, and Forgejo CI entry points.
- Dependency review, Spike reports, progress records, and changelog.
## Test report
| Check | Result |
| ------------------------------------------------------- | ------------------------------------------------------------------------------ |
| pnpm frozen lockfile-only validation | Passed with pnpm 11.9.0 and a local temporary store; no dependency scripts run |
| Frontend format, ESLint, TypeScript, Vitest, Vite build | Passed; 1 Vitest test |
| Playwright Chromium smoke | Passed; 1 test |
| cargo fmt --all -- --check | Passed |
| cargo check --workspace --all-targets | Passed |
| cargo clippy --workspace --all-targets -- -D warnings | Passed |
| cargo test --workspace | Passed; 40 tests, 2 explicit manual tests ignored |
| Controlled Windows UIA/PrintWindow smoke | Passed; 1 test, 0.12 seconds |
| Protocol Schema drift check | Passed |
| Corrected dual-SSE soak | Passed; 1800.02 seconds, companion 1800, operations 1801 |
| Tauri development launch | Passed; `AstrBot Desktop` window responsive and safely stopped |
| Tauri release executable | Passed |
| Tauri NSIS installer | Passed |
Soak resource samples:
- Working set: approximately 11.4-12.1 MiB.
- Private memory: approximately 2.0-2.4 MiB.
- Final pre-exit cumulative CPU: 1.38 seconds.
- No cross-routing assertion, stream stall, or failed shutdown in the corrected run.
NSIS artifact:
- File: `AstrBot Desktop_0.1.0-alpha.0_x64-setup.exe`
- Size: 3,552,257 bytes
- SHA-256: `BF87DCD13B81C18EFC9A2DB8DE6E201396FFBB9ABA0EABC579A22479C004816C`
## Security review
- Tauri window capability contains only `core:default`.
- No shell plugin or product API for PowerShell, CMD, arbitrary shell, input injection, registry write, or unrestricted filesystem execution exists.
- Credential values remain in Rust/Windows Credential Manager; React has no credential read command.
- Repository secret scan found only the documented redaction example and deliberate fake test fixtures.
- File-transaction deletion calls are limited to transaction-owned temporary destination files and generated test-fixture cleanup; P00 never deletes the source.
- No real UNC path, NAS credential, signing key, updater key, private key, or production token was used.
## Unresolved issues
1. `ssh://git@localhost:18086/...` refuses connections.
2. `ssh://git@192.168.31.210:18086/...` responds but rejects the available key; approved HTTP push is the working transport.
3. Forgejo CI has not run; runner jobs/labels could not be verified and the jobs API returned 404.
4. Real UNC/SMB behavior is not tested because no authorized disposable fixture was provided.
5. A real elevated or custom-drawn window remains a manual UIA/capture boundary test.
6. The connection layer and tray lifecycle passed separately; configured Gateway sessions are not yet wired into Tauri setup for a combined tray-hidden end-to-end run.
7. Real AstrBot Gateway protocol compatibility is unverified; desktop-v1alpha1 remains provisional.
8. Code signing, updater signing, updater endpoint, and release publication remain outside P00.
9. pnpm 11 project registration cannot create its store symlink when the project/store are on this UNC share; local temporary store plus frozen-store is the verified lockfile-only workaround.
## Commit list
Branch commit sequence:
1. `5e6e8d5 docs(project): add architecture and implementation specifications`
2. `0d12b94 chore(repo): initialize repository and ignore rules`
3. `01607c6 feat(p00): add Tauri desktop spike foundation`
4. `69b432b test(p00): add frontend browser rust and windows checks`
5. `d4af979 ci(forgejo): add portable and windows quality workflows`
6. `353a439 docs(p00): record spike results and unresolved boundaries`
7. `docs(p00): record Forgejo branch publication`
## Forgejo PR title
`feat(p00): bootstrap Tauri desktop and validate high-risk spikes`
## Forgejo PR body
### Summary
- bootstrap the Tauri 2 + React + TypeScript + Rust desktop workspace;
- add isolated companion and operations REST/SSE clients and dual Mock Gateway;
- add provisional protocol Schema, Windows secure/native Spikes, SQLite isolation, and recoverable file transactions;
- add frontend, browser, Rust, Windows, soak, and Forgejo CI checks.
### Verification
- frontend quality/build and Chromium smoke pass;
- Rust fmt/check/Clippy and 40 normal tests pass;
- controlled UIA/PrintWindow smoke passes;
- corrected 30-minute dual-SSE soak passes with 1800/1801 isolated events;
- Tauri development launch, release executable, and NSIS installer build pass.
### Known boundaries
- Forgejo CI is not yet executed;
- real UNC, elevated/custom-drawn window, real AstrBot Gateway, signing, and updater verification remain pending;
- connection tasks are not yet wired into a combined real tray-hidden session test.
### Safety
- no arbitrary shell or unrestricted desktop/filesystem capability;
- no real credentials or destructive source-file operations;
- no force push and no automatic merge to `main`.