🎬 字幕中心

字幕中心用于配置字幕来源、媒体库策略，并查看异步补齐任务。它和媒体库同步、媒体健康中心联动：

1. 媒体库同步负责扫描本地侧车字幕，写入字幕快照
2. 字幕中心按策略搜索、下载、写入字幕
3. 媒体健康中心只读取已有快照，发现缺字幕问题并一键跳回字幕中心处理

⚠️ 健康中心不会在查询时扫盘或访问外部字幕源；缺字幕事实来自字幕快照。

快速开始

1. 先完成 媒体服务器 同步
2. 在字幕中心配置至少一个可用来源，详见 字幕来源配置教程
3. 为需要自动补齐的媒体库新增策略并启用
4. 点一次“扫描媒体库”，让路径状态和字幕快照先就绪
5. 需要排查缺字幕时，去 媒体健康中心

页面分区

概览

• 查看最近任务、待处理候选、失败/冷却来源
• 支持手动检查单个媒体，或打开批量巡检

任务

• 查看排队、处理中、待选择、已完成、失败任务
• 任务详情里可：
  • 写入候选字幕
  • 上传本地字幕
  • 重新搜索
  • 取消任务

设置

• 字幕来源：OpenSubtitles、Assrt、SubDL、射手影音、迅雷看看、SubHD、字幕库
• 媒体库策略：语言偏好、格式优先级、来源顺序、自动采用阈值、入库/巡检开关

推荐策略

场景	建议
首次上线	先启用 Assrt / OpenSubtitles，观察几天再开网页源自动写入
本地媒体多	可开启射手影音、迅雷看看做哈希/CID 精确匹配
网页源	SubHD、字幕库默认更适合人工确认，Cookie/过盾按需开启
网络受限	海外 API 可单独开系统代理，不影响其他来源

和健康中心的关系

• 健康中心的「缺字幕」来自字幕快照 language_state=missing
• 点“检查字幕”会创建字幕任务，并跳到字幕中心
• 已有任务时，可直接“查看字幕任务”

常见问题

为什么来源显示“未配置 / 冷却中”？

• 未配置：还没保存凭据，或网页源关键项不完整
• 冷却中：上游限流、认证失败或连续错误后，系统会暂时熔断该来源

为什么测试显示失败，但公共提示和页面提示不一致？

• 业务错误会由公共拦截器先提示
• 页面成功提示只在 code=20000 时出现
• 连通性测试测的是已保存配置，不是弹窗里未保存的输入

为什么某些来源搜不到？

• 射手影音依赖本地可读媒体哈希，网盘/STRM 不会走哈希匹配
• 迅雷看看依赖标题检索 + 可选 CID 校验
• OpenSubtitles / SubDL 优先 TMDB/IMDb 身份检索
• 网页源可能需要 Cookie、代理或过盾

相关文档

• 字幕来源配置教程
• 媒体健康中心
• 媒体服务器
• 媒体库