功能详解
按模块说明"能做什么、怎么配、什么情况下别开"。
☁️ 网盘管理
把 115、夸克（TV / 网页）统一在一个页面里管：浏览、搜索、上传、建目录、重命名、删除、移动、复制、直链播放。
| 网盘 | 绑定方式 | 能力与限制 |
|---|---|---|
| 115 | 网页扫码登录（Cookie）；也可从 LitePan 同步授权，或粘贴开放平台 token | 浏览 / 上传 / 秒传 / 管理文件 / 直链播放 / 创建分享（分享需 Cookie）。 网页 Cookie 与开放平台 token 二选一，同一套 token 只留一处使用，否则会互相把 refresh_token 顶掉。 |
| 夸克TV | 开放平台扫码 / 设备码 | 4K 原画直链、播放与转存都稳；下载大文件没有 50MB 限制，跨网中转优先用它。 |
| 夸克网盘 | 网页 Cookie 扫码 | 浏览、上传、分享、播放（HLS）。取直链有 50MB 上限，大文件请改用夸克TV 或本地挂载。 |
提示：绑定后先看状态是否"已连接"再建任务。115 的 access_token 只有 2 小时，程序会自动续期；如果显示授权失败，优先检查是不是另一套程序也在用同一套 token。
🔗 链接监控
粘一条分享链接，按计划检查更新，有新内容自动转存。日常只需要维护这一个列表。
执行计划
- 每 N 分钟 / 每 N 小时 / 每天几点 / 每周几 / 每月几号 / 自定义多个时间点
- 多个时间点会取最近一次，不会叠加执行
- 支持"立即执行一次"手动触发
转存范围
- 子目录深度：0 不检测子文件夹 / 1 只转根目录顶层文件 / ≥2 递归展开并保持目录结构
- 集数区间、关键字过滤、大小下限
- 删除规则：文件名包含某词的直接跳过（如
zip、广告）
同名覆盖
- 目标目录出现同名文件时，按 大小优先、时间次之 保留，删掉另一份
- 会把保留下来的文件 rename 回原名，不留
(1)后缀 - 清理是后台线程，等落盘后执行，不阻塞转存
状态看得懂
- 发现 N 个新文件 绿：有更新，可转存
- 无更新 灰：链接正常，没新内容
- 无有效文件 琥珀：链接正常，但里面的文件都被规则排除了
- 已失效 红：分享被取消 / 过期，需要换链接
手动标记完结：冷门剧 TMDB 没有总集数时，可以在卡片上点「✓ 标记完结」，仪表盘与链接监控会同步显示已完结，不再等自动判断。
📥 Kdocs 批量导入
从金山文档（Kdocs）在线表格读「剧名 + 分享链接 + 地区」，一次建几十个监控任务。
- 粘贴文档链接 → 选子表 → 标角色：剧名列、链接列、地区列，各最多 3 组
- 同表多组（A/C、D/F、G/I）会按顺序配对，第 n 个剧名配第 n 个链接
- 板块标题可以标绿，用来把任务分到不同板块；不标也能用
- 读取表依赖浏览器调试端口（Chromium / Edge），首次需要登录一次 wps.cn，之后无窗口运行
常见坑：同一行最多 3 部剧；链接必须是 http(s) 开头；文档权限要"可查看"，只有"仅查看"可能读不到脚本接口。
🎬 STRM 与播放
把网盘文件写成本地 .strm，让飞牛影视 / Emby / Jellyfin 当本地文件处理，刮削快、扫库轻。
| 模式 | 怎么走 | 适合 |
|---|---|---|
| 本机代理 | 播放器 → 你的机器 → 网盘 | 兼容性最好；占本机带宽 |
| 115 直连 | 播放器直接连 115 CDN，本机只发 302 跳转 | VLC / Infuse / 电视盒子等"全程同一 UA"的播放器，几乎不占带宽 |
| 跳转器（direct=2） | 播放器取分片时现场签发 302 | 飞牛影视这类"清单 UA 与分片 UA 不同"的场景也能零转发 |
- 清晰度：q=0（4K 原画）/ q=1（1080P）
- 浏览器 HEVC 转码：浏览器不支持 HEVC，遇到 4K HEVC 自动转 1080P H.264；有核显走 VAAPI，没有就走 CPU
- 转封装缓存：mkv 这类容器浏览器不认，会零转码换壳（remux）并缓存，拖动进度条不重新转
- 输出目录：留空 = 数据目录下的
strm；也可以指定到影视库扫描目录
不占带宽的前提：播放器要"用同一个 UA 拉清单和分片"。飞牛影视内置播放器是浏览器内核，只能走跳转器或本机代理。
🧹 目录整理
- 按 TMDB 识别剧名 / 季 / 集，重命名并归档到「剧名/季/集」结构
- 没匹配上就不动：判不出是否完结、是否在更新时，宁可不整理，也不误收连载剧
- 支持手动匹配（同名/指定 TMDB ID），手动结果整理侧也认
- 整理前可预览：会改名成什么、哪些跳过，一眼看清再执行
- 只处理"已完结"或"集数收齐且最后一集落地满 6 小时"的剧
💾 备份
- 源网盘 → 目标网盘，按计划复制；支持复制和剪切（剪切 = 传成功再删源）
- 三种执行方式：同盘直连（快）、本地挂载中转（通用）、跨网中转（夸克→115，秒传优先）
- Docker 部署要浏览挂载目录，需要在 compose 里加
-v /你的路径:/mnt/xxx - 失败的任务会写明原因，不会静默跳过
🚚 跨网中转（夸克 → 115）
- 优先走 115 秒传：同 sha1 直接复用，几秒完成且不占上传带宽
- 秒传不命中才真下载再上传；下载失败自动换另一侧夸克源（TV / 网页）
- 保持目录结构，支持同名覆盖；"剪切"是每个文件上传成功后立即删源，失败保留源
- 夸克网页源取直链有 50MB 上限，大文件请让程序回退到夸克TV
⚡ 自动联动
把「转存 → STRM → 整理 → 刷库」串成一条流水线，可选其中几步。
- 触发条件：某任务转存成功 / 定时
- 动作：生成 STRM、执行整理、刷新飞牛影视媒体库、发通知
- 每一步都有日志，失败只跳过该步，不影响其他任务
🗃 缓存任务
把常用目录缓存到本地，减少网盘接口调用、加快刮削与播放首帧。
- 可配置读取/写入间隔、随机抖动与熔断，降低被网盘风控的概率
- 缓存只影响速度，不影响原文件；随时可以清
📌 能力边界（提前说清楚）
- 夸克网页源的直链下载有 50MB 上限，这不是我们的限制，是接口本身的限制
- 浏览器不能直接播 HEVC / mkv，所以浏览器场景会自动转码或转封装；播放器原生解码不需要
- 115 分享接口需要 Cookie，只填开放平台 token 时不能创建分享
- TMDB 需要 Key，没有 Key 时整理与海报不可用，但不影响转存和播放
- 我们不做"破解会员"：所有能力都基于你账号本身已有的权限