From f33cfab0d5fb3a23d5bb038057c23044af8dc642 Mon Sep 17 00:00:00 2001
From: bridge <wangxin4qiao@163.com>
Date: Sun, 11 Jan 2026 22:08:01 +0800
Subject: [PATCH] refactor frontend (not done)

---
 src/server/main.py                            | 102 ++++++++++--
 tools/package/compress.ps1                    |  12 ++
 web/src/App.vue                               |  79 ++++++++-
 web/src/api/game.ts                           |  36 ++++-
 web/src/components/LoadingOverlay.vue         |   6 +-
 web/src/components/SystemMenu.vue             |  42 ++++-
 .../game/composables/useTextures.ts           |  45 ++++--
 .../game/panels/system/GameStartPanel.vue     | 152 ++++++++++++++++++
 .../game/panels/system/LLMConfigPanel.vue     |   5 +
 9 files changed, 440 insertions(+), 39 deletions(-)
 create mode 100644 web/src/components/game/panels/system/GameStartPanel.vue

diff --git a/src/server/main.py b/src/server/main.py
index b74e50c..ab1de65 100644
--- a/src/server/main.py
+++ b/src/server/main.py
@@ -20,7 +20,7 @@ from src.classes.world import World
 from src.classes.calendar import Month, Year, create_month_stamp
 from src.run.load_map import load_cultivation_world_map
 from src.sim.new_avatar import make_avatars as _new_make_random, create_avatar_from_request
-from src.utils.config import CONFIG
+from src.utils.config import CONFIG, load_config
 from src.classes.sect import sects_by_id
 from src.classes.technique import techniques_by_id
 from src.classes.weapon import weapons_by_id
@@ -536,10 +536,9 @@ async def game_loop():
 
 @asynccontextmanager
 async def lifespan(app: FastAPI):
-    # 启动时自动开始异步初始化游戏
-    # 前端会轮询 /api/init-status 来显示加载进度
-    print("服务器启动，开始异步初始化游戏...")
-    asyncio.create_task(init_game_async())
+    # 启动时不再自动开始初始化游戏，等待前端指令
+    # 保持 init_status 为 idle
+    print("服务器启动，等待开始游戏指令...")
     
     # 启动后台游戏循环（会自动等待初始化完成）
     asyncio.create_task(game_loop())
@@ -900,22 +899,97 @@ def get_init_status():
     }
 
 
-@app.post("/api/game/new")
-async def start_new_game():
-    """开始新游戏（异步初始化）。"""
+# --- 开局配置与启动 API ---
+
+class GameStartRequest(BaseModel):
+    init_npc_num: int
+    sect_num: int
+    protagonist: str
+    npc_awakening_rate_per_month: float
+
+@app.get("/api/config/current")
+def get_current_config():
+    """获取当前游戏配置（用于回显）"""
+    return {
+        "game": {
+            "init_npc_num": getattr(CONFIG.game, "init_npc_num", 12),
+            "sect_num": getattr(CONFIG.game, "sect_num", 3),
+            "npc_awakening_rate_per_month": getattr(CONFIG.game, "npc_awakening_rate_per_month", 0.01)
+        },
+        "avatar": {
+            "protagonist": getattr(CONFIG.avatar, "protagonist", "none")
+        }
+    }
+
+@app.get("/api/config/llm/status")
+def get_llm_status():
+    """获取 LLM 配置状态"""
+    key = getattr(CONFIG.llm, "key", "")
+    base_url = getattr(CONFIG.llm, "base_url", "")
+    return {
+        "configured": bool(key and base_url)
+    }
+
+@app.post("/api/game/start")
+async def start_game(req: GameStartRequest):
+    """
+    保存配置并开始新游戏。
+    """
     current_status = game_instance.get("init_status", "idle")
-    
-    # 如果已经在初始化中，返回错误
     if current_status == "in_progress":
         raise HTTPException(status_code=400, detail="Game is already initializing")
+
+    # 1. 保存到 local_config.yml
+    local_config_path = "static/local_config.yml"
     
