[!NOTE]
ArtCraft 是一个来自各行各业的艺术家社区。 数字艺术、生成艺术、音乐、游戏——只要你创造东西，你就是我们的一员。来 Discord 跟我们打个招呼。
EffectCraft 是什么
EffectCraft 面向动画标题、动态图形与合成工作：也就是动态设计师和视觉特效艺术家所需要的那类工具。你用图层（纯色、形状、文字、素材、其他合成）搭建出一个合成，用关键帧为它们的属性做动画，在上面叠加特效，然后渲染出结果。
界面自然且响应灵敏，配有专门的面板（项目、合成、时间轴、图层、素材、特效控制、工具、预览、特效与预设、音频、信息、段落、字符、对齐、进度、渲染队列）以及标准的动态图形快捷键，并在我们看重的一些地方更进一步：
- 内置 Lottie 导入与导出，动画无需插件即可直接进入网页与应用。
- 可读的项目文件。 项目以带版本的 JSON（
.ecproj）保存，因此在版本控制中能干净地 diff。
- 一切皆可脚本化。 每一个菜单项、时间轴拖拽与属性修改都经由同一个命令注册表，因此相同的操作可以从命令行、JSON 控制通道，以及面向智能体的 MCP 服务器触达。
- 没有 FFmpeg。 视频与音频的解码、编码全部是纯 Rust：FilmCraft 的编解码器，以及 EffectCraft 自家的 VP9、AV1、HEVC 与 Opus 编码器。
动画
面板、菜单与快捷键遵循标准的动态设计惯例：项目、合成、时间轴、特效控制、属性、特效与预设、字符、段落、对齐、信息、预览、音频与渲染队列，按你期望的方式停靠。在它们之间拖拽素材、合成与特效：拖到合成视图中时，它们落在指针下方；拖入时间轴时，落在图层之间与你所指的时间点。
- 各类图层： 纯色、形状、文字、素材、嵌套合成、空对象、调整图层、摄像机与灯光；父子关系、轨道遮罩、全部 38 种混合模式、运动模糊。
- 行为一致的关键帧： 线性、贝塞尔、定格、自动与连续贝塞尔、游走关键帧、Easy Ease（F9）、关键帧速度与插值对话框、在当前时间点复制粘贴，以及带有数值图与速度图、可拖拽控制柄的图表编辑器。
- 时间： 时间重映射、时间伸缩、时间反转、冻结帧、工作区、标记，在包括 29.97 掉帧在内的任意帧率下都做到逐帧精确。
- 形状与遮罩： 带修剪路径、重复器、圆角、偏移、zig zag、扭曲、抖动、合并路径与渐变描边的形状图层；用钢笔工具绘制的遮罩，支持模式、羽化、扩展与在视图中编辑顶点。
- 文字： 点文字与段落文字，支持本机安装任意字体的真实成型；字符与段落面板，以及带范围选择器的文字动画器。
- 表达式： 标准动态表达式模型的 JavaScript（
wiggle、loopOut、thisComp.layer("…")，对数组的矢量运算），带内联编辑器与拾取鞭。
- 熟悉的时间轴： 展开图层以查看变换、遮罩、特效等；拖动行以重新排序图层；用 Enter 或双击重命名；属性快捷键（A、P、S、R、T、M、F、E、L、U 及双击 AA、PP、SS、RR、TT、MM、FF、EE、LL、UU），Shift 添加属性，Alt+Shift+A/P/S/R/T 为当前时间打关键帧，Ctrl+` 展开所选图层。
- 木偶工具： 在由图层构建的网格上放置位置、高级、弯曲、僵硬与重叠图钉，实时录制图钉，旋转/缩放手柄，由（或承载）空对象驱动的图钉用于绑定，以及头发与布料的自然跟随。
特效
跨各个分类共 306 种内置特效，每种都有各自的参数名、顺序与默认值：模糊与锐化、通道、颜色校正（曲线、色阶、色相/饱和度、完整的调色面板……）、扭曲（变形、膨胀、湍流置换、CC Power Pin……）、生成（分形噪点、渐变斜坡、描边、书写、音频频谱……）、抠像、遮罩、噪点与颗粒、透视、模拟（CC Particle World、CC Rainfall、Shatter、Card Dance、Caustics、Wave World……）、风格化（辉光、CC Glass……）、时间（Echo、Posterize Time、Timewarp、时间置换……）、音频（混响、参数均衡、延迟、立体声混合……）、文字、转场、工具与表达式控制。全部九种图层样式（投影、内/外发光、斜角与浮雕、缎面、叠加、描边）均带全局光。预览可同步播放音频，并带有电平表与波形。
3D
经典的 3D 合成：带方向与材质选项的 3D 图层，带景深的一节点与两节点摄像机，灯光（平行、聚光、点光、环境光）带柔和的光线追踪阴影，图层正确相交，轨道、平移与推拉摄像机工具，以及前、顶、左与自定义视图。
导出
专用的渲染队列，带渲染设置与输出模块：H.264 MP4 与带音频的 ProRes MOV（从 Proxy 到带 Alpha 的 4444 XQ）、HEVC（Main / Main 10）与 AV1 MP4、WebM（带帧间与 Alpha 的 VP9，或 AV1；Opus 音频）、PNG、JPEG、TIFF 与 32 位 EXR 序列、动态 GIF，以及 WAV/AIFF。支持 3:2 下拉的场渲染、特效/solo/参考线/深度覆盖、裁剪、感兴趣区域与缩放、带默认值的渲染设置与输出模块模板、渲染后动作、存储溢出与渲染日志。同一队列也可从命令行运行。每个编码器都是纯 Rust（FilmCraft 的 H.264、ProRes 与 AAC；EffectCraft 自家的 VP9、AV1、HEVC 与 Opus）；内部没有任何 FFmpeg。
Lottie 双向支持：文件 ▸ 导出 ▸ Lottie JSON… 将一个合成（预合成、形状、纯色、图像、文字与空对象图层，缓动与空间关键帧、遮罩、轨道遮罩、混合模式、时间重映射，以及可选的表达式）写为 .json 或 .lottie，并列出 Lottie 无法表达的任何内容；文件 ▸ 导入 ▸ Lottie… 将其作为一个新合成打开。
为 AI 智能体而生
你能从菜单里做的每一件事，都是一个带 id 的命令，而智能体可以触达其中的每一个：
- MCP 服务器：
effectcraft-cli mcp 通过 stdio 讲模型上下文协议，可无头运行，或桥接到正在运行的应用（--bridge 9877）。工具覆盖命令、项目与属性树、关键帧以及渲染帧。本仓库已附带一份可用的 .mcp.json。
- 命令行： 带 JSON 输出的一次性调用，例如
effectcraft-cli set Main '#1' transform/position '[100,360]' --time 0 main.ecproj --save
或 effectcraft-cli render --comp Main --out main.mp4，或
effectcraft-cli exec file.exportLottie '{"comp":"Main","path":"main.json"}' main.ecproj。
- 控制通道：
effectcraft --control 9877 接受 JSON 行来运行命令、按自动化 id 检查并点击任意控件，以及截图。
详见 docs/agents.md 与 docs/control-protocol.md。
开始使用
各版本的安装程序位于 Releases 页面：通用的 macOS 应用；面向 x64、x86 与 ARM64 的 Windows MSI 与便携 zip；面向 x86_64 与 aarch64 的 Linux AppImage、Flatpak、deb、rpm 与 tar.gz，外加一份 riscv64 tar.gz；以及一份 FreeBSD x86_64 tarball；还有 Web 构建。下载 列出了每一个文件。Windows ARM64 构建在 Windows on ARM 上原生运行，无需 x64 模拟。CI 会在 Windows 11 ARM64 硬件上安装该 MSI，检查两个程序均为 ARM64，并在那里运行命令行工具，但尚不能在 ARM64 上原生打开应用窗口或运行测试套件，因此若有任何不同表现，请告诉我们。
在 Gentoo 上，社区 ::snakebyte overlay 将 Linux 发行版打包为 media-video/effectcraft-bin（非 EffectCraft 团队维护）：
eselect repository add snakebyte git https://github.com/switch87/snakebyte-overlay.git
emaint sync -r snakebyte
echo 'media-video/effectcraft-bin ~amd64' >> /etc/portage/package.accept_keywords/effectcraft
emerge --ask media-video/effectcraft-bin
要自己构建，你需要 Rust 1.95 或更新版本。
git clone https://github.com/storytold/effectcraft
cd effectcraft
cargo run --release -p effectcraft # 应用（加 `-- --demo` 打开演示项目）
cargo run --release -p effectcraft-cli -- render --out intro.mp4 # 无头渲染演示
cargo xtask web --serve 8765 # 浏览器构建，地址 http://127.0.0.1:8765/（https://github.com/storytold/effectcraft/blob/main/docs/web.md）
刚上手？docs/footage.md 介绍了导入素材与图像序列，以及“解释素材”。
要参与开发：cargo test --workspace，并在每次提交前运行 cargo xtask ci（格式化、lint、测试、分层、资产归属与 WebAssembly 构建）。参见 CONTRIBUTING.md、docs/architecture.md 与 docs/testing.md。
当前进展
EffectCraft 还很年轻：它的首个提交在 2026 年 10 月 1 日。它已具备一套全面的功能，包括 306 种特效，但“覆盖面广”不等于在每一个边界情况下都足够成熟。如今它是个尝试东西、并告诉我们哪里会出错的好地方。它尚未被推荐用于生产客户项目。具体而言：
- 原生项目格式。 项目以
.ecproj 保存，即可读的带版本 JSON。不支持专有项目格式与 After Effects SDK 插件。
- 保真度仍在打磨中。 自动化渲染测试目前只聚焦于小型合成，因此若有视觉差异或异常行为，请告诉我们。
- macOS 是测试最充分的平台。 Linux 与 Windows 用户遇到过基础交互问题，我们正在优先修复。
- 训练模型还很新。 旋转笔刷可使用 MobileSAM（设置 ▸ 旋转笔刷中的一项可选 40 MB 下载），人脸跟踪可使用 Google 的 MediaPipe Face Landmarker（设置 ▸ 人脸跟踪中的一项可选 3.8 MB 下载）。两者都还在积极评估与调优中。
EffectCraft 正处于 alpha：docs/target-app-parity.md 中追踪的功能约有 91% 已实现，我们估计它大约完成了迈向成熟专业生产工作所需进度的 45%。ROADMAP 列出了计划，docs/target-app-parity.md 是度量，docs/gaps.md 记录了每一个已知短板。Web 构建（docs/web.md）可在浏览器中运行完整应用。Bug 报告 是目前你能发给我们最有用的东西。
如何实现
- 引擎优先。 一摞具有严格分层的小 crate。界面（egui）位于最上层，其下层没有任何东西依赖它。
- 洁净室。 我们只依据公开文档与可观察行为工作，绝不使用专有文件、图标、预设或代码。没有从 GPL 项目复制任何代码。完整规则见 AGENTS.md。
- 默认隐私。 没有遥测，除非你主动要求，否则没有任何网络访问。
- 同一个家族。 EffectCraft 与 FilmCraft 共享其时间模型与文字引擎设计，并从中获得视频与音频编解码器。
下载
刚接触 EffectCraft？ 从 getartcraft.com 上的 EffectCraft 页面 下载。那是最简单的安装方式。
想要某个特定构建或格式？ 在 GitHub 上，最新发布 包含下面列出的每一个构建，全部发布 则包含更早的版本及其说明。文件名中的 <ver> 是版本号，SHA256SUMS.txt 列出了每个文件的校验和。
Windows
| 构建 | 安装程序 | 便携版 |
|---|
| x64（64 位 Intel/AMD） | effectcraft-<ver>-windows-x64.msi | effectcraft-<ver>-windows-x64-portable.zip |
| arm64（骁龙及其他 ARM 电脑） | effectcraft-<ver>-windows-arm64.msi | effectcraft-<ver>-windows-arm64-portable.zip |
| x86（32 位） | effectcraft-<ver>-windows-x86.msi | effectcraft-<ver>-windows-x86-portable.zip |
安装程序与可执行文件均经过代码签名。安装程序会询问 EffectCraft 的安装位置（默认为 Program Files），后续版本会安装到同一文件夹。要以静默方式安装到你选择的文件夹：msiexec /i effectcraft-<ver>-windows-x64.msi /qn INSTALLFOLDER="D:\Apps\EffectCraft"。
macOS
| 构建 | 文件 | 说明 |
|---|
| 应用，通用版（Apple 芯片 + Intel） | effectcraft-<ver>-macos-universal.dmg | 已签名并公证 |
| 命令行工具，通用版 | effectcraft-cli-<ver>-macos-universal.zip | 已签名并公证 |
Linux
| 格式 | x86_64 | aarch64（ARM64） | 说明 |
|---|
| AppImage | effectcraft-<ver>-linux-x86_64.AppImage | effectcraft-<ver>-linux-aarch64.AppImage | 随处可运行；通过 AppImageUpdate（.zsync 文件）自我更新 |
| Flatpak | effectcraft-<ver>-linux-x86_64.flatpak | effectcraft-<ver>-linux-aarch64.flatpak | 沙盒化；flatpak install --user <file> |
| Debian/Ubuntu | effectcraft-<ver>-linux-x86_64.deb | effectcraft-<ver>-linux-aarch64.deb | |
| Fedora/RHEL/openSUSE | effectcraft-<ver>-linux-x86_64.rpm | effectcraft-<ver>-linux-aarch64.rpm | |
| Tarball | effectcraft-<ver>-linux-x86_64.tar.gz | effectcraft-<ver>-linux-aarch64.tar.gz | 任意位置解包 |
RISC-V 64 位：effectcraft-<ver>-linux-riscv64.tar.gz（仅 tarball；需要 glibc 2.39+，例如 Ubuntu 24.04+ 或 Debian 13+）。
Linux 上的文件拖放： 当前的 eframe/winit 0.30 原生 Wayland 后端不会传递文件悬停或文件拖放事件。在 Hyprland 及其他原生 Wayland 会话中，请使用 文件 ▸ 导入 ▸ 文件…（可多选），或者在已安装 XWayland 且设置了 DISPLAY 时通过 XWayland 启动 EffectCraft：
env -u WAYLAND_DISPLAY effectcraft
当后端能传递事件时（X11/XWayland、Windows 与 macOS），在窗口任意位置拖入媒体即可导入，悬停时还会显示放置目标提示。在原生 Wayland 上，应用无法检测到不会产生任何事件的尝试；它会显示一个启动提示，并给出“文件 ▸ 导入”的替代方式。
FreeBSD
| 构建 | 文件 |
|---|
| x86_64 | effectcraft-<ver>-freebsd-x86_64.tar.gz |
Web（WebAssembly）
| 构建 | 文件 | 说明 |
|---|
| 静态站点 | effectcraft-web-<ver>.zip | 在现代浏览器中运行；可托管于任意静态服务器 |
Crafting 系列应用
EffectCraft 是 Crafting 系列应用 之一：来自 ArtCraft 团队的免费、开源创意工具，每一个都用 Rust 从零编写，且都能独立运行。
还有 ArtCraft 本身，我们为想要真正掌控权的艺术家打造的 AI 图像与视频工作室。
许可证与致谢
EffectCraft 采用双重许可，你可任选 MIT 或 Apache-2.0。版权所有 (c) 2026 ArtCraft Team 与 EffectCraft 贡献者。必要的声明见 NOTICE。
打包的字体、图标、图像及其他资产保留各自的开放许可证；每一项都随作者、来源与许可证列于 ATTRIBUTION.md。
docs/brand/ 中的 ArtCraft 名称、文字商标与徽标是 ArtCraft Team 的商标，不受本许可证覆盖。它们只能原样、且只能作为本仓库与 EffectCraft 的一部分使用，依据 docs/brand/LICENSE-brand.txt。分支与修改版本必须移除它们。
Star 历史
