Blackshield 开源 OpenShield 桌面端 GUI，配套 Android 移动端 OpenShield Pocket

The GUI companion for the OpenShield AI coding harness — plus OpenShield Pocket, the mobile remote (same codebase, Android first).

Part of the Blackshield Company.

Stack

Tauri 2 (Rust shell in src-tauri/) — app ID com.openshield.desktop
SvelteKit 2 (adapter-static, SPA mode) + Svelte 5 + TypeScript
Frontend talks to openshield serve (axum REST + WS, port 9310) directly over HTTP/WebSocket — the same code path runs on desktop, Android, and browser dev. No Tauri IPC for backend traffic.

The original Flutter scaffold is preserved in git history only; design doc §8 decision 5 (Tauri + SvelteKit) supersedes it.

Layout

openshield-desktop/
├── docs/                 # design doc + vendored reference configs
├── scripts/              # icon generation (python3 + PIL)
├── src/
│   ├── app.html / app.css
│   ├── lib/
│   │   ├── services/backend.ts   # REST+WS client (§3.1 / §4 contract)
│   │   ├── themes.ts             # CSS-variable theme store
│   │   └── components/
│   └── routes/           # chat, sessions, approvals, swarm,
│                         # memory, doctor, settings
├── static/               # favicon + assets
└── src-tauri/            # Rust shell (window, CSP, icons, capabilities)

Themes

CSS variables + Svelte store, swapped via data-theme on <html>:

Blackshield (flagship): #101014 matte black, #8F959C steel, #C1121F blood, #D8D3C8 bone.
Synthwave '84: #240037, #8F00FF, #FF7EDB, #FF00FF, #F3E70F.

Develop

npm install
npm run dev          # vite dev server on :1420
npm run tauri dev    # full Tauri window
npm run check        # svelte-check
npm run build        # static build → build/

Regenerate icons after editing scripts/generate_icons.py:

python3 scripts/generate_icons.py

Milestones

See docs/openshield-desktop-design.md §7. M1 (desktop shell) is complete: adaptive nav, theme system, backend client with disconnected banner, Doctor panel (live + mock fallback), Settings (connection, theme, pairing, credit).