docs: rewrite README to match current architecture

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.gitignore

@@ -1,2 +1,3 @@
 node_modules/
 dist/
+renderer/

README.md

@@ -1,64 +1,52 @@
 # Fabric.Desktop
 
-Electron desktop shell for Fabric.Frontend.
+A **self-contained** Electron desktop app for Fabric. It bundles the
+`Fabric.Frontend` SPA inside the package and loads it locally over
+`file://` — no separate frontend web server is needed. It still talks to the
+Center/Guild **backends** over HTTP (the Center base is set on the login
+screen, so the desktop app points at whatever host runs the backends).
 
-## 功能（当前）
-- BrowserWindow 基础配置（尺寸/最小尺寸/标题）
-- Dev/Prod 加载策略（dev server / 本地 offline.html）
-- 基础菜单与快捷键（刷新、开发者工具、退出）
-- 安全基线：`contextIsolation` + `sandbox` + 禁止任意新窗口/导航
-- `preload + IPC` 白名单：
-  - `fabric:config:get`
-  - `fabric:config:set`
-  - `fabric:notify`
+## How it works
 
-## Dev
+- `npm run build:renderer` builds `Fabric.Frontend` with a relative asset
+  base (`build:desktop`) and copies the bundle into `renderer/`.
+- `main.js` loads `renderer/index.html` in production (falls back to
+  `offline.html` if the bundle is missing); dev mode loads
+  `FABRIC_DESKTOP_URL` (default `http://localhost:5173`).
+- Security baseline: `contextIsolation` + `sandbox`, no arbitrary new
+  windows/navigation; `preload` exposes a small IPC allowlist
+  (`fabric:config:get|set`, `fabric:notify`).
+- System tray (show/hide window, quit) with the Fabric tray icon; app/window
+  icons use the Fabric mark.
+
+## Develop
 
 ```bash
 npm install
-npm run start:dev
+npm run start:dev     # expects Fabric.Frontend dev server at :5173
+# or, against the bundled renderer:
+npm run build:renderer && npm start
 ```
 
-`start:dev` expects Frontend dev server at `http://localhost:5173`.
-
-## Standalone
-
-```bash
-npm start
-```
-
-## Build / Release
-
-先安装依赖（包含 `electron-builder`）：
+## Build / package
 
 ```bash
 npm install
+npm run pack          # unpacked dir (no installer)
+npm run dist:linux    # AppImage, deb, tar.gz   -> dist/
+npm run dist:mac      # dmg, zip
+npm run dist:win      # nsis, zip
 ```
 
-仅打包目录（不生成安装包）：
+Each `dist:*`/`pack` runs `build:renderer` first (so `Fabric.Frontend` must
+be present beside this submodule, which it is in the `Fabric` checkout).
+Output goes to `dist/` (git-ignored). `productName` is **Fabric** so the app
+installs to `/opt/Fabric/` (a space there breaks Electron's sandbox); the
+launcher is still labelled "Fabric Desktop". Linux icons are generated from
+`build/icons/`.
 
-```bash
-npm run pack
-```
+## Notes
 
-跨平台构建入口：
-
-```bash
-npm run dist
-```
-
-按平台构建：
-
-```bash
-npm run dist:linux
-npm run dist:mac
-npm run dist:win
-```
-
-构建产物输出到：
-
-- `dist/`
-
-产物命名规范：
-
-- `Fabric-Desktop-${version}-${os}-${arch}.${ext}`
+- The bundled SPA uses `HashRouter` under `file://` (no server for the
+  History API). The Center/Guild backends are HTTP and CORS-allow the
+  Electron `file://` origin (`null`).

main.js

@@ -4,7 +4,11 @@ const path = require('path')
 
 const isDev = !!process.env.FABRIC_DESKTOP_URL
 const DEFAULT_DEV_URL = 'http://localhost:5173'
-const DEFAULT_PROD_ENTRY = path.join(__dirname, 'offline.html')
+// Self-contained: load the bundled frontend if present, else the placeholder.
+const BUNDLED_ENTRY = path.join(__dirname, 'renderer', 'index.html')
+const DEFAULT_PROD_ENTRY = fs.existsSync(BUNDLED_ENTRY)
+  ? BUNDLED_ENTRY
+  : path.join(__dirname, 'offline.html')
 
 let mainWindow = null
 let tray = null

package.json

@@ -12,11 +12,12 @@
   "scripts": {
     "start": "electron .",
     "start:dev": "FABRIC_DESKTOP_URL=http://localhost:5173 electron .",
-    "pack": "electron-builder --dir",
-    "dist": "electron-builder",
-    "dist:linux": "electron-builder --linux AppImage deb tar.gz",
-    "dist:mac": "electron-builder --mac dmg zip",
-    "dist:win": "electron-builder --win nsis zip"
+    "build:renderer": "node scripts/build-renderer.mjs",
+    "pack": "npm run build:renderer && electron-builder --dir",
+    "dist": "npm run build:renderer && electron-builder",
+    "dist:linux": "npm run build:renderer && electron-builder --linux AppImage deb tar.gz",
+    "dist:mac": "npm run build:renderer && electron-builder --mac dmg zip",
+    "dist:win": "npm run build:renderer && electron-builder --win nsis zip"
   },
   "devDependencies": {
     "electron": "^37.2.1",
@@ -34,7 +35,8 @@
       "preload.js",
       "offline.html",
       "package.json",
-      "assets/**"
+      "assets/**",
+      "renderer/**"
     ],
     "asar": true,
     "icon": "build/icon.png",

scripts/build-renderer.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+/**
+ * Build the Fabric web frontend with a relative asset base and copy the
+ * static bundle into Fabric.Desktop/renderer/ so the packaged Electron app
+ * is self-contained (loaded via file://, no separate web server needed).
+ *
+ * Fabric.Frontend is the sibling submodule under the parent Fabric repo.
+ */
+import { execSync } from 'node:child_process'
+import fs from 'node:fs'
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const DESKTOP = path.resolve(__dirname, '..')
+const FRONTEND = path.resolve(DESKTOP, '..', 'Fabric.Frontend')
+const SRC = path.join(FRONTEND, 'dist-desktop')
+const DEST = path.join(DESKTOP, 'renderer')
+
+if (!fs.existsSync(FRONTEND)) {
+  console.error(`[build-renderer] Fabric.Frontend not found at ${FRONTEND}`)
+  process.exit(1)
+}
+
+console.log('[build-renderer] building frontend (relative base)…')
+execSync('npm install --no-audit --no-fund', { cwd: FRONTEND, stdio: 'inherit' })
+execSync('npm run build:desktop', { cwd: FRONTEND, stdio: 'inherit' })
+
+if (!fs.existsSync(path.join(SRC, 'index.html'))) {
+  console.error(`[build-renderer] expected ${SRC}/index.html after build`)
+  process.exit(1)
+}
+
+fs.rmSync(DEST, { recursive: true, force: true })
+fs.cpSync(SRC, DEST, { recursive: true })
+console.log(`[build-renderer] copied ${SRC} -> ${DEST}`)