5bd314deb2
- 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
664 lines
32 KiB
Markdown
664 lines
32 KiB
Markdown
# 码枪堂桌面端复刻 — 全面开发规划
|
||
|
||
> 基于 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 | — |
|