maqt-desktop/DEVELOPMENT_PLAN.md

码枪堂桌面端复刻 — 全面开发规划

基于 MaQiangTang v7.0.4 完整逆向分析 后端: https://gch3n.online/delta | 源码: https://git.gch3n.online/gch3n/mqsrv

---

一、原版功能全景图

1.1 页面结构

┌─────────────────────────────────────────────────────────┐
│  桌面首页 (Desktop/Home)                                 │
│  ┌────────────────┐  ┌────────────────┐                  │
│  │  快速优化       │  │  画面滤镜       │                  │
│  │  (一键优化)     │  │  (Exposure)     │                  │
│  └────────────────┘  └────────────────┘                  │
│  ┌────────────────┐  ┌────────────────┐                  │
│  │  滤镜社区       │  │  改枪方案       │                  │
│  │  (Filter-Share) │  │  (Weapon)      │                  │
│  └────────────────┘  └────────────────┘                  │
│  ┌────────────────┐  ┌────────────────┐                  │
│  │  游戏准星       │  │  神秘力量       │                  │
│  │  (Crosshair)   │  │  (Xixi-Haha)   │                  │
│  └────────────────┘  └────────────────┘                  │
│  ┌────────────────┐                                     │
│  │  嘉豪之力       │                                     │
│  │  (Forbidden)   │                                     │
│  └────────────────┘                                     │
│                                                          │
│  ┌──────────────────────────────────────────────────┐   │
│  │  底部 Dock: 社区教程 | 微信 | 官网                 │   │
│  └──────────────────────────────────────────────────┘   │
│                                                          │
│  ┌── 底部启动按钮 ──────────────────────────────────┐   │
│  │  [ 启动硬件监控 ] [ 启动码枪堂2.0 (XiXiOverlay) ]  │   │
│  └──────────────────────────────────────────────────┘   │
├─────────────────────────────────────────────────────────┤
│  底部 Dock 导航栏 (离开首页时显示)                       │
│  [快速优化] [画面滤镜] [滤镜社区] [改枪方案] [设置]      │
└─────────────────────────────────────────────────────────┘

1.2 完整页面/功能清单

#	页面 ID	名称	描述
1	home	桌面首页	桌面图标、启动按钮、社区入口
2	one-click-optimization	快速优化	一键系统优化（VIP）
3	exposure	画面滤镜	显示/色彩滤镜管理（VIP）
4	filter-community	滤镜社区	分享和下载滤镜（VIP）
5	weapon	改枪方案	武器配置方案浏览/分享
6	game-crosshair	游戏准星	准星定制（需登录）
7	xixi-haha	神秘力量	趣味功能（需登录）
8	forbidden-force	嘉豪之力	高级功能（VIP）
9	settings	设置页	应用偏好、开机自启等

1.3 原生服务清单（Services）

服务	功能	复用方式
SystemOptimizationService	系统优化项执行/恢复	IPC spawn MaqiangTangh1.exe
XiXiOverlayNativeService	游戏内 Overlay 浮窗	IPC spawn MaqiangTangXiXiOverlay.exe
HardwareMonitorService	硬件监控（CPU/GPU 温度）	IPC spawn MaqiangTangHardwareMonitor.exe
ArgyllService	色彩校准（ICC 配置文件）	调用 dispwin.exe / iccvcgt.exe
NvidiaProfileService	NVIDIA 驱动配置	调用 nvidiaProfileInspector.exe
NipConfigService	NIP 配置文件管理	读写 .nip 文件
CustomFilterIccService	自定义滤镜 ICC	色彩配置文件管理
PowerManagementService	电源管理	调用 PowerShell 系统命令
ResolutionService	分辨率切换	调用 DVChange.exe
GpuDeviceService	GPU 设备信息	系统 API 查询
SystemInfoService	系统信息收集	系统 API 查询
CompareFitService	方案比对	算法比对
DlssNativeService	DLSS 配置管理	驱动层 DLSS 设置
ShaderCacheService	着色器缓存管理	缓存文件管理
NvidiaAppService	NVIDIA App 集成	系统 API
PermissionChecker	权限检查	管理员权限检测
MemoryService	内存优化	系统 API
ProcessService	进程管理	系统 API
RegistryService	注册表操作	系统 API
WindowsFeaturesService	Windows 功能开关	PowerShell
WindowsServiceManager	系统服务管理	PowerShell
SecurityMonitorService	安全监控	系统 API

