ClipForge 使用手册:从安装到第一条 AI 带货视频

先说结论:装好后 3 分钟、0 元就能出第一条无水印带货视频。ClipForge 是开源(AGPL-3.0)的 AI 带货短视频工具——上传商品图或说一句话主题,AI 写脚本、配画面、配音、合成竖屏成片。本手册覆盖安装、免费出片、AI 成片、带货形式、双模式、爆款复刻、批量与合规发布的完整流程,中英双语界面通用。

一、安装:三种方式任选

方式 1:桌面版(最简单)

到 GitHub Releases 下载 Windows / macOS 安装包,双击即用,数据全部保存在本机。

方式 2:Docker 一行命令

docker run -d -p 3000:3000 -v clipforge-data:/app/data ghcr.io/xixihhhh/clipforge:latest

打开 http://localhost:3000 即可。

方式 3:源码运行(开发者)

git clone https://github.com/xixihhhh/clipforge.git
cd clipforge && npm install && npm run dev

二、3 分钟出第一条片:免费快剪(全程 0 元)

打开工作台,你只需要回答两个问题——输入什么和怎么出片:

1. 把商品丢进来:上传商品图(最多 5 张)、粘贴商品链接(自动抓标题/价格/主图),或点「一句话成片」直接说主题,比如「3 个让租房变高级的小物」。没素材?点示例商品直接试。
2. 出片方式保持默认「🆓 免费快剪」:真实图库素材混剪 + 免费 AI 配音,全程 ¥0,约 2 分钟。
3. 点「开始生成」——写脚本 → 免费素材配画面 → 配音合成,一张进度卡全程托管,完成后直达成片页下载。

三、配一个 Key,解锁 AI 生成

ClipForge 是开源 BYOK(自带 Key)工具:软件永远免费,AI 用量按秒付给你选的模型平台,我们不加价不抽成。一个接口聚合 7 大平台 30+ 模型:

• Atlas Cloud(推荐):一个 Key 覆盖脚本 + 生图(GPT Image 2)+ 视频(Seedance 2.5/2.0 全系)+ 配音,在 设置 → 平台 Key 粘贴即完成;
• 也支持火山方舟、fal.ai、OpenAI、DeepSeek 等,设置 → 生图模型 / 视频模型 里各选一个默认模型即可;
• 模型清单运行时自动拉取,新模型上架即可用,还能添加自定义模型 ID。

四、免费快剪 vs AI 生成成片:怎么选

AI 档花钱只有一次点击:脚本免费生成后停在「脚本好了」页,看完口播文案、确认没问题,点「AI 生成成片」才开始计费——自动跑 九宫格分镜(一次生图把所有镜头的人物/房间/光线锁死)→ 一键整片(Seedance 2.5 原生切镜,台词由人物原声逐字说出)→ 直达成片页。

五、带货形式与主播库

选了 AI 档后再选带货形式(免费档不用选——通用素材混剪选了也不生效):

• 智能推荐(默认):AI 按商品挑风格,以实物展示为主;
• 真人口播:AI 素人对镜口播种草,内置真实感规则(口语台词、生活痕迹背景、行为节拍),不出「一眼假」网红脸;
• 情景短剧:有人物有剧情的种草小短剧,多角色各配专属音色;
• 图文混剪:节奏卡点的图文快剪。

选真人口播/情景短剧时可指定出镜主播:在「主播库」自建形象,一键生成正/侧/背/特写四视图定妆照(一次生成保证同一个人),之后九宫格与整片都拿定妆照当身份锚——跨镜头、跨条视频不换脸。

六、小白模式与导演模式

侧边栏底部一键切换:

• 小白模式(默认):只有工作台一条创作路,脚本→成片全托管,不见分镜不见术语;
• 导演模式:解锁全部专业工具——分镜逐条编辑、判官团(四位毒舌判官撕台词并等长重写)、逐镜运镜(18 款预设 + Mix 叠加)、画面 Look、九宫格、一键整片、高级新建(品类/人群/平台/391 款成片模板逐项可调)、变体矩阵 A/B。

七、爆款复刻与热点选题

• 爆款复刻:上传一条参考爆款视频,解析它的镜头切点与节奏,用你的商品重新生成同结构视频;也支持模型级 reference-to-video 直接换品复刻(注意素材授权,风险自担);
• 今天发什么:工作台热榜实时拉抖音热搜(已过滤时政类),点热点直接写成视频,每条带「同款」直达复刻;
• 按人设日更:填人设关键词自动选题,配合 cron + CLI 就是全自动日更机。

八、批量出片 / MCP / CLI

• 批量出片(导演模式):大促前 10 个商品一键排队出片;
• MCP Server:在 Claude / Cursor 等 agent 里接入 clipforge-mcp,贴商品链接一句话出片;
• CLI:npm run cli -- create --topic "..." 脚本化出片,适合定时任务。

九、导出与合规发布

• 成片页直接下载 1080p 无水印 MP4;抖音 9:16 / 小红书 3:4 等规格一键切换,附标题/话题/封面文案包;
• 合规默认开:AIGC 隐式标识自动写入(对齐国标 GB 45438-2025)+ 显式「AI 生成」角标默认烧录;
• 发布前限流自检:风险词、钩子、时长、字幕、CTA 逐项检查并给出改法;广告法违禁词扫描附替换建议。

十、常见问题