refactor frontend (not done)

2026-01-11 22:29:53 +08:00
parent 08e28f52c7
commit 879a3c0d1f
24 changed files with 759 additions and 519 deletions
--- a/web/src/api/game.ts
+++ b/web/src/api/game.ts
@@ -1,277 +0,0 @@
-import { httpClient } from './http';
-import type { 
-  InitialStateDTO, 
-  MapResponseDTO, 
-  DetailResponseDTO,
-  SaveFileDTO
-} from '../types/api';
-
-export interface HoverParams {
-  type: string;
-  id: string;
-}
-
-// --- New Types ---
-
-export interface GameDataDTO {
-  sects: Array<{ id: number; name: string; alignment: string }>;
-  personas: Array<{ id: number; name: string; desc: string; rarity: string }>;
-  realms: string[];
-  techniques: Array<{ id: number; name: string; grade: string; attribute: string; sect: string | null }>;
-  weapons: Array<{ id: number; name: string; grade: string; type: string }>;
-  auxiliaries: Array<{ id: number; name: string; grade: string }>;
-  alignments: Array<{ value: string; label: string }>;
-}
-
-export interface SimpleAvatarDTO {
-  id: string;
-  name: string;
-  sect_name: string;
-  realm: string;
-  gender: string;
-  age: number;
-}
-
-export interface CreateAvatarParams {
-  surname?: string;
-  given_name?: string;
-  gender?: string;
-  age?: number;
-  level?: number;
-  sect_id?: number;
-  persona_ids?: number[];
-  pic_id?: number;
-  technique_id?: number;
-  weapon_id?: number;
-  auxiliary_id?: number;
-  alignment?: string;
-  appearance?: number;
-  relations?: Array<{ target_id: string; relation: string }>;
-}
-
-export interface PhenomenonDTO {
-  id: number;
-  name: string;
-  desc: string;
-  rarity: string;
-  duration_years: number;
-  effect_desc: string;
-}
-
-export interface LLMConfigDTO {
-  base_url: string;
-  api_key: string;
-  model_name: string;
-  fast_model_name: string;
-  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 {
-  id: string;
-  text: string;
-  content: string;
-  year: number;
-  month: number;
-  month_stamp: number;
-  related_avatar_ids: string[];
-  is_major: boolean;
-  is_story: boolean;
-  created_at: number;
-}
-
-export interface EventsResponseDTO {
-  events: EventDTO[];
-  next_cursor: string | null;
-  has_more: boolean;
-}
-
-export interface FetchEventsParams {
-  avatar_id?: string;
-  avatar_id_1?: string;
-  avatar_id_2?: string;
-  cursor?: string;
-  limit?: number;
-}
-
-export interface InitStatusDTO {
-  status: 'idle' | 'pending' | 'in_progress' | 'ready' | 'error';
-  phase: number;
-  phase_name: string;
-  progress: number;
-  elapsed_seconds: number;
-  error: string | null;
-  llm_check_failed: boolean;
-  llm_error_message: string;
-}
-
-export const gameApi = {
-  // --- World State ---
-  
-  fetchInitialState() {
-    return httpClient.get<InitialStateDTO>('/api/state');
-  },
-
-  fetchMap() {
-    return httpClient.get<MapResponseDTO>('/api/map');
-  },
-
-  fetchAvatarMeta() {
-    // Add timestamp to prevent caching
-    return httpClient.get<{ males: number[]; females: number[] }>(`/api/meta/avatars?t=${Date.now()}`);
-  },
-
-  fetchPhenomenaList() {
-    return httpClient.get<{ phenomena: PhenomenonDTO[] }>('/api/meta/phenomena');
-  },
-
-  setPhenomenon(id: number) {
-    return httpClient.post('/api/control/set_phenomenon', { id });
-  },
-
-  // --- Information ---
-
-  fetchDetailInfo(params: HoverParams) {
-    const query = new URLSearchParams(Object.entries(params));
-    return httpClient.get<DetailResponseDTO>(`/api/detail?${query}`);
-  },
-
-  // --- Actions ---
-
-  setLongTermObjective(avatarId: string, content: string) {
-    return httpClient.post('/api/action/set_long_term_objective', {
-      avatar_id: avatarId,
-      content
-    });
-  },
-
-  clearLongTermObjective(avatarId: string) {
-    return httpClient.post('/api/action/clear_long_term_objective', {
-      avatar_id: avatarId
-    });
-  },
-
-  // --- Controls ---
-
-  pauseGame() {
-    return httpClient.post('/api/control/pause', {});
-  },
-
-  resumeGame() {
-    return httpClient.post('/api/control/resume', {});
-  },
-
-  // --- Saves ---
-
-  fetchSaves() {
-    return httpClient.get<{ saves: SaveFileDTO[] }>('/api/saves');
-  },
-
-  saveGame(filename?: string) {
-    return httpClient.post<{ status: string; filename: string }>('/api/game/save', { filename });
-  },
-
-  loadGame(filename: string) {
-    return httpClient.post<{ status: string; message: string }>('/api/game/load', { filename });
-  },
-
-  // --- Avatar Management ---
-  
-  fetchGameData() {
-    return httpClient.get<GameDataDTO>('/api/meta/game_data');
-  },
-
-  fetchAvatarList() {
-    return httpClient.get<{ avatars: SimpleAvatarDTO[] }>('/api/meta/avatar_list');
-  },
-
-  createAvatar(params: CreateAvatarParams) {
-    return httpClient.post<{ status: string; message: string; avatar_id: string }>('/api/action/create_avatar', params);
-  },
-
-  deleteAvatar(avatarId: string) {
-    return httpClient.post<{ status: string; message: string }>('/api/action/delete_avatar', { avatar_id: avatarId });
-  },
-
-  // --- LLM Config ---
-
-  fetchLLMConfig() {
-    return httpClient.get<LLMConfigDTO>('/api/config/llm');
-  },
-
-  testLLMConnection(config: LLMConfigDTO) {
-    return httpClient.post<{ status: string; message: string }>('/api/config/llm/test', config);
-  },
-
-  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 ---
-
-  fetchEvents(params: FetchEventsParams = {}) {
-    const query = new URLSearchParams();
-    if (params.avatar_id) query.set('avatar_id', params.avatar_id);
-    if (params.avatar_id_1) query.set('avatar_id_1', params.avatar_id_1);
-    if (params.avatar_id_2) query.set('avatar_id_2', params.avatar_id_2);
-    if (params.cursor) query.set('cursor', params.cursor);
-    if (params.limit) query.set('limit', String(params.limit));
-    const qs = query.toString();
-    return httpClient.get<EventsResponseDTO>(`/api/events${qs ? '?' + qs : ''}`);
-  },
-
-  cleanupEvents(keepMajor = true, beforeMonthStamp?: number) {
-    const query = new URLSearchParams();
-    query.set('keep_major', String(keepMajor));
-    if (beforeMonthStamp !== undefined) query.set('before_month_stamp', String(beforeMonthStamp));
-    return httpClient.delete<{ deleted: number }>(`/api/events/cleanup?${query}`);
-  },
-
-  // --- Init Status ---
-
-  fetchInitStatus() {
-    return httpClient.get<InitStatusDTO>('/api/init-status');
-  },
-
-  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);
-  }
-};
--- a/web/src/api/index.ts
+++ b/web/src/api/index.ts
@@ -0,0 +1,9 @@
+// 导出子模块
+export { worldApi } from './modules/world';
+export { avatarApi, type HoverParams } from './modules/avatar';
+export { systemApi } from './modules/system';
+export { llmApi } from './modules/llm';
+export { eventApi } from './modules/event';
+
+// 保持向后兼容的聚合对象 (Optional, for transition)
+// 但这次我们直接重构，不再保留大对象，鼓励按需引用
--- a/web/src/api/modules/avatar.ts
+++ b/web/src/api/modules/avatar.ts
@@ -0,0 +1,53 @@
+import { httpClient } from '../http';
+import type { 
+  DetailResponseDTO,
+  SimpleAvatarDTO,
+  CreateAvatarParams,
+  GameDataDTO
+} from '../../types/api';
+
+export interface HoverParams {
+  type: string;
+  id: string;
+}
+
+export const avatarApi = {
+  fetchAvatarMeta() {
+    // Add timestamp to prevent caching
+    return httpClient.get<{ males: number[]; females: number[] }>(`/api/meta/avatars?t=${Date.now()}`);
+  },
+
+  fetchDetailInfo(params: HoverParams) {
+    const query = new URLSearchParams(Object.entries(params));
+    return httpClient.get<DetailResponseDTO>(`/api/detail?${query}`);
+  },
+
+  setLongTermObjective(avatarId: string, content: string) {
+    return httpClient.post('/api/action/set_long_term_objective', {
+      avatar_id: avatarId,
+      content
+    });
+  },
+
+  clearLongTermObjective(avatarId: string) {
+    return httpClient.post('/api/action/clear_long_term_objective', {
+      avatar_id: avatarId
+    });
+  },
+
+  fetchGameData() {
+    return httpClient.get<GameDataDTO>('/api/meta/game_data');
+  },
+
+  fetchAvatarList() {
+    return httpClient.get<{ avatars: SimpleAvatarDTO[] }>('/api/meta/avatar_list');
+  },
+
+  createAvatar(params: CreateAvatarParams) {
+    return httpClient.post<{ status: string; message: string; avatar_id: string }>('/api/action/create_avatar', params);
+  },
+
+  deleteAvatar(avatarId: string) {
+    return httpClient.post<{ status: string; message: string }>('/api/action/delete_avatar', { avatar_id: avatarId });
+  }
+};
--- a/web/src/api/modules/event.ts
+++ b/web/src/api/modules/event.ts
@@ -0,0 +1,25 @@
+import { httpClient } from '../http';
+import type { 
+  EventsResponseDTO,
+  FetchEventsParams
+} from '../../types/api';
+
+export const eventApi = {
+  fetchEvents(params: FetchEventsParams = {}) {
+    const query = new URLSearchParams();
+    if (params.avatar_id) query.set('avatar_id', params.avatar_id);
+    if (params.avatar_id_1) query.set('avatar_id_1', params.avatar_id_1);
+    if (params.avatar_id_2) query.set('avatar_id_2', params.avatar_id_2);
+    if (params.cursor) query.set('cursor', params.cursor);
+    if (params.limit) query.set('limit', String(params.limit));
+    const qs = query.toString();
+    return httpClient.get<EventsResponseDTO>(`/api/events${qs ? '?' + qs : ''}`);
+  },
+
+  cleanupEvents(keepMajor = true, beforeMonthStamp?: number) {
+    const query = new URLSearchParams();
+    query.set('keep_major', String(keepMajor));
+    if (beforeMonthStamp !== undefined) query.set('before_month_stamp', String(beforeMonthStamp));
+    return httpClient.delete<{ deleted: number }>(`/api/events/cleanup?${query}`);
+  }
+};
--- a/web/src/api/modules/llm.ts
+++ b/web/src/api/modules/llm.ts
@@ -0,0 +1,20 @@
+import { httpClient } from '../http';
+import type { LLMConfigDTO } from '../../types/api';
+
+export const llmApi = {
+  fetchConfig() {
+    return httpClient.get<LLMConfigDTO>('/api/config/llm');
+  },
+
+  testConnection(config: LLMConfigDTO) {
+    return httpClient.post<{ status: string; message: string }>('/api/config/llm/test', config);
+  },
+
+  saveConfig(config: LLMConfigDTO) {
+    return httpClient.post<{ status: string; message: string }>('/api/config/llm/save', config);
+  },
+  
+  fetchStatus() {
+    return httpClient.get<{ configured: boolean }>('/api/config/llm/status');
+  }
+};
--- a/web/src/api/modules/system.ts
+++ b/web/src/api/modules/system.ts
@@ -0,0 +1,49 @@
+import { httpClient } from '../http';
+import type { 
+  SaveFileDTO,
+  InitStatusDTO,
+  GameStartConfigDTO,
+  CurrentConfigDTO
+} from '../../types/api';
+
+export const systemApi = {
+  pauseGame() {
+    return httpClient.post('/api/control/pause', {});
+  },
+
+  resumeGame() {
+    return httpClient.post('/api/control/resume', {});
+  },
+
+  fetchSaves() {
+    return httpClient.get<{ saves: SaveFileDTO[] }>('/api/saves');
+  },
+
+  saveGame(filename?: string) {
+    return httpClient.post<{ status: string; filename: string }>('/api/game/save', { filename });
+  },
+
+  loadGame(filename: string) {
+    return httpClient.post<{ status: string; message: string }>('/api/game/load', { filename });
+  },
+
+  fetchInitStatus() {
+    return httpClient.get<InitStatusDTO>('/api/init-status');
+  },
+
+  startNewGame() {
+    return httpClient.post<{ status: string; message: string }>('/api/game/new', {});
+  },
+
+  reinitGame() {
+    return httpClient.post<{ status: string; message: string }>('/api/control/reinit', {});
+  },
+
+  fetchCurrentConfig() {
+    return httpClient.get<CurrentConfigDTO>('/api/config/current');
+  },
+
+  startGame(config: GameStartConfigDTO) {
+    return httpClient.post<{ status: string; message: string }>('/api/game/start', config);
+  }
+};
--- a/web/src/api/modules/world.ts
+++ b/web/src/api/modules/world.ts
@@ -0,0 +1,24 @@
+import { httpClient } from '../http';
+import type { 
+  InitialStateDTO, 
+  MapResponseDTO, 
+  PhenomenonDTO
+} from '../../types/api';
+
+export const worldApi = {
+  fetchInitialState() {
+    return httpClient.get<InitialStateDTO>('/api/state');
+  },
+
+  fetchMap() {
+    return httpClient.get<MapResponseDTO>('/api/map');
+  },
+
+  fetchPhenomenaList() {
+    return httpClient.get<{ phenomena: PhenomenonDTO[] }>('/api/meta/phenomena');
+  },
+
+  setPhenomenon(id: number) {
+    return httpClient.post('/api/control/set_phenomenon', { id });
+  }
+};