AstrBot-Desktop/docs/reports/p00-bootstrap-report.md
YokiiroBW 353a439b41
一些检测仍在等待运行
ci / Portable quality checks (push) Waiting to run
ci / Windows Tauri build (push) Waiting to run
docs(p00): record spike results and unresolved boundaries
2026-07-18 21:00:49 +08:00

7.6 KiB

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 development continued on feat/p00-bootstrap.

Implementation, test, and CI 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. docs(p00): record spike results and unresolved boundaries

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.