chore: remove API_FULL_ANALYSIS.md from tracking
This commit is contained in:
@@ -1,192 +0,0 @@
|
|||||||
# 码枪堂 API 全线分析报告
|
|
||||||
|
|
||||||
> 基于 Fiddler 抓包 ss3.saz(原版 API)+ ss4.saz(自定义服务器)对比
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 一、API 域名概览
|
|
||||||
|
|
||||||
| 域名 | 用途 |
|
|
||||||
|------|------|
|
|
||||||
| `https://maqt.top/api/*` | 主业务 API |
|
|
||||||
| `https://pop.maqt.top/api/*` | 弹窗广告 API |
|
|
||||||
| `https://update.maqt.top/*` | 更新服务 |
|
|
||||||
| `https://tuku.maqt.top/*` | 图片托管 |
|
|
||||||
| `http://100.105.17.52:3001/api/*` | 自定义后端(解包版) |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 二、完整 API 端点清单
|
|
||||||
|
|
||||||
### 🔐 认证
|
|
||||||
| 方法 | 端点 | 请求体 | 当前状态 |
|
|
||||||
|------|------|--------|----------|
|
|
||||||
| POST | `/api/login` | `{"username","password","installId","deviceHash","platform","osVersion","appVersion"}` | ✅ 已实现 |
|
|
||||||
| POST | `/api/register` | 需要抓包确认 | ❌ 待实现 |
|
|
||||||
| POST | `/api/activate-vip` | 需要抓包确认 | ✅ 已实现 |
|
|
||||||
|
|
||||||
### 📊 会话 & 状态
|
|
||||||
| 方法 | 端点 | 当前状态 |
|
|
||||||
|------|------|----------|
|
|
||||||
| GET | `/api/session-status` | ✅ 已实现 |
|
|
||||||
| GET | `/api/vip-status` | ❌ 待实现 |
|
|
||||||
| GET | `/api/user/stats/{userId}` | ❌ 待实现 |
|
|
||||||
| GET | `/api/user/favorited-count/{userId}` | ❌ 待实现 |
|
|
||||||
| GET | `/api/user/limits/{userId}` | ❌ 待实现 |
|
|
||||||
| GET | `/api/user/schemes/{userId}` | ❌ 待实现 |
|
|
||||||
|
|
||||||
### 🎯 改枪方案
|
|
||||||
| 方法 | 端点 | 参数 | 当前状态 |
|
|
||||||
|------|------|------|----------|
|
|
||||||
| GET | `/api/category/{type}` | AR/SMG/SR/LMG/SG/Pistol/Launcher | ✅ 已实现 |
|
|
||||||
| GET | `/api/schemes` | `sort=hot&page=1&limit=12&source=...` | ✅ 已实现 |
|
|
||||||
| GET | `/api/schemes` | `sort=hot&page=1&limit=12&weaponCategory&weaponName` | ✅ 已实现 |
|
|
||||||
| POST | `/api/schemes/{id}/use` | 需要抓包确认 | ❌ 待实现 |
|
|
||||||
|
|
||||||
### ❤️ 收藏
|
|
||||||
| 方法 | 端点 | 当前状态 |
|
|
||||||
|------|------|----------|
|
|
||||||
| GET | `/api/favorites/count` | ✅ 已实现 |
|
|
||||||
| GET | `/api/favorites/check?schemeId={id}&source=...` | ✅ 已实现 |
|
|
||||||
|
|
||||||
### 🎯 弹出广告
|
|
||||||
| 方法 | 端点 | 当前状态 |
|
|
||||||
|------|------|----------|
|
|
||||||
| GET | `/api/popups/test_beta_01` | ❌ 待实现 |
|
|
||||||
| GET | `/api/aftersale-tutorial-popup` | ❌ 待实现 |
|
|
||||||
| GET | `/api/software-version-ad` | ❌ 待实现 |
|
|
||||||
|
|
||||||
### 🔄 更新服务
|
|
||||||
| 方法 | 端点 | 备注 |
|
|
||||||
|------|------|------|
|
|
||||||
| GET | `/latest.yml` | Electron auto-updater 配置 |
|
|
||||||
| GET | `/update-config.json` | 更新配置 |
|
|
||||||
|
|
||||||
### 🖼️ 图片托管
|
|
||||||
| 方法 | 端点 | 备注 |
|
|
||||||
|------|------|------|
|
|
||||||
| GET | `tuku.maqt.top/i/2026/03/22/*.png` | 静态图片资源 |
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 三、ss3 vs ss4 请求对比(关键差异)
|
|
||||||
|
|
||||||
### 原版(ss3)完整流程:
|
|
||||||
```
|
|
||||||
1. 检查更新: GET update.maqt.top/{latest.yml,update-config.json}
|
|
||||||
2. 弹窗广告: GET pop.maqt.top/api/software-version-ad
|
|
||||||
3. 会话状态: GET maqt.top/api/session-status (高频轮询!)
|
|
||||||
4. 注册/登录: POST maqt.top/api/register
|
|
||||||
5. 获取分类: GET maqt.top/api/category/{type}
|
|
||||||
6. 获取方案: GET maqt.top/api/schemes?...
|
|
||||||
7. 收藏检查: GET maqt.top/api/favorites/check?schemeId=...
|
|
||||||
8. 激活VIP: POST maqt.top/api/activate-vip
|
|
||||||
9. VIP状态: GET maqt.top/api/vip-status
|
|
||||||
10. 用户数据: GET maqt.top/api/user/{stats,favorited-count,limits,schemes}/{id}
|
|
||||||
11. 方案使用: POST maqt.top/api/schemes/{id}/use
|
|
||||||
12. 图片加载: GET tuku.maqt.top/... (持续轮询)
|
|
||||||
```
|
|
||||||
|
|
||||||
### 自定义服务器(ss4 后半段)请求序列:
|
|
||||||
```
|
|
||||||
162: GET /api/popups/test_beta_01
|
|
||||||
163: GET /api/session-status
|
|
||||||
164: GET /api/software-version-ad
|
|
||||||
165: GET /api/aftersale-tutorial-popup
|
|
||||||
166: GET /update-config.json
|
|
||||||
169: GET /api/software-version-ad
|
|
||||||
170: GET /api/popups/test_beta_01
|
|
||||||
171: GET /api/aftersale-tutorial-popup
|
|
||||||
172: GET /update-config.json
|
|
||||||
173: GET /api/category/AR
|
|
||||||
174: GET /api/schemes?sort=hot&page=1&limit=12&source=...
|
|
||||||
175: GET /api/category/SMG
|
|
||||||
176: GET /api/category/SR
|
|
||||||
177: GET /api/category/LMG
|
|
||||||
178: GET /api/category/SG
|
|
||||||
179: GET /api/category/Pistol
|
|
||||||
180: GET /api/category/Launcher
|
|
||||||
181: POST /api/login
|
|
||||||
182: GET /api/session-status
|
|
||||||
183: GET /api/favorites/count
|
|
||||||
184: GET /api/schemes?...
|
|
||||||
185: GET /api/schemes?...
|
|
||||||
186: GET /api/favorites/count
|
|
||||||
187: GET /api/session-status
|
|
||||||
190: GET /api/session-status
|
|
||||||
194-199: GET /api/session-status (轮询...)
|
|
||||||
```
|
|
||||||
|
|
||||||
### ❗ 自定义服务器缺失的端点
|
|
||||||
以下端点在原版中有调用,但在自定义服务器请求中从未出现:
|
|
||||||
- **POST `/api/register`** — 注册功能
|
|
||||||
- **POST `/api/activate-vip`** — VIP 激活(端点存在但可能未被调用)
|
|
||||||
- **GET `/api/vip-status`** — VIP 状态查询
|
|
||||||
- **GET `/api/user/stats/{id}`** — 用户统计
|
|
||||||
- **GET `/api/user/favorited-count/{id}`** — 用户收藏数
|
|
||||||
- **GET `/api/user/limits/{id}`** — 用户限制
|
|
||||||
- **GET `/api/user/schemes/{id}`** — 用户方案列表
|
|
||||||
- **POST `/api/schemes/{id}/use`** — 方案使用记录
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 四、重新封装开发计划
|
|
||||||
|
|
||||||
### 阶段 1:API 补充(先补齐缺失端点)
|
|
||||||
|
|
||||||
**优先级 P0(应用启动必需):**
|
|
||||||
- [ ] `GET /api/vip-status` — 登录后立刻调用,缺了前端一直没 VIP
|
|
||||||
- [ ] `GET /api/user/stats/:id`
|
|
||||||
- [ ] `GET /api/user/favorited-count/:id`
|
|
||||||
- [ ] `GET /api/user/limits/:id`
|
|
||||||
- [ ] `GET /api/user/schemes/:id`
|
|
||||||
- [ ] `POST /api/schemes/:id/use`
|
|
||||||
|
|
||||||
**优先级 P1(弹窗广告,不影响核心功能):**
|
|
||||||
- [ ] `GET /api/software-version-ad`
|
|
||||||
- [ ] `GET /api/popups/test_beta_01`
|
|
||||||
- [ ] `GET /api/aftersale-tutorial-popup`
|
|
||||||
- [ ] `GET /api/update-config.json`
|
|
||||||
|
|
||||||
**优先级 P2(注册,一次性的):**
|
|
||||||
- [ ] `POST /api/register`(含 installId, deviceHash)
|
|
||||||
|
|
||||||
### 阶段 2:桌面端复刻(Electron + React)
|
|
||||||
|
|
||||||
等 API 补全后,桌面端从头写:
|
|
||||||
|
|
||||||
```
|
|
||||||
maqt-desktop/
|
|
||||||
├── electron/
|
|
||||||
│ ├── main.ts # 窗口管理
|
|
||||||
│ └── preload.ts # electronAPI
|
|
||||||
├── src/
|
|
||||||
│ ├── App.tsx
|
|
||||||
│ ├── pages/
|
|
||||||
│ │ ├── Home.tsx # 桌面首页
|
|
||||||
│ │ ├── Login.tsx
|
|
||||||
│ │ ├── Schemes.tsx # 改枪方案
|
|
||||||
│ │ ├── Filters.tsx # 画面滤镜
|
|
||||||
│ │ ├── Optimization.tsx
|
|
||||||
│ │ └── ...
|
|
||||||
│ ├── components/
|
|
||||||
│ │ ├── Dock.tsx # 底部导航
|
|
||||||
│ │ ├── DesktopIcons.tsx
|
|
||||||
│ │ └── ...
|
|
||||||
│ └── hooks/
|
|
||||||
│ ├── useAuth.ts
|
|
||||||
│ └── useApi.ts
|
|
||||||
├── native/ # 原生程序
|
|
||||||
│ ├── MaqiangTangh1.exe
|
|
||||||
│ ├── nvidiaProfileInspector.exe
|
|
||||||
│ └── tools/
|
|
||||||
└── package.json
|
|
||||||
```
|
|
||||||
|
|
||||||
### 阶段 3:原生功能对接
|
|
||||||
|
|
||||||
- [ ] spawn `MaqiangTangh1.exe` 执行系统优化
|
|
||||||
- [ ] spawn `MaqiangTangXiXiOverlay.exe` 游戏内 Overlay
|
|
||||||
- [ ] 调用 PowerShell 脚本 Gamma 校准
|
|
||||||
- [ ] NVIDIA Profile Inspector 配置
|
|
||||||
- [ ] 硬件监控面板
|
|
||||||
Reference in New Issue
Block a user