Only Scripts使用教程
同样先保存工程并关闭 AE，再运行新版完整安装包。4.6.6 的更新说明明确保留已有模型和运行目录；首次使用的新组件仍可能需要下载。
当前文档面向 AE 2020 及更新版本。具体系统与原生效果范围，以账户页提供的对应平台安装包说明为准。
重开 AE 后，能从扩展菜单打开面板；在面板中核对版本。
CEP 面板和原生效果分别有自己的平台包。某个效果在 Windows 可用，不表示它已经包含在你拿到的 MacOS 包中；请核对下载页的组件列表。
核对面板可打开，并检查准备使用的效果是否列在该平台包的组件说明中。
遇到设备数量限制时，可在旧设备的卡密信息中解除本机绑定，再到新设备激活。账户页也提供设备绑定信息与自助解绑入口，具体次数以账户显示为准。
解除本机绑定会立即锁定这台设备。请先保存工程，并确认新设备可使用同一卡密。
面板显示当前设备授权完成；账户中的卡密、期限与设备信息符合预期。
常见问题
适用于重开 AE 后，「窗口 → 扩展」中没有 Only Scripts。若菜单已有入口、点开后白屏，这是加载问题，不要把它当作菜单未安装。
检查结果：扩展菜单出现入口，点击后能进入面板或授权界面。
检查结果：支持人员能定位实际安装副本；修正后从目标 AE 的扩展菜单打开面板。
目标 AE 的「窗口 → 扩展」出现 Only Scripts，且能打开授权页或面板；安装器退出本身不算恢复。
SEAT_LIMIT_REACHED旧设备可解除本机绑定；旧机不可用时，可在官网账户按设备列表自助解绑。该卡密已绑定两台设备，请在旧设备解除本机绑定或联系管理员处理换机。完整提示为“该卡密已绑定两台设备”，或原因码 SEAT_LIMIT_REACHED。它表示设备名额已满；只有连接失败、卡密错误或到期提示时，不按本条解绑。
检查结果：旧设备显示本机绑定已解除；新设备完成当前设备授权。
检查结果：目标旧设备从绑定列表中移除，可用名额释放，新设备验证成功。
检查结果：配额/授权或未决操作得到正确处理后，新设备可以验证。
检查结果：真实原因得到处理后可验证，不额外改变仍需使用的设备绑定。
新设备显示“已完成当前设备授权”，且需要继续使用的其他设备没有被误解绑。
使用教程
先检查主体轮廓、透明边缘与明暗分界，再决定是否增加采样。第一次模型准备与后续调光是不同阶段，处理速度会受图像尺寸和运行环境影响。
深度与法线已准备，灯光调整产生符合预期的明暗变化。
常见问题
未准备 / 待校验 / 资源准备完成后仍未找到模型文件Only Shadow 无法生成深度/法线，运行组件中的该模型项显示“未准备”“待校验”，或明确提示准备后仍未找到模型文件。
在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。展开“效果模型”，检查独立的「Only Shadow 模型」一项；不要只看基础组件总数。
检查结果：Only Shadow 模型项通过完整检查，实际深度与法线生成完成。
检查结果：本次任务的目录中所有必要资源都通过检查，原错误消失。
检查结果：对应平台存在可用的完整准备路线，模型项能够验证通过。
Only Shadow 模型项显示已就绪，并完成一次实际深度/法线生成；不是只确认文件存在或基础组件为3/3。
TORCH_CPU_BUILD · The managed Torch package was built without CUDA诊断的 causeCode 为 TORCH_CPU_BUILD，或包含“The managed Torch package was built without CUDA”。它表示当前加载的 Torch 没有 CUDA 构建信息，与驱动初始化失败不同。
在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。查看「Only Shadow 模型」这一行及其具体错误；通用“模型包”不是这条修复入口。
检查结果：新诊断不再是 TORCH_CPU_BUILD，模型准备可完成。
检查结果：配套依赖修复后，实际生成任务通过，而非仅文件存在。
检查结果：按实际初始化原因处理，避免重复安装无关包。
实际 Only Shadow 模型准备成功，新诊断不再报告 TORCH_CPU_BUILD；只看到权重或“下载完成”不够。
DEPENDENCY_IMPORT_FAILED先区分 Python 缺模块、ONNX Runtime 版本/后端错误，再准备对应组件。DEPENDENCY_IMPORT_FAILED / ORT_VERSION_MISMATCH / ORT_CUDA_PROVIDER_MISSING出现 DEPENDENCY_IMPORT_FAILED、ModuleNotFoundError、ImportError、ORT_VERSION_MISMATCH 或 ORT_CUDA_PROVIDER_MISSING。先抄出实际缺失的模块名/原因码。
在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。
检查结果：原来缺少的模块检查通过，原工具开始运行。
检查结果：加载到配套依赖，所需执行提供器存在，完整模型检查通过。
检查结果：组件与实际运行的面板来自配套安装，模块能够被加载。
相同模块/后端检查不再失败，并用原工具完成实际处理。
使用教程
图片任务提供 PNG、JPEG、WebP。JPEG 不保留透明度；处理透明素材时，优先选择 PNG 并检查输出边缘。
视频处理涉及连续帧、封装和音轨，静态图片的效果与耗时不能直接代表视频。
最终宽高符合倍数，输出格式与透明度符合用途。
常见问题
E_OUTOFMEMORY先结束当前任务，用单张小图和 2× 重试，区分输入规模与运行环境问题。out of memory / E_OUTOFMEMORY / bad_alloc / VK_ERROR_OUT_OF_DEVICE_MEMORY「超分」任务日志包含内存分配错误。VK_ERROR_OUT_OF_DEVICE_MEMORY 指向设备内存；VK_ERROR_OUT_OF_HOST_MEMORY/bad_alloc 也可能涉及系统内存，不能把所有情况都只叫显存不足。
在「实验 → 超分」点标题旁的「设置」，再切到「任务详情」；这里能查看队列、任务日志，并使用「中断」「改路径」「打开目录」。
检查结果：小图2×可完整输出；能明确定位是哪些尺寸/倍数开始失败。
检查结果：相同AI任务能够完整结束，或得到可复现的环境问题记录。
同一设置的输出文件可打开且尺寸正确，日志不再出现内存错误；没有把0强度普通缩放当AI恢复。
图片保真处理需要已就绪的共享 Python 图像运行组件适用于单张图片任务出现上述原文，或“图片保真预处理没有返回有效素材”“图片保真处理未返回完成结果”。这是图片预处理/保真阶段，不要因为视频任务能开始就认定图片所需组件齐全。
检查结果：这张图片通过保真预处理并生成可打开的2×文件。
检查结果：配套图片处理文件存在且能由受管Python运行，预处理成功。
静态PNG测试得到可打开、宽高各2倍的输出，任务没有再停在图片预处理/保真阶段。
inputpath and outputpath must be either file or directory at the same time任务日志原文为“inputpath and outputpath must be either file or directory at the same time”。这是文件/目录调用配对错误，不按显存不足、网络失败或模型缺失处理。
检查结果：同一张图片产生可打开的 2× 输出，不再出现 file or directory 配对错误。
检查结果：实际加载的配套版本完成同一静态图片任务。
单张测试图输出文件可打开，宽高为原图各 2 倍，并不再出现 file or directory 原文。
使用教程
部分打字与乱码类预设会使用 Source Text 表达式。对已有表达式、混合字符格式或复杂排版的文字，先保存工程，再检查应用后的文字和样式。
文字内容与格式符合预期，入场和出场的时间正确。
SVG 与 AE 形状并不支持完全相同的效果。复杂滤镜、图片、文字、通用蒙版、部分渐变和特殊混合方式可能被明确拒绝。需要完全保留外观时，先在原绘图工具中简化为支持的路径。
本地 SVG 库继续可用，历史公共资源分享入口已经退役。
导入后的形状可编辑，导出 SVG 的内容与预期一致。
优先用静态图形或有透明轮廓的素材检查效果。连续变化的素材会逐帧重新提取轮廓，不应把静态图形的节点稳定性直接推断到动态素材。
进度关键帧控制变化，完成状态与预期一致。
常见问题
SVG_UNSUPPORTED_ELEMENT按提示的 SVG 元素/属性或 AE 形状操作器简化副本，再用单个图形验证。导入提示 SVG_UNSUPPORTED_ELEMENT / PROPERTY / CLIP_PATH 等，或导出提示 SVG export unsupported。先保留冒号后的对象名称；“不支持 SVG”并不是足够具体的诊断。
检查结果：该具体拒绝项消失，导入后的外观符合需求。
检查结果：图形成功导入，描边与几何没有意外变化。
检查结果：导出文件可正常打开，轮廓、透明度和外观符合用途。
转换成功且在 AE 与导出文件中检查几何、颜色、透明边缘；文件存在不代表外观已保真。
超分与音轨分离
工具会核对任务开始时的图层身份。原图层被删除或替换时，结果不会按旧图层序号随意写到另一个图层。
结果出现在正确合成和范围，其他图层没有被误替换。
常见问题
SOURCE_LAYER_MISSING先保留已经生成的输出，再手动导入或重新读取正确图层；不要按旧序号替换。SOURCE_LAYER_MISSING · 找不到任务开始时的原视频图层，结果未回退到其他图层提示 SOURCE_LAYER_MISSING /“找不到任务开始时的原视频图层，结果未回退到其他图层”；音轨分离也有对应的原音频/视频图层提示。说明自动写回没有找到原身份，不表示处理文件一定没生成。
检查结果：结果保存在正确合成与时间范围，无关图层未被替换。
检查结果：新任务绑定当前真实图层，后续写回能找到它。
检查结果：先生成可用文件，再处理导入与写回。
输出文件可打开，出现在正确合成/时间段，且没有因为旧图层序号误替换其他层。
准备与日志
检查结果：每一行得到明确的就绪、未准备或失败状态。
检查结果：所需组件显示已就绪，原工具能生成实际结果文件。
检查结果：目标目录通过检查，并显示明确的迁移状态。
检查结果：缓存目录已经切换，刷新状态后所需组件通过检查。
需要的组件分别通过本地检查，并且原工具成功完成一次小任务。下载进度到 100% 或仅看到模型文件，都不等于运行资源已全部可用。
工具或功能：
Only Scripts 版本（AE 面板实际显示）：
AE 版本：
Windows / MacOS 版本：
显卡型号（AI / GPU 问题时填写）：
发生时间与 jobId（如果有）：
管理组件显示的缓存目录：
完整错误原文：
resourceId / stage（如果有）：
causeCode / causeMessage（如果有）：
出现前的操作步骤：
已经尝试的方案与结果：
本次错误前后的日志：请填实际安装版本，不要用本网站的版本号代替。素材相关问题可换成能复现的非敏感小样；去掉完整卡密、验证码、私人素材和临时下载链接后，再提供排查记录。
别人拿到记录后，能看出是哪个工具、哪个阶段、哪条原因，以及已经尝试了什么；无需再从一张“处理失败”的截图猜测。
下载与授权
RESOURCE_NETWORK_ERROR先按 DNS、代理、超时或证书原因码处理连接，再继续原任务。资源下载超时。 / 无法解析资源服务器地址。 / 代理 CONNECT 失败。出现 RESOURCE_NETWORK_ERROR、RESOURCE_NETWORK_TIMEOUT，或下载提示无法解析地址、代理 CONNECT 失败、TLS 证书验证失败。在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。
如果面板只显示总错误，按提示中的「日志路径」打开文件。也可点「打开目录」，在 logs 文件夹中找 runtime-dependency-downloads.log，搜索本次 jobId 对应的 RESOURCE_MANAGER_FAILURE，读取 stage、causeCode、causeMessage。旧版没有这份文件时，保留面板已有的完整提示。
检查结果：不再出现 ENOTFOUND，任务进入连接或下载阶段。
检查结果：代理连接错误消失，已接收字节持续增加。
检查结果：任务越过原进度，完成下载并进入验证。
检查结果：连接被接受，任务进入下载。
检查结果：服务恢复接受请求，资源完成下载和检查。
检查结果：同一资源可通过正常 HTTPS 连接下载。
下载字节继续增长，资源随后通过验证；不能只以浏览器可联网作为恢复判断。
URL_EXPIREDHTTP 410 时重新检查资源并继续任务；401/403 则先处理授权。URL_EXPIRED · 资源下载地址已失效，请重新检查资源。完整错误包含 URL_EXPIRED 或 HTTP 410 /“资源下载地址已失效”。临时地址有有效期；404 与授权失败不是同一问题。在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。
检查结果：任务取得新地址并恢复传输，随后完成验证。
检查结果：服务提供可用地址，客户端完成下载。
检查结果：按实际状态恢复授权或资源可用性。
已接收字节重新增加，任务通过下载与本地验证，不再返回 410。
安装与占用
RESOURCE_MANAGER_BUSY先确认是其他任务正在占用，还是异常结束后的等待；不要直接删除锁或运行目录。RESOURCE_MANAGER_BUSY出现 RESOURCE_MANAGER_BUSY，或组件长时间显示“等待任务”。在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。
记录失败任务的 jobId 与发生时间，并查看是否另有下载、安装、模型准备或已暂停任务。
检查结果：已有任务能继续，或结束后新任务不再被占用拦住。
检查结果：新任务能进入检查、下载或验证阶段，并最终通过检查。
检查结果：锁拥有者被核实并按对应问题修复；不是靠删除模型文件绕过。
新的准备任务能完成对应组件检查；原有已安装模型仍可用于一次实际处理。
RESOURCE_INSTALL_FAILED先取出同一任务的 stage、causeCode、causeMessage，再按下载、验证或安装切换分别处理。RESOURCE_INSTALL_FAILED · 资源安装失败。出现 RESOURCE_INSTALL_FAILED /“资源安装失败”。这是总错误，不等于一定下载坏了，也不等于一定没有权限。在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。
如果面板只显示总错误，按提示中的「日志路径」打开文件。也可点「打开目录」，在 logs 文件夹中找 runtime-dependency-downloads.log，搜索本次 jobId 对应的 RESOURCE_MANAGER_FAILURE，读取 stage、causeCode、causeMessage。旧版没有这份文件时，保留面板已有的完整提示。
检查结果：相同资源不再因空间失败，安装与检查完成。
检查结果：该资源能从安装切换进入完成状态，本地检查通过。
检查结果：原先失败的导入/后端检查通过，再完成安装。
检查结果：任务通过下载、解包和验证，不再停在同一原因。
失败资源行显示“已就绪”，并用其所属工具完成一个最小任务；单看“下载100%”不算安装恢复。
RESOURCE_WRITE_FAILED先确认缓存磁盘空间；需要换盘时选空目录，并等关闭 AE 后迁移完成。资源目录磁盘空间不足。错误明确包含 ENOSPC 或“资源目录磁盘空间不足”，才按空间不足处理；EPERM 不是空间不足的证明。在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。
检查结果：同一资源不再报 ENOSPC，并显示已就绪。
检查结果：新目录已生效，任务在目标磁盘完成，原资源仍能使用。
检查结果：迁移完成并被界面识别；不留下半搬迁的模型状态。
界面显示的实际缓存目录在预期磁盘，失败组件已就绪，最小处理任务正常。
RESOURCE_WRITE_FAILED先看失败的操作：普通写入、rename 切换和文件占用不能只凭 EPERM 混为一谈。资源目录没有写权限。 / 资源临时文件被占用。出现“资源目录没有写权限”“资源临时文件被占用”，或日志含 EACCES/EPERM/EBUSY。界面可能把 EPERM 映射成权限文案，但这并未识别根因。在 Only Scripts 的「实验」页，找到「运行组件」并点「管理组件」。展开「任务日志」，按本次失败时间找到对应任务；只看最后一行“失败”不足以区分原因。
如果面板只显示总错误，按提示中的「日志路径」打开文件。也可点「打开目录」，在 logs 文件夹中找 runtime-dependency-downloads.log，搜索本次 jobId 对应的 RESOURCE_MANAGER_FAILURE，读取 stage、causeCode、causeMessage。旧版没有这份文件时，保留面板已有的完整提示。
检查结果：目录切换通过，组件验证完成；无需删除现有模型。
检查结果：目标目录能正常写入，失败资源完成验证。
检查结果：同一文件操作不再被占用阻断。
原先失败的具体写入或目录切换通过，组件已就绪且可用；不把错误文案变化当作恢复。
修复 Only Shadow 准备任务异常结束后，残留锁导致无法继续准备模型的问题。
本次为完整安装包。更新前请保存工程并关闭 AE，安装后重新打开；已有模型和运行目录保留。