docs: full API documentation + data compat guard

- docs/API.md: complete API reference (auth/identities/tickets/bans/users/
  settings/notifications/polls/features/export/captcha/uploads/external/
  install/health) with auth, rate limits, roles, data migration notes
- auth.js register: also check user_identities for duplicate game_name
  (multi-identity compat for old data backfilled into new table)
- README: link API docs, multi-identity section
This commit is contained in:
2026-08-17 01:20:39 +08:00
parent 559970c5b7
commit 4c221ad6f1
3 changed files with 356 additions and 2 deletions

View File

@@ -17,7 +17,12 @@
| **导出** | CSVUTF-8 BOM导出工单/被举报人统计/操作日志(仅服主) |
| **插件** | Paper 1.20+,统一 `/report` 命令,游戏内注册/登录/举报/追踪 |
| **找回密码** | 邮箱验证1小时有效重置链接 |
| **安装向导** | Web 页面配置 MySQL 连接 + 创建服主账号 |
| **多来源身份** | 一个账号可同时绑定网易端 + 皮肤站身份,提交工单时选择身份 |
| **安装向导** | Web 页面配置 MySQL 连接 + 创建服主账号(完成后无需重启) |
## API 文档
完整接口文档见 **[docs/API.md](docs/API.md)**(认证/工单/封禁/用户/设置/通知/投票/更新/导出/外部插件 API
## 快速开始
@@ -79,7 +84,7 @@ node backend/server.js
- `closed` 为终态,仅服主可操作
- 结果申诉仅一次,关联原工单,仅服主可见
## 注册来源
## 注册来源与多身份
| 来源 | 标识 | UID 含义 |
|------|------|---------|
@@ -88,6 +93,8 @@ node backend/server.js
插件注册默认 `skin`
**多身份绑定**:一个账号可同时绑定网易端 + 皮肤站两个身份(控制台「我的身份」或 `POST /api/auth/identities` 管理)。提交工单时可选择使用哪个身份;`user_identities` 表由启动时自动迁移回填,`users` 表主身份字段保持不变(完全兼容旧数据)。
## 工单提交流程
1. 填写标题 + 游戏名 + UID登录后自动填充