让创意 成为影像 — RiffCut 影创,macOS 本地 AI 剪辑智能体,一句话出片

RiffCut 影创 — 本地剪辑智能体,一句话出片,全程不出本机。

全流程本机完成,也接得上你已有的模型与素材

  • FFmpeg
  • libass
  • ffprobe
  • Apple Silicon
  • macOS say
  • 素材库
  • 模板库
  • 风格包
  • 导演技能
  • 本地模型
  • 分镜清单
  • 硬闸门质检
  • 9:16 竖版
  • 16:9 横版
  • 字幕烧录
  • 声音克隆
  • FFmpeg
  • libass
  • ffprobe
  • Apple Silicon
  • macOS say
  • 素材库
  • 模板库
  • 风格包
  • 导演技能
  • 本地模型
  • 分镜清单
  • 硬闸门质检
  • 9:16 竖版
  • 16:9 横版
  • 字幕烧录
  • 声音克隆
riffcut — ~/影创/客户/茶山
velora v0.1.0
esc interruptctrl+c/ctrl+d clear/exit/ commands! bashctrl+o more
把上周拍的茶山素材剪一条 15 秒竖版,要能挂抖音,节奏快一点
先扫一遍素材库,探时长和分辨率,去掉糊片和重复,再按节奏出分镜。
scan 数据/素材库.json
edit 数据/素材库.json
41def build_filter(w: int, h: int) -> str:
42 const { rawBody, sig } = await readPayload(req);
-43 const expected = createHmac("sha256", KEY).update(rawBody).digest("hex");
-44 if (expected !== sig) throw new PayError("bad signature");
+43 if (!verifySignature(rawBody, sig)) {
+44 throw new PayError("bad signature");
+45 }
46 return settleOrder(rawBody);
$ python3 -m riffcut render 茶山-15s
✓ test/pay/sign.test.ts (12)  ✓ test/pay/callback.test.ts (35)
闸门  12 passed (47) · 1.84s
签名校验已抽到 服务/render.py 的 成片/20261118-茶山-01.mp4,配音与音乐已经混好,人声压住了背景。12 道硬闸门全过,可以直接发。
试一试

下载安装

双击就能用。素材、工程和成片都留在你自己的 Mac 上,不上传任何东西。

macOS 版 · 现已可用

下载、拖进应用程序,然后双击

下载 dmg,拖进应用程序文件夹,双击打开。第一次启动会带你选素材目录。

  • 首次启动启动后输入 /login,填了就接云端模型,不填就走本机规则引擎
  • 素材目录设置别名后,直接输入 riffcut 开始
zsh — ~
curl -L -o RiffCut影创.dmg https://github.com/lov0u/riffcut/releases/latest/mac-arm64.dmg
正在校验签名与公证…
hdiutil attach RiffCut影创.dmg
cp -R /Volumes/RiffCut/RiffCut影创.app /Applications/
hdiutil detach /Volumes/RiffCut
open -a RiffCut影创
velora v0.1.0
esc interrupt/ commands! bashctrl+o more
~/影创 (v0.1.0)
0.0%/32k (local)(riffcut) qwen2.5-14b • 本机

本地 API · 现已可用

74 个接口,全在本机回环