---

二、项目文件结构

maqt-desktop/
├── docs/                           # 开发文档
│   ├── ARCHITECTURE.md             # 架构说明
│   ├── API_REFERENCE.md            # API 接口文档
│   ├── UI_WIREFRAMES.md            # 界面线框图
│   └── DEVELOPMENT_LOG.md          # 开发日志
│
├── electron/                       # Electron 主进程
│   ├── main.ts                     # 窗口管理、生命周期
│   ├── preload.ts                  # 安全 IPC 桥
│   ├── menu.ts                     # 菜单配置
│   ├── updater.ts                  # 自动更新
│   │
│   ├── ipc/                        # IPC 处理器
│   │   ├── auth.ipc.ts             # 认证相关
│   │   ├── system.ipc.ts           # 系统级操作
│   │   ├── overlay.ipc.ts          # XiXiOverlay 控制
│   │   ├── optimization.ipc.ts     # 系统优化
│   │   ├── profile.ipc.ts          # NVIDIA 配置
│   │   ├── display.ipc.ts          # 显示/色彩
│   │   └── file.ipc.ts             # 文件操作
│   │
│   ├── services/                   # 原生服务包装
│   │   ├── SystemOptimizer.ts      # 调用 MaqiangTangh1.exe
│   │   ├── XiXiOverlayLauncher.ts  # 调用 XiXiOverlay.exe
│   │   ├── HardwareMonitor.ts      # 调用 HardwareMonitor.exe
│   │   ├── NvidiaProfile.ts        # 调用 nvidiaProfileInspector.exe
│   │   ├── ColorCalibration.ts     # 调用 Argyll CMS
│   │   ├── PowerManager.ts         # 电源方案管理
│   │   └── ResolutionChanger.ts    # 分辨率切换调用 DVChange.exe
│   │
│   └── utils/                      # 主进程工具
│       ├── logger.ts               # 日志
│       ├── permissions.ts          # 提权
│       └── paths.ts                # 路径管理
│
├── src/                            # React 前端
│   ├── main.tsx                    # 入口
│   ├── App.tsx                     # 根组件 + 路由
│   ├── router.tsx                  # 页面路由
│   │
│   ├── pages/                      # 页面组件
│   │   ├── Home.tsx                # 桌面首页
│   │   ├── Login.tsx               # 登录页
│   │   ├── Register.tsx            # 注册页
│   │   ├── Optimization.tsx        # 快速优化
│   │   ├── Exposure.tsx            # 画面滤镜
│   │   ├── FilterCommunity.tsx     # 滤镜社区
│   │   ├── WeaponSchemes.tsx       # 改枪方案
│   │   ├── Crosshair.tsx           # 游戏准星
│   │   ├── XixiHaha.tsx            # 神秘力量
│   │   ├── ForbiddenForce.tsx      # 嘉豪之力
│   │   ├── SchemeDetail.tsx        # 方案详情
│   │   └── Settings.tsx            # 设置页
│   │
│   ├── components/                 # 通用组件
│   │   ├── ui/                     # UI 基础组件
│   │   │   ├── Button.tsx          # 直角切角按钮
│   │   │   ├── Card.tsx            # 模块化卡片
│   │   │   ├── ProgressBar.tsx     # 机械进度条
│   │   │   ├── Panel.tsx           # 半透明悬浮面板
│   │   │   ├── Modal.tsx           # 弹窗
│   │   │   ├── Toast.tsx           # 消息提示
│   │   │   ├── Badge.tsx           # 角标
│   │   │   ├── Compass.tsx         # 罗盘刻度装饰
│   │   │   ├── Input.tsx           # 输入框
│   │   │   ├── Select.tsx          # 下拉选择
│   │   │   └── Skeleton.tsx        # 加载骨架屏
│   │   │
│   │   ├── layout/                 # 布局组件
│   │   │   ├── DesktopGrid.tsx     # 桌面图标网格
│   │   │   ├── DesktopIcon.tsx     # 桌面图标
│   │   │   ├── BottomDock.tsx      # 底部导航 Dock
│   │   │   ├── TopBar.tsx          # 顶部状态栏
│   │   │   ├── SidePanel.tsx       # 侧边面板
│   │   │   └── PageContainer.tsx   # 页面容器
│   │   │
│   │   ├── auth/                   # 认证相关
│   │   │   ├── LoginModal.tsx      # 登录弹窗
│   │   │   ├── VipBadge.tsx        # VIP 标识
│   │   │   └── VipActivate.tsx     # VIP 激活
│   │   │
│   │   ├── hardware/               # 硬件监控
│   │   │   ├── MonitorPanel.tsx    # 监控面板
│   │   │   ├── CpuGauge.tsx        # CPU 仪表盘
│   │   │   ├── GpuGauge.tsx        # GPU 仪表盘
│   │   │   └── TempIndicator.tsx   # 温度指示
│   │   │
│   │   ├── schemes/                # 改枪方案
│   │   │   ├── SchemeCard.tsx      # 方案卡片
│   │   │   ├── SchemeList.tsx      # 方案列表
│   │   │   ├── SchemeFilter.tsx    # 方案筛选
│   │   │   ├── SchemePreviewer.tsx # 方案预览
│   │   │   └── SchemeEditor.tsx    # 方案编辑
│   │   │
│   │   ├── filters/                # 画面滤镜
│   │   │   ├── FilterCard.tsx      # 滤镜卡片
│   │   │   ├── FilterGrid.tsx      # 滤镜网格
│   │   │   ├── FilterPreview.tsx   # 滤镜预览
│   │   │   └── FilterEditor.tsx    # 滤镜编辑
│   │   │
│   │   └── optimization/           # 系统优化
│   │       ├── OptimizeItem.tsx    # 优化项
│   │       ├── OptimizePanel.tsx   # 优化面板
│   │       └── OptimizeResult.tsx  # 优化结果
│   │
│   ├── hooks/                      # 自定义 Hooks
│   │   ├── useAuth.ts              # 登录态
│   │   ├── useApi.ts               # API 请求
│   │   ├── useVip.ts               # VIP 状态
│   │   ├── useElectron.ts          # Electron API
│   │   ├── useHardwareMonitor.ts   # 硬件监控
│   │   ├── useLocalStorage.ts      # 本地存储
│   │   └── useTheme.ts             # 主题
│   │
│   ├── stores/                     # 状态管理
│   │   ├── authStore.ts            # 认证
│   │   ├── vipStore.ts             # VIP
│   │   ├── navigationStore.ts      # 导航
│   │   └── settingsStore.ts        # 设置
│   │
│   ├── services/                   # API 服务
│   │   ├── api.ts                  # Axios 实例
│   │   ├── auth.api.ts             # 认证接口
│   │   ├── schemes.api.ts          # 方案接口
│   │   ├── filters.api.ts          # 滤镜接口
│   │   ├── favorites.api.ts        # 收藏接口
│   │   ├── user.api.ts             # 用户接口
│   │   └── popups.api.ts           # 广告接口
│   │
│   └── styles/                     # 样式
│       ├── globals.css             # 全局样式
│       ├── theme.ts                # 主题变量
│       ├── tailwind.ts             # Tailwind 配置
│       └── animations.css          # 动画
│
├── native/                         # 原生可执行文件
│   ├── MaqiangTangh1.exe
│   ├── MaqiangTangh2.exe
│   ├── MaqiangTangHardwareMonitor.exe
│   ├── nvidiaProfileInspector.exe
│   ├── tools/
│   │   ├── xixi-overlay-helper/
│   │   │   └── MaqiangTangXiXiOverlay.exe
│   │   ├── vibrance-bridge/
│   │   │   ├── VibranceBridge.exe
│   │   │   └── vibranceDLL.dll
│   │   ├── DVChange.exe
│   │   ├── gsynctoggle.exe
│   │   └── dbInstaller.exe
│   ├── Argyll/
│   │   └── bin/
│   │       ├── iccvcgt.exe
│   │       └── dispwin.exe
│   ├── icc-profiles/
│   └── scripts/
│       ├── apply-gamma-force.ps1
│       └── restore-gamma-force.ps1
│
├── package.json
├── electron-builder.yml            # 打包配置
├── tsconfig.json
├── vite.config.ts                  # Vite 配置
├── tailwind.config.ts
├── postcss.config.js
├── Dockerfile
└── docker-compose.yml

