系统概览
在线会话（Web / App）
判定为「在线」：最近 120 秒内有心跳或搜索/播放/下载等行为。网页端会定时请求 POST /api/presence/heartbeat；请求头 X-Client-Type 用于区分 web / android / ios。
| 客户端 |
用户 |
设备信息 |
IP |
最近活跃 |
| 刷新后加载 |
实时行为监测
聚合搜索、播放、下载及客户端上报的播放失败原因。服务端在请求发生时写入；播放失败可由前台调用 POST /api/behavior/report 补充。
| 时间 |
动作 |
客户端 |
用户 |
详情 |
结果 |
失败原因 |
| 加载中… |
API 自检
调用 GET /api/admin/self-check，检测 SQLite、依赖、Cookies、重启脚本、ffmpeg 等；下方以表格展示分项结果与后台接口中文说明，合并日志可展开查看。
检查项
后台接口说明
合并日志（log）
播放用量（按分钟）
设置保存在数据库 settings，键名 usage_guest_daily_limit_minutes、usage_user_daily_limit_minutes。前台 GET /api/config 会返回 guest_daily_limit_minutes、user_daily_limit_minutes，可按整数分钟精确配置。
搜索关键词定向
模糊匹配：若任一段搜索词包含下表「源词」子串（英文不区分大小写），则把该段整段换成「定向为」再去 YouTube 搜索（例：源词 故事 时，好听的故事 也会命中并整段变为 dab neeg）。
多规则按排序优先；更长的源词请设更小排序数，避免短词抢先匹配。
新增 / 编辑
用户管理
数据来自 SQLite 表 users（与注册/登录共用）。请先在前台登录，以便识别本人账号并禁止自损操作。会员期限可选「取消」或按月 / 季度 / 年续期（自尚未过期的原到期日与今天中较晚者起算）；「更新密码」将重置密码并下线该用户全部登录会话。
| 用户名 |
邮箱 |
禁用 |
管理员 |
会员到期 |
注册时间 |
操作 |
| 加载中… |
编辑选中用户
YouTube Cookies
① 点击下方「选择文件」选中本地的 cookies.txt（Netscape 导出格式）② 再点 上传并覆盖。成功后「当前状态」与下方摘要会立即更新。
服务重启
将执行服务器上的 admin_restart.sh：结束当前 uvicorn main:app 进程并重新拉起（默认端口 8000）。
操作后本页会短暂无法连接，属正常现象。可通过环境变量 UVICORN_HOST / UVICORN_PORT / PYTHON_BIN 覆盖启动参数。
若设置 ADMIN_RESTART_TOKEN，请求需带请求头 X-Admin-Restart-Token。设置 ADMIN_RESTART_DISABLED=1 可禁用本功能。
加载中…
搜索分类
首页快捷标签使用此处配置。多个关键词用 |、;、英文冒号 :、中文冒号 ： 或换行分隔，保存后会规范为同一格式；用户点击分类时随机抽取其中一个词单独搜索（不合并多词）。禁用后前台不再展示该分类。
新增 / 编辑