SystemDesign

系统设计说明：单层目录的设计理念

在 Cloud189 Auto Save 的开发过程中，我们始终坚持**单层目录（Flat Directory）**的设计理念。本页将解释为什么我们不采用多级嵌套文件夹，以及如何在此基础上实现高效管理。

---

1. 为什么选择单层目录

1.1. 简化接口请求

天翼云盘的 API 对多级嵌套目录的操作非常繁琐。每一级目录的创建和查询都需要单独的请求，大量嵌套会导致转存任务极其缓慢，且容易触发接口限频。

1.2. 提高刮削准确度

媒体服务器（Emby/Jellyfin）在处理 .strm 文件时，单层目录结构（例如：/电影/阿凡达 (2009).strm）能让刮削引擎最快定位到电影名称。

1.3. 避免“空文件夹”陷阱

在多级目录中，删除文件后往往会留下大量空文件夹，长期积累会导致云盘索引混乱。

---

2. 如何实现高效管理

2.1. 智能重命名

通过正则或 AI，我们将信息集成在文件名中（如 S01E01.strm）。这比 S01/E01/video.strm 更加直观，且在文件列表中一眼可见全部集数。

2.2. 虚拟分类

在 Emby 中，您可以将不同的单层目录添加为不同的媒体库（如：电影、动漫、记录片），通过 Emby 的界面实现完美的视觉分类，而无需在物理存储上搞嵌套。

---

3. 设计总结

简洁即高效。 我们的目标是让转存任务尽可能快地完成，并生成标准化的 STRM 文件。如果您确实需要多级目录，建议在本地挂载后的文件系统层面使用脚本进行二次整理，而不建议在云盘转存阶段执行复杂操作。