插件安装

复制目录、重启网关，插件就装好了；模型和节点不用你逐个手动下载——把插件目录交给 AI 智能体，让它按 INSTALL.md 自己完成。这篇讲安装、模型下载与验证，附全部演示插件的模型需求速查表。

1插件从哪来

• 仓库自带的演示插件：plugins/ 目录里的图像、视频、声音、音乐、后期等插件都是演示，用来展示一个插件能封装什么。
• 别人分享的插件：拿到一个完整插件目录即可，安装方式完全相同。
• 你自己开发的插件：见插件开发。

2安装：复制目录，重启网关

VideoFree/
└─ plugins/
   └─ 你的插件/     ← 整个目录复制进来，plugin.json 是唯一注册入口

重启网关后，工作台界面和 MCP 能力列表里就会出现这个插件——不需要为它写任何接入代码。卸载 = 移除目录再重启。

这一步也可以直接交给智能体：「把【插件目录】整个复制到 VideoFree 的 plugins/ 目录，然后重启网关。」

3模型和节点：交给智能体按 INSTALL.md 下载

插件不会自动下载模型——你也不需要逐个手动操作。每个插件的 INSTALL.md 都写明了所需模型的准确文件名、官方下载地址和安装目录，把插件目录交给能操作你电脑的智能体（Claude Code、Codex、OpenCode 等），让它读取说明、自己下载并放好。中英文智能体客户端都适用。

发送下面这段话，把路径换成你的实际路径：

中文智能体提示词：

我要启用 VideoFree 插件：【填插件目录路径，例如 D:\VideoFree\plugins\ltx-2.5】。先读取该目录下的 INSTALL.md，列出它需要的全部模型文件和 ComfyUI 节点包。我的 ComfyUI 根目录是：【填你的 ComfyUI 路径】。逐个核对哪些文件已存在（文件名和子目录都必须一致），缺失的从 INSTALL.md 声明的官方地址下载，放到声明的目录，不要改名、不要平铺到其他目录。全部就位后告诉我需要重启 ComfyUI，并列出你下载了什么、跳过了什么。遇到许可限制或下载失败，先停下来告诉我原因。

English prompt for your agent:

I want to enable a VideoFree plugin: [plugin folder path, e.g. C:\VideoFree\plugins\ltx-2.5]. First read INSTALL.md in that folder and list every model file and ComfyUI node package it requires. My ComfyUI root is: [your ComfyUI path]. Check which files already exist (exact filename and subfolder), download the missing ones from the official URLs declared in INSTALL.md, and place them in the declared directories. Do not rename files or flatten directories. When everything is in place, tell me to restart ComfyUI and list what you downloaded and what you skipped. If a license gate or download failure blocks you, stop and explain.

4验证装好了

1. 重启 ComfyUI，启动日志里没有「导入失败 / IMPORT FAILED」。
2. 用 ComfyUI Manager 的缺失节点检查，逐个核对插件声明的节点包。
3. 在 VideoFree 里跑一个最小任务（低分辨率图片或 480P 短片），出片即安装成功。

手动下载模型时记住三条铁律：文件名和子目录必须与 INSTALL.md 完全一致（工作流按准确文件名加载，改名或平铺都会导致「缺模型」）；只从声明的官方来源下载；装完重启 ComfyUI 再验证。显存紧张时优先选择 int8 / fp8 量化文件、降低分辨率和时长，先跑通再逐步提高质量。

附录：各插件模型需求速查表

下表是快速索引；准确文件清单以各插件目录内的 INSTALL.md 为准。