📅 订阅管理

订阅功能自 v2.8.0 起提供，用于集中查看追番日历，并根据外部元数据或视频页面创建追更任务。v2.8.2 进一步加入 AniBT 元数据与私有 RSS 订阅支持。

版本与能力说明

订阅入口会根据当前已加载、已启用且通过能力检测的弹幕源或元数据源动态生成。页面上没有某个源时，请先检查源是否启用、是否需要授权，以及当前源包是否支持订阅。

功能入口

登录 Web UI 后，进入 “订阅” 页面。页面由两部分组成：

1. 顶部统一搜索区：通过关键词或 URL 创建订阅。
2. 追番日历：查看本地作品和外部日历项目，并执行订阅、退订或批量订阅。

关键词搜索订阅

1. 在订阅页顶部选择 全部源 或指定订阅源。
2. 输入作品名并点击 搜索。
3. 系统会同时使用 bangumi-data 离线索引与可用在线源查找候选项。
4. 核对标题、海报、来源和平台标签后，点击候选项右侧的 订阅。

搜索结果中的“离线命中”表示候选项来自本地 bangumi-data 索引。带有绿色平台标签的结果表示该平台存在可用于抓取弹幕的对应源。

URL 解析订阅

在搜索框粘贴受支持的视频或合集 URL，或点击 URL 解析：

1. 输入完整的 http:// 或 https:// 地址并点击 解析。
2. 系统根据订阅源声明的域名自动定位可处理该 URL 的源。
3. 结构化解析成功后，可选择：
   • 订阅当前视频；
   • 订阅整个合集；
   • 勾选合集中的部分视频后批量订阅。

当前 B 站视频与合集是主要使用场景。页面是否能够识别某类 URL，以当前已加载弹幕源声明的订阅能力为准。

追番日历

追番日历按星期展示本地作品和外部日历项目；没有明确播出日期的作品会显示在 “其他作品” 区域。

工具栏支持：

• 按作品名搜索；
• 显示全部、本地或指定外部源；
• 同步追番日程；
• 清理日历缓存；
• 查看本地和各外部源的项目数量。

卡片会根据可用数据展示来源、年份、类型、季度、播出星期、时间、评分及最新集数。

单项与批量订阅

单项订阅

点击外部作品卡片上的 “订阅”，确认媒体类型、季度和数据源。勾选 立即执行 后，系统会立即提交搜索与导入任务；取消勾选则仅保存订阅，等待后续扫描。

当同一作品匹配多个外部源时，需要先选择用于导入的源。

批量订阅

1. 点击外部作品卡片进行多选；
2. 也可以按当天或当前过滤结果执行全选；
3. 点击悬浮操作条中的 批量订阅；
4. 确认是否立即执行后提交任务。

对合集分集进行批量选择时，系统会按父级订阅目标归组，只导入选中的分集。

取消订阅

点击已订阅卡片上的 “已订阅” 可取消追更：

• 只有一个外部源时，系统直接取消对应订阅；
• 本地作品关联多个外部源时，需要选择要解除的来源；
• 选择取消本地追更时，会解除本地源自身的追更状态。

取消订阅不会自动等同于删除媒体库中已经导入的作品、分集或弹幕。

AniBT 与私有 RSS

v2.8.2 起，项目支持 AniBT 元数据与私有 RSS 追番订阅。使用前应先在对应元数据源或订阅源配置中完成地址、凭据或授权设置。配置成功后，该源会出现在订阅页的可用源列表中。

隐私提示

私有 RSS 地址通常包含访问凭据。截图、日志或问题反馈中必须遮盖完整 URL、Token、Cookie 和账号信息。

常见问题

页面显示“暂无可用订阅源”

请依次检查：

1. 弹幕源或元数据源是否已加载并启用；
2. 对应源是否支持订阅能力；
3. OAuth、Cookie 或私有 RSS 等授权是否完成；
4. 服务端与弹幕源包版本是否兼容。

关键词能搜到作品，但无法创建订阅

候选发现与实际订阅由对应源分别实现。请查看错误提示，并检查该源的授权状态、网络连接、地区限制和日志。

URL 无法识别

请确认 URL 完整且属于已启用订阅源声明的域名。短链接可能依赖网络重定向；无法解析时可改用最终落地地址或关键词搜索。

订阅后没有立即导入

检查订阅时是否启用了 立即执行，并前往任务页面查看任务状态。未立即执行的订阅会等待后续扫描或日程同步。

建议补充的截图

文件名	截图内容	优先级
订阅管理-页面总览.png	顶部搜索区与完整日历，隐藏个人信息	高
订阅管理-关键词搜索.png	多源候选、离线命中和平台标签	高
订阅管理-URL解析.png	当前视频、合集及分集多选	高
订阅管理-追番日历.png	星期分组、来源标签和过滤器	高
订阅管理-批量订阅.png	多选状态、悬浮操作条和确认框	中

截图建议使用桌面端宽度，并遮盖私有 RSS、Token、Cookie、用户 ID 和内网域名等敏感信息。