用户管理与标签
把「谁能登录、能看哪些菜单、能用多少流量、何时到期」收进同一张表，面向日常运营用户的站长与管理员。菜单叫「用户管理」，页面标题是「账号管理」。
用户管理：所有运营动作都从这张表发起
列表默认显示用户、状态、到期、在线、30 天流量、创建时间六列，另有八列可按需打开。勾选若干行后底部浮出批量操作栏，13 项动作一次下发。
- 10 维组合筛选 + 22 条常用预设，条件写进 hash URL，可以直接把一次筛选结果发给同事
- 详情抽屉 8 个 Tab，把单个用户的观影、授权、会话、流量与禁用历史摊开
- 账号工具里做 Excel 导入导出与标签管理，导入完成后报「新建 X 位、更新 Y 位」
能做什么
- 新建、编辑、启停、重置密码、换绑邮箱与 Telegram ID、删除用户。
- 给非管理员委派部分后台菜单。
- 10 维组合筛选，或直接用 22 条预设定位人群。
- 勾选多行批量下发 13 项运营动作。
- 用 8 色标签做运营分层，可被注册码预设并核销继承。
界面与操作
概览卡
顶部 5 张卡只做汇总，下钻筛选统一收到下方「常用筛选」区。
| 卡片 | 展示内容 | 交互 |
|---|---|---|
| 在线 | 在线人数 + 播放中路数 | 整卡可点，进入实时在线会话 |
| 启用 / 停用 | 启用数 / 停用数 + 启用率进度条 | 仅展示 |
| 30 天流量 | 近 30 天汇总 + 人均 | 仅展示 |
| 即将 / 已过期 | 左为 14 天内到期，右为已过期 | 仅展示 |
| TOP 流量 | 流量榜前几名预览 | 「查看更多」打开完整排行榜 |
10 维筛选
关键词框匹配用户名、邮箱与 Telegram ID。10 个维度可任意叠加，每个维度都是固定档位而非自由输入，判定口径以 tooltip 呈现。
| 维度 | 档位 |
|---|---|
| 状态 | 在线（近 5 分钟有活跃会话）· 离线 · 已启用 · 已停用 |
| 角色 | 管理员 · 普通用户 |
| 创建时间 | 今天 · 7 天内 · 30 天内 · 30 天前 |
| 到期状态 | 已过期 · 14 天内到期 · 正常（14 天以上）· 永久（无到期日） |
| 30 天流量 | 重度（≥50 GB）· 中度（5–50 GB）· 轻度（0–5 GB，不含 0）· 无流量（=0） |
| 积分 | 有积分（>0）· 1000 以上 · 100–999 · 1–99 · 无积分（≤0） |
| 限速 | 已限速（启用带宽上限且上限 > 0）· 跟随全局 |
| Telegram | 已绑定 · 未绑定 |
| 邮箱 | 已绑定 · 未绑定 |
| 标签 | 多选标签，口径为任一 / 全部 / 无标签，单次最多 50 个 |
生效条件以 chip 显示（如「状态：已停用」）并写进地址栏，可以直接把一次筛选结果发给同事；链接里塞进来的非法字段与取值一律忽略。
22 条常用预设
预设分 5 组，点一下即写入条件。
| 分组 | 预设 |
|---|---|
| 状态（5） | 在线 · 离线 · 已启用 · 已停用 · 管理员 |
| 到期（3） | 已过期 · 14 天内到期 · 永久账号 |
| 用量（5） | 重度流量 · 中度流量 · 无流量 · 有积分 · 已限速 |
| 绑定 / 注册（5） | 未绑定 TG · 未绑定邮箱 · 今天新增 · 7 天内新增 · 30 天前注册 |
| 常用组合（4） | 沉默用户 · 到期重度用户 · 过期但仍启用 · 新号未激活 |
四条组合预设一次写入多个条件：
| 预设 | 条件 | 用途 |
|---|---|---|
| 沉默用户 | 离线 且 近 30 天零流量 | 找出已经不用的人 |
| 到期重度用户 | 14 天内到期 且 重度使用 | 续费沟通优先级最高 |
| 过期但仍启用 | 已过期 且 账号未停用 | 核对到期策略是否漏配 |
| 新号未激活 | 7 天内注册 且 零流量 | 注册后没跑起来的新用户 |
14 项批量操作
勾选行后底部浮出操作栏，范围是「仅当前页明确选择」，翻页不会自动扩大。
| 操作 | 说明 |
|---|---|
| 批量有效期 | 统一设置到期时间 |
| 批量限速 | 设置每用户带宽上限 |
| 批量流量额度 | 用户总额度，或单条播放线路额度 |
| 批量派发 | 在现有到期时间上追加天数 |
| 赠送邀请码 | 发放邀请资格，并通过 Telegram 通知已绑定用户 |
| 开启 / 关闭网页播放 | 两个独立按钮 |
| 节点授权 | 设置节点访问模式与可见节点 |
| 115 播放模式 | 批量设为「代理播放」或「302 直连」，详见播放设置与缓存 |
| 来源授权 | 仅对受限挂载源授予 / 撤销，不影响公开来源 |
| 打标签 | 授予为追加，不清掉已有标签；撤销只移除本次勾选的 |
| 批量启用 | 历史禁用记录与禁用备注保留 |
| 批量禁用 | 可填禁用备注，写入活动 / 禁用记录 |
| 批量删除 | 二次确认，不可撤销 |
详情抽屉 8 个 Tab
点用户名打开抽屉，顶部是到期、在线会话、下载权限等状态块，下面 8 个 Tab：
| Tab | 内容 |
|---|---|
| 观影记录 | 该用户看过什么，带条数 |
| 媒体库 | 用户级媒体库隐藏与排序偏好 |
| 媒体来源 | 受限挂载源的授权情况 |
| 节点 | 节点访问模式与已授权节点 |
| 菜单 | 委派的菜单；为空时显示「门户」 |
| 在线会话 | 当前活跃会话，带客户端与设备名 |
| 流量 | 配额用量与周期 |
| 活动 / 禁用记录 | 登录拒绝、限流、管理员禁用等事件 |
115 播放模式
用户编辑表单的播放权限区域里有一项**「115 播放模式」**，只有两个取值：
| 取值 | 行为 |
|---|---|
| 代理播放（推荐，默认） | play-agent 代理 115 CDN 字节流。限速、流量计量与配额扣减、并发控制、VFS 缓存全部可用 |
| 302 直连 115 CDN | play-agent 鉴权后返回 302，播放器直连 115 CDN。限速、流量计量、配额扣减、并发控制与 VFS 缓存全部失效 |
全局开关没开时它不会生效
这一项只是必要条件之一。它还要配合播放设置页的全局「115 网盘 302 直连」开关才能生效。 全局开关关闭时，已配为「302 直连」的账号会临时回退成代理播放，界面上会提示 「全局未开启，当前不会生效」。这样你可以先把用户逐个配好，再一次性打开全局开关。
用户详情抽屉与列表里也会显示当前模式徽标，方便一眼确认哪些账号已配为直连。 切换模式后，play-agent 的会话缓存会被主动清空，不需要等 5 分钟 TTL 即可生效。
列表列与排序
| 项 | 内容 |
|---|---|
| 14 列可显隐 | 用户（固定显示）、状态、角色、下载、邮箱、Telegram、备注、标签、30 天流量、在线、限速 / 并发、到期、最近活跃、创建时间 |
| 默认开启 6 列 | 用户、状态、到期、在线、30 天流量、创建时间 |
| 9 个排序键 | 用户名、启用、状态、流量、会话、限速、到期、最近活跃、创建时间 |
| 列显隐偏好 | 存在当前浏览器里，不跟随账号漫游 |
角色与委派菜单权限
身份只有三种：管理员、普通用户、带委派菜单权限的用户。可委派的菜单只有 8 项：节点管理、文件管理、媒体管理（同时覆盖媒体整理页）、调度中心、系统配置、用户管理、邀请管理、播放设置。
「文件运维」「访问管控」「播放报表」三项在委派面板里没有勾选框，无法委派，只有管理员能进。
委派菜单留空等于只能进用户门户；管理员或持有任意委派菜单的账号登录后落到后台仪表盘。管理员另外豁免带宽限速、播放流量配额与节点授权，但流量仍计入统计。
资料与配额的边界
用户资料里没有手机号，也没有独立昵称字段，界面显示名就是用户名。配额只有三类：播放流量（用户级 + 入口级）、带宽限速、并发流数，没有存储空间配额。
生命周期
| 动作 | 规则 |
|---|---|
| 新建 | 密码必填 |
| 编辑 | 改备注、头像、各类授权与配额 |
| 启用 / 停用 | 停用备注写入历史，重新启用后记录仍保留 |
| 重置密码 | 新密码至少 6 位 |
| 换绑邮箱 / Telegram ID | 留空即解绑 |
| 删除 | 二次确认，不可撤销 |
| 批量派发时长 / 统一到期时间 | 见批量操作 |
| Excel 导入 / 导出 | 账号工具菜单，另有导入模板可下载 |
用户标签体系
标签是纯运营分层工具，不参与任何权限判定。
| 项 | 规则 |
|---|---|
| 颜色 | 8 色固定色板，不接受自由色值 |
| 管理入口 | 「账号工具 → 标签管理」增删改，每个标签显示绑定用户数 |
| 打标入口 | 单个用户在表单里多选；或在批量操作栏授予 / 撤销 |
| 筛选口径 | 任一 / 全部 / 无标签，最多叠加 50 个标签 |
| 注册码继承 | 注册码可预设标签，核销时自动继承，覆盖全部 5 条核销路径 |
| 删除影响 | 级联解绑所有用户并移除注册码预设，不可撤销，有二次确认 |
六种登录方式
| 方式 | 说明 |
|---|---|
| 账号密码 | 用户名或邮箱 + 密码 |
| Telegram Login Widget | 官方 OAuth 组件 |
| Telegram 数字 ID + 验证码 | 输入 TG 数字 ID，向该 ID 发码 |
| Telegram Mini App | 免密登录 |
| Telegram Bot 一次性令牌 | 形如 #/bot-login?token= 的链接 |
| Google 账号 | 需配置 Google Client ID，未配置时不出现入口 |
找回密码四步：探测可用验证方式 → 选邮箱或 Telegram（掩码展示）→ 发码验码 → 设新密码。两种都没绑定时提示「该账号没有可用的验证方式」。
关键规则
- 没有二次验证（2FA / TOTP）。登录失败锁定不可配置：同一 IP + 用户名连续失败 5 次锁定 60 秒，客户端显示倒计时。
- 禁用、过期、未满足强制绑定三种情况分别拒绝登录，并记入活动日志。
- 强制绑定可要求 EMAIL / TELEGRAM / TELEGRAM_GROUP（须仍在指定群内），未满足者禁止访问 Emby 接口。群成员检查可一键批量禁用退群用户。
- 批量操作只对当前页明确勾选的行生效。删除用户与删除标签都不可撤销。