After Effects 效果、预设、曲线和素材的一体化工作面板
English · 中文
Beta 状态:DreamEngine 面向 Windows,当前在 After Effects 2021 / CEP 11 上完成主要实机验证。更新版本的 AE 尚未完成完整验收。
当前版本:DreamEngine 0.3.0 / v0.3.0-beta.1
从 GitHub Releases 下载:
DreamEngine-Hub-Setup-0.3.0.exeSHA256SUMS.txt
安装步骤:
- 在 After Effects 中保存工程并退出。
- 运行安装器,选择安装目录并完成安装。
- 启动 After Effects,打开
窗口 > 扩展 > DreamEngine。
安装器未签名,Windows SmartScreen 可能显示“未知发布者”。升级会替换程序文件和内置预览资源,但不会删除用户预设、分类、收藏或已生成的预览。
| 页面 | 操作 |
|---|---|
| 效果 | 搜索或筛选效果;双击添加到当前选中图层;悬停播放动态预览 |
| 预设 | 单击应用 .ffx 预设;使用左侧分类与收藏筛选 |
| 曲线 | 两点/多点编辑;读取、反向、换键、冻结;应用或保存曲线预设 |
| 素材 | 选择一个根目录后可进入子文件夹;顶部面包屑点任一段回退;单击预览;双击导入并放到当前合成时间位置 |
Hub 是不依赖 AE 主进程的独立管理程序,主要用于:
- 添加、重命名、收藏、分类和长按删除
.ffx预设。 - 为第三方插件预设生成离线预览图与动态帧序列。
- 使用当前 AE 的插件清单,在独立 AE 实例中逐条生成第三方效果预览。
- 在「效果库」按 AE 分类浏览内置效果和第三方插件效果,未生成预览的条目显示为待渲染。
- 对单条预设清空旧预览,或强制单独重渲。
- 添加自定义预览背景。
- 查看面板安装状态、AE 版本、目录和渲染日志。
预设分类和预设收藏由 AE 面板与 Hub 共用。
预设库
- 支持文件选择或拖入
.ffx。 - 左侧分类支持新建、重命名和删除;分类栏可拖动调整宽度,双击分隔条或点「«」收起,收起后点工具栏「分类 »」展开。
- 收藏是独立筛选,可与分类组合使用。
- 动态预设悬停播放;静态预览以右上角橙色圆点标识。
- 右键菜单提供:重命名、收藏、取消渲染、单独渲染、删除预设、移动到分类。
- “取消渲染”会删除该预设的索引与帧文件,使其回到待渲染状态,并重新参与下一次批量渲染。
- 长按卡片或使用右键菜单可删除预设库中的
.ffx。 - 可自动索引当前所选 AE 的安装 Presets 与 User Presets 中的
.ffx(只建索引、不复制文件),并在预设页按来源筛选;外部 AE 预设可以勾选渲染和单独渲染,但重命名/删除只作用于 DreamEngine 自己的预设库。左侧分类栏会把外部预设按 AE 来源文件夹(如 Text、Trapcode Tao)分组。
效果库
- 与预设库同款布局:左侧分类栏可拖动/收起,右侧预览网格支持搜索、来源筛选和悬停播放。
- 内置效果与「渲染 → 插件效果」里扫描到的第三方效果统一列出:已生成预览的悬停播放,还没生成的显示为「待渲染」占位。
- 左侧按来源分组(AE 内置 / BCC / Sapphire / Red Giant / RE:Vision / Video Copilot / 其它插件),每组可展开或折叠,折叠状态会被记住;分类与分组都来自当前 AE 的扫描结果。
- 分类同步当前 AE:内置效果用双语名字表里的 AE 分类,插件效果用插件目录扫描到的 AE 分类。
- 插件预览按「插件 + 效果显示名」复用;插件升级或
matchName改变时不要求重新渲染,当前版本已不存在的旧预览只计为历史预览。 - 「同步 AE 分类」会重新扫描插件效果目录(只扫描、不渲染),刷新分类后自动回到效果库。
离线预览渲染
- “插件效果”页会自动读取当前 AE 的插件清单,逐条隔离渲染,并支持停止、断点继续和崩溃黑名单。
- “插件效果”页可先“扫描插件目录”,按插件/分类/名称勾选指定效果,只渲染所选条目;勾选“强制重渲”可重新渲染已生成或已跳过的效果。
- Sapphire Transitions 系列会自动使用前景 / 背景两层输入并开启 Auto Trans,生成完整转场动画;S_Transition Builder 仍需载入具体转场预设后才能预览。
- 预设页支持多选预设,只渲染所选;也可一键选择当前筛选下所有未渲染的预设。
- 文本 / 动画类 AE 预设(AE 自带的 Text、Behaviors、Transitions 等)不新增效果,预览会先自动落在合成里的文本层上;没有文本层时自动改用「文字」素材渲染,不再误报「应用失败」。
- 插件预设通过独立的 AE 实例渲染,避免破坏正在使用的 AE 会话。
- 默认每个专用 AE 实例连续处理最多 40 条,减少重复启动。
- 渲染前必须保存并关闭 AE;任务完成后可按原状重新打开 AE。
- 渲染模板按所选 AE 主版本首次自动生成并复用,避免用 AE 2023 创建的 AEP 去启动 AE 2021。
- 支持内置与自定义预览背景。
- “单独渲染”只处理所选预设,并强制绕过已有预览和失败黑名单。
设置与诊断
- 查看 Hub、面板和内置预览版本。
- 在介绍页检查 GitHub Releases 更新,并在发现新版本时打开下载页。
- 查看已安装的 AE 版本与运行状态。
- 打开扩展、预设库和日志目录。
效果
- 按名称或分类排序,按插件来源筛选。
- 动态预览悬停播放,静态效果保持静止。
- 双击效果或点击卡片上的添加按钮,将效果加入当前选中图层。
- 收藏效果,并与分类条件组合筛选。
- 可在设置中上传普通画面类效果的自定义预览背景。
预设
- 浏览已导入预设及预览。
- 预设库与 Hub 同步:递归显示用户库,并合并 Hub 索引的 AE 安装预设和 User Presets;外部预设按 AE 来源文件夹分类、只读且不复制文件。
- 单击应用预设;长按可删除库内预设。
- 分类和收藏与 Hub 双向共用。
- 动态预设悬停播放;静态预设显示橙色圆点。
曲线
- 支持两点和多点曲线模式,并提供值曲线、速度曲线和空间路径图。
- 多点模式可双击插入节点、拖动节点与把手,并用 Delete/Backspace 删除中间节点。
- 工具栏支持读取当前曲线、曲线反向、关键帧交换、左右冻结、0.1 网格磁吸以及本地撤销/重做。
- 可保存单点和多点自定义曲线预设,并长按删除已有预设。
- 多关键帧应用要求正好选中两个关键帧,只写入该区间;已有用户原生中间键时拒绝改写。
- 写入前检查关键帧是否发生变化,避免覆盖并发修改;整批应用可通过一次 AE 撤销恢复。
素材
- 只登记一个素材根目录,不复制、不移动、不修改源文件。
- 按目录浏览:进入子文件夹、点顶部面包屑逐级回退;文件夹卡片显示该目录下的素材数量。
- 分类计数与搜索都只统计当前所在目录;空文件夹不显示。
- 刷新与更换根目录在右上角,刷新后保留当前目录;目录被删除时自动回退到最近仍存在的上级。
- 自动分类视频、图片、音频、
.aep工程和.jsx/.jsxbin脚本。 - 视频单击后播放,视频预览最多截取 5 秒。
- 音频显示面板内生成的波形,并支持单击播放/停止;波形生成不依赖 FFmpeg。
- 双击视频、图片或音频,导入项目并添加到当前合成的时间指示器位置。
.aep只导入工程,不解析内容或作为素材层加入合成。- 素材收藏可与分类组合筛选。
- Windows 10 或 Windows 11
- After Effects 2021(18.0)或更高版本
- 推荐安装
ffmpeg,用于部分视频缩略图/预览缓存
未安装 ffmpeg 时,音频波形、播放和导入仍可使用;部分不兼容视频的缩略图/预览可能显示为空。
After Effects 面板
DreamEngine Hub
DreamEngine 不上传工程、素材或预设。
| 路径 | 内容 |
|---|---|
文档/DreamEngine/presets/ |
用户 .ffx 预设 |
文档/DreamEngine/backgrounds/ |
自定义预览背景 |
文档/DreamEngine/preset_categories.json |
预设分类与预设收藏 |
文档/DreamEngine/materials/ |
素材索引与视频预览缓存 |
文档/DreamEngineProbe/ |
Hub 渲染状态与日志 |
%APPDATA%/Adobe/CEP/extensions/com.dreamengine.panel/ |
已安装面板及内置预览索引 |
效果收藏、素材收藏、曲线预设和部分面板设置仍保存在 CEP 面板的本地 localStorage 中。
升级会保留预设与缓存。通过 Windows 设置或开始菜单卸载 DreamEngine 时会完全清理面板脚本、预设库、背景、缓存、日志、CEP localStorage 和相关注册表设置;如需保留预设,请在卸载前备份 文档/DreamEngine/。
AE 菜单里没有 DreamEngine
- 确认安装器和 AE 使用同一个 Windows 用户。
- 完全退出并重新启动 AE。
- 在 Hub 的“设置”页确认面板安装状态和扩展目录。
插件预设无法渲染
- 保存并关闭所有 AE 实例后,再从 Hub 开始渲染。
- 检查 Hub 的渲染日志和
文档/DreamEngineProbe/。 - 确认本机安装了预设依赖的第三方插件。
素材没有预览
- 安装
ffmpeg,或在文档/DreamEngine/materials/ffmpeg.txt中填写ffmpeg.exe的绝对路径。 - 回到素材页点击“刷新”。
- 使用 Bug 模板 报告可复现问题。
- 使用 功能建议模板 提议新工作流。
- 提交问题时请附上 DreamEngine、Windows、After Effects 和 CEP 版本,以及
文档/DreamEngineProbe/中的相关日志。 - 提交代码前请阅读 PR 模板,并确保公开内容不包含密钥、个人路径或隐私信息。
cep/com.dreamengine.panel/ After Effects CEP 面板
hub/ Electron 管理程序
tools/ Hub 与面板调用的 PowerShell、ExtendScript 和模板
dist/L1/ 内置效果预览资源
assets/screenshots/ README 截图
提交 tools/ 前请检查脚本中不包含密钥、个人路径或隐私数据。
本项目采用 MIT License。允许使用、复制、修改、合并、发布、分发、再许可和销售,但需保留版权与许可声明。
- 安装包尚未代码签名。
- 主要在 AE 2021 / CEP 11 上完成验收。
- 第三方插件预览依赖本机插件和授权环境。
- 素材库目前只支持一个根目录;磁盘变化后需要手动刷新。
.aep不解析内部合成,也不会自动打开。- Hub 与 AE 面板不会在另一端操作后自动轮询刷新分类列表;切回对应页面时会重新读取。

