9e2333c90c
功能: - 激活码管理 (Pro/Auto 两种类型) - 账号池管理 - 设备绑定记录 - 使用日志 - 搜索/筛选功能 - 禁用/启用功能 (支持退款参考) - 全局设置 (换号间隔、额度消耗等) 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
132 lines
3.1 KiB
Markdown
132 lines
3.1 KiB
Markdown
# 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
|