---

三、UI 设计规范

3.1 设计语言

军工战术风 · 单兵头盔HUD · 暗区射击手游UI

配色方案：
  ████ #0A0E17    炭黑（主背景）
  ████ #1A1F2E    深碳灰（卡片/面板）
  ████ #2D3349    铁灰（边框/分隔）
  ████ #3B4A3B    军绿（强调色/按钮）
  ████ #5C7A3E    橄榄绿（次要强调）
  ████ #3A6B35    暗军绿（激活态）
  ████ #4A3B22    泥土棕（装饰/辅助）
  ████ #7A6B4A    暗金（VIP/高级元素）
  ████ #C8A95B    淡金（VIP 高亮）
  ████ #E8E0D0    米白（主文字）
  ████ #A09888    灰白（次要文字）
  ████ #5A5248    深灰（禁用文字）
  ████ #3B2B1A    暗琥珀（警告/危险）

字体：
  - 主字体: "JetBrains Mono" (monospace, 军事终端感)
  - 备用: "Cascadia Code", "Fira Code", monospace
  
字号阶梯：
  10px  罗盘刻度标签
  12px  辅助信息
  14px  正文
  16px  突出文字
  18px  小标题
  24px  页面标题
  36px  大数字（监控数据）

3.2 组件风格

/* 按钮: 直角切角 + 磨砂金属 */
.btn-tactical {
  border: 1px solid rgba(59, 74, 59, 0.6);
  background: linear-gradient(180deg, 
    rgba(26, 31, 46, 0.95) 0%, 
    rgba(15, 20, 30, 0.98) 100%);
  box-shadow: 
    inset 0 1px 0 rgba(200, 169, 91, 0.08),
    inset 0 -1px 0 rgba(0, 0, 0, 0.3);
  clip-path: polygon(
    4px 0, calc(100% - 4px) 0,
    100% 4px, 100% calc(100% - 4px),
    calc(100% - 4px) 100%, 4px 100%,
    0 calc(100% - 4px), 0 4px
  );
}

