片头片尾

Pro 下本地文件与 STRM 的片头片尾都由 Cirvel 生成，本地库、STRM 库与两者混放的库一视同仁。同一部剧的同一季在各个库里的集放在一起比对，结果写到每个库里的这一集。片尾先在同一季各集比对出片尾曲，认不出时再看画面。片尾默认只跳片尾曲，之后的彩蛋与预告照常播放。电影只有片尾。

已有 Plex 媒体库换用 Cirvel 时，保留原来的配置目录与媒体路径即可，不需要重新建库，也不会先清空全库的片头片尾。启用 Pro 并打开对应的生成开关后，已有标记与缺少标记的条目分别处理。

已有片头

首次接管时复用 Plex 已保存的分析结果，按 Cirvel 的规则重新比对，识别出结果后可能更新原来的片头，未识别出可靠结果时保留原标记。重新比对不等于重新读取全部视频，缺少必要的分析结果时才补读文件。

已有片尾

Plex 已经生成的片尾保持原样，后台不会自动换成 Cirvel 的结果，也不会为了替换这些片尾而重新检测画面。Plex 生成的片尾不区分片尾曲与彩蛋，想换成 Cirvel 的结果时，在条目详情点「换成 Cirvel 的片尾」，或者按媒体库生成。

缺少标记

跟随 Plex 的自动生成任务，或在维护时段逐步补齐。需要读取文件时，本地文件读磁盘，STRM 的自动读取受「为 STRM 生成片头标记」「为 STRM 生成片尾标记」开关与读取上限控制，这两个开关默认关闭。

什么时候自动生成，跟随 Plex 的「生成片头标记」与「生成片尾标记」两个开关，新条目入库后尽快生成，或者作为计划任务在维护时段里生成，维护时段还会补上之前没生成的季。开关可以在 Plex 设置里改，也可以在 Cirvel 的「维护」页「Plex 的任务」里改，两边同步。设为「从不」时不再生成新的标记，条目详情里的生成也会提示先打开其中一项。

片尾生成深度

「标准」（默认）先比对各集重复的片尾曲，认不出、片尾曲太短或是电影时，再用 Plex 的片尾模型看画面，名单的起止更准，长名单也能认全，每集多用 0 到 2 分钟 CPU。「快速」只用片尾曲与文件章节，不看画面，CPU 用得很少，但电影没有片尾，长名单只认出片尾曲那一段。

生成占用

生成片尾时占用的 CPU，可以选低、标准或高，默认标准。机器容易发热时选低，想快一些时选高，改了之后从下一项开始生效。生成以最低优先级进行，让位给播放与其它工作。

片头靠同一季各集比对出重复的片头曲与片名卡。「片头片尾」页设置里的「片头识别」有「标准」与「实验」两档，默认「标准」。

标准

只用逐集核对过、不会多跳正片的规则。各集共有的片头曲、文件自带的片头章节、片头前的制作方动画、片头曲之后的宣传与标题卡，以及至少 4 集一致的短片名卡都能认出。

实验

在标准之上多认出两类。一季里换了几首片头曲、每首只用十几集的长篇剧集，按相邻的几十集分开比对。只有 3 集一致的短片名卡也写入。代价是偶尔多跳几秒正片，例如片名字幕叠在正片的空镜上。

两档用同一份分析结果，切换后按已有结果重新计算，不重新读取文件。只有实验档认出的片头，换回标准时会删掉。片尾不分档，实验档也不改片尾，片尾决定客户端什么时候提示下一集，多跳的代价更大。

片头按声音认出，片头曲的音乐常比画面先响，起点会落在冷开场的最后一个镜头上，跳过片头时少看一两秒正片。勾上「片头对齐画面」后，Cirvel 读片头起止附近十几秒的画面，与同一季其它集比对，起点挪到片头曲的第一个画面，终点挪回片头曲的最后一个画面。

只会少跳

起点只往后挪，终点只往前挪，找不到依据时不动。代价是偶尔少跳一点片头曲。

本地文件

每集多读几秒画面，生成稍慢一些。选「实验」时自动勾上，也可以取消。

STRM

每集还要从网盘多读两小段，计入 STRM 的每日上限，默认不勾。网盘容易限流时不建议勾选。

两档都能勾选。勾上后，已经生成过片头的季在维护时段里补读画面，读完再改写片头，之前的片头先保留。实验档分段比对出的片头要等画面对齐过才写入，没勾对应文件类型时不写。

