适用于 MoviePilot V2 的 Telegram 公开频道监控与 115 自动转存插件
简体中文 · English
115 网盘转存助手会定时扫描指定的 Telegram 公开频道，识别其中的 115 分享链接，并自动转存到你的 115 网盘目录。它也可以识别磁力和 ED2K 链接，将其提交到 115 离线下载。
插件不需要 Telegram Bot 参与频道读取。Bot Token 只用于发送转存结果通知，是可选配置。
Telegram 公开频道
↓
提取文字、按钮和超链接
↓
可信域名与链接类型检查
↓
115 分享转存 / 影巢OpenAPI解锁 / 115 离线下载
↓
保存记录、去重、统计和通知
- 定时监控多个 Telegram 公开频道，每行配置一个频道用户名。
- 识别消息正文中的 115 分享链接。
- 识别“点击跳转”“直达链接”“立即查看”“一键转存”等文字背后的真实链接。
- 支持
115.com、115cdn.com和anxia.com分享地址，并统一转换为可处理的 115 链接。 - 保留并使用分享链接中的提取码。
- 可选识别
magnet:磁力链接和ed2k://链接，提交到 115 离线下载。 - 支持 MoviePilot 订阅集成，只转存订阅中仍然缺失的资源。
- 使用 SQLite 保存处理记录，避免重复转存；也可选择重新处理。
- 可通过 Telegram Bot 向指定账号发送成功、失败和本轮汇总通知。
- 自动复用 MoviePilot 的网络代理访问 Telegram 页面和 Bot API。
- 插件详情页显示运行状态、今日统计和最近处理记录。
- 识别
hdhive.com/resource/...，通过影巢官方 OpenAPI 解锁后复用原有115转存流程。 - 自动刷新过期的影巢 Access Token，并单独记录等待、成功和失败状态。
- 主动读取MoviePilot订阅，按媒体类型和TMDB ID查询影巢资源。
- 可自建轻量OAuth服务，App Secret和Token不再保存于MoviePilot。
- 提供linux/amd64和linux/arm64 Docker镜像自动构建。
插件不会像浏览器一样随意点击页面中的按钮。
| 链接类型 | 处理方式 |
|---|---|
115.com、115cdn.com、anxia.com |
识别并转存 |
| Telegram 官方域名中的可信包装参数 | 只解析参数，不打开跳转页面 |
magnet:、ed2k:// |
开启离线下载后提交到 115 |
| 广告域名、陌生短链、未知跳转页 | 不访问、不执行 |
| JavaScript 跳转 | 不执行 |
Telegram 包装链接只读取 url、target、redirect、redirect_url 和 link 参数。这样既能处理常见的“点击跳转”“直达链接”，又能降低误入广告网站的风险。
| 场景 | 支持情况 |
|---|---|
| Telegram 公开频道 | ✅ 支持 |
| 正文中的直接 115 分享链接 | ✅ 支持 |
| 按钮或文字背后的可信 115 链接 | ✅ 支持 |
| Telegram 官方包装的可信链接 | ✅ 支持 |
| 磁力链接和 ED2K 链接 | ✅ 可选 |
| MoviePilot 订阅缺集过滤 | ✅ 可选 |
| Telegram 私有频道 | ❌ 暂不支持 |
| 广告、陌生短链和未知跳转页 | ❌ 主动拒绝 |
| 影巢OpenAPI解锁和115转存 | ✅ 需要官方应用及OAuth授权 |
插件只调用影巢官方 OpenAPI，不模拟登录，也不会绕过网站权限。
进入 MoviePilot V2 的插件市场设置，添加下面的自定义插件仓库：
https://github.com/xhui999w/my-mp-plugins-v2
刷新后搜索 115 网盘转存助手，确认显示的版本为 1.5.0 或更高版本。
点击“安装到本地”。安装成功后，在已安装插件中打开 115 网盘转存助手。
如果市场提示安装成功，但已安装列表中没有插件：
- 先刷新浏览器页面。
- 再重启 MoviePilot。
- 回到插件市场重新安装。
- 在 MoviePilot 日志中搜索
Tg115Transfer或115转存助手。
只填写频道用户名，不要填写完整网址，也不要加 @。
例如频道地址是：
https://t.me/xhui999w
配置中填写：
xhui999w
多个频道一行一个。
在浏览器中登录你自己的 115 账号，取得完整 Cookie 后粘贴到 115 Cookie（必填）。
Cookie 相当于账号登录凭证：
- 不要发到聊天群、Issue 或日志截图中。
- 不要提交到 GitHub。
- Cookie 失效后，需要重新获取并保存。
打开 115 网页版并进入要保存资源的目录，从浏览器地址栏中找到 cid 参数，将其数值填写到 保存目录ID。
填写 0 表示保存到根目录。
- 普通 115 分享转存：不需要开启额外开关。
- 磁力和 ED2K：开启 启用115离线下载（磁力 / ED2K）。
- 仅处理 MoviePilot 缺失资源：订阅集成模式选择 仅转存订阅缺失资源。
- 需要 Telegram 通知：填写 Bot Token 和管理员用户 ID，并开启通知。
- 开启 启用插件。
- 首次测试时开启 立即运行一次。
- 点击保存。
- 等待约 10～30 秒。
- 打开插件详情页查看统计和最近记录。
- 在 MoviePilot 日志中搜索
115转存助手。
正常日志示例：
【115转存助手】频道 @example 扫描完成，新链接: 2 条
【115转存助手】发现115分享: https://115.com/s/...
【115转存助手】本轮监控完成 | 发现 2 条 | 成功 2 条 | 失败 0 条
| 配置项 | 是否必填 | 说明 |
|---|---|---|
| 启用插件 | 是 | 开启定时监控 |
| 立即运行一次 | 否 | 保存后执行一次扫描，会自动关闭 |
| 检查间隔 | 是 | 默认 10 分钟，建议 5～30 分钟 |
| 单次最大处理数量 | 是 | 默认 50，限制一次扫描的处理量 |
| 公开频道列表 | 是 | 每行一个频道用户名 |
| Bot Token | 否 | 只用于发送 Telegram 通知 |
| 管理员用户ID | 否 | 接收通知的 Telegram 数字 ID |
| 115 Cookie | 是 | 115 登录凭证，请妥善保管 |
| 保存目录ID | 是 | 0 为根目录，其他值为目录 cid |
| 重复处理方式 | 是 | skip 跳过记录，reprocess 重新处理 |
| 115 离线下载 | 否 | 处理磁力和 ED2K 链接 |
| 订阅集成模式 | 否 | 可只转存 MoviePilot 订阅缺失资源 |
| 转存结果通知 | 否 | 需要同时配置 Bot Token 和用户 ID |
依次检查：
- 启用插件是否已打开。
- 频道是否为公开频道，用户名是否填写正确。
- MoviePilot 容器能否访问
https://t.me/s/频道用户名。 - 115 Cookie 是否仍然有效。
- 是否开启了“立即运行一次”，或者等待了完整的检查间隔。
- 日志中搜索
115转存助手，不要只搜索插件的市场名称。
405 METHOD NOT ALLOWED：请升级到1.2.6或更高版本。- Cookie 无效：重新取得 Cookie 并保存。
- 分享已失效或提取码错误：请先在浏览器中手动验证分享。
- 保存目录无效：重新检查目录
cid。 - 旧失败记录被去重：临时把重复处理方式改为
reprocess后再测试。
确认已开启 启用115离线下载（磁力 / ED2K）。插件提交成功只代表任务进入 115 离线列表，不代表文件已经下载完成。
插件只处理最终目标为可信 115 域名，或 Telegram 官方包装参数中包含可信目标的链接。陌生域名、广告页和短链会被主动忽略。
当前不能。插件读取的是 Telegram 的公开频道网页 t.me/s/...，没有登录 Telegram 用户账号。
1.5.0：新增自建OAuth服务、Docker镜像和MP订阅主动查询影巢转存。1.4.0：新增影巢OpenAPI资源解锁、Token自动刷新、独立目录和去重记录。1.3.1：新增安全跳转白名单，不访问广告、短链及未知跳转页。1.3.0：新增磁力和 ED2K 识别及 115 离线下载。1.2.7：支持提取“点击跳转”等超链接中的 115 地址。1.2.6：修复 115 分享信息接口返回 405 的问题。1.2.5：修复立即运行后配置被清空的问题。1.2.4：Telegram 抓取和 Bot 通知复用 MoviePilot 代理。1.2.0：新增 MoviePilot 订阅缺失资源过滤。
完整记录可在插件市场的版本历史中查看。
my-mp-plugins-v2/
├── package.v2.json
└── plugins.v2/
└── tg115transfer/
├── __init__.py
└── requirements.txt
本项目在学习和实现过程中参考了：
感谢 MoviePilot 社区及以上开源项目作者。
本项目仅用于个人学习和自动化管理。请仅处理你有权访问和保存的内容，并遵守当地法律、Telegram、115 网盘及资源来源站点的服务条款。项目作者不提供任何内容，也不对第三方链接的可用性、合法性或使用后果负责。