/* 面板: 半透明悬浮 */
.panel-hud {
  backdrop-filter: blur(12px);
  background: rgba(15, 20, 30, 0.75);
  border: 1px solid rgba(59, 74, 59, 0.3);
  box-shadow: 
    0 4px 24px rgba(0, 0, 0, 0.4),
    inset 0 1px 0 rgba(92, 122, 62, 0.1);
}

/* 进度条: 机械风格 */
.progress-mechanical {
  height: 6px;
  background: rgba(26, 31, 46, 0.9);
  border: 1px solid rgba(59, 74, 59, 0.4);
  position: relative;
}
.progress-mechanical::after {
  content: '';
  position: absolute;
  top: 0; left: 0;
  height: 100%;
  width: var(--progress);
  background: linear-gradient(90deg, 
    #3A6B35 0%, #5C7A3E 50%, #7A6B4A 100%);
  /* 添加扫描线纹理 */
  background-image: repeating-linear-gradient(
    90deg,
    transparent 0px,
    rgba(255,255,255,0.03) 2px,
    transparent 4px
  );
}

3.3 动画效果

按钮悬停: 边框微光流动 (border-glow animation)
面板展开: HUD 扫描线展开效果 (scan-line reveal)
页面切换: 十字准星聚合展开 (crosshair transition)
数据更新: 数字滚动跳变 (digital roll)
加载中: 扫描雷达动画 (radar scan spinner)
错误提示: 红色警告闪烁 + 抖动 (shaker + flash)
VIP 元素: 暗金流光 (gold shimmer flow)

---

四、页面线框图

4.1 桌面首页 (Home.tsx)

┌──────────────────────────────────────────────────────────┐
│ ████████████████████████████████████████████████████████ │  ← 顶部 HUD 条
│ 10:45 │ FPS: 144 │ CPU: 52° │ GPU: 68° │ VIP ● │ 网络 ✓ │  (罗盘刻度装饰)
│ ▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔ │
│                                                          │
│   ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐     │
│   │ ⚡ 快速  │ │ 🎨 画面  │ │ 📸 滤镜  │ │ 🔫 改枪  │     │  ← 桌面图标 2x3 网格
│   │  优化   │ │  滤镜   │ │  社区   │ │  方案   │     │
│   └─────────┘ └─────────┘ └─────────┘ └─────────┘     │
│   ┌─────────┐ ┌─────────┐ ┌─────────┐                 │
│   │ 🎯 游戏  │ │ 💫 神秘  │ │ 🛡️ 嘉豪  │                 │
│   │  准星   │ │  力量   │ │  之力   │                 │
│   └─────────┘ └─────────┘ └─────────┘                 │
│                                                          │
│  ┌────────────────────────────────────────────────────┐ │
│  │  教程 │ 微信群 │ 官网                               │ │  ← 社区快捷栏
│  └────────────────────────────────────────────────────┘ │
│                                                          │
│  ┌──────────────────────┐ ┌──────────────────────┐      │
│  │  ▨ 启动硬件监控       │ │  ▣ 启动码枪堂2.0     │      │  ← 启动按钮
│  │  [温度/频率监测]      │ │  [游戏内Overlay]     │      │
│  └──────────────────────┘ └──────────────────────┘      │
└──────────────────────────────────────────────────────────┘

4.2 改枪方案页 (WeaponSchemes.tsx)

┌──────────────────────────────────────────────────────────┐
│ ◀ 返回          改枪方案                     🔍 搜索     │  ← TopBar
├──────────────────────────────────────────────────────────┤
│ ┌──────────┐ ┌──────┐ ┌───┐ ┌──┐ ┌──┐ ┌───┐ ┌───┐    │
│ │ 突击步枪 │ │冲锋枪│ │狙│ │轻│ │霰│ │手 │ │发 │    │  ← 武器分类标签
│ │   AR    │ │ SMG  │ │SR│ │MG│ │SG│ │枪 │ │射 │    │
│ └──────────┘ └──────┘ └───┘ └──┘ └──┘ └───┘ └───┘    │
│                                                          │
│ ┌──────────────┐  ┌──────────────┐  ┌──────────────┐   │
│ │ 武器: XXXX   │  │ 武器: XXXX   │  │ 武器: XXXX   │   │  ← 方案卡片网格
│ │ 作者: xxx    │  │ 作者: xxx    │  │ 作者: xxx    │   │
│ │ ⭐ 4.8  142🔥│  │ ⭐ 4.5  89🔥 │  │ ⭐ 4.9  203🔥│   │
│ │ 效果预览...   │  │ 效果预览...   │  │ 效果预览...   │   │
│ │ ┌──────┐     │  │ ┌──────┐     │  │ ┌──────┐     │   │
│ │ │ 收藏 │     │  │ │ 收藏 │     │  │ │ 收藏 │     │   │
│ │ └──────┘     │  │ └──────┘     │  │ └──────┘     │   │
│ └──────────────┘  └──────────────┘  └──────────────┘   │
│                                                          │
│                       ← 1 2 3 4 →                       │  ← 分页
├──────────────────────────────────────────────────────────┤
│  [快速优化] [画面滤镜] [滤镜社区] [改枪方案] [设置]       │  ← BottomDock
└──────────────────────────────────────────────────────────┘

4.3 登录/注册 (Login.tsx)

┌──────────────────────────────────────────────────────────┐
│                                                          │
│                    ═══ 认证 ═══                          │
│                                                          │
│  ┌──────────────────────────────────────┐                │
│  │  ┌────────────────────────────────┐  │                │
│  │  │  用户名/邮箱                     │  │                │  ← 磨砂输入框
│  │  └────────────────────────────────┘  │                │
│  │  ┌────────────────────────────────┐  │                │
│  │  │  密码                           │  │                │
│  │  └────────────────────────────────┘  │                │
│  │                                      │                │
│  │  ┌────────────────────────────────┐  │                │
│  │  │        █ 登 录                  │  │                │  ← 军绿按钮
│  │  └────────────────────────────────┘  │                │
│  │                                      │                │
│  │  ═══ 或 ═══                          │                │
│  │                                      │                │
│  │  ┌────────────────────────────────┐  │                │
│  │  │        创建账号                  │  │                │
│  │  └────────────────────────────────┘  │                │
│  │                                      │                │
│  │  ────── VIP 卡密激活 ──────          │                │
│  │  ┌────────────────────────────────┐  │                │
│  │  │  输入卡密...                     │  │                │
│  │  └────────────────────────────────┘  │                │
│  │  ┌────────────────────────────────┐  │                │
│  │  │        激 活                    │  │                │
│  │  └────────────────────────────────┘  │                │
│  └──────────────────────────────────────┘                │
│                                                          │
└──────────────────────────────────────────────────────────┘

4.4 硬件监控 (MonitorPanel)

┌──────────────────────────────────────────────────────────┐
│ ░ 硬 件 监 控 ░                                          │
│                                                          │
│  ┌────────────┐  ┌────────────┐                          │
│  │  ▓ CPU     │  │  ▓ GPU     │                          │  ← 圆形仪表盘
│  │   52°C     │  │   68°C     │                          │
│  │   ┌──┐     │  │   ┌──┐     │                          │
│  │   │52│     │  │   │68│     │                          │
│  │   └──┘     │  │   └──┘     │                          │
│  │  2.4GHz    │  │  1.8GHz    │                          │
│  └────────────┘  └────────────┘                          │
│                                                          │
│  ▓ 内存: ████████░░░░ 72%                                │  ← 机械进度条
│  ▓ FPS:  ████████████░ 144                               │
│  ▓ 网络: ████████████  ✓                                 │
│                                                          │
│  [ 刷新 ]  [ 最小化到托盘 ]                                │
└──────────────────────────────────────────────────────────┘

---

五、功能操作逻辑地图

5.1 应用启动流程

应用启动
  ↓
加载配置 (settingsStore)
  ↓
检查登录态 (localStorage token)
  ├── 有 token → 验证 session-status
  │   ├── 有效 → 进入首页
  │   └── 无效 → 清除 token → 显示首页 + 登录提示
  └── 无 token → 显示首页 + 登录提示
  ↓
启动硬件监控 (后台)
  ↓
检查更新
  ↓
渲染桌面首页

5.2 桌面图标交互

点击桌面图标
  ↓
检查权限要求（选项：loginRequired / vipRequired）
  ├── 需要 VIP 但非 VIP → 弹出 VIP 激活窗口
  ├── 需要登录但未登录 → 弹出登录弹窗
  └── 权限通过 → 导航到目标页面
  ↓
隐藏桌面图标区域 → 显示页面内容
  ↓
底部 Dock 出现（包含导航按钮）

5.3 XiXi Overlay 启动

点击「启动码枪堂2.0」
  ↓
检查 XiXiOverlayNativeService.isAvailable()
  ├── false → 提示"未找到 overlay 程序"
  └── true → 继续
  ↓
ensureProcess() → spawn MaqiangTangXiXiOverlay.exe
  ├── spawn 失败 → 提示错误
  └── spawn 成功 → 等待 stdout "ready"
  ↓
发送 show 命令 (包含 label/gameId)
  ↓
等待 "ready" 信号 → overlay 显示

5.4 改枪方案浏览

进入改枪方案页
  ↓
加载武器分类 (GET /api/category/{type})
  ↓
默认选中 AR → 加载热榜方案 (GET /api/schemes?sort=hot)
  ↓
点击分类标签 → 切换武器类型 → 重新加载方案
  ↓
点击方案卡片 → 进入方案详情页
  │
  ├── 收藏按钮 → POST /api/favorites (需登录)
  ├── 使用按钮 → POST /api/schemes/{id}/use
  ├── 预览模式 → 弹窗预览效果
  └── 分享 → 复制分享链接

---

六、API 接口清单

详见 API_FULL_ANALYSIS.md，关键端点：

基础:  POST   /api/login
        POST   /api/register
        GET    /api/session-status
        GET    /api/vip-status
        POST   /api/activate-vip

用户:  GET    /api/user/stats/:id
        GET    /api/user/limits/:id
        GET    /api/user/schemes/:id
        GET    /api/user/favorited-count/:id

方案:  GET    /api/schemes?sort=&page=&limit=&source=
        GET    /api/schemes/:id
        POST   /api/schemes/:id/use
        GET    /api/category/:code

收藏:  GET    /api/favorites/count
        GET    /api/favorites/check?schemeId=
        POST   /api/favorites
        DELETE /api/favorites/:id

工具:  GET    /api/software-version-ad
        GET    /api/popups/:id
        GET    /api/aftersale-tutorial-popup
        GET    /api/update-config.json

---

七、开发阶段

Phase 1: 脚手架 + UI 框架

• Vite + Electron + React + Tailwind 脚手架
• 主题系统（军武风格变量）
• 路由 + 页面骨架
• 桌面首页 + 桌面图标
• 底部 Dock 导航
• 顶部 HUD 状态栏
• UI 组件库（按钮/卡片/面板/进度条）

Phase 2: 认证 + API 对接

• Axios 实例 + 拦截器
• 登录/注册页面
• VIP 激活
• Token 管理 + 自动刷新
• 各页面数据对接

Phase 3: 改枪方案模块

• 武器分类标签
• 方案列表 + 分页
• 方案详情
• 收藏系统
• 方案使用记录

Phase 4: 画面滤镜模块

• 滤镜列表
• 滤镜预览
• 滤镜编辑器
• 上传/分享

Phase 5: 系统优化模块

• 系统优化项列表展示
• IPC 调用优化程序
• 优化结果展示
• 一键优化

Phase 6: 原生功能对接

• XiXi Overlay 启动/控制
• 硬件监控面板
• NVIDIA 配置管理
• 色彩校准
• 分辨率切换

Phase 7: 系统集成

• 自动更新
• 开机自启
• 托盘图标
• 权限管理
• 打包发布

---

八、技术栈速览

层	技术	版本
桌面框架	Electron	latest
构建工具	Vite	latest
UI	React + TypeScript	latest
样式	Tailwind CSS	v3
状态	Zustand	latest
动画	Framer Motion	latest
IPC	@electron/remote / contextBridge	—
打包	electron-builder	latest
后端 API	https://gch3n.online/delta	—
字体	JetBrains Mono	—
图标	Material Symbols + 自定义 SVG	—