[ymote]

The app-and-agent guide now has an interactive React Flow architecture map directly below its introduction, with a prominent homepage link. Readers can switch between native UI construction and agent requests, select a node for its responsibilities, and follow source walkthrough links.

The rendering view separates Rust modules, Splash bundles, L0 realization/lowering, admission and native mounting. The request view connects human/system conversations, the shell broker, app peer, shared kernel, authorized host tools and app data. Directional request/reply arrows and dashed ownership edges distinguish these relationships.

English and Chinese views support keyboard selection, zoom, fit, opt-in panning and light/dark themes. Mobile starts with readable node detail and provides a node selector and full-map overview. A server-rendered text version and the existing guide remain usable without JavaScript. Adds the Astro React integration and React Flow dependencies, with contributor and bilingual README guidance.

Validation:

• 4 unit tests passed; Astro/TypeScript checks reported no diagnostics; production build generated 23 pages.
• All 27 Playwright checks passed, including the existing native WASM demo and five new architecture checks for navigation, heading order, modes, keyboard, mobile scrolling, themes/accessibility and no-JavaScript fallback.
• Independently inspected English/Chinese desktop/mobile and dark-theme captures; corrected overlapping connectors before final regression.
• Independent architecture/writing review and rendered review: 4.6/5 overall (A− target met).

The map documents implementation relationships; it does not connect to a running app, agent or account.