docs: rewrite README to match current architecture

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

.gitignore

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

README.md

@@ -1,28 +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
+## Build / package
 
 ```bash
-npm start
+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/`.
+
+## Notes
+
+- 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

@@ -1,10 +1,18 @@
-const { app, BrowserWindow, Menu, ipcMain, Notification, shell } = require('electron')
+const { app, BrowserWindow, Menu, Tray, ipcMain, Notification, nativeImage, shell } = require('electron')
 const fs = require('fs')
 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
+let isQuitting = false
 
 function configPath() {
   return path.join(app.getPath('userData'), 'fabric-desktop.config.json')
@@ -56,6 +64,7 @@ function createWindow() {
     minWidth: 1024,
     minHeight: 700,
     title: 'Fabric Desktop',
+    icon: path.join(__dirname, 'assets/icon.png'),
     autoHideMenuBar: false,
     webPreferences: {
       contextIsolation: true,
@@ -81,11 +90,70 @@ function createWindow() {
   } else {
     win.loadFile(DEFAULT_PROD_ENTRY)
   }
+
+  win.on('close', (event) => {
+    if (!isQuitting) {
+      event.preventDefault()
+      win.hide()
+    }
+  })
+
+  return win
+}
+
+function createTrayIcon() {
+  if (tray) return tray
+
+  const icon = nativeImage.createFromPath(path.join(__dirname, 'assets/tray.png'))
+
+  tray = new Tray(icon)
+  tray.setToolTip('Fabric Desktop')
+
+  const buildTrayMenu = () =>
+    Menu.buildFromTemplate([
+      {
+        label: mainWindow?.isVisible() ? '隐藏窗口' : '显示窗口',
+        click: () => {
+          if (!mainWindow) {
+            mainWindow = createWindow()
+            return
+          }
+          if (mainWindow.isVisible()) mainWindow.hide()
+          else {
+            mainWindow.show()
+            mainWindow.focus()
+          }
+          tray.setContextMenu(buildTrayMenu())
+        },
+      },
+      {
+        label: '退出',
+        click: () => {
+          isQuitting = true
+          app.quit()
+        },
+      },
+    ])
+
+  tray.setContextMenu(buildTrayMenu())
+
+  tray.on('double-click', () => {
+    if (!mainWindow) {
+      mainWindow = createWindow()
+      return
+    }
+    mainWindow.show()
+    mainWindow.focus()
+    tray.setContextMenu(buildTrayMenu())
+  })
+
+  return tray
 }
 
 app.whenReady().then(() => {
   createMenu()
-  createWindow()
+  mainWindow = createWindow()
+  createTrayIcon()
 
   ipcMain.handle('fabric:config:get', () => readConfig())
   ipcMain.handle('fabric:config:set', (_evt, next) => writeConfig(next || {}))
@@ -100,10 +168,15 @@ app.whenReady().then(() => {
   })
 
   app.on('activate', () => {
-    if (BrowserWindow.getAllWindows().length === 0) createWindow()
+    if (BrowserWindow.getAllWindows().length === 0) mainWindow = createWindow()
+    else if (mainWindow && !mainWindow.isVisible()) mainWindow.show()
+  })
+
+  app.on('before-quit', () => {
+    isQuitting = true
   })
 })
 
 app.on('window-all-closed', () => {
-  if (process.platform !== 'darwin') app.quit()
+  // 保持后台驻留，由托盘控制退出
 })

package.json

@@ -2,12 +2,71 @@
   "name": "fabric-desktop",
   "version": "0.1.0",
   "private": true,
+  "description": "Electron desktop shell for Fabric frontend.",
+  "homepage": "https://github.com/hangman0414/Fabric",
+  "author": {
+    "name": "Hangman",
+    "email": "noreply@hangman-lab.top"
+  },
   "main": "main.js",
   "scripts": {
     "start": "electron .",
-    "start:dev": "FABRIC_DESKTOP_URL=http://localhost:5173 electron ."
+    "start:dev": "FABRIC_DESKTOP_URL=http://localhost:5173 electron .",
+    "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"
+    "electron": "^37.2.1",
+    "electron-builder": "^24.13.3"
+  },
+  "build": {
+    "appId": "ai.hangman.fabric.desktop",
+    "productName": "Fabric",
+    "artifactName": "Fabric-Desktop-${version}-${os}-${arch}.${ext}",
+    "directories": {
+      "output": "dist"
+    },
+    "files": [
+      "main.js",
+      "preload.js",
+      "offline.html",
+      "package.json",
+      "assets/**",
+      "renderer/**"
+    ],
+    "asar": true,
+    "icon": "build/icon.png",
+    "linux": {
+      "target": [
+        "AppImage",
+        "deb",
+        "tar.gz"
+      ],
+      "category": "Utility",
+      "maintainer": "Hangman <noreply@hangman-lab.top>",
+      "executableName": "fabric-desktop",
+      "icon": "build/icons",
+      "desktop": {
+        "Name": "Fabric Desktop",
+        "StartupWMClass": "Fabric Desktop"
+      }
+    },
+    "mac": {
+      "target": [
+        "dmg",
+        "zip"
+      ],
+      "category": "public.app-category.productivity"
+    },
+    "win": {
+      "target": [
+        "nsis",
+        "zip"
+      ]
+    }
   }
 }

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}`)