整理剧集

设置

把磁盘上已有的剧集收进来，整理名称，删掉不再看的内容，查看某一集经历了什么。只有所有者和管理员能看到这些页面。

把已有的剧集收进来

HolyArrs 按原样接管一个剧集文件夹。扫描只读取，不移动也不重命名任何东西。

打开 Library（媒体库），再打开 Import a library（导入媒体库），选一个放剧集的媒体库文件夹。它们显示为“Shows: …”。
点击 Scan（扫描）。HolyArrs 从每个文件夹名里读出剧集名称，有年份的话也读出年份，然后到你的剧集信息来源那里查找。
打开每部剧集的摘要行，比如“8 episodes in 7 files; 1 file with no episode, left alone”。每个视频都会列出来，并标出它的名称对应的集。
检查各个分组：Matched（已匹配）、Unsure（不确定）、Not matched（未匹配）、Already in the Library（已在媒体库里）、On the Never-add list（在永不添加列表里）、No video file（没有视频文件）。对不确定或未匹配的剧集，点击 Look up（查找），按名称或 tvdb:81189 这样的 id 搜索。
勾选你想要的剧集，点击 Adopt（接管）。

你应该会看到每个有文件的集都在媒体库里；如果文件没有达标，则显示为正在找更好的副本。其他集按你的剧集设置处理。

如果某一次查找失败，那个文件夹会显示为未匹配并附上原因，其余的继续进行。

下面这些文件会原样不动，并附上原因：写着另一部剧集名称的文件、名称里没有集数的文件，以及另一个文件已经包含的某一集的较小副本。

重命名单集文件

单集文件按 Settings > Naming and files > Show names（设置 > 命名和文件 > 剧集名称）里的模式命名，参见剧集下载。

只改一部剧集：打开它，点击 Rename files（重命名文件）。全部都改：打开 Library，点击 Rename files。
看预览：每个文件现在的名称、将要得到的名称，以及文件被跳过的原因。
点击 Rename（重命名）。

你应该会在剧集页面上看到新名称。重命名做的事和预览显示的完全一样。如果这期间有东西变了，什么都不会重命名，你会得到一份新的预览。

只有 HolyArrs 导入或接管的文件会被重命名。包含两集的文件得到一个涵盖两集的名称。有多个版本的剧集按版本分别重命名，每个文件都留在自己版本的文件夹里。

删除一部剧集、一季或一集

打开这部剧集。删除整部剧集点击 Delete show（删除剧集），删除某一季点击那一季上的 Delete Season 1（删除第 1 季）（或对应的季），删除某一集点击那一集上的 Delete episode（删除这一集）。
看对话框里的 What will happen（将会发生什么）。
选好选项并确认。

你应该会看到被删除的剧集从媒体库里消失。被删除的季或集仍留在剧集页面上，Keep up to date（持续追踪）是关闭的。想要的时候随时再打开。

选项或情况	结果
Default（默认）	所有文件都留在磁盘上。
Also delete the files	HolyArrs 导入或接管的文件会移到它们所在媒体库文件夹里的暂存文件夹。在暂存天数用完之前，可以从那里拿回来。HolyArrs 只是发现的文件永远不会动。
包含多集的文件	只有里面的每一集都被删除时才会删。有文件保留时，对话框会说明。
多个版本	每个版本的副本都会删。
Add it to the Never-add list（加入永不添加列表）	删除整部剧集时显示。之后列表再也不能添加它。
空文件夹	空的季文件夹和剧集文件夹会随文件一起删除。里面还有其他东西的文件夹会保留。

文件被删除后，会通知你的媒体服务器重新扫描那部剧集的文件夹。

可选项

历史记录

剧集页面上有一张 History（历史记录）卡片，显示最新的几行。All 12 rows（全部 12 行）（数字会变）打开这部剧集的完整历史记录。每一行都写明是哪几集，比如“S01E02 The Mill”；剧集有不止一个版本时，还会写明版本。每一集都有一个 History 按钮，里面有它的搜索、发出的资源、导入、重命名、删除和各项决定。

日历

Calendar（日历）把播出日期和电影日期放在一起显示。播出时间已知的集会按你的时区显示在那个时间，所以国外深夜播出的一集可能落在第二天。用 Everything（全部）、Movies（电影）或 Shows（剧集）筛选。有多个版本的一集只列一次，并写明你有哪些版本。日历订阅源里的集在播出时间上；时间未知时，是全天事件。

通知

剧集的通知会写明剧集和集，比如“In the Library: Copper Valley S01E02”。一个整季包只发一条通知，列出每一集。想每集一条通知，在 Settings > Alerts（设置 > 通知）里改 Season packs（整季包）。

如果不成功

扫描在一个有剧集的文件夹里什么都没找到。 原因：某个硬盘或共享没有挂载。如果 HolyArrs 知道这个文件夹里有文件，却看到它是空的，它会这样提示。解决办法：挂载好，再扫描一次。

某一集显示为缺失。 原因：每天的磁盘检查发现它的文件不见了。历史记录里会写明。如果整个媒体库文件夹都不见了，HolyArrs 会警告你，并且不把任何东西标记为缺失。解决办法：把文件放回去。它会重新标记为存在。

剧集文件夹里的新文件没有被用上。 原因：HolyArrs 自己发现的视频会连同它对应的集一起记录下来，但从不会自动填上某一集，也从不会被重命名、移动或删除。解决办法：再导入一次这个文件夹来接管它。

重命名预览里有一个文件被跳过。 原因：只有导入或接管的文件会被重命名。解决办法：看预览上的原因，或者先接管这个文件。

进阶

命名示例

Copper Valley (2025)/Season 1/Copper Valley - S01E02 - The Mill 1080p WEB.mkv
Copper Valley (2025)/Season 1/Copper Valley - S01E02-E03 - The Mill + Flood 1080p WEB.mkv
Copper Valley (2025)/Specials/Copper Valley - S00E01 - Behind the scenes 1080p WEB.mkv
Night Talk (2019)/Season 2025/Night Talk - 2025-03-14 - Guests 1080p WEB.mkv
Blade Song (2015)/Season 5/Blade Song - S05E12 - 112 - Rain 1080p WEB.mkv

最后两行是按播出日期和按连续编号的结构。模式和默认值见剧集下载。

每集一条通知的上限

把 Season packs 设为每集一条通知时，一个大的整季包最多发 25 条单集通知，再加一条列出其余各集。用 each_limit 这个 API 设置项改这个数字，范围 1 到 500。