媒体库文件夹

设置

告诉 HolyArrs 你的成品电影、剧集和音乐放在哪里。

你需要有 Change settings（更改设置）权限。首次运行的设置向导会添加一个文件夹；其余的在这里添加。

开始之前

文件夹已经存在，并且 HolyArrs 可以写入。
在 Docker 里，你知道容器内的路径，比如 /movies。主机上的路径不能用。

添加文件夹

打开 Settings > Library folders（设置 > 媒体库文件夹）。
选择 Add a folder（添加文件夹）。Add a Library folder（添加媒体库文件夹）卡片会打开。
在 Holds（存放内容）下，选 Movies（电影）、Shows（剧集）或 Music（音乐）。
在 Folder path（文件夹路径）下填入 HolyArrs 看到的完整路径。
填一个 Name（名称），或者留空，用路径的最后一段，比如 movies。
选择 Add（添加）。你应该会看到这个文件夹出现在它所属的分组里，带着剩余空间和健康状况。

检查告诉你什么

检查会确认文件夹存在，写入并删除一个小测试文件，从每个启用中的下载器文件夹试着建一个硬链接，并看剩余空间是否至少有 100 MB。每一行上的刷新按钮会再检查一次。

硬链接是同一块磁盘上同一个文件的第二个名字。它瞬间完成，不多占空间。

显示的状态	意思	导入
Healthy（健康）	所有检查都通过	瞬间移动
Folder not found（找不到文件夹）或 Cannot write here（这里无法写入）	文件夹不见了或不可写	停止，直到你修好
Works, but files are copied (no hardlinks)（能用，但文件是复制的，没有硬链接）	下载的文件在另一块磁盘或另一个挂载点上	能用，但会复制文件：更慢，而且在下载器删掉它那份之前占双倍空间

剩余空间不到 100 MB 时会多一条空间不足的提示。在磁盘写满之前，导入照常进行。

重命名或移除文件夹

Rename（重命名）改的是你看到的名称。磁盘上什么都不会动。

垃圾桶按钮把文件夹从 HolyArrs 里移除，所有文件原样留在原处。只要还有条目在用这个文件夹，HolyArrs 就会拒绝。先把这些条目移走。

如果不成功

现象：状态显示文件是复制的（没有硬链接）。原因：下载和媒体在不同的挂载点上。 解决办法：挂载一个同时包含两者的共用上级文件夹，并且在每个容器里用同一个路径。

现象：导入时提示路径不允许。原因：路径不在任何允许的位置之内（见下面的 Extra import folders）。提示信息会列出允许的位置。带 .. 的路径、\\server\share 这样的网络共享，以及指向外面的链接或 junction 也会被拒绝。

现象：导入时看不到下载文件夹。原因：没有设置 HOLYARRS_SAVE_PATH，也没有哪个下载器配了路径对。 解决办法：设置 HOLYARRS_SAVE_PATH，或者把下载文件夹（比如 /downloads）加到 Extra import folders（额外的导入文件夹）下。

现象：无法移除文件夹。 解决办法：先把它的条目移到另一个文件夹。

进阶

文件夹规则

媒体库文件夹必须存在、是一个文件夹、是完整路径、可写，并且不能在另一个媒体库文件夹里面，也不能把另一个媒体库文件夹包在里面。每种类型（电影、剧集、音乐）用各自的文件夹。

Extra import folders（额外的导入文件夹）

Library > Import files by hand（媒体库 > 手动导入文件）只在这些位置之内读取、复制和移动文件：

你的媒体库文件夹，
你的下载器保存文件的文件夹，按 HolyArrs 看到的路径算：HOLYARRS_SAVE_PATH 和每个下载器路径对里 HolyArrs 这一侧的路径，
Settings > Library folders 上的 Extra import folders。

每行填一个完整路径，比如 /imports 或 D:\Imports。最多 32 个。/ 或 C:\ 这样的整块磁盘会被拒绝。

只有所有者，或者用密码登录的管理员，才能修改这个列表。API 密钥还需要 admin 权限范围。其他人会看到 Owner and admins only（仅限所有者和管理员）。