buff/.history/游铛铛-技术方案-总览_20251109223629.md

游铛铛产品技术方案 - 总览

一、产品概述

1.1 产品信息

• 产品品牌名称：游铛铛
• 产品功能：Buff平台选品 + Steam平台扫货
• 产品销售模式：客户端exe需要激活后使用
• 产品特征码：buff-xp-steam-sh（标识Buff选品、Steam扫货软件）

1.2 系统架构

产品分为三个部分：

┌─────────────────┐
│   客户端exe     │  Windows桌面应用
│  (PyQt6+Python) │
└────────┬────────┘
         │ HTTP + RSA加密
         ▼
┌─────────────────┐
│   后台API端      │  Python Flask/FastAPI
│  (统一接口服务)  │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   MySQL数据库   │  47.99.164.66:3306
└─────────────────┘
         ▲
         │
┌────────┴────────┐
│   管理web端     │  React/Vue + Chrome浏览器
│  (后台管理)     │
└─────────────────┘

二、技术选型

2.1 客户端exe技术栈

技术组件	选型	说明
编程语言	Python 3.10+	开发效率高，代码简洁
桌面框架	PyQt6	Qt的Python绑定，功能完整
浏览器自动化	Playwright	比Selenium更强大的自动化能力
加密库	cryptography	RSA加密，支持密钥轮换
打包工具	PyInstaller	打包为exe
代码保护	PyArmor + Nuitka	代码混淆和编译保护
Steam集成	subprocess + SDA	Steam Desktop Authenticator

2.2 管理web端技术栈

技术组件	选型	说明
前端框架	React / Vue 3	现代化前端框架
UI组件库	Ant Design / Element Plus	企业级UI组件
HTTP客户端	Axios	API请求
状态管理	Redux / Pinia	状态管理
构建工具	Vite / Webpack	打包构建

2.3 后台API端技术栈

技术组件	选型	说明
Web框架	FastAPI / Flask	Python Web框架
数据库	MySQL 8.0	关系型数据库
ORM	SQLAlchemy	数据库ORM
加密	cryptography	RSA加密，密钥管理
API文档	Swagger/OpenAPI	API文档自动生成

2.4 数据库信息

• 服务器：47.99.164.66:3306
• 数据库名：buff
• 用户名：root
• 密码：hn02le.34lkdLKD

三、核心功能模块

3.1 客户端exe功能

1. 登录注册模块

   • 用户登录/注册
   • 机器码绑定/解绑
   • 卡密激活
   • 免登录功能

2. 主界面模块

   • 头部区域（Logo、有效期、用户名、退出）
   • 左侧菜单（充值、Steam账号绑定、选品、扫货、公告）
   • 右侧Tab页系统

3. 扫货模块（核心难点）

   • 内置Chrome浏览器
   • Chrome插件支持
   • 浏览器自动化操作
   • 数据抓取和处理

4. Steam集成模块

   • Steam账号绑定
   • Steam Guard验证码生成
   • 交易确认

5. 安全模块

   • 接口加密（RSA）
   • 密钥轮换（每10天）
   • 许可证验证
   • 心跳检测

3.2 管理web端功能

1. 用户管理

   • 管理员登录/退出
   • 注册用户信息查看

2. 软件管理

   • 软件特征码管理
   • 收费基数配置（每天多少钱）

3. 卡密管理

   • 卡密生成（按特征码、天数、折扣）
   • 卡密激活信息查看

4. 密钥管理

   • API公钥/私钥展示
   • 历史密钥记录
   • 更新周期配置

5. 日志管理

   • API接口日志记录
   • 日志查询和导出

6. 公告管理

   • 公告发布和编辑

3.3 后台API端功能

1. 统一接口服务

   • 所有接口统一管理
   • 接口加密开关（开发/生产环境）

2. 认证授权

   • 用户登录/注册
   • 机器码验证
   • 卡密验证

3. 密钥管理

   • RSA密钥生成
   • 密钥轮换（每10天）
   • 密钥分发

4. 数据接口

   • 用户信息
   • 卡密信息
   • 软件配置
   • 公告信息

四、安全方案

4.1 客户端安全

• 代码保护：PyArmor混淆 + Nuitka编译核心模块
• 接口加密：所有API请求使用RSA加密
• 密钥轮换：每10天自动更换密钥
• 机器码绑定：防止多机使用
• 许可证验证：在线验证 + 心跳检测

4.2 服务端安全

• 接口加密：支持加密开关，方便调试
• 密钥管理：服务端私钥，客户端公钥
• 数据验证：签名验证，防止篡改
• 日志记录：所有接口调用记录日志

五、部署方案

5.1 客户端打包

• 打包方式：PyInstaller打包为exe
• 安装包：NSIS创建安装包（~180MB）
• 浏览器：内置Chrome浏览器（~120MB）
• 代码保护：PyArmor加密后打包

5.2 服务端部署

• API服务：Python服务（FastAPI/Flask）
• 数据库：MySQL 8.0
• Web管理端：Nginx + 静态文件

六、开发计划

6.1 第一阶段：基础框架

• 客户端登录注册功能
• 后台API基础接口
• 数据库设计

6.2 第二阶段：核心功能

• 扫货模块（浏览器自动化）
• Steam集成
• 管理web端

6.3 第三阶段：安全加固

• 接口加密
• 密钥轮换
• 代码保护

6.4 第四阶段：测试和优化

• 功能测试
• 性能优化
• 打包部署

七、详细文档索引

• 客户端技术方案
• 管理web端技术方案
• 后台API技术方案
• 安全加固方案
• 打包部署方案