Features

功能深度解析

本页从使用角度概括 Cloud189 Auto Save 的核心能力，并给出它们之间的关系。

---

1. 任务驱动的核心模型

系统的大多数能力都围绕“任务”展开。

典型流程：

分享链接 / CloudSaver / 自动追剧 / 订阅
  ↓
创建任务
  ↓
按规则检查更新
  ↓
转存到目标目录
  ↓
可选执行：刮削 / 整理器 / STRM / 通知

因此很多功能并不是孤立的页面，而是会在创建任务、编辑任务和任务执行过程中联动生效。

---

2. STRM 体系

STRM 是本项目最重要的媒体联动能力之一。

普通 STRM

• 普通转存任务完成后，系统可根据配置生成 .strm 文件。
• 是否生成由 媒体 页的 STRM 设置 决定。
• 账号的 云端路径前缀 和 本地路径前缀 会影响生成路径和映射关系。

懒转存 STRM

• 先生成可播放入口，不立即占用网盘空间。
• 真正播放时再执行转存，并动态换取直链。
• 自动追剧、任务创建和 STRM 页都能触发懒转存相关流程。

系统中转

• 启用后，STRM 中写入的是项目代理地址，而不是短时有效直链。
• 可显著减少“STRM 过期导致无法播放”的问题。

详细配置见 StrmGuide。

---

3. 自动追剧

自动追剧是“TMDB + CloudSaver + 任务系统”的组合能力。

工作方式

1. 输入剧名和可选年份。
2. 用 TMDB 识别剧集信息。
3. 用 CloudSaver 搜索候选资源。
4. 自动选择最佳资源，或手动选择资源。
5. 创建普通任务或懒转存任务。

两种模式

• 自动转存 (下载文件)：立即创建并执行普通转存任务。
• 懒转存 (生成STRM)：优先生成懒转存 STRM，再在播放时转存。

它依赖 系统 页中的默认账号和默认保存目录。

---

4. 整理器与 AI

整理器用于把“能转存”变成“适合媒体库刮削”。

整理器做什么

• 识别媒体类型。
• 规范文件名。
• 按电视剧、电影、动漫、综艺、纪录片分类归档。
• 与 STRM、刮削和媒体服务器联动。

AI 的作用

• 处理复杂、混乱的文件名。
• 按命名模板生成更规范的文件名。
• 降低手写正则的配置成本。

AI 配置在 媒体 页，整理入口在 整理器 页和任务配置中。

---

5. 订阅系统

订阅适合批量接入外部资源集合。

订阅能做什么

• 通过 UUID 或订阅链接导入资源。
• 只选择订阅中的部分资源。
• 周期性刷新资源状态。
• 自动为新资源创建任务。

与任务系统的关系

订阅本身不等于任务；它更像是“任务来源管理器”。

是否自动生成任务、是否启用懒 STRM、是否启用整理器，都由订阅中的 自动创建任务 配置决定。

---

6. CloudSaver 搜索

CloudSaver 是资源入口之一。

使用场景：

• 浮动按钮中直接搜索资源。
• Telegram 中用 /search_cs 搜索并转存。
• 自动追剧中作为候选资源来源。
• 部分任务失败后作为自动换源候选。

它只负责提供公开分享资源搜索能力，不保证资源始终可用。

---

7. CAS 秒传

CAS 秒传适合大文件快速恢复和中转。

主要用途

• 通过 .cas 存根恢复文件。
• 使用家庭云中转提高部分场景成功率。
• 为懒转存或媒体管理场景补充快速恢复能力。

需要注意

• 命中云端已有文件特征时才能真正实现“秒传”。
• 若 Hash 未命中，恢复会失败。

---

8. 媒体服务器联动

本项目和 Emby/Jellyfin/Plex 的结合点主要有三类：

• STRM 播放
• 入库通知 / 刷新
• 路径替换与代理播放

其中账号级别的路径配置包括：

• 云端路径前缀
• 本地路径前缀
• Emby 替换路径

这些路径信息会影响 STRM 输出和媒体服务器能否正确定位文件。

---

9. 自动化与调度

系统内建任务调度能力，常见自动化包括：

• 周期性检查任务更新
• 自动清理个人云和家庭云回收站
• 自动清理懒转存文件
• 周期性执行 STRM 配置
• 刷新订阅状态

调度规则主要在 系统 页用 Cron 表达式配置。

---

使用建议

• 如果你的目标是“电视墙可播”，先完成账号路径、STRM、Emby 和媒体设置。
• 如果你的目标是“自动追更”，优先配置 TMDB、CloudSaver 和自动追剧默认目录。
• 如果你的目标是“媒体库整洁”，再补 AI 模型、整理器和正则预设。