任务运行与结果核对

本页适用于媒体整理、媒体刮削和生成 STRM。

任务、运行和历史怎么区分

名称	表示什么	在哪里查看
长期任务	保存的一套目录、规则和调度设置。	对应功能的任务列表。
本轮运行	点击运行、到达计划时间或接到触发后，实际开始的一次处理。	任务详情或“最近的一次性运行”。
文件历史	某个文件在这次处理中得到的结果。	对应功能的历史列表。

保存任务不会立刻处理文件。手动操作和历史重试也会产生本轮运行，但不一定新建长期任务。排队或“已接收”只表示请求已登记，完成结果要看本轮状态和逐文件历史。

部分整理监控操作会直接出现在文件历史中，不一定有独立的本轮运行卡片。找不到卡片时，可按触发时间和来源目录核对对应文件历史。

就绪即处理

媒体整理、媒体刮削和生成 STRM 统一采用“就绪即处理”：发现文件并核实来源、作品和规则后，允许已就绪的文件先处理。本地与远端的手动、定时任务都使用这项策略，已有任务后续运行和历史重试也会采用它，页面不再提供“扫描完成后处理”选项。

“就绪”表示已确认这个文件可以安全开始处理。整理可能先要比较同一作品的多个版本；刮削的整剧海报、季海报等，要等相关文件的范围确认完整。部分存储也必须先读完整个目录。因此，第一个文件出现在列表里时，任务仍可能需要等待。

监控任务先核对本轮触发范围，处理策略不会放宽范围。网盘定时任务还可能复用近期完整的目录读取结果，详见目录缓存。

扫描失败与已经完成的文件

就绪即处理期间，后续目录读取失败不会撤回前面已经完成的复制、移动、资料写入或 STRM。看到部分文件成功而本轮失败时，先检查发现是否完整和失败原因，再决定如何重试。

读懂运行进度

进度会分开展示“发现了多少文件”和“文件处理到哪里”，扫描没结束时总数还会增加。

提示	怎么理解
正在发现文件、仍在扫描	当前数量是已发现数量，不是整个来源的最终总数。
正在识别作品、比较版本	在判断作品或版本，暂时没有文件输出也可能正常。
正在处理文件	已有文件进入实际处理；传输字节仅代表该文件的传输进度。
等待共享资料	单文件处理已推进，仍需等待剧集、季或目录共用的 NFO、图片等结果。
等待额度、冷却或存储资源	当前受存储保护或资源限制，按提示等待或处理账号问题。
发现未完成、发现范围受限	本轮未确认完整范围，不能把已发现数量当作全库数量。
本轮已结束	本轮不再执行，仍需看成功、跳过、失败和取消的细分数量。

STRM 的“已生成”只计算新建和覆盖，跳过文件不计入。阶段耗时指当前阶段的等待与处理时间，不是预计剩余时间。大文件上传正文发送完毕后，仍可能需要关闭、发布和回读核对，字节到达总量不代表任务已经成功。

大目录与容量保护

单轮文件清单最多记录 50,000 个文件；作品资料较多时，也可能先达到资料容量上限。达到上限会提示并保留已有结果，没扫描到的部分不会算作成功。可按作品或子目录拆分任务，再核对每轮范围；不要反复对同一个大目录重试，期待它自动跳过这项限制。

例如，任务已经完成一部分影片，随后某个子目录读取失败，这时“已有成功文件”和“本轮失败”可以同时成立。先看失败目录是否恢复，再决定重试；不要因为成功数大于零就认定其余目录也都扫描过了。

暂停、取消和停止计划

操作	影响
暂停	请求在安全位置暂停，正在写入的操作需要先交回结果。
恢复	继续原轮次，重新核对来源和受保护的状态。
只取消本轮	停止本轮后续工作，不自动停用未来定时或监控计划。
停止自动计划	还需在任务中停用或调整对应调度设置，按页面确认范围操作。

取消不会恢复已完成的文件改名、移动、覆盖或删除。工作流创建的子运行应在工作流执行页控制，避免把另一轮手动任务误当作工作流步骤。

确认作品归属

整理或刮削历史出现“待确认 · 查看候选与文件”或“未匹配 · 指定作品与文件”时：

