豆瓣求片

豆瓣求片用于把用户的豆瓣片单变成 PanSave 可处理的求片任务。适合家人、朋友或多个用户用各自片单表达“想看什么”，系统负责同步、查库、搜索、转存和通知。

入口：资源获取 / 豆瓣求片

使用前准备

豆瓣求片需要先完成：

• Emby 配置
• TMDB 配置
• 监控策略里的搜索来源
• 搜索来源对应的网盘转存目标

豆瓣求片不会单独维护搜索频道。它继承当前 Emby 服务器在监控策略中启用的搜索来源。

添加求片用户

每个求片用户至少需要：

• 用户名：系统里用于区分用户，不一定等于豆瓣真实昵称。
• 豆瓣片单 ID：片单地址里的编号。
• 通知邮箱：可选，开启用户级通知时必填。

同一个 Emby 服务器下，求片用户名称不能重复。每个 Emby 服务器最多允许 10 个求片用户。

测试抓取

保存前建议先点“测试抓取”。

测试抓取用于确认：

• 片单 ID 是否正确
• 片单是否能访问
• 系统能否识别电影或剧集
• 同步预览是否符合预期

如果片单需要登录才能稳定读取，可以在页面里按短信验证码流程保存豆瓣登录状态。未登录时，系统仍会尝试读取公开可访问的片单。

开启同步

开启总开关后，系统会按固定频率同步片单。

新条目进入后，系统会先检查 Emby：

检查结果	后续行为
已完整入库	标记为已入库，不再搜索。
已入库但缺集	标记为缺集，并交给监控清单继续跟踪。
未入库	按监控策略里的来源搜索并尝试转存。

状态怎么理解

状态	含义
待检测	新同步进来的条目，等待检查和处理。
已转存	已经发起转存，等待后续 Emby 确认是否入库。
已入库	Emby 已确认完整存在。
已入库但缺集	Emby 有这个剧集，但仍缺少部分集数。
监控中	暂时没找到或还没补齐，后续交给监控清单继续跟踪。

如果某个条目已经进入“已转存”但 6 小时后仍未在 Emby 里确认，系统会重新把它放回待处理流程。

什么时候会重新搜索

豆瓣求片不是每轮都无脑重搜。只有在搜索依据变化时才会重新处理，例如：

• 新同步进来的片单条目
• TMDB 匹配结果变化
• 原来已入库的资源后来在 Emby 里消失
• 监控策略新增了可搜索来源
• 总开关从关闭重新开启

这样能减少重复请求和重复转存。

通知

豆瓣求片会按状态变化聚合通知：

• 管理员可以收到系统级摘要
• 求片用户可以收到和自己片单相关的邮件

邮件需要先在 系统配置 / 邮箱配置 中启用。Telegram 系统提醒由内置机器人负责。

排查建议

如果豆瓣求片没有按预期处理：

1. 确认当前 Emby 已选对。
2. 确认监控策略里有启用搜索来源。
3. 确认来源已经关联网盘，并且网盘有整理源目录。
4. 确认 TMDB 和 Emby 测试通过。
5. 查看系统日志和该条目的处理历史。