同一集有本地文件时用本地文件，不读网盘。只有 STRM 的集，自动生成时读不读网盘由「片头片尾」页设置里的两个开关决定，默认都关闭。

为 STRM 生成片头标记

打开后读每集开头的一段，长度见「STRM 读取长度」。

为 STRM 生成片尾标记

打开后读每集的最后四分之一，至少 10 分钟，不超过「STRM 读取长度」。「片尾生成深度」为「标准」时，认不出片尾曲的集与电影再读最后 10% 到 20% 看画面。

STRM 读取长度

「与 Plex 相同」读每集前一半，至少 10 分钟，与本地文件读的长度一致，片头出现得晚也能找到，流量最多。「不超过 10 分钟」与「不超过 5 分钟」同样读前一半，只是加了上限，片头结束得比上限更晚的剧集找不到片头，这些集已有的片头保留。片尾的读取同样不超过这个上限，结尾名单很长的集可能只认出最后一段。

读取占用 NAS 的下行带宽与网盘流量，片头与片尾共用下文的每日上限。开关关着时，只有 STRM 的集可以从本地同一份内容与文件自带的章节取得标记，不读网盘，见下文的「从本地文件与章节补全」。打开静默分析后，自动生成只在维护时段读 STRM。

这两个开关只管自动生成。在条目详情里点「立即生成」等操作，或者在 Plex 里点「分析」时，只有 STRM 的集总会读取。

为了不给网盘带来过多请求，自动为 STRM 生成片头片尾时按过去 24 小时设了两个上限，先到哪个停哪个，到上限后稍后自动接着做。

• STRM 每日流量上限 默认 200 GB。视频与声音一起下载，一集 1080p 读 10 分钟约 0.5 GB，4K 高码率片源约 3 到 4 GB。
• STRM 每日集数上限 默认 100 集。同一集的片头与片尾只算一集。
• 填 0 表示不限。

维护时段里的补全、Plex 自动发起的生成、按媒体库生成，以及「重试失败的条目」都计入上限。在条目详情里点「立即生成」「换成 Cirvel 的片尾」或「重新生成」，在 Plex 里对单个条目点「分析」不计入。片头片尾页显示过去 24 小时已读取的流量与集数。向 Plex 云端查片尾另有自己的次数上限，不占这两个上限，见下文的「从 Plex 云端取片尾」。

Plex 在云端存有不少剧集与电影的片尾位置，但 Plex 自己去查时，只有 STRM 的集永远查不到。生成片尾之前，Cirvel 先替 Plex 去云端查这一集，本地文件与 STRM 都查，查到就直接写入，不必读文件分析，查不到再按 Plex 的「标记来源」决定是否在本机生成。「标记来源」是「仅本地」时不查。

只给还没有片尾的集

已有片尾的集、选了不跳过片尾或忽略了片尾的集都不查，云端的结果也不会覆盖它们。

STRM 只读一小段

每集读网盘文件开头与结尾各一小段用来认出这个文件，不读整份文件，也不看「为 STRM 生成片尾标记」开关。打开静默分析时，后台只在维护时段读。

每天最多 1000 集

查云端的次数单独计算，不占 STRM 每日的流量与集数上限，到了上限只停下查云端，其余照常生成。片头片尾页的读取用量后面写着「向 Plex 查片尾」的次数。

算作 Plex 生成的片尾

与 Plex 自己从云端下载的一样，后台不会把它换掉。想换成 Cirvel 识别的片尾曲与彩蛋时，在条目详情点「换成 Cirvel 的片尾」。

云端暂时连不上时，Cirvel 过一阵再查，这期间照「标记来源」在本机生成，已有的能力不受影响。

在顶栏「查找条目」里找到剧、季、单集或电影，进入条目详情。「片头片尾」里按这个条目的现状只给出一个操作。

立即生成

还缺片头或片尾时出现，只补缺的部分。同一范围里有 Plex 生成的片尾时一并换成 Cirvel 的结果。

换成 Cirvel 的片尾

标记已经齐全，但片尾是 Plex 生成的时出现，改由 Cirvel 识别片尾曲与之后的彩蛋。

重新生成

标记都由 Cirvel 生成时出现。确认后清掉已有结果，从头重新生成，涉及的每一集都要重新读取文件，适合结果明显不对或文件换过的情况。