1. 打开“确认作品归属”，阅读识别原因、候选的作品类型和年份。
2. 检查文件名、目录、NFO 等识别证据；候选不正确时搜索其他作品。
3. 查看“适用文件”，文件较多时翻页核对，总数包含所有页面。
4. 只有整组都适用时才填写纠正季号或集号；留空保留逐文件判断。电影无需填写。
5. 点击“确认并重跑这一组”，之后回到运行记录检查结果。

提交针对这次展示的整组范围，不只处理当前页。来源配置、作品组或历史发生变化时，旧确认可能被拒绝，应关闭后重新读取核对；确认不会授权扫描组外的整个目录。

写入结果不明确时

网络断开、挂载重连或进程退出时，不能仅凭报错判断文件没有写入。系统会保留现有文件和待核实记录，可能暂时阻止冲突路径、存储修改或清理。

入口	可做什么	操作后不会自动发生什么
刮削任务详情：“有写入结果需要核实”	暂停并等待在途操作停止，再“核实写入结果”；决定放弃时“终止此产物”。	不会重新下载图片、补写、覆盖或自动恢复任务。
文件列表：“文件操作记录”	“核对实际文件”，证据充分时“结束并保留文件”。	不会继续复制、移动或删除来源。

刮削核实只读取现有目标，不能证明成功时继续保留保护；“终止此产物”会把该产物记为失败，保留文件和证据，依赖它的文件按真实结果结束。文件操作核对可能读取整个文件，大文件会产生额外 NAS 或网盘流量。

如果连接已经指向另一份来源、上一次写入仍未结束，或现有资料不足以确认文件，核实可能暂时不能结束记录。先恢复原挂载并保留现有文件与提示；删除数据库记录或重加同名存储，会丢失核对依据，不能用来解除保护。

重试和删除历史

• 重试：按该历史保存的设置重新执行，先解决连接、权限或缺失文件等原因。
• 重新整理 / 重新刮削 / 重新生成：打开表单核对可修改的规则；来源和目标以历史快照为准。
• 删除历史：先核对确认框。默认保留来源文件；只有明确选择同时删除源文件时才会作用于真实文件。仍在运行或保护中的记录可能不能删除。

改了当前任务，不会自动修改旧历史中的来源与规则。例如，任务来源从 /旧目录 改到 /新目录 后，点旧历史的“重试”仍使用旧目录。想处理新目录，应运行修改后的任务；要另选旧历史固定的位置，则创建新的手动操作。

容易搞错的地方

容易搞错	实际情况
看到“已接收 / 排队中”就以为处理完了	这只是请求登记成功，真实结果要看本轮状态和逐文件历史。
扫描数字还在涨，以为出错了	扫描没结束时显示的是“已发现数量”，不是最终总数。
看到“等待”就反复重试	等待多半是版本比较、共享资料、额度冷却或存储资源，重复点击不会更快。
看到“跳过”当成失败	通常是目标已存在、命中排除条件或本次没内容，去历史详情看原因。
以为本轮失败 = 什么都没改	就绪即处理下，前面已完成的复制、移动、资料写入会保留。
只“取消本轮”，以为自动计划也停了	取消只停当前一轮；要停自动计划必须在任务里改调度设置。
删除任务以为文件也被删了	删除的是规则和入口，已生成的媒体、资料和 STRM 都在。
用“删除历史”顺带清文件	默认不删源文件，只有明确勾选“同时删除源文件”才会动真实文件。
挂载重连后重新加个同名存储绕过保护	不行。待核实写入会阻碍冲突路径和存储修改，应先核实或终止产物。

最佳实践

首次运行任何文件的流程：

1. 准备一个 1–3 个文件的测试目录；
2. 用“手动执行”跑一遍，不看通知，直接去文件列表核对结果；
3. 核对无误后，再改成定时或工作流触发；
4. 第一次扩大范围之前，按备份与恢复保留安装备份，并保留来源媒体或可恢复副本；应用数据备份不包含媒体文件。

遇到异常的三步法：

1. 先暂停，不要在写入过程中继续操作；
2. 去原记录看证据（文件是否真的存在、大小和摘要是否一致）；
3. 证据充分就“核实 / 结束并保留文件”，证据不足就先恢复原挂载或原存储，保留现场。

保留核对依据： 不要为了跳过提示而删数据库记录、删归档、重加同名存储或改成 root。即使页面不再显示原记录，也不能证明原写入已经完成，这些操作还可能破坏后续核对。