项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
技术标签
使用教程
—
环境要求
- macOS 14+(Apple Silicon)或 Windows x64
- 媒体分析、转写准备与导出需要 ffmpeg 与 ffprobe 在 PATH 中(安装包不自带)
- 使用 agent 功能需已安装并登录的 agent 引擎,如 Codex CLI 或 Claude Code
- 仅源码开发需要 Node.js 22.12+;完整桌面开发另需 Rust、CMake 与平台构建工具
安装与启动步骤
-
1选择安装包
按平台下载 DMG 或 Windows 的 CPU/CUDA/Vulkan 版 EXE 或 ZIP,链接始终指向最新版本。
-
2macOS 安装
打开 DMG,把 BaoCut 拖入「应用程序」文件夹后启动;该版本已签名并公证。
-
3Windows 安装
先装 Microsoft Visual C++ v14 x64 运行库,再运行 Setup EXE 或解压 ZIP;GPU 版需匹配驱动。
-
4安装外部媒体工具
macOS 可用 Homebrew 装 ffmpeg;Windows 需自行把 ffmpeg 与 ffprobe 放到 PATH 上。
brew install cmake ffmpeg -
5准备 agent 引擎
安装并登录 Codex CLI 或 Claude Code;仅打开应用本身不需要 agent 登录。
-
6从源码运行
需 Node.js 22.12+;npm ci 后先跑 doctor 检查环境,dev 会自动构建原生 worker 与 WASM。
git clone https://github.com/jimliu/baocut.git cd baocut npm ci npm run doctor npm run dev -
7接入 CLI 与 MCP
把 BaoCut 技能装进你自己的 agent,并注册 MCP 服务,两条路径工具名一致。
baocut skill install baocut mcp install
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
BAOCUT_CLI | 否 | 外部 agent 调用本地 CLI 时使用的环境变量入口 | baocut |
Model download source | 否 | 设置 › 通用 › 模型下载源,Hugging Face 不可达时可换 ModelScope 或自定义镜像 | ModelScope |
ffmpeg / ffprobe | 是 | 媒体分析、转写准备与导出依赖,必须在 PATH 中 | /opt/homebrew/bin/ffmpeg |
如何确认成功
运行 npm run doctor 无报错退出,或打开应用看到主页与可编辑时间线即成功。
常见问题
Q:普通使用需要装 Node.js 和 Rust 吗?
A:不需要。打包应用已内置 Runtime 与原生 worker,Node.js 和 Rust 只在源码开发时才需要。
Q:本地模型下载很慢或失败怎么办?
A:在设置 › 通用 › 模型下载源中切换为 ModelScope,或选 Custom 填入镜像 base URL;个别文件仍走 Hugging Face。
Q:Windows 安装后打不开或报缺 DLL?
A:先安装 Microsoft Visual C++ v14 x64 Redistributable 再运行安装包;GPU 版本还需兼容的显卡驱动。
Q:为什么导出或转写功能不可用?
A:缺少 ffmpeg 与 ffprobe。它们不随应用打包,需自行安装并确保在 PATH 中。
Q:npm run dev:lite 能做什么?
A:只跑外壳与 UI,跳过原生和 WASM 构建;新检出的仓库无法剪辑、预览、导出和本地推理。
注意事项
- Windows 安装包未签名,系统可能提示风险;校验和与验证方式见各版本 GitHub 发布页。
- 本地模型默认从 Hugging Face 下载,每个文件都会与内置 checksum 校验。
- 首次源码构建会下载大量依赖,耗时且占磁盘,后续复用 Cargo 缓存。
- 官网与 GitHub Releases 页面提供版本号与发行说明。
核心亮点
- AI 生成结果落在可编辑时间线上,避免一键生成后无法精修的痛点
- 覆盖转写、字幕、翻译、配音、剪辑、动画的完整链路,减少多工具切换
- 基于 TypeScript 且接入 claude-code、codex 等代理能力,扩展和二次开发门槛较低
不足之处
- 目前标注 macOS 平台,跨平台支持有限
- 项目处于成长早期,文档和社区生态待观察
适用场景
- 口播视频批量加字幕并翻译成多语言版本
- 访谈或课程内容自动转写后人工校对剪辑
- 用自然语言指令驱动代理完成粗剪和配音替换
替代项目
OpenCut、auto-editor
同类项目推荐
MoneyPrinterTurbo
开源
输入一句话,高清短视频自动出炉,文案配音全包了
利用 AI 大模型和自动化工作流,根据主题或关键词一键生成高清短视频。Generate HD short ···
openscreen
开源
免费无水印录屏做演示,替代 Screen Studio
Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermark···
seedance-2.0-api
开源
快速上手字节Seedance 2.0,文本/图片一键生成视频
Seedance 2.0 API — text-to-video and image-to-video examples
auto-subs
开源
在剪辑软件里直接生成字幕,省去导出导入的麻烦
On-device subtitle generation that connects directly to DaVinci Resolve, Premiere, a···