在 Plex 里对这个条目点「分析」效果相同。用户主动发起的生成排在一切后台工作之前，只有 STRM 的集照样读取，不看上面两个 STRM 开关，也不计入每日上限。条目正在生成时按钮显示排队中或生成中，完成后条目详情里的现状随即刷新。

在「片头片尾」页，每个媒体库一行，点这一行的「生成」处理这个库。想处理全部库时点汇总卡片右上角的「全部生成」。在 Plex 里对整个媒体库点「分析」也一样。点击后先显示大致要处理多少季与电影、其中多少要读取文件，以及有多少 Plex 生成的片尾会换成 Cirvel 的结果，确认后开始。没有要生成的库显示「无需生成」，不会排队。

按媒体库生成不看维护时段与两个 STRM 开关，但读 STRM 计入每日上限，到上限后剩下的自动接着做。生成中这一行显示还剩几季，电影库显示还剩几部。想中途结束时点这一行的「停止生成」，有库在生成时汇总卡片右上角的按钮变为「全部停止」，排队的库不再开始，已生成的标记保留。

不读声音与画面，也能为 STRM 补上标记。在「片头片尾」页的设置里打开下面的来源。

复用本地文件的标记

只有 STRM 的条目沿用本地同一份内容的标记，典型的情况是同一部剧的本地版本与网盘版本分在不同的媒体库。是不是同一份内容按 STRM 分析的「本地复用匹配」判断，已有的标记不会被覆盖。

使用文件章节

按文件里名为「片头」「片尾」「OP」「ED」「Intro」「Credits」这类的章节写入标记。新入库的 STRM 在分析时已经取得章节，更早入库的在第一次补全时补读一次文件头，计入「后台每小时请求上限」。

打开后维护时段里自动补全，从本地同源文件复用的标记在新条目入库后随即补上，不等维护。也可以在状态标签里点「立即补全」或某个库的「补全此库」，补全不分析声音与画面，只用章节和本地副本。关闭这两项后已写入的标记保留。不想要这些标记时，从菜单里选「还原」，生成的标记不受影响。之后本地文件被删或条目重新入库，确认是同一份内容时标记会自动找回。

识别出错常常只集中在个别集，例如特别篇没有片头曲。这时不必放弃整季，可以只对这一集选择不跳过。

1. 1在「查找条目」里打开这部剧、这一季、这一集或这部电影的详情。
2. 2在「片头片尾」里把片头或片尾从「跳过」改成「不跳过」。
3. 3想恢复时选回「默认」，跟随上一层。

下层的选择覆盖上层，单集覆盖季，季覆盖剧。电影只有片尾，只能按这部电影设置。选「不跳过」会删掉这个范围里 Cirvel 写入的对应标记，改回「跳过」时按已有的结果重新写入，不重读文件。

前情概要

每集开头回顾前几集的片段。默认「跳过」，它并进片头，与片头相连时合成一段，不相连时另成一段，客户端在这一段同样显示「跳过片头」。

开头广告

片头之前插入的一段广告、许可证卡或片方标识。这一段的声音与同一季另外几集相同，或者相邻几集长度一样时才认出，冷开场不会被当成广告。默认「跳过」，这一段并进片头，客户端在这里显示「跳过片头」，开了自动跳过的客户端会直接跳过。只跳认出的集，其余的集照常播放。

彩蛋与预告

片尾曲之后的彩蛋、名单与下集预告。默认「照常播放」，跳过片尾只跳片尾曲。选「随片尾跳过」时片尾一直标到结尾，客户端在片尾开始时就提示下一集。Plex 生成的片尾本来就标到结尾，不受这一项影响。

全局默认在「片头片尾」页的设置里改。前情概要与开头广告可以在条目详情里按剧、季或集另选，彩蛋与预告可以按剧、季、集或电影另选，也能选回「默认」或跟随上一层。改了之后按已有的结果重新计算，不重新读取文件。

认出开头广告的季，条目详情里会给出提示，列出这些集与各自的长度。不想跳过时按剧或季改为「不跳过」。

觉得「跳过」按钮出现得太早或太晚，或者跳过后接着播放的位置不合适，可以在「片头片尾」页的设置里调整四个偏移，单位为秒，正数推后，负数提前，最多 60 秒。

• 片头起点偏移
• 片头终点偏移
• 片尾起点偏移
• 片尾终点偏移

