观看保号
观看保号 用于在原有会员到期规则之外,再增加一层“最近是否有观看行为”的约束。
它适合这类场景:
- 希望账号不仅按到期时间管理,还要求用户保持最近活跃
- 希望到期用户在满足最近观看条件时自动续期
- 希望长期不观看但仍在有效期内的账号自动进入禁用状态
使用前提
启用前建议先确认以下几点:
- Emby Webhook 已正常配置,系统能够持续收到播放相关事件
- 用户播放数据会正常进入本系统,
最后观看时间能持续更新 - 你接受“会员规则始终生效,观看规则是在其上叠加”的口径
如果 Webhook 没有打通,系统无法及时更新 最后观看时间,观看保号判断就会失真。
怎么开启
进入后台 配置中心 -> 基础 -> 账号策略,在 保号规则 区域配置。
1. 会员到期规则
会员到期规则 当前为固定启用。
这表示:
- 到期时间始终存在业务意义
- 用户中心会持续显示到期日期
- 账号是否到期,始终会参与状态判断
2. 启用观看保号规则
打开 启用观看保号规则 后,系统才会开始按最近观看情况做额外判断。
关闭时,系统只按会员到期规则工作。
3. 最近观看窗口天数
最近观看窗口天数 表示系统往前看多少天内是否存在播放行为。
例如设置为 30:
- 系统会检查最近
30天内是否有播放记录 - 有播放则视为满足观看条件
- 没有播放则视为不满足观看条件
4. 到期自动续费天数
到期自动续费天数 只在“用户已经到期,但又满足观看条件”时生效。
例如设置为 30:
- 用户已到期
- 最近
30天内有播放行为 - 到期扫描命中后,会自动续
30天
当前执行规则
会员规则是基础规则
当前系统口径是:
会员规则永远是基础规则观看规则是附加规则,不替代会员规则
所以文档上可以直接理解为:
- 先看账号是否到期
- 再看是否满足最近观看条件
- 最终状态由这两层规则共同决定
白名单优先
白名单用户不参与观看保号和到期删除判断。
手动禁用和客户端黑名单
已被手动禁用、或因客户端黑名单进入禁用状态的账号,不会通过观看保号自动恢复;应按原有禁用原因处理。
系统如何判断
系统主要依赖两条链路:
1. Emby Webhook 更新最近观看时间
当用户发生播放行为时,系统会通过 Emby Webhook 更新账号的 最后观看时间。
这是观看保号判断的数据来源。
2. 定时任务统一重算
系统不会在每次用户操作后立刻做完整重算,而是通过后台任务统一处理。
当前有 2 条与观看保号直接相关的系统任务:
到期扫描观看保号扫描
两类系统任务分别做什么
到期扫描
到期扫描 用于处理“已经到期”的账号。
命中后的结果如下:
- 已到期,且满足最近观看条件:自动续期,并恢复为
正常 - 已到期,但不满足观看条件:继续保持到期或进入观看禁用,具体取决于组合规则结果
观看保号扫描
观看保号扫描 用于处理“当前仍处于正常状态的账号”。
当前默认每天 08:30 运行一次。
命中后的结果如下:
- 账号仍有效,且最近观看达标:保持
正常 - 账号仍有效,但最近观看不达标:禁用账号,并写入禁用原因
观看保号不足
状态会如何变化
常见结果可以这样理解:
| 场景 | 结果 |
|---|---|
| 未到期,且最近有观看 | 正常 |
| 未到期,但最近无观看 | 已禁用,禁用原因为 观看保号不足 |
| 已到期,且最近有观看 | 自动续期后回到 正常 |
| 已到期,且最近无观看 | 已过期 或 已禁用,以最终组合判断为准 |
| 白名单用户 | 不参与观看保号判断 |
其中:
已过期更偏向“会员已到期”已禁用更偏向“明确禁用”,例如观看保号不足
怎么手动执行
如果你刚修改了规则,或者想立即检查效果,可以在后台 异步任务 页面手动执行:
系统到期禁用用户系统观看保号扫描系统到期删除用户
操作方式:
- 进入
异步任务 - 点击右上角
手动触发 - 选择对应系统任务
- 点击
确认执行
如果当前已有同类任务在排队或执行,系统不会重复创建。
排查建议
如果你发现观看保号结果不符合预期,建议优先排查:
- Emby Webhook 是否正常到达系统
- 用户最近播放后,
最后观看时间是否更新 最近观看窗口天数是否设置过短- 是否把用户加入了白名单
- 是否已有同类系统任务正在执行,导致本次手动触发被跳过