Skip to content

Releases: tzdwindows/after-effects-mcp

v1.1.0 - Complete Package (dist/index.js + Audio Beat Sync + MMS-CTC Aligner + Bundled DOVER-Mobile)

Choose a tag to compare

@tzdwindows tzdwindows released this 23 Oct 07:19

After Effects MCP v1.1.0 — 完整打包版 (含 dist/index.js、音画鼓点对齐、MMS/CTC 强制字幕对齐与内置 DOVER-Mobile 视频评分模型)

📦 下载文件说明 (Release Assets)

文件名 内容与用途说明
after-effects-mcp-v1.1.0-complete.zip (推荐下载) 完整独立打包程序。内含已编译的 dist/index.js (MCP 服务端主程序)、dist/scripts/mcp-bridge-auto.jsx (AE 面板脚本)、内置 DOVER-Mobile 视频质量打分模型 (models/dover_mobile/dover_mobile.onnx)、内置 MMS/CTC 强制字幕对齐模型 (models/mms_fa/ctc_aligner.int8.onnx + silero_vad.onnx)、内置 bin/ffmpeg.exe 解码器、一键安装脚本 install-bridge.bat 以及专用安装说明 INSTALL_GUIDE.md。
mcp-bridge-panel-v1.1.0.zip 仅包含 After Effects 面板脚本 mcp-bridge-auto.jsx 与安装说明,适合仅需单独更新 AE 面板的用户。

🚀 三步快速安装与使用指南 (Quick Installation Guide)

第一步:解压并一键安装 AE 桥接面板

  1. 下载并解压 after-effects-mcp-v1.1.0-complete.zip 到任意固定目录(例如 D:\after-effects-mcp)。
  2. Windows 用户:直接双击运行根目录下的 install-bridge.bat(或终端运行 npm install && npm run install-bridge)。
    macOS / Linux 用户:在终端运行 bash install-bridge.sh。

    自动完成的操作:

    • 自动安装/校验 onnxruntime-node 原生推理依赖;
    • 自动查找本机 Adobe After Effects 安装目录并部署 mcp-bridge-auto.jsx 到 Support Files/Scripts/ScriptUI Panels/;
    • 自动清理 AE 主菜单与窗口菜单中堆积的历史备份文件(所有备份统一隔离在 ~/.ae-mcp/backups/)。
  3. 手动安装面板方式(可选):直接将 dist/scripts/mcp-bridge-auto.jsx 复制到:
    • Windows: C:\Program Files\Adobe\Adobe After Effects <版本>\Support Files\Scripts\ScriptUI Panels\
    • macOS: /Applications/Adobe After Effects <版本>/Scripts/ScriptUI Panels/

第二步:开启 After Effects 脚本权限并打开面板

  1. 打开 Adobe After Effects。
  2. 进入 编辑 (Edit) -> 首选项 (Preferences) -> 脚本和表达式 (Scripting & Expressions),勾选 “允许脚本写入文件和访问网络” (Allow Scripts to Write Files and Access Network)。
  3. 点击顶部菜单 窗口 (Window) -> mcp-bridge-auto.jsx 打开控制台面板,保持 自动执行指令 (Auto-run) 勾选即可。

第三步:在 AI 客户端 (Claude Desktop / Cursor / Cline / Antigravity) 中配置 dist/index.js

在客户端的 MCP 配置文件中添加(请将路径替换为您解压后的实际路径):

{
  "mcpServers": {
    "after-effects": {
      "command": "node",
      "args": [
        "D:/after-effects-mcp/dist/index.js"
      ]
    }
  }
}

