xinyu-pro 0.21.0

package/lib/router-history.ts

@@ -0,0 +1,119 @@
+/**
+ * 路由历史栈 - 基于 localStorage 实现
+ *
+ * 用法：
+ *   import { useRouterHistory } from '@/lib/router-history';
+ *   const { push, back, canGoBack } = useRouterHistory();
+ *
+ *   // 跳转到新页面（自动将当前路径压入栈）
+ *   push('/extensions');
+ *
+ *   // 返回上一页（从栈中弹出）
+ *   back();
+ */
+
+const STORAGE_KEY = 'xinyu_route_history';
+
+function getStack(): string[] {
+  if (typeof window === 'undefined') return [];
+  try {
+    const raw = localStorage.getItem(STORAGE_KEY);
+    return raw ? JSON.parse(raw) : [];
+  } catch {
+    return [];
+  }
+}
+
+function setStack(stack: string[]) {
+  if (typeof window === 'undefined') return;
+  try {
+    localStorage.setItem(STORAGE_KEY, JSON.stringify(stack));
+  } catch {
+    // localStorage 满了或不可用时静默失败
+  }
+}
+
+/** 将当前路径压入路由栈（去重：如果栈顶已经是当前路径则不重复压入） */
+export function routeHistoryPush(currentPath: string) {
+  const stack = getStack();
+  // 去重：栈顶与当前路径相同则跳过
+  if (stack.length > 0 && stack[stack.length - 1] === currentPath) return;
+  // 限制栈深度，避免无限增长
+  if (stack.length >= 50) stack.shift();
+  stack.push(currentPath);
+  setStack(stack);
+}
+
+/** 从路由栈弹出并返回上一条路径，栈为空时返回 null */
+export function routeHistoryPop(): string | null {
+  const stack = getStack();
+  if (stack.length === 0) return null;
+  const prev = stack.pop()!;
+  setStack(stack);
+  return prev;
+}
+
+/** 查看栈顶路径但不弹出 */
+export function routeHistoryPeek(): string | null {
+  const stack = getStack();
+  return stack.length > 0 ? stack[stack.length - 1] : null;
+}
+
+/** 路由栈是否非空 */
+export function routeHistoryCanGoBack(): boolean {
+  return getStack().length > 0;
+}
+
+/** 清空路由栈 */
+export function routeHistoryClear() {
+  setStack([]);
+}
+
+/** 获取完整路由栈（调试用） */
+export function routeHistoryGetAll(): string[] {
+  return getStack();
+}
+
+import { useCallback } from 'react';
+import { useRouter as useNextRouter } from 'next/navigation';
+
+/**
+ * 自定义 Hook：封装路由跳转 + 历史栈管理
+ *
+ * - navigate(path): 跳转到目标页面，自动将当前路径压入栈
+ * - back(): 返回上一页，从栈中弹出路径并跳转
+ * - canGoBack: 是否可以返回
+ */
+export function useRouterHistory() {
+  const nextRouter = useNextRouter();
+
+  const navigate = useCallback(
+    (targetPath: string, {record = true, pop = false} = {}) => {
+      // 将当前路径压入栈
+      if (pop) {
+        routeHistoryPop();
+      }
+      if (typeof window !== 'undefined' && record) {
+        routeHistoryPush(window.location.pathname);
+      }
+      nextRouter.push(targetPath);
+    },
+    [nextRouter],
+  );
+
+  const back = useCallback(() => {
+    const prevPath = routeHistoryPop();
+    if (prevPath) {
+      nextRouter.push(prevPath);
+    } else {
+      // 栈为空时回退到首页
+      nextRouter.push('/');
+    }
+  }, [nextRouter]);
+
+  const canGoBack = useCallback(() => {
+    return routeHistoryCanGoBack();
+  }, []);
+
+  return { navigate, back, canGoBack };
+}

package/lib/storage.ts

