# 码枪堂桌面端复刻 — 全面开发规划 > 基于 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 | — |