订阅与看板

NanShare 订阅系统用于自动追更电影、电视剧和动漫。它会从资源来源搜索分享或可处理资源，结合名称解析、TMDB 匹配、条件筛选、FFprobe、缺集追踪和通知模板，自动执行分享 STRM、转存或转存再分享。

看板则负责发现资源。它聚合 TMDB 和豆瓣分类，显示已入库状态，并提供添加订阅、快捷搜索和一键转存入口。

订阅来源

来源	说明
TG 频道搜索	使用 Telethon 客户端 API 搜索 Telegram 频道或群组消息
HDHive 搜索	使用 HDHive 解析或 Open API 获取资源
影巢	作为搜索来源之一提供资源结果

TG 搜索支持：

• 二维码登录。
• 手机号 + 验证码登录。
• 二步验证。
• 代理设置。
• 多 Telegram API 配置。
• 频道或群组消息搜索。

HDHive 支持：

• 账号密码登录。
• Cookie 自动刷新。
• Token 定时刷新。
• API Key 模式。
• 多账号签到。
• 积分限制。
• 自动转存到 115。

订阅策略

策略	说明	适合场景
分享 STRM	直接根据分享生成 STRM	快速入库，不强制转存
转存	把资源保存到自己的 115 目录	想沉淀到自己网盘
转存再分享	批量转存后创建自己的分享并生成 STRM	长期库、减少原分享取消影响

转存再分享流程：

搜索资源 -> 命中分享 -> 转存到自己 115 -> 创建新分享 -> 生成分享 STRM -> 通知

筛选条件

订阅可以按资源参数过滤：

条件	示例
分辨率	2160p、1080p、720p
特效	HDR、DV、HDR10+
来源	WEB-DL、BluRay、REMUX
制作组	CMCT、HDSky、MTeam
平台字段	按解析结果中的 webSource 字段筛选
编码	H265、H264、AV1
音频	AAC、EAC3、TrueHD

当文件名缺少分辨率或特效信息时，可启用 FFprobe 在线探测，提升匹配准确度。

电影追更

电影订阅通常在命中一个合适资源并执行成功后完成。

流程：

1. 搜索电影标题、年份和别名。
2. 解析资源名称并通过 TMDB 校验。
3. 应用分辨率、特效、制作组、平台等条件。
4. 执行分享 STRM、转存或转存再分享。
5. 发送完成通知。

电视剧追更

电视剧订阅会维护缺集进度。

规则：

• 按季和集识别资源。
• 每集可从多个分享中选择最符合条件的版本。
• 已完成的集不会重复处理，除非手动重跑或配置允许替换。
• 可根据缺集列表只处理缺失集数。
• 通知中可展示本次新增集、剩余缺集和资源质量。

名称解析引擎

内置名称解析器会提取：

• 名称。
• 年份。
• 季。
• 集。
• 分辨率。
• HDR、DV、HDR10+ 等特效。
• 视频编码。
• 音频编码。
• 制作组。
• 平台字段。
• Part、版本、来源等补充信息。

如果解析不准确，可使用：

• 自定义识别词。
• 自定义制作组。
• 自定义捕获词。
• 渲染后处理词。
• OpenAI 辅助识别。
• 手动指定 TMDB。

通知模板

订阅通知支持 Jinja2 模板，并可携带海报图片。常用字段与文件整理通知相近；webSource 仅在解析结果存在平台字段时显示。

🎯 {{ title }} {{ year }}

策略：{{ strategy }}
质量：{{ resource_quality }}
来源：{{ source }}
制作组：{{ releaseGroup }}
平台：{{ webSource }}
缺集：{{ lack_episode }}
本次完成：{{ completed_episode }}

{{ overview }}

看板

看板集成 TMDB 和豆瓣双数据源。

TMDB 分类：

• 流行趋势。
• 正在热映。
• 电影。
• 电视剧。
• 正在播出。
• 分类排序。

豆瓣分类：

• 正在热映。
• 热门电影。
• 热门电视剧。
• 热门动漫。
• 电影 TOP250。
• 国产剧集榜。
• 全球剧集榜。

看板操作

操作	说明
已入库标识	海报上显示资源是否已在 Emby 媒体库中
添加订阅	从看板一键创建订阅
入库过滤	添加订阅前自动过滤已入库条目
快捷搜索	用 TG 频道或 HDHive 搜索当前影片
一键转存	命中资源后直接转存
榜单订阅	将榜单资源加入订阅流程

HDHive 快捷链路

如果看板中发现目标影片，可以通过 HDHive 快捷搜索并解析：

看板影片 -> HDHive 搜索 -> 解析资源 -> 转存 115 -> 生成分享 STRM -> Emby 扫库

TG 频道搜索链路

看板影片 -> TG 频道搜索 -> 提取分享链接 -> 订阅筛选 -> 分享 STRM / 转存 / 转存再分享

建议配置

• 电影：优先按年份和 TMDB 校验，避免同名误判。
• 电视剧：开启缺集追踪，筛选条件不要过窄。
• 动漫：配置自定义识别词和制作组，必要时做集数偏移。
• 高质量库：开启 FFprobe，筛选 HDR/DV、REMUX、指定制作组。
• 自动化库：使用转存再分享，降低外部分享失效影响。