服务端纯 Python 标准库,没有一行 pip 依赖。只监听 127.0.0.1,带 token 与 Host/Origin/Sec-Fetch-Site 校验,浏览器侧无法被别的网页借用。

  • 接口74 个 /api/* 路由,openapi 工具可导出完整描述
  • 调用一条 curl 就能扫素材、出分镜、跑质检
本机内置
zsh — ~/影创127.0.0.1
# 扫一遍素材库,标出糊片与重复
$ curl -s -H "X-Token: $RiffCut_TOKEN" localhost:7788/api/scan -d '{"dir":"客户/茶山"}'
# 出分镜清单,等确认再剪
$ curl -s -H "X-Token: $RiffCut_TOKEN" localhost:7788/api/plan -d '{"ratio":"9:16"}'

系统要求

Apple Silicon,macOS 12 起

双击 .app 就能跑,不用装 Node、不用配环境、不用连外网。

  • 系统macOS 12.0 或更新,Apple Silicon(arm64)
  • 依赖自带 FFmpeg 与 libass,开箱即用
  • macOSarm64支持
  • macOSIntel暂不支持
  • Windows / Linux—暂不支持

环境需要 macOS 12.0 或更新版本、Apple Silicon(arm64)。Intel 机型暂不支持。

安全RiffCut 影创 只监听 127.0.0.1,带 token 与 Host/Origin 校验,需要隔离时请在独立用户账号下运行。

四种用法,同一套引擎

对话里剪、批量任务里剪、模板里剪、API 里剪,共用同一套渲染与质检。

使用文档 →
riffcut — ~/影创/客户/茶山
~/影创/客户/茶山 $ riffcut
velora v0.1.0
esc 中断 · / 命令 · ! 终端
这条素材讲了什么,帮我起个标题
scan 素材/茶山-01.mp4
$ riffcut probe 素材/茶山-01.mp4
服务 渲染 质检 发布
这条是茶山日出,4K 24fps,有环境声:服务/api 前 3 秒是空镜,可以当片头;服务/渲染 中间有一段采茶特写,适合放口播;服务/素材 结尾是装筐,适合收尾。服务/任务 建议标题:《这一杯,等了一年》。
这条素材讲了什么,帮我起个标题
~/影创/客户/茶山(riffcut) qwen2.5-14b • 本机

像跟剪辑师说话一样。不满意就改,改完直接重出。

zsh — ~/影创/客户
$ ls 素材/ | riffcut -p "全剪成 15 秒竖版"
成片/20261118-茶山-01.mp4 已出,
9:16 · 15.0s · 12 道闸门全过
$ riffcut -p "给这批素材配口播"
已生成 9 条口播,按 9:16 折好行,写进 工程/口播.srt。
$

不开窗口也能跑,适合批量出片和定时任务。

命令行参数 ↗
批处理 / 定时
$ riffcut --template 产品展示/竖版-快节奏
→{"id":"1","type":"prompt","message":"把茶山素材剪成 15 秒竖版"}
←{"id":"1","type":"response","command":"render","success":true,…}
←{"type":"render_start"}
←{"type":"tool_start","toolName":"render_clip",…}
←{"type":"render_end",…}

448 个模板直接调用,参数换成你的素材就能出片。

API ↗
render.py
from riffcut import render, qc
分镜 { session } = 任务 render(分镜="茶山-15s", ratio="9:16")
任务 任务.qc("成片/20261118-茶山-01.mp4" }
print(任务.report())

在你自己的脚本里直接调同一套渲染与质检。

为真实素材而生

把一堆原始素材丢给它。它探清楚每条素材,出分镜给你确认,再真剪真混音,直到质检全过。

  1. 01

    读懂素材,直接动手剪

    探测时长、分辨率、帧率、有没有声音,dhash 去重,灰度方差标出糊片。它会读素材、排顺序、真剪真混音,每一步都看得见。

    • esc随时中断
    • !直接跑 ffmpeg
    快速上手 ↗
    这批茶山素材有点乱,帮我理一遍,挑出能用的
    scan 数据/素材库.json
    edit 数据/素材库.json
    18def scan(files: list[Path]) -> dict:
    -19 rows = [probe(f) for f in files]
    +19 rows = dedupe(rows, key="dhash", tol=6)
    +20 rows = [r for r in rows if r["sharpness"] > 18]
    +21 return {
    +22 "total": len(rows),
    +23 "rows": rows,
    +24 }
    25 # 糊片与重复已剔除
    26
    $ python3 -m riffcut scan 素材/茶山
    ✓ 客户/茶山/素材-01.mp4 (9)
    ✓ 客户/茶山/素材-02.mp4 (6)
    素材 9 条可用 (2)
    剔除 3 条糊片 (15)
  2. 02

    先出分镜,你点头才开剪

    每一段素材、起止秒、文案、口播、字幕,先列成清单给你看。不满意就改,点头了才进渲染。渲染完还要过 12 道硬闸门。

    • ctrl+o展开分镜
    • /tighten压缩工程
    分镜文档 ↗
    扫描结论

    这批素材里有 3 条糊片和 4 条重复:

    •scan 读时长、分辨率、帧率、有无声音
    •灰度方差低于阈值的 3 条已标糊片,不会进分镜
    分镜 rows = 任务 素材库.scan_media(片段.id);
    if (rows) return rows;
    建议补拍两条空镜,15 秒片还差一个收尾。
    ~/影创/客户/茶山 (茶山-15s)
    ↑31k ↓4.1k R206k CH88.2% 3.1%/1.0M (local)(riffcut) qwen2.5-14b • 本机
  3. 03

    按你的方式定制

    87 个 AI 工具、41 篇导演技能、49 个成片风格、448 个模板,都能自定义。写一篇 skill 就能教会它新的剪法。

    • /tools管理工具
    • /style:<name>套用风格
    风格文档 ↗
    /
    服务/导演技能/投放-快节奏.md
    ---
    name: 口播稿
    description: 生成口播稿并按画幅折行
    ---
    1. 读分镜清单里的文案
    2. 按 9:16 和 16:9 分别折行
    3. 写进 工程/口播.srt
  4. 04

    工程随你带走

    工程自动保存,用 /resume 随时恢复。/tree 在版本之间切换,/fork 从任意一版开出新方案,/export 导出工程包换台 Mac 接着剪。

    • /tree切换版本
    • /fork另开一版
    工程文档 ↗
    Version tree5 个版本
    user: 这批茶山素材有点乱,帮我理一遍,挑出能用的
    assistant: 扫完 9 条,3 条糊片、2 条重复,剩 4 条能用…
    ├─ user: 去掉糊片和重复,按拍摄时间排好
    │ assistant: 已生成分镜清单,4 段共 15 秒,等你确认
    └─ user: 把节奏调快一点,再出一版
    ↑/↓ 切换 · ←/→ 折叠 · enter 进入 · shift+l 标注 · esc 关闭
    /export 茶山工程.zip
    工程已导出到:~/影创/客户/茶山/茶山工程.zip

把你的工具接进流程

FFmpeg 剪、libass 烧字幕、ffprobe 探素材、macOS say 出声——它们本来就是你的工具,现在由一个会说人话的引擎串起来。

本机 · 无依赖
纯 Python 标准库,不用 pip 装任何东西
/tools
看当前机器能跑什么:编码器、滤镜、硬件加速
riffcut tools list
看 87 个工具和 448 个模板的装载状态
看能力清单 ↗
  • 串起来的工具与资源:
  • FFmpeg
  • libass
  • 模板库
  • ffprobe
  • 风格包
  • 导演技能
  • 素材库
  • 本地模型
  • 分镜清单
  • 硬闸门
macOS say
$ riffcut capabilities --json
ffmpeg 6.1.1 · libx264 · libx265 · prores_ks · aac · libmp3lame
硬件编码不可用,走 libx264 软编码(更稳)
$

为什么选
RiffCut 影创

为每天都在剪片子的人而设计。素材、模型和节奏,都由你决定。

~/影创/数据/仅在本机
  • ├─ 凭据.json钥匙串加密
  • ├─ 设置.json偏好
  • ├─ 模型.json本地模型
  • ├─ 工具.json工具开关
  • ├─ 工程/工程版本
  • │ └─ --影创-客户-茶山--/
  • │ └─ 20261118-茶山-竖版-01.mp4
  • ├─ 模板库/448 个模板
  • ├─ 风格包/49 种风格
  • ├─ 素材库/dhash 去重
  • ├─ 产出/平铺不覆盖
  • ├─ 备份/自动回滚
  • ├─ 日志/G0–G12 闸门
  • └─ 客户/按客户隔离

素材留在本地

工程、配置与凭据都存在你自己的 Mac 上。成片不上传,不发送使用统计,没有任何云端账号。

qwen2.5-14b[本机]本机运行
  • qwen2.5-14b 本机
  • 任意 OpenAI 兼容
  • OpenAI
  • Anthropic
  • Gemini
  • DeepSeek
  • 通义千问
  • 智谱 GLM
  • Kimi
  • MiniMax
  • Mistral
  • xAI
  • qwen2.5-14b 本机
  • 任意 OpenAI 兼容
  • OpenAI
  • Anthropic
  • Gemini
  • DeepSeek
  • 通义千问
  • 智谱 GLM
  • Kimi
  • MiniMax
  • Mistral
  • xAI

模型由你选择

不填 Key 就走本机规则引擎,一样能剪;填了 Key 就接云端模型,说得更细、剪得更准。

esc打断
/tree回溯
/fork分叉

节奏由你掌控

随时按 Esc 打断,在它剪的时候追加要求;回到任意一版工程,或者分出一条新分支试别的剪法。

zsh
~ $ cd ~/影创 && riffcut
velora v0.1.0
esc 中断 · / 命令 · ! 终端
~/影创

在你习惯的地方工作

不换软件,不导来导去。双击打开,素材、工程、成片都在同一个窗口里。

工程上下文2.6%
[压缩]
已压缩,原 984,316 tokens(ctrl+o 展开)
~/影创/客户/茶山 (茶山-15s)
↑197k ↓43k R6.4M CH91.6% 2.6%/32k (local)(riffcut) qwen2.5-14b • 本机

为长片而设计

渲染在后台队列里跑,界面不卡。长片子断点续跑,进度随时能看,失败了自动回滚。

v0.1.0版本记录RiffCut 影创 · v0.1.0Apple Silicon · macOS 12.0+
$ git log --oneline -- 服务/
a350c6a(HEAD -> master)feat: 分镜清单确认后才开剪
b4b72a3feat(render): 字幕按真实画幅折行 (#8790)
e509d7efix(qc): 静音段检测改用 silencedetect (#11231)
b9e3eeffix(voice): apad 对齐后不再吞掉尾音 (#11514)
$

本机运行,可追溯

服务端纯 Python 标准库,没有一行 pip 依赖。每个版本可回退,每步产出都有记录。

下载 RiffCut 影创,开始剪辑

双击就能用。素材不上传,成片直接发。

下载即用,不用装环境。需要 macOS 12.0+ 与 Apple Silicon。