## 概述此技能通过生成 ExtendScript (.jsx) 并通过 osascript 执行它来自动化 After Effects。它通过查询脚本读取项目状态，使用规则文件获取领域知识，并将所有变更包装在撤消组中。 ## 首次设置 1.使用任意查询脚本运行“scripts/runner.sh”来检测AE版本 2. 如果安装了多个AE版本，用户必须选择一个——runner.sh会提示 3. 确保 AE 首选项 > 脚本和表达式 >“允许脚本写入文件和访问网络”已启用 ## 工作流程对于每个用户请求： ### 第 1 步：收集上下文（自动运行，无需确认）运行活动状态查询： bash脚本/runner.sh脚本/active-state.jsx 然后读取“/tmp/ae-assistant-result.json”以获取活动合成、选定图层、CTI。如果这是第一次交互或项目上下文未知，还请运行： bash 脚本/runner.sh 脚本/project-overview.jsx 默认情况下，这会返回**摘要**：包含计数的文件夹树、列出的所有合成、按文件类型分组的素材。不是每个单独的文件。要深入到特定文件夹： bash 脚本/runner.sh 脚本/project-overview.jsx '{"mode": "folder", "folderName": "Images"}' 仅当您确实需要列出的所有项目时才使用完整模式： bash 脚本/runner.sh 脚本/project-overview.jsx '{"mode": "full"}' ### 第 2 步：根据需要深入分析（自动运行）如果任务针对特定的补偿： bash 脚本/runner.sh 脚本/comp-detail.jsx '{"compName": "Comp Name"}' 如果任务针对特定层： bash脚本/runner.sh脚本/layer-detail.jsx'{“layerNames”：[“第1层”，“第2层”]}' 省略“compName”以使用活动的comp。省略“layerNames”以使用选定的图层。 #### 附加查询脚本 **表达式错误** — 扫描损坏的表达式： bash 脚本/runner.sh 脚本/表达式错误.jsx bash 脚本/runner.sh 脚本/表达式错误.jsx '{"compName": "Main Comp"}' **字体库存** — 列出项目中使用的所有字体： bash 脚本/runner.sh 脚本/font-inventory.jsx **项目审核** — 全面的健康检查（未使用的素材、丢失的文件、表达错误、重复的实体、字体问题、空文件夹）： bash 脚本/runner.sh 脚本/project-audit.jsx bash脚本/runner.sh脚本/project-audit.jsx'{“检查”：[“未使用”，“缺失”，“表达式”]}' ### 第 3 步：加载领域知识从`rules/`中读取相关规则文件。请务必阅读“rules/extendscript-fundamentals.md”——它包含适用于每个生成脚本的 ES3 约束。任务涉及|加载规则文件 ---|--- 图层（创建、移动、父级、复制）| [rules/layer-manipulation.md]() 关键帧、动画、缓动 | [rules/keyframes-animation.md]() 表达式 | [规则/表达式.md]() 合成（创建、预合成、嵌套）| [rules/composition-management.md]() 效果和参数| [rules/effects.md]() 导入、素材、资产 | [rules/assets-footage.md]() 渲染队列，导出| [rules/rendering.md]() 批量/批量操作| [rules/batch-operations.md]() 特定于版本的功能 | [references/ae-api-versions.md]() ### 第 4 步：生成操作脚本 **关键：首先解决技能的真实路径** 在编写或执行任何动作脚本之前，请解析技能的真实（非符号链接）路径。 ExtendScript `#include` 无法遵循符号链接，因此您必须使用真实的文件系统路径。在每个会话开始时运行一次： SKILL_SCRIPTS="$(readlink -f ~/.claude/skills/after-effects-assistant/scripts 2>/dev/null || readlink ~/.claude/skills/after-effects-assistant/scripts)" 回显“$SKILL_SCRIPTS” 在此会话中的所有后续 Write 和 Bash 命令中使用解析的路径 (`$SKILL_SCRIPTS`)。 **为什么这很重要：** * `~/.claude/skills/` 通常是一个符号链接 — ExtendScript `#include` 通过符号链接失败 * 写入真实的 `scripts/` 目录可以让 `#include "lib/json2.jsx"` 正确解析 * 解析的路径每台机器都会改变，所以不要硬编码它每个生成的脚本必须遵循此模板： #include“lib/json2.jsx” #include“lib/utils.jsx” （函数（）{ app.beginUndoGroup("AE助手：<动作描述>"); 尝试{ var args = readArgs(); var comp = app.project.activeItem; if (!comp || !(comp instanceof CompItem)) { writeResult({ 错误: "没有有效的组合" }); 返回； } // ... 操作代码 ... writeResult({ success: true, message: "<完成了什么>" }); } 捕获 (e) { 尝试 { writeResult({ 错误: e.toString(), 行: e.line, 文件名: e.fileName }); } catch(e2) { writeError(e.toString(), "line:" + e.line); } } }最后{ app.endUndoGroup(); } })(); **使用 Write 工具编写脚本，然后使用简短的 bash 命令执行：** 1.使用**Write**工具将脚本写入`$SKILL_SCRIPTS/ae-action.jsx`（解析后的真实路径） 2.用bash执行： bash“$SKILL_SCRIPTS/runner.sh”“$SKILL_SCRIPTS/ae-action.jsx” **重要提示：** 不要在此处使用 `cat > file << 'SCRIPT'` — 它们将整个脚本放在 bash 命令中，从而使权限提示变得混乱。始终使用写入工具来编写脚本内容，然后使用简短的 bash 命令来运行它。 ###第五步：执行或确认 **自动运行**（无需确认）： * 所有只读查询（活动状态、项目概述、组合详细信息、图层详细信息、表达式错误、字体库存、项目审核） * 非破坏性添加：添加关键帧、添加效果、创建图层、创建合成 **运行前确认**（显示脚本并询问用户）： * 删除图层或合成 * 删除关键帧 * 替换素材 * 清除表达式 * 渲染队列操作 * 项目清理（删除未使用的项目，合并固体） * 用户可能不期望的任何操作 ### 内置动作脚本在生成自定义“ae-action.jsx”之前，请检查内置脚本是否已处理该任务。这些是永久的、经过测试的脚本，具有基于参数的行为： **真正的Comp复制器** - 深度克隆具有独立子comp的comp（运行前确认）： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/true-comp-duplicator.jsx" '{"compName": "Main Comp", "suffix": " COPY"}' **字体替换** — 在整个项目中查找并替换字体。始终先进行 dryRun： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/font-replace.jsx" '{"find": "Helvetica", "replace": "Inter-Regular", "dryRun": true}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/font-replace.jsx" '{"find": "Helvetica", "replace": "Inter-Regular"}' **项目清理** — 删除未使用的素材、合并重复的实体、删除空文件夹。始终先进行 dryRun： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/project-cleanup.jsx" '{"dryRun": true}' bash“$SKILL_SCRIPTS/runner.sh”“$SKILL_SCRIPTS/project-cleanup.jsx” **批量重命名** — 批量重命名图层、复合或项目项： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/batch-rename.jsx" '{"target": "layers", "mode": "find-replace", "find": "Layer", "replace": "Element"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/batch-rename.jsx" '{"target": "layers", "mode": "prefix", "prefix": "BG_"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/batch-rename.jsx" '{"target": "layers", "mode": "sequence", "base": "Card", "start": 1}' **图层交错** — 及时偏移所选图层以进行级联动画： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/layer-stagger.jsx" '{"offset": 0.1, "unit": "secs", "direction": "forward"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/layer-stagger.jsx" '{"offset": 2, "unit": "frames"}' **表达式替换** — 在项目范围内的表达式中查找/替换文本。始终先进行 dryRun： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/expression-replace.jsx" '{"find": "comp(\"Old\")", "replace": "comp(\"New\")", "dryRun": true}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/expression-replace.jsx" '{"find": "comp(\"Old\")", "replace": "comp(\"New\")"}' **组织项目** — 按类型将项目面板项目自动分类到文件夹中： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/organize-project.jsx" '{"struct": "by-type"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/organize-project.jsx" '{"struct": "by-extension"}' **批量补偿设置** — 更改多个补偿的 fps、分辨率、持续时间： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/batch-comp-settings.jsx" '{"scope": "all", "fps": 25}' bash“$SKILL_SCRIPTS/runner.sh”“$SKILL_SCRIPTS/batch-comp-settings.jsx”'{“compNames”：[“Comp 1”，“Comp 2”]，“宽度”：3840，“高度”：2160}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/batch-comp-settings.jsx" '{"scope": "nested", "fps": 30, "duration": 10}' **缓动预设** — 应用专业缓动或弹跳/弹性表达式： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/easing-presets.jsx" '{"preset": "smooth"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/easing-presets.jsx" '{"preset": "snappy"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/easing-presets.jsx" '{"preset": "bounce"}' **锚点移动器** — 通过视觉位置补偿重新定位锚点： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/anchor-point-mover.jsx" '{"position": "center"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/anchor-point-mover.jsx" '{"position": "左下角"}' **反向关键帧** — 选定属性上的反向动画： bash“$SKILL_SCRIPTS/runner.sh”“$SKILL_SCRIPTS/reverse-keyframes.jsx” **选择图层** — 按类型、标签、属性或名称选择图层： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/select-layers.jsx" '{"type": "text"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/select-layers.jsx" '{"hasExpressions": true}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/select-layers.jsx" '{"nameContains": "BG"}' **图层排序** — 按名称、位置、入点、类型或标签对时间轴中的图层重新排序： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/layer-sort.jsx" '{"sortBy": "名称", "顺序": "升序"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/layer-sort.jsx" '{"sortBy": "position-y"}' **智能预合成** — 具有自动修剪持续时间的预合成： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/smart-precompose.jsx" '{"name": "我的 Precomp", "trimToContent": true}' **复制缓动** — 从一个关键帧复制缓动并粘贴到其他关键帧： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/copy-ease.jsx" '{"mode": "both"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/copy-ease.jsx" '{"sourceLayer": "徽标", "sourceProperty": "位置", "sourceKeyIndex": 2}' **重新链接素材** — 批量重新链接搜索目录中丢失的素材。始终先进行 dryRun： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/relink-footage.jsx" '{"searchPaths": ["/Volumes/Projects/footage"], "dryRun": true}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/relink-footage.jsx" '{"searchPaths": ["/Volumes/Projects/footage"]}' **SRT 导入** — 从 SRT 文件创建定时字幕文本图层： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/srt-import.jsx" '{"srtPath": "/path/to/subs.srt", "fontSize": 48}' **文本导出/导入** — 将所有文本导出到 CSV，在外部编辑，重新导入： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/text-export-import.jsx" '{"mode": "export", "csvPath": "/tmp/text.csv"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/text-export-import.jsx" '{"mode": "import", "csvPath": "/tmp/text.csv"}' **批量表达式** — 批量应用、删除、启用或禁用表达式： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/batch-expression.jsx" '{"property": "不透明度", "表达式": "wiggle(2, 10)", "mode": "应用"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/batch-expression.jsx" '{"mode": "remove"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/batch-expression.jsx" '{"mode": "disable"}' **随机化属性** — 应用随机值来变换属性： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/randomize-properties.jsx" '{"property": "旋转", "最小值": -15, "最大值": 15}' bash“$SKILL_SCRIPTS/runner.sh”“$SKILL_SCRIPTS/randomize-properties.jsx”'{“property”：“位置”，“minX”：0，“maxX”：1920，“minY”：0，“maxY”：1080}' **Un-PreCompose** — 将预复合中的层提取回父级（运行前确认）： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/un-precompose.jsx" '{"precompLayerName": "Precomp 1"}' **来自 CSV 的比较** — 从电子表格数据生成比较变体（运行前确认）： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/comp-from-csv.jsx" '{"templateComp": "下三分之一", "csvPath": "/path/data.csv"}' **渲染队列批次** — 将多个组合添加到渲染队列（运行前确认）： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/render-queue-batch.jsx" '{"compNames": ["Final_16x9", "Final_9x16"], "outputPath": "~/Desktop/renders/"}' bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/render-queue-batch.jsx" '{"scope": "folder", "folderName": "Finals"}' **分解形状层** — 将形状组拆分为单独的层： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/explode-shape-layer.jsx" '{"layerName": "AI 导入"}' **增量保存** — 使用自动递增版本号保存项目： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/incremental-save.jsx" '{"comment": "修订前"}' **清除缓存** — 清除内存缓存、磁盘缓存和可用资源。 dryRun 首先检查尺寸： bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/purge-cache.jsx" '{"dryRun": true}' bash“$SKILL_SCRIPTS/runner.sh”“$SKILL_SCRIPTS/purge-cache.jsx” bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/purge-cache.jsx" '{"内存": true, "磁盘": false}' ###第六步：执行并读取结果 # 执行操作脚本（已在步骤 4 中写入 $SKILL_SCRIPTS/ae-action.jsx） bash "$SKILL_SCRIPTS/runner.sh" "$SKILL_SCRIPTS/ae-action.jsx" '{"arg1": "value1"}' 读取“/tmp/ae-assistant-result.json”以获取结果。 ### 调试失败如果脚本失败，请按顺序检查以下内容： 1. **`~/.ae-assistant-log`** — runner.sh 在此记录每次执行、参数、结果和错误 2. **`/tmp/ae-assistant-error.txt`** — JXA 级错误（AE 未响应，DoScriptFile 失败） 3. **`~/.ae-assistant-extendscript.log`** — 来自 utils.jsx 中 `appendLog()` 的 ExtendScript 级别日志 4. **AE 首选项** — 确保启用“允许脚本写入文件和访问网络” 发生错误时，请阅读“~/.ae-assistant-log”以了解发生的情况，修复脚本并重试。 ## 必须 * 始终将突变包装在 `app.beginUndoGroup()` / `app.endUndoGroup()` 中 * 始终使用 matchNames 进行属性访问，而不是显示名称（显示名称已本地化） * 始终对图层和项目项使用基于 1 的索引 * 始终将操作脚本写入“$SKILL_SCRIPTS/ae-action.jsx”（已解析的真实路径，而不是“/tmp/”） * 始终使用相对 `#include "lib/json2.jsx"` 和 `#include "lib/utils.jsx"` （不是绝对路径） * 始终包裹在 IIFE 中以避免全局范围污染 * 始终使用 `var`，切勿使用 `let` 或 `const` (ES3) * 始终通过 writeResult() 将结果写入 /tmp/ae-assistant-result.json * 在访问 comp 属性之前始终检查 `comp instanceof CompItem` ## 禁止 * 切勿使用 ES5+ 语法：let、const、箭头函数、模板文字、解构 * 永远不要使用 Array.map、Array.filter、Array.reduce、Array.forEach（ES3 中没有） * 切勿在不包含 json2.jsx 的情况下使用 JSON.parse 或 JSON.stringify * 切勿将操作脚本写入 `/tmp/` — ExtendScript `#include` 无法解析那里的路径 * 切勿在“#include”中使用绝对路径——它们会破坏符号链接 * 切勿对图层索引进行硬编码 - 使用名称、选择或迭代 * 切勿在未经用户确认的情况下运行破坏性操作 * 切勿在未检查的情况下假设比较处于活动状态 * 切勿在此处使用 `cat > file << 'SCRIPT'` 来编写脚本 - 请改用 Write 工具，然后使用简短的 bash 命令执行

后期效果

包含技能