@@ -0,0 +1,381 @@
+// lib/storage.ts - 数据存取封装
+// 游戏会话、世界卡片模板、应用设置 → 后端 MySQL API
+// 主题配置 → localStorage（纯客户端 UI 偏好）
+
+import { ThemeConfig, AppSettings, WorldCardTemplate } from './types';
+import { PluginManifest, PluginBinding } from './plugin-types';
+import { getDefaultThemeConfig } from './themes';
+
+// ==================== 主题相关（localStorage） ====================
+
+const THEME_CONFIG_KEY = 'xinyu-theme-config';
+
+/** 通用 localStorage 读取 */
+function getLocalItem<T>(key: string, fallback: T): T {
+  if (typeof window === 'undefined') return fallback;
+  try {
+    const raw = localStorage.getItem(key);
+    if (raw === null) return fallback;
+    return JSON.parse(raw) as T;
+  } catch {
+    return fallback;
+  }
+}
+
+/** 通用 localStorage 写入 */
+function setLocalItem<T>(key: string, value: T): void {
+  if (typeof window === 'undefined') return;
+  try {
+    localStorage.setItem(key, JSON.stringify(value));
+  } catch (e) {
+    console.error('Failed to write to localStorage:', e);
+  }
+}
+
+/** 读取主题配置 */
+export function getThemeConfig(): ThemeConfig {
+  return getLocalItem<ThemeConfig>(THEME_CONFIG_KEY, getDefaultThemeConfig());
+}
+
+/** 保存主题配置 */
+export function saveThemeConfig(config: ThemeConfig): void {
+  setLocalItem(THEME_CONFIG_KEY, config);
+}
+
+// ==================== 游戏会话相关（后端 API） ====================
+
+export interface StoredSession {
+  id: string;
+  worldSetting: Record<string, unknown>;
+  messages: Array<{ role: string; content: string }>;
+  createdAt: string;
+  updatedAt: string;
+}
+
+/** 读取所有游戏会话 */
+export async function getGameSessions(): Promise<StoredSession[]> {
+  try {
+    const res = await fetch('/api/sessions');
+    if (res.ok) {
+      return await res.json();
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
+
+/** 保存单个游戏会话（新增或更新） */
+export async function saveGameSession(session: StoredSession): Promise<void> {
+  try {
+    await fetch('/api/sessions', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(session),
+    });
+  } catch (e) {
+    console.error('Failed to save game session:', e);
+  }
+}
+
+/** 读取单个游戏会话 */
+export async function getGameSession(id: string): Promise<StoredSession | undefined> {
+  try {
+    const res = await fetch(`/api/sessions?id=${encodeURIComponent(id)}`);
+    if (res.ok) {
+      return await res.json();
+    }
+    return undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/** 删除游戏会话 */
+export async function deleteGameSession(id: string): Promise<void> {
+  try {
+    await fetch(`/api/sessions?id=${encodeURIComponent(id)}`, { method: 'DELETE' });
+  } catch (e) {
+    console.error('Failed to delete game session:', e);
+  }
+}
+
+/** 清除所有游戏会话 */
+export async function clearAllGameSessions(): Promise<void> {
+  try {
+    await fetch('/api/sessions?action=clearAll', { method: 'DELETE' });
+  } catch (e) {
+    console.error('Failed to clear all game sessions:', e);
+  }
+}
+
+// ==================== 应用设置相关（后端 API） ====================
+
+/** 默认应用设置 */
+export function getDefaultAppSettings(): AppSettings {
+  return {
+    aiApiKey: '',
+    aiApiBase: 'https://api.openai.com/v1',
+    aiModel: 'gpt-4o',
+    aiTemperature: 0.8,
+    aiMaxTokens: 1024,
+    systemPromptExtra: '',
+    maxHistorySessions: 50,
+    pluginToastEnabled: true,
+    pluginToastLevels: ['info', 'success', 'warning', 'error'],
+  };
+}
+
+/** 读取应用设置（从后端 API） */
+export async function getAppSettings(): Promise<AppSettings> {
+  try {
+    const res = await fetch('/api/settings');
+    if (res.ok) {
+      const data = await res.json();
+      if (data && !data.error) {
+        return { ...getDefaultAppSettings(), ...data };
+      }
+    }
+  } catch {
+    // ignore
+  }
+  return getDefaultAppSettings();
+}
+
+/** 保存应用设置（到后端 API） */
+export async function saveAppSettings(settings: AppSettings): Promise<boolean> {
+  try {
+    const res = await fetch('/api/settings', {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(settings),
+    });
+    return res.ok;
+  } catch {
+    return false;
+  }
+}
+
+// ==================== 世界卡片模板相关（后端 API） ====================
+
+/** 读取所有世界卡片模板 */
+export async function getWorldTemplates(): Promise<WorldCardTemplate[]> {
+  try {
+    const res = await fetch('/api/templates');
+    if (res.ok) {
+      return await res.json();
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
+
+/** 保存世界卡片模板（新增或更新） */
+export async function saveWorldTemplate(template: WorldCardTemplate): Promise<void> {
+  try {
+    await fetch('/api/templates', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(template),
+    });
+  } catch (e) {
+    console.error('Failed to save world template:', e);
+  }
+}
+
+/** 读取单个世界卡片模板 */
+export async function getWorldTemplate(id: string): Promise<WorldCardTemplate | undefined> {
+  try {
+    const res = await fetch(`/api/templates?id=${encodeURIComponent(id)}`);
+    if (res.ok) {
+      return await res.json();
+    }
+    return undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/** 删除世界卡片模板 */
+export async function deleteWorldTemplate(id: string): Promise<void> {
+  try {
+    await fetch(`/api/templates?id=${encodeURIComponent(id)}`, { method: 'DELETE' });
+  } catch (e) {
+    console.error('Failed to delete world template:', e);
+  }
+}
+
+// ==================== 插件相关（后端 API） ====================
+
+/** 读取所有插件 */
+export async function getPlugins(type?: string): Promise<PluginManifest[]> {
+  try {
+    const params = type ? `?type=${encodeURIComponent(type)}` : '';
+    const res = await fetch(`/api/plugins${params}`);
+    if (res.ok) {
+      return await res.json();
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
+
+/** 读取单个插件 */
+export async function getPlugin(id: string): Promise<PluginManifest | undefined> {
+  try {
+    const res = await fetch(`/api/plugins?id=${encodeURIComponent(id)}`);
+    if (res.ok) {
+      return await res.json();
+    }
+    return undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+/** 创建插件 */
+export async function createPlugin(plugin: PluginManifest): Promise<boolean> {
+  try {
+    const res = await fetch('/api/plugins', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(plugin),
+    });
+    return res.ok;
+  } catch (e) {
+    console.error('Failed to create plugin:', e);
+    return false;
+  }
+}
+
+/** 更新插件 */
+export async function updatePlugin(id: string, fields: Partial<PluginManifest> & { newId?: string }): Promise<boolean> {
+  try {
+    const { newId, ...restFields } = fields;
+    const body: Record<string, unknown> = { id, ...restFields };
+    if (newId) body.newId = newId;
+    const res = await fetch('/api/plugins', {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(body),
+    });
+    return res.ok;
+  } catch (e) {
+    console.error('Failed to update plugin:', e);
+    return false;
+  }
+}
+
+/** 删除插件 */
+export async function deletePlugin(id: string): Promise<void> {
+  try {
+    await fetch(`/api/plugins?id=${encodeURIComponent(id)}`, { method: 'DELETE' });
+  } catch (e) {
+    console.error('Failed to delete plugin:', e);
+  }
+}
+
+/** 获取插件绑定列表 */
+export async function getPluginBindings(scope?: string, worldId?: string): Promise<PluginBinding[]> {
+  try {
+    const params = new URLSearchParams();
+    if (scope) params.set('scope', scope);
+    if (worldId) params.set('worldId', worldId);
+    const query = params.toString();
+    const res = await fetch(`/api/plugins/bindings${query ? `?${query}` : ''}`);
+    if (res.ok) {
+      return await res.json();
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
+
+/** 创建或更新插件绑定 */
+export async function upsertPluginBinding(binding: Partial<PluginBinding>): Promise<boolean> {
+  try {
+    const res = await fetch('/api/plugins/bindings', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(binding),
+    });
+    return res.ok;
+  } catch (e) {
+    console.error('Failed to upsert plugin binding:', e);
+    return false;
+  }
+}
+
+/** 更新插件绑定 */
+export async function updatePluginBinding(id: number, fields: Partial<PluginBinding>): Promise<boolean> {
+  try {
+    const res = await fetch('/api/plugins/bindings', {
+      method: 'PUT',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ id, ...fields }),
+    });
+    return res.ok;
+  } catch (e) {
+    console.error('Failed to update plugin binding:', e);
+    return false;
+  }
+}
+
+/** 删除插件绑定 */
+export async function deletePluginBinding(id: number): Promise<void> {
+  try {
+    await fetch(`/api/plugins/bindings?id=${id}`, { method: 'DELETE' });
+  } catch (e) {
+    console.error('Failed to delete plugin binding:', e);
+  }
+}
+
+/** 导出所有插件 */
+export async function exportPlugins(): Promise<string> {
+  try {
+    const res = await fetch('/api/plugins/export');
+    if (res.ok) {
+      return await res.text();
+    }
+    return '[]';
+  } catch {
+    return '[]';
+  }
+}
+
+/** 导入插件 */
+export async function importPlugins(data: unknown): Promise<{ imported: number; skipped: number; total: number }> {
+  try {
+    const res = await fetch('/api/plugins/import', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(data),
+    });
+    if (res.ok) {
+      return await res.json();
+    }
+    return { imported: 0, skipped: 0, total: 0 };
+  } catch {
+    return { imported: 0, skipped: 0, total: 0 };
+  }
+}
+
+/** AI 安全检测 */
+export async function scanPluginSecurity(code: string, manifest?: Partial<PluginManifest>): Promise<import('./plugin-types').SecurityScanResult | null> {
+  try {
+    const res = await fetch('/api/plugins/scan', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ code, manifest }),
+    });
+    if (res.ok) {
+      return await res.json();
+    }
+    return null;
+  } catch {
+    return null;
+  }
+}

package/lib/themes.ts

@@ -0,0 +1,129 @@
+// lib/themes.ts - 主题定义（预设主题 & 类型）
+
+import { Theme, ThemeConfig } from './types';
+
+/** 暗夜紫（Deep Night）- 默认主题 */
+const deepNight: Theme = {
+  id: 'deep-night',
+  name: '暗夜紫',
+  description: '深紫黑背景配金色强调，适合奇幻/史诗氛围',
+  isDark: true,
+  variables: {
+    '--color-bg-primary': '#0f0a1a',
+    '--color-bg-secondary': '#1a1128',
+    '--color-bg-tertiary': '#2a1f3d',
+    '--color-text-primary': '#e8e0f0',
+    '--color-text-secondary': '#a89bc2',
+    '--color-text-muted': '#6b5f85',
+    '--color-accent': '#d4a843',
+    '--color-accent-hover': '#e6bc5a',
+    '--color-border': '#2a1f3d',
+    '--color-shadow': 'rgba(0, 0, 0, 0.5)',
+    '--color-user-bubble': '#2a1f3d',
+    '--color-ai-bubble': '#1a1128',
+    '--font-body': "'Noto Sans SC', 'PingFang SC', 'Microsoft YaHei', sans-serif",
+    '--font-heading': "'Noto Sans SC', 'PingFang SC', 'Microsoft YaHei', serif",
+    '--border-radius': '12px',
+  },
+};
+
+/** 月光白（Moonlight）*/
+const moonlight: Theme = {
+  id: 'moonlight',
+  name: '月光白',
+  description: '米白背景配深蓝强调，适合轻松/日常氛围',
+  isDark: false,
+  variables: {
+    '--color-bg-primary': '#f5f3f0',
+    '--color-bg-secondary': '#ffffff',
+    '--color-bg-tertiary': '#e8e4df',
+    '--color-text-primary': '#1a1a2e',
+    '--color-text-secondary': '#4a4a6a',
+    '--color-text-muted': '#8888a0',
+    '--color-accent': '#2a4a7f',
+    '--color-accent-hover': '#3a5a9f',
+    '--color-border': '#d8d4cf',
+    '--color-shadow': 'rgba(0, 0, 0, 0.08)',
+    '--color-user-bubble': '#2a4a7f',
+    '--color-ai-bubble': '#e8e4df',
+    '--font-body': "'Noto Sans SC', 'PingFang SC', 'Microsoft YaHei', sans-serif",
+    '--font-heading': "'Noto Sans SC', 'PingFang SC', 'Microsoft YaHei', serif",
+    '--border-radius': '12px',
+  },
+};
+
+/** 赛博绿（Cyber Glow）*/
+const cyberGlow: Theme = {
+  id: 'cyber-glow',
+  name: '赛博绿',
+  description: '纯黑背景配荧光绿强调，适合科幻/赛博朋克氛围',
+  isDark: true,
+  variables: {
+    '--color-bg-primary': '#0a0a0a',
+    '--color-bg-secondary': '#111111',
+    '--color-bg-tertiary': '#1a1a1a',
+    '--color-text-primary': '#e0ffe0',
+    '--color-text-secondary': '#80c080',
+    '--color-text-muted': '#406040',
+    '--color-accent': '#00ff88',
+    '--color-accent-hover': '#33ffaa',
+    '--color-border': '#1a3a1a',
+    '--color-shadow': 'rgba(0, 255, 136, 0.1)',
+    '--color-user-bubble': '#0a2a15',
+    '--color-ai-bubble': '#111111',
+    '--font-body': "'Noto Sans SC', 'PingFang SC', 'Microsoft YaHei', monospace",
+    '--font-heading': "'Noto Sans SC', 'PingFang SC', 'Microsoft YaHei', monospace",
+    '--border-radius': '4px',
+  },
+};
+
+/** 羊皮纸（Parchment）*/
+const parchment: Theme = {
+  id: 'parchment',
+  name: '羊皮纸',
+  description: '暖黄仿旧纸张背景配棕色强调，适合古典/历史氛围',
+  isDark: false,
+  variables: {
+    '--color-bg-primary': '#f0e6d0',
+    '--color-bg-secondary': '#f8f0e0',
+    '--color-bg-tertiary': '#e0d4be',
+    '--color-text-primary': '#3a2a1a',
+    '--color-text-secondary': '#6a5a4a',
+    '--color-text-muted': '#9a8a7a',
+    '--color-accent': '#8b4513',
+    '--color-accent-hover': '#a0522d',
+    '--color-border': '#c8b898',
+    '--color-shadow': 'rgba(60, 40, 20, 0.15)',
+    '--color-user-bubble': '#8b4513',
+    '--color-ai-bubble': '#e8dcc8',
+    '--font-body': "'Noto Serif SC', 'STSong', 'SimSun', serif",
+    '--font-heading': "'Noto Serif SC', 'STSong', 'SimSun', serif",
+    '--border-radius': '8px',
+  },
+};
+
+/** 所有预设主题 */
+export const presetThemes: Theme[] = [deepNight, moonlight, cyberGlow, parchment];
+
+/** 默认主题 ID */
+export const DEFAULT_THEME_ID = 'deep-night';
+
+/** 获取默认主题配置 */
+export function getDefaultThemeConfig(): ThemeConfig {
+  return {
+    presets: presetThemes,
+    activeThemeId: DEFAULT_THEME_ID,
+    customTheme: null,
+    importedThemes: [],
+  };
+}
+
+/** 根据 ID 查找主题 */
+export function findThemeById(config: ThemeConfig, id: string): Theme | undefined {
+  if (id === 'custom' && config.customTheme) {
+    return config.customTheme;
+  }
+  const preset = config.presets.find((t) => t.id === id);
+  if (preset) return preset;
+  return (config.importedThemes || []).find((t) => t.id === id);
+}