个别集识别得差几秒，例如片头曲后面还有一张集数标题卡，或者片尾曲之前已经开始滚名单，可以对照画面逐集修正，不必整季不跳，也不必让所有剧一起偏移。

1. 1在条目详情的「片头片尾」里，或在「片头片尾」页列表中季这一组的行尾，点「编辑起止」。
2. 2在左边选一集，在时间轴上点要改的一段，可以是片头、片尾、前情概要、开头广告或彩蛋与预告。
3. 3拖动两端或整段，也可以用方向键每次移动 0.1 秒、按住 Shift 每次 1 秒，对照起点与终点的画面对准画面切换的地方。
4. 4点「保存修正」。

修正优先

修正写进 Plex，所有客户端都照修正后的位置跳过，重新生成也不会改掉它。原来的自动结果以虚线框留在原处，随时可以「恢复自动结果」。

随时撤销

每次保存、应用到整季与恢复之后，顶部都有「撤销」，之后在条目详情的「最近的改动」与「维护」页的「改动记录」里同样能撤销。

补上缺的一段

还没有片头或片尾的集可以手动添加一段，例如点「手动添加片头」。

这一集跳不跳过

编辑区右侧可以只为这一集改这一段跳不跳过，与条目详情里的选择相同。

应用到整季（Pro）

一集修好后点「应用到整季…」，可以按各集自己的位置平移同样的差值，也可以让各集用同一个起止。已修正过的集默认保持不变，确认前逐集列出改动。

电影

同样可以修正片尾与片尾曲之后的一段，没有应用到整季。

换过文件的集

时长相差不到 2 秒时修正照旧生效，这一集标出「修正之后文件换过」，请对照画面确认。相差更多时修正暂停，回到自动结果，调好后重新保存。

「片头片尾」页按媒体库统计片头与片尾的覆盖情况，本地文件与 STRM 分开计数，免费版同样可见。点数字可以列出对应的条目。

同一集或同一部电影同时有本地文件与 STRM 时，标记按本地文件分析，STRM 版本直接共用。列表与条目详情里这样的条目会注明「按本地文件分析，STRM 版本共用」。

已有

已有标记，客户端可以跳过。

待处理

STRM 等待分析或补全，本地文件等待生成。

本身没有

生成过，内容本身没有片头或片尾。

暂无来源

STRM 补全过，但文件里没有片头片尾章节，也没有本地同源文件。

生成失败

每一条都写着原因和处理办法。

确认某一集或某部电影本来就没有片头或片尾时，在条目详情里缺少的那一项旁点「忽略」，它就计入本身没有，不再算作失败或待处理，也不进失败的批量重试。改主意时在同一处点「取消忽略」。

页面下方的「识别出的片段」列出识别到的开头广告、片尾后的彩蛋与名单，以及在剧、季、单集或电影上单独调整过的地方。同一部作品在本地库与 STRM 库里只算一次，点数字可以按季展开查看。

常见的失败原因有 STRM 文件无效、远端已经找不到这个文件、文件太大超过了每日读取上限、文件里没有读得出的声音、文件打不开或解不了码、画面解不了码。按提示修好或替换文件后，在条目详情里点「立即生成」重新读取。文件太大的，点「立即生成」手动读取不受上限限制。失败的条目多时，可以按下文一次重试。

网络波动、读取暂停这类临时问题会自动重试，不算失败。多次没有生成成功的条目，后台不再自动重试，可以手动一次重试。

1. 1在「片头片尾」页点片头或片尾的「生成失败」数字，打开失败列表。
2. 2点「重试失败的条目」，弹窗里列出将要重试的条目数，以及要先修好文件的数量。
3. 3点「开始重试」，按媒体库排队生成，媒体库这一行显示进度，可以随时停止。

• 需要先处理文件的条目默认跳过，包括 STRM 文件无效、远端已经找不到这个文件、文件里没有读得出的声音、文件打不开或解不了码、画面解不了码。已经修好或替换了这些文件时，勾选「这些文件已经处理好，一起重试」。
• 超过每日读取上限的大文件不在重试之列，请在条目详情里点「立即生成」逐个手动读取。
• 重试读 STRM 时计入每日上限，到上限后剩下的自动接着做。
• 确认本来就没有片头片尾的条目，在条目详情里忽略后不再出现在失败列表里。