AEAEAgent地图动画助手

AEAGENT / GET STARTED

从安装开始，
让文案变成地图动画。

跟着下面的步骤，准备音视频工具并安装 AEAgent。
Node.js 已内置，准备好 FFmpeg 和 ffprobe 即可继续安装。

开始安装

适用于 Windows 10 / 11 · 64 位 · 安装包 1.1.0

你的安装路线

  1. 00
    替换 GEOlayers 的 main.js必需步骤，先备份原文件
  2. 01
    完整解压安装包保留所有文件与文件夹
  3. 02
    准备 FFmpeg 与 ffprobe一个工具包，一次配置
  4. 03
    验证两条命令确认环境已准备好
  5. 04
    双击 安装.cmd在 AE 中打开 AEAgent
Node.js 已随安装包提供
开始之前

请先安装 After Effects 和已授权的 GEOlayers 3，并准备好你收到的 AEAgent 完整安装包。模型 API 和素材目录可按下方配置教程填写，旁白服务教程后续补充。

00

REQUIRED / GEOLAYERS

先替换 GEOlayers 的 main.js（必需）

我们提供的 main.js 新增了 AEAgent 制作流程所需的函数。必须先完成替换，再继续下面的安装步骤。

  1. 保存当前工程并完全关闭 After Effects。
  2. 在电脑上找到已安装的 GEOlayers 扩展文件夹，进入其中的 js 文件夹，找到 main.js。
  3. 将原来的 main.js 复制到其他文件夹保存，作为备份。
  4. 把我们提供的 main.js 复制到 GEOlayers 的同一个 js 文件夹，选择「替换目标中的文件」。如 Windows 提示管理员权限，请授权完成复制。
  5. 确认替换后的文件名仍为 main.js，再继续下方安装流程。
下载我们的 main.js ↓

对应 GEOlayers 3 · 1.6.3 build 847。下载后按上面的步骤替换；请先备份原文件。

在哪里找 GEOlayers 文件夹？

按 Win + R，依次尝试打开下面的扩展目录，找到名称包含 GEOlayers 的文件夹，再进入 js：

常见安装目录C:\Program Files (x86)\Common Files\Adobe\CEP\extensions
C:\Program Files\Common Files\Adobe\CEP\extensions
%APPDATA%\Adobe\CEP\extensions
完整路径示例（版本文件夹名以你电脑实际情况为准）C:\Program Files (x86)\Common Files\Adobe\CEP\extensions\GEOlayers3 1_6_3_build847\js\main.js
替换的是 js 文件夹里的 main.js

不要替换根目录的 main.html，也不要覆盖其他文件。如果找到多个 GEOlayers 安装目录，请先确认 AE 正在使用哪一份。使用我们为对应 GEOlayers 版本提供的文件；版本不同或找不到文件时，请先联系提供方确认。

以后更新或重新安装 GEOlayers，main.js 可能被恢复为原版，需要确认这一步是否仍然生效。

01

EXTRACT

完整解压 AEAgent 安装包

右键安装包，选择「全部解压缩」，解压到本地文件夹。打开解压后的文件夹，找到 安装.cmd 和 payload 文件夹。

AEAgent 安装包├─ 安装.cmd
├─ 环境检查.cmd
└─ payload
　 └─ node
　　 └─ node.exe
Node.js 不用另外安装

payload\node\node.exe 就是内置运行环境，安装器会自动复制，插件会自动调用。不要单独双击它，也不要删除或只复制部分文件。

不要直接在压缩包预览窗口中运行「安装.cmd」。

02

MEDIA TOOLS

安装 FFmpeg 和 ffprobe

这两个工具可以一起安装：FFmpeg 处理音视频，ffprobe 读取时长、尺寸等信息。下面的 Windows 工具包同时包含它们，不需要分别下载两套安装程序。

A. 下载 Windows 工具包

打开 Gyan 的 FFmpeg Windows 下载页 ↗，找到 release builds 区域，选择 ffmpeg-release-essentials.zip。选择 ZIP 包可以直接用 Windows 解压。

下载 FFmpeg + ffprobe（ZIP）

下载来源：FFmpeg 官方下载页列出的 Windows 构建提供方 Gyan。文件由该提供方托管。

B. 解压到固定位置

解压后，打开包含 bin 文件夹的那一层。将这一层文件夹改名为 ffmpeg，放到固定位置，例如 C:\Tools\ffmpeg。

确认以下两个文件都存在C:\Tools\ffmpeg\bin\ffmpeg.exe
C:\Tools\ffmpeg\bin\ffprobe.exe

如果你的实际文件夹位置不同，后面填写你自己的路径即可。请保留完整工具包，配置后不要移动它。

C. 添加到 Windows 的 Path

  1. 在 Windows 开始菜单搜索「编辑账户的环境变量」并打开。也可以搜索「编辑系统环境变量」，打开后点击「环境变量」。
  2. 在上方「用户变量」中选中 Path，点击「编辑」。
  3. 点击「新建」，添加 C:\Tools\ffmpeg\bin，然后逐层点击「确定」保存。
