gch3n/maqt-desktop
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: initial commit - maqt-desktop v0.2

Browse Source 
- Phase 1-5: UI framework, auth, weapon schemes, color filters, system optimization
- Industrial/tech design style with Chinese localization
- Points to gch3n.online/delta backend API
- Hardware monitor, filter editor, and all module pages
This commit is contained in:
Chen Gu
2026-05-09 00:31:09 +08:00
commit 5bd314deb2
80 changed files with 12217 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

663
DEVELOPMENT_PLAN.md Normal file
View File

@@ -0,0 +1,663 @@
# 码枪堂桌面端复刻 — 全面开发规划
> 基于 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 组件风格
```css
/* 按钮: 直角切角 + 磨砂金属 */
.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 | — |