Easy Edit v1.2 - After Effects 智能合成修改脚本

Easy Edit 是一款专为 Adobe After Effects 设计的高效脚本工具，旨在简化繁琐的合成设置修改流程。
它具备“智能判定”与“递归穿透”功能，能够根据您的选择状态，快速批量地修改合成时长、帧率及尺寸，极大提升项目整理与修改的效率。

🇨🇳 中文说明 (Chinese)

✨ 主要功能

智能上下文判定
有选中时：修改所选图层对应的源合成（Source Comp）。
无选中时：直接修改当前打开的活跃合成（Active Comp）。
强大的子合成穿透 (Recursive)
勾选穿透功能后，脚本会自动递归查找并修改所有嵌套的子合成，一键搞定复杂的嵌套结构。
点击对齐按钮，可将合成或图层出点对齐至当前播放头（CTI）。
自动补帧逻辑：自动增加 1 帧时长，避免因 AE 播放机制导致最后一帧不可见的问题。
灵活的时长修改模式
模式1：修改所有层 + 穿透子合成。
模式2：智能识别，仅修改原本时长触及末尾的图层 + 穿透（保持短图层不变）。
模式3：仅修改当前合成容器的时长，不影响内部图层。

📥 安装方法

下载 EasyEdit.jsx 文件。
将脚本文件复制到 After Effects 的脚本面板文件夹中：
Windows: ...\Adobe After Effects [版本]\Support Files\Scripts\ScriptUI Panels\
Mac: /Applications/Adobe After Effects [版本]/Scripts/ScriptUI Panels/
重启 After Effects
在顶部菜单栏选择 窗口 (Window) -> EasyEdit 即可打开面板。
该面板支持停靠（Dockable），您可以将其吸附在 AE 界面的任意位置。

🎮 使用指南

1. 时长与出点控制

对齐至播放头：将时间线指针（CTI）移动到想要结束的位置，点击按钮。脚本会将合成时长或选中图层的出点裁剪至此（包含当前帧）。
增加 20 秒：点击即可快速在当前时长基础上增加 20 秒。
修改模式 (Radio Buttons)：
若只想改合成总时长而不改变内部结构，请选择模式 3。
若想让内部所有子合成同步变长/变短，请选择模式1或模式2。

2. 帧率设置 (FPS)

输入目标帧率（如 25, 30, 60）。
勾选 开启子合成穿透修改，可将所有嵌套的子合成统一改为指定帧率。
点击 应用帧率修改。

3. 合成尺寸设置 (Size)

输入格式为 宽度 * 高度（例如：1920 * 1080）。
同样支持子合成穿透修改。
点击 应用尺寸修改。

👨‍💻 作者信息

博客：yuemoon.vip
GitHub：@YueMoon99
B站：UID223633562
Bug反馈或更多脚本制作建议：我的博客与我联系

English Description

✨ Features

Easy Edit v1.2 is a smart utility script for Adobe After Effects designed to streamline composition settings adjustment.
It features "Smart Context Detection" and "Recursive Penetration" logic to maximize efficiency.

Smart Context Detection
Selection Exists: Modifies the Source Comps of the selected layers.
No Selection: Modifies the Active Composition currently open.
Recursive Sub-Comp Penetration
When the "Penetrate" checkbox is enabled, the script recursively finds and modifies all nested pre-comps deep within the hierarchy.
Precise Duration Alignment (CTI + 1 Frame)
Aligns the Out Point to the Current Time Indicator (Playhead).
Smart Fix: Automatically adds 1 extra frame to ensure the last frame remains visible (solving the common "disappearing last frame" issue in AE).
Flexible Duration Modes
Mode 1: Modifies all layers + Penetrates sub-comps.
Mode 2: Smart Logic – Only modifies layers that originally extended to the end of the comp + Penetration.
Mode 3: Container Only – Changes the composition duration without affecting layer out-points.
Quick Actions
[Add 20s]: Instantly extends the duration of the active comp or selected layer sources by 20 seconds.

📥 Installation

Download the EasyEdit.jsx file.
Copy the file to the ScriptUI Panels folder:
Windows:...\Adobe After Effects [Version]\Support Files\Scripts\ScriptUI Panels\
Mac: /Applications/Adobe After Effects [Version]/Scripts/ScriptUI Panels/
Restart After Effects.
Go to the top menu: Window -> EasyEdit.
The panel is dockable and can be placed anywhere in your workspace.

🎮 How to Use

1. Duration / Out Point Control

Align to Playhead: Move the CTI to your desired end point and click. The script sets the duration/out-point exactly to this time (inclusive of the current frame).
Add 20s: Quickly adds 20 seconds to the current duration.
Modes:
Use Mode 3 if you only want to change the container duration.
Use Mode 1 or Mode 2 to recursively adjust internal layers and sub-comps.

2. Frame Rate (FPS)

Enter your desired FPS (e.g., 25, 30, 60).
Check Sub-Comp Penetrate to apply this FPS to all nested compositions.
Click Apply FPS.

3. Comp Size

Enter dimensions in Width * Height format (e.g., 1080 * 1920).
Check Sub-Comp Penetrate to resize all nested compositions recursively.
Click Apply Size.

📝 Author & License

Author: YueMoon (舟午)
Blog: yuemoon.vip
GitHub：@YueMoon99
Bilibili: UID 223633562
License: Open-source free software. Resale is prohibited.