CursorPro 后台管理系统 v1.0
功能: - 激活码管理 (Pro/Auto 两种类型) - 账号池管理 - 设备绑定记录 - 使用日志 - 搜索/筛选功能 - 禁用/启用功能 (支持退款参考) - 全局设置 (换号间隔、额度消耗等) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
131
backend/README.md
Normal file
131
backend/README.md
Normal file
@@ -0,0 +1,131 @@
|
||||
# CursorPro 后台管理系统
|
||||
|
||||
基于 FastAPI 的 Cursor 账号管理和激活码系统,兼容原 CursorPro 插件 API。
|
||||
|
||||
## 功能特性
|
||||
|
||||
- 账号管理:导入、编辑、删除 Cursor 账号
|
||||
- 激活码系统:生成、管理激活码,支持换号次数限制
|
||||
- Web 管理后台:Vue.js + Tailwind CSS 构建的现代化界面
|
||||
- 客户端 API:完全兼容原 CursorPro 插件
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 方式一:本地运行
|
||||
|
||||
1. **安装 MySQL 数据库**
|
||||
|
||||
2. **配置环境**
|
||||
```bash
|
||||
# 复制配置文件
|
||||
cp .env.example .env
|
||||
|
||||
# 编辑 .env 填入数据库信息
|
||||
```
|
||||
|
||||
3. **启动服务**
|
||||
```bash
|
||||
# Windows
|
||||
start.bat
|
||||
|
||||
# Linux/Mac
|
||||
chmod +x start.sh
|
||||
./start.sh
|
||||
```
|
||||
|
||||
4. **访问管理后台**
|
||||
- 地址: http://localhost:8000
|
||||
- 默认账号: admin / admin123
|
||||
|
||||
### 方式二:Docker 部署
|
||||
|
||||
```bash
|
||||
# 启动 MySQL + 后台服务
|
||||
docker-compose up -d
|
||||
|
||||
# 查看日志
|
||||
docker-compose logs -f backend
|
||||
```
|
||||
|
||||
## API 文档
|
||||
|
||||
启动后访问 http://localhost:8000/docs 查看 Swagger API 文档。
|
||||
|
||||
### 客户端 API(兼容原插件)
|
||||
|
||||
| 接口 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/api/verify-key` | POST | 验证激活码 |
|
||||
| `/api/switch-account` | POST | 切换账号 |
|
||||
| `/api/version` | GET | 获取版本信息 |
|
||||
|
||||
### 管理 API
|
||||
|
||||
| 接口 | 方法 | 说明 |
|
||||
|------|------|------|
|
||||
| `/admin/login` | POST | 管理员登录 |
|
||||
| `/admin/dashboard` | GET | 仪表盘统计 |
|
||||
| `/admin/accounts` | GET/POST | 账号列表/创建 |
|
||||
| `/admin/accounts/import` | POST | 批量导入账号 |
|
||||
| `/admin/keys` | GET/POST | 激活码列表/生成 |
|
||||
|
||||
## 账号数据格式
|
||||
|
||||
导入账号时使用 JSON 格式:
|
||||
|
||||
```json
|
||||
[
|
||||
{
|
||||
"email": "user@example.com",
|
||||
"access_token": "...",
|
||||
"refresh_token": "...",
|
||||
"workos_session_token": "...",
|
||||
"membership_type": "pro"
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
backend/
|
||||
├── app/
|
||||
│ ├── api/ # API 路由
|
||||
│ │ ├── admin.py # 管理后台 API
|
||||
│ │ └── client.py # 客户端 API(兼容原插件)
|
||||
│ ├── models/ # 数据库模型
|
||||
│ ├── schemas/ # Pydantic 数据模式
|
||||
│ ├── services/ # 业务逻辑
|
||||
│ ├── config.py # 配置
|
||||
│ ├── database.py # 数据库连接
|
||||
│ └── main.py # 应用入口
|
||||
├── templates/ # HTML 模板
|
||||
├── static/ # 静态文件
|
||||
├── .env.example # 环境变量示例
|
||||
├── docker-compose.yml
|
||||
├── Dockerfile
|
||||
├── requirements.txt
|
||||
├── run.py # 启动脚本
|
||||
└── start.bat/sh # 快捷启动
|
||||
```
|
||||
|
||||
## 配置说明
|
||||
|
||||
`.env` 文件配置项:
|
||||
|
||||
| 变量 | 说明 | 默认值 |
|
||||
|------|------|--------|
|
||||
| DB_HOST | 数据库地址 | localhost |
|
||||
| DB_PORT | 数据库端口 | 3306 |
|
||||
| DB_USER | 数据库用户 | root |
|
||||
| DB_PASSWORD | 数据库密码 | - |
|
||||
| DB_NAME | 数据库名 | cursorpro |
|
||||
| JWT_SECRET_KEY | JWT 密钥 | - |
|
||||
| ADMIN_USERNAME | 管理员账号 | admin |
|
||||
| ADMIN_PASSWORD | 管理员密码 | admin123 |
|
||||
|
||||
## 安全提示
|
||||
|
||||
- 生产环境请修改 `JWT_SECRET_KEY`
|
||||
- 修改默认管理员密码
|
||||
- 建议使用 HTTPS
|
||||
Reference in New Issue
Block a user