-    # 如果已经初始化完成，需要重置
+    # 读取现有 local_config 或创建新的
+    if os.path.exists(local_config_path):
+        conf = OmegaConf.load(local_config_path)
+    else:
+        conf = OmegaConf.create({})
+    
+    # 确保结构存在
+    if "game" not in conf: conf.game = {}
+    if "avatar" not in conf: conf.avatar = {}
+    
+    # 更新值
+    conf.game.init_npc_num = req.init_npc_num
+    conf.game.sect_num = req.sect_num
+    conf.game.npc_awakening_rate_per_month = req.npc_awakening_rate_per_month
+    conf.avatar.protagonist = req.protagonist
+    
+    # 写入文件
+    try:
+        OmegaConf.save(conf, local_config_path)
+    except Exception as e:
+        print(f"Error saving local config: {e}")
+        # Log but continue? Or fail? Best to fail if we promised to save.
+        raise HTTPException(status_code=500, detail=f"Failed to save config: {e}")
+
+    # 2. 重新加载全局 CONFIG
+    global CONFIG
+    try:
+        # 重新执行 load_config
+        new_config = load_config()
+        # 更新 CONFIG 引用 (OmegaConf 对象是可变的吗？ load_config 返回新对象)
+        # 我们不能简单替换 import 的 CONFIG，因为其他模块可能已经 import 了它。
+        # OmegaConf.merge 是原地更新吗？ 不是。
+        # 这是一个常见坑。最好的方式是修改 CONFIG 的内容而不是替换对象。
+        # 但 CONFIG 是 DictConfig。
+        
+        # 让我们尝试更新 CONFIG 的内容
+        # 更好的方法可能是：
+        CONFIG.merge_with(new_config) 
+        
+    except Exception as e:
+        print(f"Error reloading config: {e}")
+    
+    # 3. 开始初始化
     if current_status == "ready":
         # 清理旧的游戏状态
         game_instance["world"] = None
         game_instance["sim"] = None
     
-    # 重置初始化状态
     game_instance["init_status"] = "pending"
     game_instance["init_phase"] = 0
     game_instance["init_progress"] = 0
@@ -924,7 +998,7 @@ async def start_new_game():
     # 启动异步初始化任务
     asyncio.create_task(init_game_async())
     
-    return {"status": "ok", "message": "New game initialization started"}
+    return {"status": "ok", "message": "Game initialization started"}
 
 
 @app.post("/api/control/reinit")
@@ -1537,4 +1611,4 @@ def start():
     uvicorn.run(app, host="127.0.0.1", port=8002)
 
 if __name__ == "__main__":
-    start()
+    start()
\ No newline at end of file
diff --git a/tools/package/compress.ps1 b/tools/package/compress.ps1
index 9751f3a..7b88a33 100644
--- a/tools/package/compress.ps1
+++ b/tools/package/compress.ps1
@@ -76,6 +76,18 @@ if ($LogFiles) {
     }
 }
 
+# 4.3 Remove saves directories (Recursively)
+# Deletes 'saves' folder in root and inside '_internal' (and any save files within)
+$SaveDirs = Get-ChildItem -Path $SourceDir -Include "saves" -Recurse -Directory -Force
+if ($SaveDirs) {
+    foreach ($dir in $SaveDirs) {
+        if (Test-Path $dir.FullName) {
+            Remove-Item -Path $dir.FullName -Recurse -Force
+            Write-Host "  [-] Deleted Saves Dir: $($dir.FullName)" -ForegroundColor DarkGray
+        }
+    }
+}
+
 # ==============================================================================
 # 5. Compress
 # ==============================================================================
diff --git a/web/src/App.vue b/web/src/App.vue
index 9575046..7d46744 100644
--- a/web/src/App.vue
+++ b/web/src/App.vue
@@ -1,6 +1,6 @@
 <script setup lang="ts">
 import { onMounted, onUnmounted, ref, watch, computed } from 'vue'
-import { NConfigProvider, darkTheme, NMessageProvider } from 'naive-ui'
+import { NConfigProvider, darkTheme, NMessageProvider, createDiscreteApi } from 'naive-ui'
 import { useWorldStore } from './stores/world'
 import { useUiStore } from './stores/ui'
 import { useSocketStore } from './stores/socket'
@@ -23,14 +23,22 @@ const initStatus = ref<InitStatusDTO | null>(null)
 const gameInitialized = ref(false)
 const mapPreloaded = ref(false)
 let pollInterval: ReturnType<typeof setInterval> | null = null
+const canCloseMenu = ref(true)
+const { message } = createDiscreteApi(['message'], {
+  configProviderProps: {
+    theme: darkTheme
+  }
+})
 
 // 根据 spec: showLoading = initStatus !== 'ready'
 // 注意：
 // 1. initStatus 为 null 时显示加载界面（还没获取到状态）
