管理后台

管理后台是 RPG Roleplay 平台管理员专用的运维控制台，涵盖用户管理、用量分析、安全配置、合规处置与成就目录编辑等全平台管理功能。只有角色为管理员的账号才能访问，普通用户访问时会被重定向至权限拒绝页。

入口：顶部导航「系统管理」分组，或在搜索框中直接输入子功能名称跳转。

子页面总览

子页面	路由	用途
部署配置	`#admin-deploy`	监听地址、CORS、上传限制、SMTP、CAPTCHA
用户管理	`#admin-users`	查看用户列表、停用/恢复、强制下线、角色变更
全局用量	`#admin-usage`	全平台 Token 消耗与 API 成本总览
审计日志	`#admin-audit`	管理员操作记录
系统健康	`#admin-health`	数据库、内存、磁盘与进程状态（每 30 秒刷新）
系统日志	`#admin-logs`	运行时日志查看与下载
注册与邀请	`#admin-registration`	注册模式开关、邀请码生成与管理
安全配置	`#admin-security`	速率限制、密码策略、Session 策略、IP 黑名单
维护模式	`#admin-maintenance`	全局维护公告开关与服务重启
DMCA 下架	`#admin-dmca-takedowns`	下架请求受理与处置
DMCA Strike	`#admin-dmca-strikes`	Strike 累积与账号限制管理
CSAM 举报	`#admin-csam-reports`	儿童性虐待材料举报队列与处置
AUP 用户行动	`#admin-aup-actions`	搜索用户执行暂停、解封、永久终止
反馈审查	`#admin-feedback`	用户提交的反馈审查队列
成就目录	`#admin-achievements`	新建、编辑、停用成就定义

常见任务

查找并管理用户

进入「用户管理」(#admin-users)，支持按用户名搜索，以及按角色（管理员/普通用户）和状态（活跃/已停用）筛选。列表每页显示 20 条，显示用户名、显示名、角色、状态、最后登录时间、30 天 Token 消耗、活跃 Session 数。

每行可执行以下操作（均有确认对话框）：

操作	说明
停用	用户无法登录，数据保留，可随时恢复
恢复	重新允许已停用用户登录
强制下线	使该用户所有 Session 立即失效
升为管理员	授予系统管理权限
降为普通用户	撤销管理权限

注意：不能对自己账号执行停用、升降权限操作。

查看全平台用量

进入「全局用量」(#admin-usage)，右上角选择时间范围（7 / 14 / 30 / 90 天）。页面分为四个区块：

总览：总请求数、总 Token（输入+输出）、总估算成本（USD）
按用户排行：各用户的 Token 量、估算成本与占比进度条
按 API 分布：各供应商的 Token 用量与成本
按天趋势：日粒度 Token 柱状图

生成邀请码

进入「注册与邀请」(#admin-registration)，点「生成邀请码」，填写数量（支持批量生成）、有效天数（7 / 14 / 30 / 90 / 180 / 365 天）、备注（可选），点「生成」即可。

列表显示每个码的状态：可用（绿色）、已使用（灰色，标注被谁使用）、已过期（红色）。未使用的码可随时删除。

同一页面还可以切换注册模式（开放注册 / 仅邀请 / 关闭注册），以及开关「邮箱验证」和「自动审批」。

处理用户反馈

进入「反馈审查」(#admin-feedback)，默认显示「未审核」队列。点「查看」弹出详情弹窗，包含：

提交时间与当前审核状态
反馈正文
客户端运行环境切片（URL、应用版本、视窗、活跃存档/剧本/回合、近期错误与 API 失败日志）
NSFW 审核结果（若有）
对话节选（若有）

可执行以下决定：

决定	说明
OK	标记为已处理，正常情况
标垃圾	标记为无效反馈
终止账号(NSFW)	需先在下方填写理由才可点击，操作不可逆，慎用

还可以在弹窗内给用户发送回复，回复展示在该用户的「我的反馈历史」中，与审核决定互不影响。留空并点「更新回复」可撤回已发送的回复。

管理成就目录

进入「成就目录」(#admin-achievements)，显示当前所有成就定义。

新建成就：点「新建成就」，填写：

ID（小写字母/数字/下划线，创建后不可修改）
名称与描述
图标
类目（启程 / 叙事 / 探索 / 收藏 / 坚持 / 隐藏）
分级（bronze / silver / gold / 无）
解锁规则：简单模式选指标（如总回合、存档数、分支条数等）+ 算子（≥ / > / =）+ 目标值；高级模式直接写复合规则 JSON（{"all": [...]} 格式）
隐藏成就：开启后未解锁用户看到打码展示
启用状态

编辑成就：点行内「编辑」按钮，修改后保存即时生效。

停用成就：点「停用」后成就从前台消失，已解锁的用户记录不受影响（成就只增不删）。

安全配置

进入「安全配置」(#admin-security)，分四个区块，修改后点「保存」：

速率限制：每 IP 最大请求数、每用户最大请求数、时间窗口（分钟）。修改需重启服务才生效。
密码策略：最小长度、是否要求包含数字。
Session 策略：Session 超时天数。
IP 黑名单：每行一个 IP 或 CIDR 段（如 192.168.1.0/24）。

开启维护模式与重启服务

进入「维护模式」(#admin-maintenance)：

维护模式开关：开启后所有用户看到维护公告，可在此编辑公告内容。
服务重启：点「重启服务」按钮，弹出确认对话框，确认后向后端发送优雅重载信号，约 5–15 秒完成。建议先开启维护模式，再执行重启。

合规处置

DMCA 下架（#admin-dmca-takedowns）：录入侵权通知（填写权利人姓名、邮箱、侵权 URL、原始作品说明），之后可对每条通知执行下架、拒绝，或录入反通知（自动设置 10 天后恢复计时，到期后可执行恢复操作）。

DMCA Strike（#admin-dmca-strikes）：为累犯用户添加 Strike，累计 3 次触发账户终止流程，系统会提示危险级别。

CSAM 举报（#admin-csam-reports）：记录举报内容，标记决定（成立 / 升级上报 / 不成立）。决定为「成立」时，需按规程向 NCMEC CyberTipline 上报，字段中留有 CyberTip 报告 ID 记录位。

AUP 用户行动（#admin-aup-actions）：搜索用户名，找到后可执行：

暂停（临时，需填写原因和可选天数）
解封
永久终止（不可逆，需填写原因才可点击确认）

查看系统日志

进入「系统日志」(#admin-logs)，可选择拉取行数（50 / 100 / 200 / 500 行），以及按级别过滤（全部 / ERROR / WARN / INFO）。ERROR 行红色高亮，WARN 行橙色高亮。点「下载」可将当前日志保存为 .log 文件。

常见问题

Q：我是管理员但访问 #admin-users 显示权限拒绝？

A：确认账号 role 字段确实是 admin。可以让另一个管理员账号在用户管理列表中确认你的角色，或通过数据库直接核查。

Q：成就「停用」后还能重新启用吗？

A：可以。停用操作将成就标记为停用状态，前台不再展示。若需重新启用，在成就编辑弹窗中将「启用」开关打开并保存即可。

Q：审计日志里的操作类别能过滤哪些？

A：支持按前缀过滤：user.*（用户相关操作）、config.*（配置变更）、maintenance.*（维护模式）、invite.*（邀请码操作），以及「全部」。

Q：速率限制改完需要做什么才能生效？

A：速率限制配置需重启后端服务后生效。保存后前往「维护模式」页面执行服务重启，或通过运维后台重启进程。