要安装 motion-anything 这类本地优先动效引擎，首先要明确它是否真的具备“本地优先”属性。很多工具标榜本地，但安装时会偷偷拉取远程依赖。建议先从官方仓库的 Release 或包管理描述确认分发形态，再决定用包管理器、预编译二进制还是源码构建。下面给出一套可执行的检查清单和命令骨架，用来代替网上各种互相矛盾的安装教程。
motion-anything 的安装核心是把所有动效依赖落在本地。推荐选择包管理器或官方预编译二进制安装，避免在线编译引入外部源。安装后必须做一次断开网络的运行验证，确认工具不访问远端资源。常见失败原因是 Node.js 版本过低、缺少原生构建工具链、渲染后端配置错误。操作时应以官方 Release 说明为准，再结合下列通用步骤微调。
安装前确认分发形态和运行环境
动效引擎可能同时提供 npm 包、独立 CLI 或 Docker 镜像。本地优先场景下，优先选择 npm 包或独立二进制，因为 Docker 镜像也会自带运行时，但可能不适合在受限的开发机上运行。确认分发形态后，检查 Node.js 版本是否在支持范围内，以及是否安装了构建工具。如果计划使用 GPU 渲染，还需要确认显卡驱动和 Vulkan/Metal/OpenGL 是否符合要求。这些信息通常写在官方 README 的环境中，没有明确标注时，可以先试装最新版本，再看错误日志。
安装命令骨架
如果项目以 npm 包发布，安装命令通常是：
npm init -y
npm install motion-anything如果发布的是独立二进制，建议通过类似下面的方式下载并赋予执行权限。实际链接需要以官方 Release 页面为准，这里只给出骨架：
curl -L -o motion-anything https://github.com/your-repo/motion-anything/releases/download/latest/motion-anything-linux-x64
chmod +x motion-anything无论用哪种方式，安装后先执行版本和帮助命令，确认程序能启动：
motion-anything `--version`
motion-anything `--help`如果版本命令成功，说明主程序可执行；如果帮助中显示用法，说明依赖没有缺失。
本地优先配置要点
本地优先不等于安装后自动不联网。很多动效引擎会默认加载在线字体、模板或更新服务，所以要在配置中显式关闭远程能力。常见的配置项包括离线开关、缓存目录、渲染后端和资源根目录。参考如下 YAML 配置，可写入项目根目录的 .motion-any.yml 或用户配置目录：
offline: true
cacheDir: ./.motion-cache
renderBackend: software
assetRoot: ./assets其中 offline 强制禁止网络请求，assetRoot 让动效资源从本地目录读取。配置后需要重启工具才能生效。如果工具的配置采用 JSON 格式，一样等价写入上述字段，只是注意字符串要用引号包裹。
验证安装与离线行为
安装完成后，建议先用最小示例验证基本渲染链路。如果工具提供 demo 参数，可以执行：
motion-anything `--demo` `--renderer` software `--output` /tmp/test.png看到输出文件生成，说明安装可用的基线成立。然后断开网络，再次执行同一条命令，确认能重复生成输出。若出现“无法连接”“request failed”之类的错误，说明还有外部调用，需要回到配置步骤检查 offline 是否被其他配置覆盖。
除了断网验证，还要确认缓存目录可写，以及资源根目录下的文件是否齐全。某些工具在离线模式下会因缺少一个内置文件而失败，这属于安装不完整，而非配置错误。
常见问题
Q1：安装时提示缺少 native module 怎么办？
这通常发生在源码编译安装场景。需要先安装 Python 和 C++ 编译工具链。Windows 安装 Build Tools，macOS 安装 Xcode Command Line Tools，Linux 安装 build-essential。
Q2：配置文件不生效？
先确认工具加载的配置文件路径是否正确。部分工具同时支持命令行参数和环境变量，环境变量优先级更高，会覆盖文件配置。执行帮助命令查看配置来源。
Q3：本地优先模式是否不需要网络？
仍然需要本地网络的场景是资源文件存放在内网服务器。如果工具允许通过 assetRoot 配置远程地址，那需要主动关闭。本配置示例中的 offline 开关就是用来阻止这种情况。