-// 2. initStatus 不是 ready 时显示加载界面
-// 3. 前端还没初始化完成时也要显示加载界面
+// 2. initStatus 不是 ready 且不是 idle 时显示加载界面
+// 3. 前端还没初始化完成时也要显示加载界面（如果后端 ready）
 const showLoading = computed(() => {
   if (initStatus.value === null) return true
+  // idle 状态下，不显示全屏 loading，而是显示菜单供用户配置
+  if (initStatus.value.status === 'idle') return false
   if (initStatus.value.status !== 'ready') return true
   if (!gameInitialized.value) return true
   return false
@@ -38,7 +46,7 @@ const showLoading = computed(() => {
 
 const showMenu = ref(false)
 const isManualPaused = ref(true)
-const menuDefaultTab = ref<'save' | 'load' | 'create' | 'delete' | 'llm'>('load')
+const menuDefaultTab = ref<'save' | 'load' | 'create' | 'delete' | 'llm' | 'start'>('load')
 
 // 可以提前加载地图的阶段（宗门初始化后地图数据就 ready 了）。
 const MAP_READY_PHASES = ['initializing_sects', 'generating_avatars', 'checking_llm', 'generating_initial_events']
@@ -54,6 +62,12 @@ async function pollInitStatus() {
     const prevStatus = initStatus.value?.status
     initStatus.value = res
     
+    // 如果是从 null -> idle，或者一直保持 idle 但菜单没打开
+    // 这里我们只在第一次检测到 idle 时执行启动检查
+    if (res.status === 'idle' && !showMenu.value && prevStatus !== 'idle') {
+      performStartupCheck()
+    }
+
     // 提前加载地图：当进入特定阶段且还没预加载过时。
     if (!mapPreloaded.value && MAP_READY_PHASES.includes(res.phase_name)) {
       mapPreloaded.value = true
@@ -72,12 +86,60 @@ async function pollInitStatus() {
       await initializeGame()
       // ready 后停止轮询
       stopPolling()
+      // 游戏准备就绪，关闭菜单
+      showMenu.value = false
     }
   } catch (e) {
     console.error('Failed to fetch init status:', e)
   }
 }
 
+async function performStartupCheck() {
+  try {
+    const res = await gameApi.fetchLLMStatus()
+    
+    if (!res.configured) {
+      // 未配置 -> 强制进入 LLM 配置，禁止关闭
+      showMenu.value = true
+      menuDefaultTab.value = 'llm'
+      canCloseMenu.value = false
+      message.warning('检测到 LLM 未配置，请先完成设置')
+    } else {
+      // 已配置 -> 验证连通性
+      try {
+        const configRes = await gameApi.fetchLLMConfig()
+        await gameApi.testLLMConnection(configRes)
+        
+        // 测试通过 -> 允许进入开始游戏
+        menuDefaultTab.value = 'start'
+        canCloseMenu.value = true
+        // 确保菜单显示在 Start 页
+        showMenu.value = true
+      } catch (connErr) {
+        // 连接失败 -> 强制进入配置
+        console.error('LLM Connection check failed:', connErr)
+        showMenu.value = true
+        menuDefaultTab.value = 'llm'
+        canCloseMenu.value = false
+        message.error('LLM 连接测试失败，请重新配置')
+      }
+    }
+  } catch (e) {
+    console.error('Failed to check LLM status:', e)
+    // Fallback
+    showMenu.value = true
+    menuDefaultTab.value = 'llm'
+    canCloseMenu.value = false
+    message.error('无法获取系统状态')
+  }
+}
+
+function handleLLMReady() {
+  canCloseMenu.value = true
+  menuDefaultTab.value = 'start'
+  message.success('LLM 配置成功，请开始游戏')
+}
+
 async function initializeGame() {
   if (gameInitialized.value) {
     // 重新加载存档时，重新初始化
@@ -141,6 +203,10 @@ function handleKeydown(e: KeyboardEvent) {
       uiStore.clearSelection()
     } else {
       showMenu.value = !showMenu.value
+      // 如果打开菜单，默认切到 load (或者保持上一次的状态，这里暂定 load)
+      if (showMenu.value) {
+        menuDefaultTab.value = 'load'
+      }
     }
   }
 }
@@ -226,7 +292,10 @@ watch([showMenu, isManualPaused], ([menuVisible, manualPaused]) => {
         <SystemMenu 
           :visible="showMenu"
           :default-tab="menuDefaultTab"
+          :game-initialized="gameInitialized"
+          :closable="canCloseMenu"
           @close="handleMenuClose"
+          @llm-ready="handleLLMReady"
         />
       </div>
     </n-message-provider>
@@ -316,4 +385,4 @@ watch([showMenu, isManualPaused], ([menuVisible, manualPaused]) => {
   flex-direction: column;
   z-index: 20;
 }
-</style>
+</style>
\ No newline at end of file
diff --git a/web/src/api/game.ts b/web/src/api/game.ts
index 1f048cc..70c9e92 100644
--- a/web/src/api/game.ts
+++ b/web/src/api/game.ts
@@ -66,6 +66,24 @@ export interface LLMConfigDTO {
   mode: string;
 }
 
+export interface GameStartConfigDTO {
+  init_npc_num: number;
+  sect_num: number;
+  protagonist: string;
+  npc_awakening_rate_per_month: number;
+}
+
+export interface CurrentConfigDTO {
+  game: {
+    init_npc_num: number;
+    sect_num: number;
+    npc_awakening_rate_per_month: number;
+  };
+  avatar: {
+    protagonist: string;
+  };
+}
+
 // --- Events Pagination ---
 
 export interface EventDTO {
@@ -117,7 +135,8 @@ export const gameApi = {
   },
 
   fetchAvatarMeta() {
-    return httpClient.get<{ males: number[]; females: number[] }>('/api/meta/avatars');
+    // Add timestamp to prevent caching
+    return httpClient.get<{ males: number[]; females: number[] }>(`/api/meta/avatars?t=${Date.now()}`);
   },
 
   fetchPhenomenaList() {
@@ -205,6 +224,10 @@ export const gameApi = {
   saveLLMConfig(config: LLMConfigDTO) {
     return httpClient.post<{ status: string; message: string }>('/api/config/llm/save', config);
   },
+  
+  fetchLLMStatus() {
+    return httpClient.get<{ configured: boolean }>('/api/config/llm/status');
+  },
 
   // --- Events Pagination ---
 
@@ -233,10 +256,21 @@ export const gameApi = {
   },
 
   startNewGame() {
+    // Legacy: replaced by startGame logic usually, but kept for compatibility if needed
     return httpClient.post<{ status: string; message: string }>('/api/game/new', {});
   },
 
   reinitGame() {
     return httpClient.post<{ status: string; message: string }>('/api/control/reinit', {});
+  },
+
+  // --- Game Start Config ---
+  
+  fetchCurrentConfig() {
+    return httpClient.get<CurrentConfigDTO>('/api/config/current');
+  },
+
+  startGame(config: GameStartConfigDTO) {
+    return httpClient.post<{ status: string; message: string }>('/api/game/start', config);
   }
 };
diff --git a/web/src/components/LoadingOverlay.vue b/web/src/components/LoadingOverlay.vue
index 6884a7e..3fb0406 100644
--- a/web/src/components/LoadingOverlay.vue
+++ b/web/src/components/LoadingOverlay.vue
@@ -42,17 +42,19 @@ const tips = [
   '天灵根角色在任何洞府修行，都事半功倍',
   '改变天地灵机，不仅会影响加成，还会微妙调整角色行事风格',
   '偶尔会有修仙小说中的主角穿越进此方世界',
-  '每个角色都有自己的思考和情绪',
+  '每个角色都有自己的真实思考和情绪',
   '除了修炼，炼丹和练气也很重要',
   '参加拍卖会可能捡漏，但要小心恶人的衔尾追杀',
   '江湖同道会根据你的行为取一个绰号',
   '双修虽好，还请克制',
   '在宗门驻地回血，可以回满HP',
-  '境界之间，战力差距极大，越阶挑战难于登天',
+  '不同境界之间，战力差距极大，越阶挑战难于登天',
   '天命之子特质的角色，好运连连，奇遇不断',
   '现代世界的穿越者，只想回到现实世界，但这是不可能的',
   '丹药有生效的时间限制',
   '由于大模型需要思考，游戏启动可能耗时较久',
+  '模拟世界对大模型token消耗较大，请注意',
+  '设定开局历史，世界也会随之而改变',
 ]
 
 const currentTip = ref(tips[Math.floor(Math.random() * tips.length)])
diff --git a/web/src/components/SystemMenu.vue b/web/src/components/SystemMenu.vue
index 49f3acd..dcc4d6a 100644
--- a/web/src/components/SystemMenu.vue
+++ b/web/src/components/SystemMenu.vue
@@ -4,17 +4,21 @@ import SaveLoadPanel from './game/panels/system/SaveLoadPanel.vue'
 import CreateAvatarPanel from './game/panels/system/CreateAvatarPanel.vue'
 import DeleteAvatarPanel from './game/panels/system/DeleteAvatarPanel.vue'
 import LLMConfigPanel from './game/panels/system/LLMConfigPanel.vue'
+import GameStartPanel from './game/panels/system/GameStartPanel.vue'
 
 const props = defineProps<{
   visible: boolean
-  defaultTab?: 'save' | 'load' | 'create' | 'delete' | 'llm'
+  defaultTab?: 'save' | 'load' | 'create' | 'delete' | 'llm' | 'start'
+  gameInitialized: boolean
+  closable?: boolean
 }>()
 
 const emit = defineEmits<{
   (e: 'close'): void
+  (e: 'llm-ready'): void
 }>()
 
-const activeTab = ref<'save' | 'load' | 'create' | 'delete' | 'llm'>(props.defaultTab || 'load')
+const activeTab = ref<'save' | 'load' | 'create' | 'delete' | 'llm' | 'start'>(props.defaultTab || 'load')
 
 function switchTab(tab: typeof activeTab.value) {
   activeTab.value = tab
@@ -40,10 +44,18 @@ watch(() => props.visible, (val) => {
     <div class="system-menu">
       <div class="menu-header">
         <h2>系统菜单</h2>
-        <button class="close-btn" @click="emit('close')">×</button>
+        <!-- 只有在游戏未开始且处于 start/llm 界面时才可能无法关闭（如果是强制引导） -->
+        <!-- 但为了用户体验，通常保留关闭按钮，用户如果没配置好就关闭，也只是回到 idle 状态的空界面 -->
+        <button class="close-btn" @click="emit('close')" v-if="closable !== false">×</button>
       </div>
       
       <div class="menu-tabs">
+        <button 
+          :class="{ active: activeTab === 'start' }"
+          @click="switchTab('start')"
+        >
+          开始游戏
+        </button>
         <button 
           :class="{ active: activeTab === 'load' }"
           @click="switchTab('load')"
@@ -53,18 +65,21 @@ watch(() => props.visible, (val) => {
         <button 
           :class="{ active: activeTab === 'save' }"
           @click="switchTab('save')"
+          :disabled="!gameInitialized"
         >
           保存游戏
         </button>
         <button 
           :class="{ active: activeTab === 'create' }"
           @click="switchTab('create')"
+          :disabled="!gameInitialized"
         >
           新建角色
         </button>
         <button 
           :class="{ active: activeTab === 'delete' }"
           @click="switchTab('delete')"
+          :disabled="!gameInitialized"
         >
           删除角色
         </button>
@@ -77,8 +92,13 @@ watch(() => props.visible, (val) => {
       </div>
 
       <div class="menu-content">
+        <GameStartPanel 
+          v-if="activeTab === 'start'" 
+          :readonly="gameInitialized"
+        />
+
         <SaveLoadPanel 
-          v-if="activeTab === 'save' || activeTab === 'load'" 
+          v-else-if="activeTab === 'save' || activeTab === 'load'" 
           :mode="activeTab === 'save' ? 'save' : 'load'"
           @close="emit('close')"
         />
@@ -87,12 +107,13 @@ watch(() => props.visible, (val) => {
           v-else-if="activeTab === 'create'" 
           @created="switchTab('create')" 
         />
-        <!-- Note: @created callback could switch to list or stay, 
-             currently it stays to allow creating more or just refreshes internal list -->
         
         <DeleteAvatarPanel v-else-if="activeTab === 'delete'" />
         
-        <LLMConfigPanel v-else-if="activeTab === 'llm'" />
+        <LLMConfigPanel 
+          v-else-if="activeTab === 'llm'" 
+          @config-saved="emit('llm-ready')"
+        />
       </div>
     </div>
   </div>
@@ -165,10 +186,15 @@ watch(() => props.visible, (val) => {
   font-size: 1em;
 }
 
-.menu-tabs button:hover {
+.menu-tabs button:hover:not(:disabled) {
   background: #2a2a2a;
 }
 
+.menu-tabs button:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
 .menu-tabs button.active {
   background: #1a1a1a;
   color: #fff;
diff --git a/web/src/components/game/composables/useTextures.ts b/web/src/components/game/composables/useTextures.ts
index a08cf51..ce712fa 100644
--- a/web/src/components/game/composables/useTextures.ts
+++ b/web/src/components/game/composables/useTextures.ts
@@ -32,19 +32,46 @@ export function useTextures() {
   
   // 基础纹理加载（地图块、角色）
   const loadBaseTextures = async () => {
-    if (isLoaded.value) return
-
-    // Load Avatar Meta first
+    // 1. 获取最新的 Avatar Meta 并检查是否有变化
+    let metaChanged = false
     try {
         const meta = await gameApi.fetchAvatarMeta()
-        if (meta.males) availableAvatars.value.males = meta.males
-        if (meta.females) availableAvatars.value.females = meta.females
-        console.log('Avatar meta loaded:', availableAvatars.value)
+        
+        // 对比当前缓存的列表和新获取的列表
+        const newMalesStr = JSON.stringify(meta.males || [])
+        const curMalesStr = JSON.stringify(availableAvatars.value.males)
+        if (meta.males && newMalesStr !== curMalesStr) {
+            availableAvatars.value.males = meta.males
+            metaChanged = true
+        }
+
+        const newFemalesStr = JSON.stringify(meta.females || [])
+        const curFemalesStr = JSON.stringify(availableAvatars.value.females)
+        if (meta.females && newFemalesStr !== curFemalesStr) {
+            availableAvatars.value.females = meta.females
+            metaChanged = true
+        }
+        
+        if (metaChanged) {
+            console.log('Avatar meta updated:', availableAvatars.value)
+        }
     } catch (e) {
         console.warn('Failed to load avatar meta, using default range', e)
-        // Fallback
-        availableAvatars.value.males = Array.from({length: 47}, (_, i) => i + 1)
-        availableAvatars.value.females = Array.from({length: 41}, (_, i) => i + 1)
+        // Fallback: 只有在列表为空时才使用默认值
+        if (availableAvatars.value.males.length === 0) {
+            availableAvatars.value.males = Array.from({length: 47}, (_, i) => i + 1)
+            availableAvatars.value.females = Array.from({length: 41}, (_, i) => i + 1)
+            metaChanged = true
+        }
+    }
+
+    // 2. 如果已经加载过，且元数据没有变化，则跳过
+    // 注意：如果 metaChanged 为 true，即使 isLoaded 为 true 也要重新执行加载逻辑（Pixi Assets 会处理去重）
+    if (isLoaded.value && !metaChanged) {
+        // Double check if textures are actually loaded for current avatars
+        // This handles the case where meta didn't change (e.g. was fallback) but textures weren't loaded
+        const missingTexture = availableAvatars.value.males.some(id => !textures.value[`male_${id}`])
+        if (!missingTexture) return
     }
 
     const manifest: Record<string, string> = {
diff --git a/web/src/components/game/panels/system/GameStartPanel.vue b/web/src/components/game/panels/system/GameStartPanel.vue
new file mode 100644
index 0000000..8ea2871
--- /dev/null
+++ b/web/src/components/game/panels/system/GameStartPanel.vue
@@ -0,0 +1,152 @@
+<script setup lang="ts">
+import { ref, onMounted } from 'vue'
+import { NForm, NFormItem, NInputNumber, NSelect, NButton, useMessage } from 'naive-ui'
+import { gameApi } from '../../../../api/game'
+
+const props = defineProps<{
+  readonly: boolean
+}>()
+
+const message = useMessage()
+
+// 配置表单数据
+const config = ref({
+  init_npc_num: 12,
+  sect_num: 3,
+  protagonist: 'none',
+  npc_awakening_rate_per_month: 0.01
+})
+
+const loading = ref(false)
+
+// 选项
+const protagonistOptions = [
+  { label: '不引入主角', value: 'none' },
+  { label: '随机引入主角', value: 'random' },
+  { label: '全部引入主角', value: 'all' }
+]
+
+async function fetchConfig() {
+  try {
+    loading.value = true
+    const res = await gameApi.fetchCurrentConfig()
+    config.value = {
+      init_npc_num: res.game.init_npc_num,
+      sect_num: res.game.sect_num,
+      protagonist: res.avatar.protagonist,
+      npc_awakening_rate_per_month: res.game.npc_awakening_rate_per_month
+    }
+  } catch (e) {
+    message.error('加载配置失败')
+    console.error(e)
+  } finally {
+    loading.value = false
+  }
+}
+
+async function startGame() {
+  try {
+    loading.value = true
+    await gameApi.startGame(config.value)
+    message.success('配置已保存，正在初始化世界...')
+    // 父组件会通过 polling 检测到状态变化，从而自动关闭菜单并显示 loading
+  } catch (e) {
+    message.error('开始游戏失败')
+    console.error(e)
+    loading.value = false
+  }
+}
+
+onMounted(() => {
+  fetchConfig()
+})
+</script>
+
+<template>
+  <div class="game-start-panel">
+    <div class="panel-header">
+      <h3>开始游戏</h3>
+      <p class="description">设定世界的初始状态。注意：游戏开始后，这些设定将无法更改。</p>
+    </div>
+
+    <n-form
+      label-placement="left"
+      label-width="160"
+      require-mark-placement="right-hanging"
+      :disabled="readonly"
+    >
+      <n-form-item label="初始修士数量" path="init_npc_num">
+        <n-input-number v-model:value="config.init_npc_num" :min="0" :max="100" />
+      </n-form-item>
+
+      <n-form-item label="活跃宗门数量" path="sect_num">
+        <n-input-number v-model:value="config.sect_num" :min="0" :max="10" />
+      </n-form-item>
+      <div class="tip-text" style="margin-top: -12px;">
+        宗门数量建议少于角色数量的一半
+      </div>
+
+      <n-form-item label="主角引入模式" path="protagonist">
+        <n-select v-model:value="config.protagonist" :options="protagonistOptions" />
+      </n-form-item>
+      
+      <div class="tip-text" v-if="config.protagonist !== 'none'">
+        <span v-if="config.protagonist === 'random'">
+          随机引入：每次生成角色时，有 5% 的概率使用预设的“小说主角”模板。
+        </span>
+        <span v-if="config.protagonist === 'all'">
+          全部引入：开局时强制生成所有预设的“小说主角”。
+        </span>
+      </div>
+
+      <n-form-item label="每月新生修士概率" path="npc_awakening_rate_per_month">
+        <n-input-number 
+            v-model:value="config.npc_awakening_rate_per_month" 
+            :min="0" 
+            :max="1" 
+            :step="0.001"
+            :format="(val: number) => `${(val * 100).toFixed(1)}%`"
+            :parse="(val: string) => parseFloat(val) / 100"
+        />
+      </n-form-item>
+
+      <div class="actions" v-if="!readonly">
+        <n-button type="primary" size="large" @click="startGame" :loading="loading">
+          开始
+        </n-button>
+      </div>
+    </n-form>
+  </div>
+</template>
+
+<style scoped>
+.game-start-panel {
+  color: #eee;
+  max-width: 600px;
+  margin: 0 auto;
+}
+
+.panel-header {
+  margin-bottom: 2em;
+  text-align: center;
+}
+
+.description {
+  color: #888;
+  font-size: 0.9em;
+}
+
+.tip-text {
+  margin-left: 160px; /* offset label width */
+  margin-bottom: 24px;
+  color: #aaa;
+  font-size: 0.85em;
+  line-height: 1.5;
+}
+
+.actions {
+  display: flex;
+  justify-content: center;
+  margin-top: 2em;
+}
+</style>
\ No newline at end of file
diff --git a/web/src/components/game/panels/system/LLMConfigPanel.vue b/web/src/components/game/panels/system/LLMConfigPanel.vue
index bd3975c..74dfb6f 100644
--- a/web/src/components/game/panels/system/LLMConfigPanel.vue
+++ b/web/src/components/game/panels/system/LLMConfigPanel.vue
@@ -69,6 +69,10 @@ function applyPreset(preset: typeof presets[0]) {
   message.info(`已应用 ${preset.name} 预设 (请填写 API Key)`)
 }
 
+const emit = defineEmits<{
+  (e: 'config-saved'): void
+}>()
+
 async function handleTestAndSave() {
   if (!config.value.api_key) {
     message.warning('请填写 API Key')
@@ -88,6 +92,7 @@ async function handleTestAndSave() {
     // 2. 保存配置
     await gameApi.saveLLMConfig(config.value)
     message.success('配置已保存')
+    emit('config-saved')
   } catch (e: any) {
     message.error('测试或保存失败: ' + (e.response?.data?.detail || e.message))
   } finally {