🔀 merge: 性能与模块化优化方案（7 阶段 24 任务全部完成）

合并 feature/perf-modular-optimization（39 commits / 176 files）

性能基线对比（brotli）：
- entry:       72 KB  → 25.14 KB（-65%）
- vendor:    1.27 MB  → 58.38 KB（-95%）
- game-runtime: 636 KB  → 377 KB（-41%）
- entry raw: 326 KB   → 100 KB（-69%）

关键产出：
- vite manualChunks 拆 6 块 vendor + 5 块 game-runtime + 5 块 settings
- 异步 NSFW 注册（按 gameConfig 激活，修复原配置路径错误）
- useGame 130 文件领域重组 + 6 Zustand slice 骨架 + FACADE.md
- 路由级 code splitting（Landing/NewGame/Game 三视图独立）
- js-tiktoken 移除（节省 1.19 MB brotli）
- size-limit + Lighthouse CI 双层防护
- 155 个 feature flag 全面盘点

参考：docs/technical/13b-performance-modularization.md

Author: oneMuggle

.github/workflows/ci.yml

@@ -7,6 +7,30 @@ on:
     branches: [main]
 
 jobs:
+  build:
+    name: Build & Bundle Size
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Check bundle size (size-limit)
+        run: npm run size
+
   vitest:
     name: Unit Tests (Vitest)
     runs-on: ubuntu-latest

.github/workflows/lighthouse.yml

@@ -0,0 +1,34 @@
+name: Lighthouse CI
+
+on:
+  pull_request:
+    branches: [main]
+  push:
+    branches: [main]
+
+jobs:
+  lighthouse:
+    name: Lighthouse Performance Audit
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Run Lighthouse CI
+        run: npx lhci autorun
+        env:
+          LHCI_GITHUB_APP_TOKEN: ${{ secrets.LHCI_GITHUB_APP_TOKEN }}

.gitignore

@@ -1,5 +1,6 @@
 # Dependencies
 /node_modules/
+**/node_modules/
 
 # Build outputs
 /dist/
@@ -28,7 +29,9 @@ pnpm-debug.log*
 lerna-debug.log*
 
 # Generated reports, temp workspaces, and local analysis outputs
-/artifacts/
+/artifacts/*
+!/artifacts/baseline-*.json
+!/artifacts/build-*.txt
 /.tmp*/
 /clean_diff.txt
 /diff.txt

App.tsx

@@ -0,0 +1,96 @@
+{
+  "metadata": {
+    "collectedAt": "2026-06-04T08:42:54.270Z",
+    "phase": "0.3",
+    "branch": "feature/perf-modular-optimization",
+    "script": "node scripts/collectMetricsBaseline.mjs",
+    "command": "npm run metrics:baseline",
+    "supplementalCommands": [
+      "npm run size",
+      "find . -type f \\( -name '*.ts' -o -name '*.tsx' \\) [excludes]"
+    ]
+  },
+  "bundle": {
+    "source": "size-limit (npm run size)",
+    "entry": {
+      "sizeLimit": "350 kB",
+      "size": "72.03 kB",
+      "loadingTime": "1.5 s on slow 3G",
+      "runningTime": "48 ms on Snapdragon 410"
+    },
+    "vendor": {
+      "sizeLimit": "3.7 MB",
+      "size": "1.27 MB",
+      "loadingTime": "24.9 s on slow 3G",
+      "runningTime": "112 ms on Snapdragon 410"
+    },
+    "gameRuntime": {
+      "sizeLimit": "3 MB",
+      "size": "636.56 kB",
+      "loadingTime": "12.5 s on slow 3G",
+      "runningTime": "81 ms on Snapdragon 410"
+    }
+  },
+  "codeStats": {
+    "tsTsxFileCount": 2916,
+    "tsTsxLineCount": 1020698,
+    "note": "Includes all .ts/.tsx under project root, excluding node_modules/.git/dist/coverage/.tmp"
+  },
+  "circularDependencies": {
+    "tool": "madge",
+    "filesProcessed": 1501,
+    "circularCount": 15,
+    "warnings": 74,
+    "ok": false,
+    "exitCode": 1,
+    "detailsFile": ".tmp/baseline-circular.txt"
+  },
+  "deadExports": {
+    "tool": "ts-prune",
+    "deadExportCount": 5615,
+    "ok": true,
+    "exitCode": 0,
+    "detailsFile": ".tmp/baseline-dead.txt"
+  },
+  "unusedCode": {
+    "tool": "knip",
+    "unusedFiles": 420,
+    "unusedExports": 1415,
+    "unusedExportedTypes": 1032,
+    "unusedDevDependencies": 5,
+    "unusedDevDependenciesList": [
+      "@alloc/quick-lru",
+      "@testing-library/jest-dom",
+      "ast-grep",
+      "depcheck",
+      "tslib"
+    ],
+    "unlistedBinaries": 1,
+    "unlistedBinariesList": [
+      "wrangler (.github/workflows/deploy.yml)"
+    ],
+    "ok": false,
+    "exitCode": 1,
+    "detailsFile": ".tmp/baseline-unused.txt"
+  },
+  "tests": {
+    "tool": "vitest run + manual glob",
+    "testFiles": 96,
+    "testCases": 2137,
+    "vitestResult": {
+      "testFilesPassed": 96,
+      "testsPassed": 2149,
+      "duration": "69.27s"
+    },
+    "ok": true,
+    "exitCode": 0,
+    "detailsFile": ".tmp/baseline-tests.txt"
+  },
+  "summary": {
+    "totalSteps": 5,
+    "okSteps": 3,
+    "failSteps": 2,
+    "failSoftTools": ["madge", "knip"],
+    "notes": "Script uses fail-soft: madge and knip exited non-zero but their raw output is captured for review. Follow-up phases can decide whether to remediate or document the failures."
+  }
+}

