-
Notifications
You must be signed in to change notification settings - Fork 7
Features
本页从使用角度概括 Cloud189 Auto Save 的核心能力，并给出它们之间的关系。
系统的大多数能力都围绕“任务”展开。
典型流程：
分享链接 / CloudSaver / 自动追剧 / 订阅
↓
创建任务
↓
按规则检查更新
↓
转存到目标目录
↓
可选执行：刮削 / 整理器 / STRM / 通知
因此很多功能并不是孤立的页面，而是会在创建任务、编辑任务和任务执行过程中联动生效。
任务页还提供两个维护入口：
- 清理缓存：清理指定任务的转存记录缓存，让下一次执行重新检查分享目录和目标目录。
- 绑定 TMDB：手动指定 TMDB ID、媒体类型和季度，用于修正自动识别不准导致的刮削或整理问题。
详细使用见 Tasks。
STRM 是本项目最重要的媒体联动能力之一。
- 普通转存任务完成后，系统可根据配置生成
.strm文件。 - 是否生成由 媒体 页的 STRM 设置 决定。
- 账号的 云端路径前缀 和 本地路径前缀 会影响生成路径和映射关系。
- 先生成可播放入口，不立即占用网盘空间。
- 真正播放时再执行转存，并动态换取直链。
- 自动追剧、任务创建和 STRM 页都能触发懒转存相关流程。
- 启用后，STRM 中写入的是项目代理地址，而不是短时有效直链。
- 可显著减少“STRM 过期导致无法播放”的问题。
详细配置见 StrmGuide。
自动追剧是“TMDB + CloudSaver + 任务系统”的组合能力。
- 输入剧名和可选年份。
- 用 TMDB 识别剧集信息。
- 用 CloudSaver 搜索候选资源。
- 自动选择最佳资源，或手动选择资源。
- 创建普通任务或懒转存任务。
- 自动转存 (下载文件)：立即创建并执行普通转存任务。
- 懒转存 (生成STRM)：优先生成懒转存 STRM，再在播放时转存。
它依赖 系统 页中的默认账号和默认保存目录。
整理器用于把“能转存”变成“适合媒体库刮削”。
- 识别媒体类型。
- 规范文件名。
- 按电视剧、电影、动漫、综艺、纪录片分类归档。
- 与 STRM、刮削和媒体服务器联动。
- 处理复杂、混乱的文件名。
- 按命名模板生成更规范的文件名。
- 降低手写正则的配置成本。
- AI 助手的增强接口可给出账号容量、任务执行、缓存清理、TMDB 搜索和创建任务等工具建议；写操作仍需要前端二次确认。
AI 配置在 媒体 页，整理入口在 整理器 页和任务配置中。
订阅适合批量接入外部资源集合。
- 通过 UUID 或订阅链接导入资源。
- 只选择订阅中的部分资源。
- 周期性刷新资源状态。
- 自动为新资源创建任务。
订阅本身不等于任务；它更像是“任务来源管理器”。
是否自动生成任务、是否启用懒 STRM、是否启用整理器，都由订阅中的 自动创建任务 配置决定。
CloudSaver 是资源入口之一。
使用场景：
- 浮动按钮中直接搜索资源。
- Telegram 中用
/search_cs搜索并转存。 - 自动追剧中作为候选资源来源。
- 部分任务失败后作为自动换源候选。
它只负责提供公开分享资源搜索能力，不保证资源始终可用。
影巢资源是新的影视资源入口，主要面向按 TMDB 条目查询和解锁天翼云盘资源。
- Cookie 网页解析：从影巢页面中解析可见资源和天翼链接。
- OpenAPI OAuth：使用影巢 OpenAPI 凭证获取授权能力。
-
Browser Bridge：通过常驻浏览器调用影巢网页签名接口，支持
/api/customer/*、签到、积分日志、资源查询和解锁。
影巢本身负责“找到资源”和“解锁资源”。解锁得到天翼分享链接后，系统会把链接、访问码和标题带入创建任务流程，后续仍由普通任务系统执行转存、重命名、STRM、整理器和通知。
部署 Bridge 见 HDHiveBridge，使用方式见 HDHive。
账号页可展示多账号个人容量和家庭容量聚合。系统会缓存容量结果，减少频繁访问天翼接口。
系统页可开启 账号 Session 保活，按 Cron 定时刷新账号会话，也可以手动点击立即执行。该功能用于降低长期运行时 Cookie / Session 失效概率。
CAS 秒传适合大文件快速恢复和中转。
- 通过
.cas存根恢复文件。 - 使用家庭云中转提高部分场景成功率。
- 为懒转存或媒体管理场景补充快速恢复能力。
- 命中云端已有文件特征时才能真正实现“秒传”。
- 若 Hash 未命中，恢复会失败。
本项目和 Emby/Jellyfin/Plex 的结合点主要有三类：
- STRM 播放
- 入库通知 / 刷新
- 路径替换与代理播放
其中账号级别的路径配置包括：
- 云端路径前缀
- 本地路径前缀
- Emby 替换路径
这些路径信息会影响 STRM 输出和媒体服务器能否正确定位文件。
系统内建任务调度能力，常见自动化包括：
- 周期性检查任务更新
- 自动清理个人云和家庭云回收站
- 自动清理懒转存文件
- 账号 Session 保活
- 周期性执行 STRM 配置
- 刷新订阅状态
调度规则主要在 系统 页用 Cron 表达式配置。
- 如果你的目标是“电视墙可播”，先完成账号路径、STRM、Emby 和媒体设置。
- 如果你的目标是“自动追更”，优先配置 TMDB、CloudSaver 和自动追剧默认目录。
- 如果你的目标是“媒体库整洁”，再补 AI 模型、整理器和正则预设。