添加的是 bin 文件夹路径

不要填 ffmpeg.exe 或 ffprobe.exe 的完整文件路径，也不要删除已有的 Path 条目。若用户变量中没有 Path，可新建名为 Path 的变量，将值填写为上述 bin 路径。

同一个 bin 目录里已经包含 ffprobe，添加一次 Path，就完成两个工具的配置。

03

VERIFY

确认 FFmpeg 和 ffprobe 都可用

关闭以前打开的命令提示符，在开始菜单输入 cmd，重新打开一个命令提示符窗口。依次输入下面两条命令，每输入一条按一次回车。

检查 FFmpeg
ffmpeg -version
检查 ffprobe
ffprobe -version

分别看到以 ffmpeg version、ffprobe version 开头的版本信息，就说明两者都可以运行。版本号不必与教程一致。

提示「不是内部或外部命令」？

检查 Path 中的目录是否准确，目录里是否包含对应的 exe 文件；保存后关闭并重新打开命令窗口，再试一次。若仍不生效，重启电脑后检查。

如果 AE 或插件服务在修改 Path 之前已经启动，可能仍在使用旧环境。建议保存工程并重启电脑，再继续安装和打开插件。

04

INSTALL AEAGENT

双击「安装.cmd」

  1. 回到第 1 步解压好的 AEAgent 安装包文件夹，双击 安装.cmd。
  2. 等待窗口提示「安装完成」。保留安装过程中的错误信息，若未提示成功，请不要跳过错误继续操作。
  3. 打开 After Effects，选择 窗口 → 扩展 → AEAgent。
  4. 若菜单中没有出现 AEAgent，请保存当前工程，关闭并重新启动 AE，再检查菜单。

看到「简化制作 / 文案制作 / 设置」三个页签后，插件界面已就绪。输入你自己的卡密激活，再配置模型接口和素材目录。

安装后可运行「环境检查.cmd」

检查内置 Node、FFmpeg、ffprobe 和连接状态。模型、素材、OmniVoice 尚未配置时，对应检查可能显示 False；这些需要在后续设置中完成。

QUICK ANSWERS

安装时的常见问题

ffprobe 要单独安装吗？

不需要。上述 FFmpeg ZIP 包已经包含 ffprobe.exe。确认它在同一个 bin 文件夹内，并完成 Path 配置即可。

双击 node.exe、ffmpeg.exe 后没有安装界面？

它们是命令行工具，不是安装向导。内置 Node 由插件调用；FFmpeg 和 ffprobe 按教程解压、配置 Path 并通过命令验证。

环境检查显示「内置 Node：False」，怎么办？

当前检查脚本查找的是安装后的正式版目录。尚未运行「安装.cmd」时，可能显示 False，并不代表压缩包没有内置 Node。请先完成安装，再检查；若安装后仍为 False，请确认完整解压且安装成功。

以前已经安装过 FFmpeg，还需要再安装吗？

先在新打开的命令提示符中分别运行 ffmpeg -version 和 ffprobe -version。两条命令都能正常显示版本信息，可跳过重复安装。

05

CONFIGURATION / API

配置 DeepSeek 模型接口

A. 注册并创建 API key

  1. 打开 DeepSeek 开放平台 ↗，注册并登录账号。
  2. 按平台提示完成实名认证，并为 API 账户充值。
  3. 进入 API keys，选择「创建 API key」。
  4. 复制创建的 API key，回到 AEAgent 的「设置」页。

B. 在插件「设置」中填写

API 地址https://api.deepseek.com/v1
模型名称deepseek-flash

在 API key 输入栏粘贴刚才复制的密钥，并保存设置。API 地址和模型名称按上面的内容填写，不要添加空格。

使用你自己的 API key

密钥用于调用你的 DeepSeek 账户，请妥善保管，不要发到公开群聊或放进教程截图。

06

CONFIGURATION / MATERIALS

解压并配置本地素材

  1. 将收到的素材压缩包完整解压到磁盘根目录，例如 D 盘或 G 盘根目录，保留素材文件夹的名称和内部结构。
  2. 打开解压后的素材文件夹，在资源管理器地址栏复制实际文件夹路径。
  3. 回到插件「设置」，在对应素材路径输入栏中，填入该素材文件夹的完整地址。
  4. 保存设置后检查素材是否能被识别。
路径示例，以你实际解压的位置为准G:\素材库

若设置中分别要求不同类别的素材目录，请分别填写对应文件夹，例如 G:\素材库\同盟、G:\素材库\士兵。填写文件夹地址，不要填写压缩包地址或单张图片地址。

换一台电脑时重新填写路径

素材保存在用户本地。请使用当前电脑实际存在的盘符和文件夹，配置完成后不要随意移动或重命名。

接下来

配置本地配音，开始制作

本地配音配置与使用说明将陆续补充。