Skip to content

观看保号

观看保号 用于在原有会员到期规则之外,再增加一层“最近是否有观看行为”的约束。

它适合这类场景:

  • 希望账号不仅按到期时间管理,还要求用户保持最近活跃
  • 希望到期用户在满足最近观看条件时自动续期
  • 希望长期不观看但仍在有效期内的账号自动进入禁用状态

使用前提

启用前建议先确认以下几点:

  • Emby Webhook 已正常配置,系统能够持续收到播放相关事件
  • 用户播放数据会正常进入本系统,最后观看时间 能持续更新
  • 你接受“会员规则始终生效,观看规则是在其上叠加”的口径

如果 Webhook 没有打通,系统无法及时更新 最后观看时间,观看保号判断就会失真。

怎么开启

进入后台 配置中心 -> 基础 -> 账号策略,在 保号规则 区域配置。

1. 会员到期规则

会员到期规则 当前为固定启用。

这表示:

  • 到期时间始终存在业务意义
  • 用户中心会持续显示到期日期
  • 账号是否到期,始终会参与状态判断

2. 启用观看保号规则

打开 启用观看保号规则 后,系统才会开始按最近观看情况做额外判断。

关闭时,系统只按会员到期规则工作。

3. 最近观看窗口天数

最近观看窗口天数 表示系统往前看多少天内是否存在播放行为。

例如设置为 30

  • 系统会检查最近 30 天内是否有播放记录
  • 有播放则视为满足观看条件
  • 没有播放则视为不满足观看条件

4. 到期自动续费天数

到期自动续费天数 只在“用户已经到期,但又满足观看条件”时生效。

例如设置为 30

  • 用户已到期
  • 最近 30 天内有播放行为
  • 到期扫描命中后,会自动续 30

当前执行规则

会员规则是基础规则

当前系统口径是:

  • 会员规则 永远是基础规则
  • 观看规则 是附加规则,不替代会员规则

所以文档上可以直接理解为:

  • 先看账号是否到期
  • 再看是否满足最近观看条件
  • 最终状态由这两层规则共同决定

白名单优先

白名单用户不参与观看保号和到期删除判断。

手动禁用和客户端黑名单

已被手动禁用、或因客户端黑名单进入禁用状态的账号,不会通过观看保号自动恢复;应按原有禁用原因处理。

系统如何判断

系统主要依赖两条链路:

1. Emby Webhook 更新最近观看时间

当用户发生播放行为时,系统会通过 Emby Webhook 更新账号的 最后观看时间

这是观看保号判断的数据来源。

2. 定时任务统一重算

系统不会在每次用户操作后立刻做完整重算,而是通过后台任务统一处理。

当前有 2 条与观看保号直接相关的系统任务:

  • 到期扫描
  • 观看保号扫描

两类系统任务分别做什么

到期扫描

到期扫描 用于处理“已经到期”的账号。

命中后的结果如下:

  • 已到期,且满足最近观看条件:自动续期,并恢复为 正常
  • 已到期,但不满足观看条件:继续保持到期或进入观看禁用,具体取决于组合规则结果

观看保号扫描

观看保号扫描 用于处理“当前仍处于正常状态的账号”。

当前默认每天 08:30 运行一次。

命中后的结果如下:

  • 账号仍有效,且最近观看达标:保持 正常
  • 账号仍有效,但最近观看不达标:禁用账号,并写入禁用原因 观看保号不足

状态会如何变化

常见结果可以这样理解:

场景结果
未到期,且最近有观看正常
未到期,但最近无观看已禁用,禁用原因为 观看保号不足
已到期,且最近有观看自动续期后回到 正常
已到期,且最近无观看已过期已禁用,以最终组合判断为准
白名单用户不参与观看保号判断

其中:

  • 已过期 更偏向“会员已到期”
  • 已禁用 更偏向“明确禁用”,例如 观看保号不足

怎么手动执行

如果你刚修改了规则,或者想立即检查效果,可以在后台 异步任务 页面手动执行:

  • 系统到期禁用用户
  • 系统观看保号扫描
  • 系统到期删除用户

操作方式:

  1. 进入 异步任务
  2. 点击右上角 手动触发
  3. 选择对应系统任务
  4. 点击 确认执行

如果当前已有同类任务在排队或执行,系统不会重复创建。

排查建议

如果你发现观看保号结果不符合预期,建议优先排查:

  • Emby Webhook 是否正常到达系统
  • 用户最近播放后,最后观看时间 是否更新
  • 最近观看窗口天数 是否设置过短
  • 是否把用户加入了白名单
  • 是否已有同类系统任务正在执行,导致本次手动触发被跳过

相关文档