artifacts/baseline-2026-06-04.json

@@ -16,7 +16,7 @@ import { GalgameView } from './GalgameView';
 import { MobileGalgameView } from '../features/Galgame/mobile/MobileGalgameView';
 import { 懒加载边界, MobileMusicPlayer } from '../features/lazyComponents';
 import { useGalgameEngine } from '../../hooks/useGalgameEngine';
-import { getCurrentMode, switchMode } from '../../hooks/useGame/modeManager';
+import { getCurrentMode, switchMode } from '../../hooks/useGame/engine/modeManager';
 
 // ============================================================================
 // 类型

artifacts/build-2026-06-04.txt

@@ -6,7 +6,7 @@ import {
     执行战斗行动,
     战斗行动选项,
     战斗行动结果,
-} from '../../../hooks/useGame/combatCalculation';
+} from '../../../hooks/useGame/combat/combatCalculation';
 import { IconSwords, IconShield, IconPotion } from '../../ui/Icons';
 
 interface Props {

components/app/GameView.tsx

@@ -3,7 +3,7 @@ import { 角色数据结构, 战斗状态结构 } from '../../../types';
 import { IconSwords, IconYinYang } from '../../ui/Icons';
 import BattleActionPanel from './BattleActionPanel';
 import { RpgBattleIntegration, shouldUseRpgBattle } from './RpgBattleIntegration';
-import { 战斗行动结果 } from '../../../hooks/useGame/combatCalculation';
+import { 战斗行动结果 } from '../../../hooks/useGame/combat/combatCalculation';
 
 interface Props {
     character: 角色数据结构;

components/features/Battle/BattleActionPanel.tsx

@@ -5,7 +5,7 @@ import type { 论坛帖子 } from '../../../../models/campusPhone';
 import type { BDSM论坛帖子, BDSM帖子分类, 联系对话, 联系状态 } from '../../../../models/campusNSFW/bdsm-forum';
 import type { NPC结构 } from '../../../../models/social';
 import type { 当前可用接口结构 } from '../../../../utils/apiConfig';
-import { 从BDSM帖子创建NPC } from '../../../../hooks/useGame/bdsmForumEngine';
+import { 从BDSM帖子创建NPC } from '../../../../hooks/useGame/nsfw/bdsmForumEngine';
 import BDSMContactModal from './BDSMContactModal';
 
 type ApiConfigLike = 当前可用接口结构 | Record<string, unknown>;