✨ v1.1.0 核心更新内容 (What's New)

  1. 彻底修复插件备份添加到 AE 主菜单导致选项堆积的问题:
    • 修复了旧版 app.project.save(snapFile) 触发 AE “另存为” 导致每次执行操作都将 snapshot_*.aep 塞入 文件 -> 最近打开的文件 (Open Recent) 主菜单并篡改当前工程路径的严重 Bug;现改为原位 app.project.save() + 操作系统级静默复制 (File.copy)。
    • 面板启动时自动调用 cleanSnapshotEntriesFromMRU() 清除 AE 首选项 MRU 中的历史快照记录。
    • 新增 cleanBridgeBackups 工具,自动将 ScriptUI Panels 中的残留备份移至 ~/.ae-mcp/backups/。
  2. 新增多频段音频鼓点与节拍检测引擎 (analyzeAudioRhythm & applyBeatMarkersToComp):
    • 基于 2048-STFT 与 Ellis (2007) 动态规划节拍追踪,精准提取 BPM、4/4 小节重拍 (Downbeats)、Kick 底鼓 (20–150Hz)、Snare 军鼓 (150–2500Hz)、Hi-Hat 踩镲 (2500–10500Hz)、强冲击点及前奏/铺垫/高潮爆发分段,并支持一键在 AE 合成时间线上生成彩色鼓点标记。
  3. 新增内置 MMS-Align / CTC-Segmentation 声学强制字幕对齐引擎 (alignLyricsWithMMS & createAlignedLyricLayers):
    • 内置神经声学 CTC 模型 (models/mms_fa/ctc_aligner.int8.onnx) + silero_vad_v6.onnx + Kürzinger et al. (2020) Viterbi CTC-Segmentation 算法,精准对齐每个词/字的起止毫秒时间、修正 LRC 偏移、计算鼓点毫秒差,并支持一键生成 3D 卡点字幕图层。
  4. 新增内置官方 DOVER-Mobile 视频质量与音画同步评分模型 (evaluateVideoWithDOVER):
    • 内置官方 DOVER-Mobile (ConvNeXtV2-Femto-3D, models/dover_mobile/dover_mobile.onnx) 模型,对渲染视频进行 技术质量评分 (TQE)、美学质量评分 (AQE)、综合质量总分 (0–100) 与 音画鼓点同步率评分 (0–100),并提供分时段画面诊断与 AI 改进建议。

v1.0.0 - Initial Release (See v1.1.0 for Complete Package with dist/index.js & Bundled Models)

Choose a tag to compare

@tzdwindows tzdwindows released this 06 Oct 01:39

After Effects MCP v1.1.0 — 完整打包版 (含 dist/index.js、音画鼓点对齐、MMS/CTC 强制字幕对齐与内置 DOVER-Mobile 视频评分模型)

📦 下载文件说明 (Release Assets)

文件名 内容与用途说明
after-effects-mcp-v1.1.0-complete.zip (推荐下载) 完整独立打包程序。内含已编译的 dist/index.js (MCP 服务端主程序)、dist/scripts/mcp-bridge-auto.jsx (AE 面板脚本)、内置 DOVER-Mobile 视频质量打分模型 (models/dover_mobile/dover_mobile.onnx)、内置 MMS/CTC 强制字幕对齐模型 (models/mms_fa/ctc_aligner.int8.onnx + silero_vad.onnx)、内置 bin/ffmpeg.exe 解码器、一键安装脚本 install-bridge.bat 以及专用安装说明 INSTALL_GUIDE.md。
mcp-bridge-panel-v1.1.0.zip 仅包含 After Effects 面板脚本 mcp-bridge-auto.jsx 与安装说明,适合仅需单独更新 AE 面板的用户。

🚀 三步快速安装与使用指南 (Quick Installation Guide)

第一步:解压并一键安装 AE 桥接面板

  1. 下载并解压 after-effects-mcp-v1.1.0-complete.zip 到任意固定目录(例如 D:\after-effects-mcp)。
  2. Windows 用户:直接双击运行根目录下的 install-bridge.bat(或终端运行 npm install && npm run install-bridge)。
    macOS / Linux 用户:在终端运行 bash install-bridge.sh。

    自动完成的操作:

    • 自动安装/校验 onnxruntime-node 原生推理依赖;
    • 自动查找本机 Adobe After Effects 安装目录并部署 mcp-bridge-auto.jsx 到 Support Files/Scripts/ScriptUI Panels/;
    • 自动清理 AE 主菜单与窗口菜单中堆积的历史备份文件(所有备份统一隔离在 ~/.ae-mcp/backups/)。
  3. 手动安装面板方式(可选):直接将 dist/scripts/mcp-bridge-auto.jsx 复制到:
    • Windows: C:\Program Files\Adobe\Adobe After Effects <版本>\Support Files\Scripts\ScriptUI Panels\
    • macOS: /Applications/Adobe After Effects <版本>/Scripts/ScriptUI Panels/

第二步:开启 After Effects 脚本权限并打开面板

  1. 打开 Adobe After Effects。
  2. 进入 编辑 (Edit) -> 首选项 (Preferences) -> 脚本和表达式 (Scripting & Expressions),勾选 “允许脚本写入文件和访问网络” (Allow Scripts to Write Files and Access Network)。
  3. 点击顶部菜单 窗口 (Window) -> mcp-bridge-auto.jsx 打开控制台面板,保持 自动执行指令 (Auto-run) 勾选即可。

第三步:在 AI 客户端 (Claude Desktop / Cursor / Cline / Antigravity) 中配置 dist/index.js

在客户端的 MCP 配置文件中添加(请将路径替换为您解压后的实际路径):

{
  "mcpServers": {
    "after-effects": {
      "command": "node",
      "args": [
        "D:/after-effects-mcp/dist/index.js"
      ]
    }
  }
}

✨ v1.1.0 核心更新内容 (What's New)

  1. 彻底修复插件备份添加到 AE 主菜单导致选项堆积的问题:
    • 修复了旧版 app.project.save(snapFile) 触发 AE “另存为” 导致每次执行操作都将 snapshot_*.aep 塞入 文件 -> 最近打开的文件 (Open Recent) 主菜单并篡改当前工程路径的严重 Bug;现改为原位 app.project.save() + 操作系统级静默复制 (File.copy)。
    • 面板启动时自动调用 cleanSnapshotEntriesFromMRU() 清除 AE 首选项 MRU 中的历史快照记录。
    • 新增 cleanBridgeBackups 工具,自动将 ScriptUI Panels 中的残留备份移至 ~/.ae-mcp/backups/。
  2. 新增多频段音频鼓点与节拍检测引擎 (analyzeAudioRhythm & applyBeatMarkersToComp):
    • 基于 2048-STFT 与 Ellis (2007) 动态规划节拍追踪,精准提取 BPM、4/4 小节重拍 (Downbeats)、Kick 底鼓 (20–150Hz)、Snare 军鼓 (150–2500Hz)、Hi-Hat 踩镲 (2500–10500Hz)、强冲击点及前奏/铺垫/高潮爆发分段,并支持一键在 AE 合成时间线上生成彩色鼓点标记。
  3. 新增内置 MMS-Align / CTC-Segmentation 声学强制字幕对齐引擎 (alignLyricsWithMMS & createAlignedLyricLayers):
    • 内置神经声学 CTC 模型 (models/mms_fa/ctc_aligner.int8.onnx) + silero_vad_v6.onnx + Kürzinger et al. (2020) Viterbi CTC-Segmentation 算法,精准对齐每个词/字的起止毫秒时间、修正 LRC 偏移、计算鼓点毫秒差,并支持一键生成 3D 卡点字幕图层。
  4. 新增内置官方 DOVER-Mobile 视频质量与音画同步评分模型 (evaluateVideoWithDOVER):
    • 内置官方 DOVER-Mobile (ConvNeXtV2-Femto-3D, models/dover_mobile/dover_mobile.onnx) 模型,对渲染视频进行 技术质量评分 (TQE)、美学质量评分 (AQE)、综合质量总分 (0–100) 与 音画鼓点同步率评分 (0–100),并提供分时段画面诊断与 AI 改进建议。