开源视频制作工具
访问官网 — 在线了解灵剪的功能特性、使用演示和快速上手指南。
Lingji Cut(灵剪) 是一个本地优先的开源 AI 视频创作工作台。它把内容创作中分散的环节串成一条完整流水线:从选题采集、写稿、AI 审稿,到语音合成、字幕处理、内容分析、信息卡 / 封面生成、时间线剪辑,再到 Remotion 导出和多平台发布——全部在同一个桌面端、以本地优先的方式完成。
它不是单一的视频播放器或字幕工具,而是面向内容创作者的桌面端创作环境。你可以从一份原始素材开始,逐步生成口播稿、音频、字幕、信息卡和最终视频,也可以直接导入已有音频 / 字幕进入编辑器。
欢迎扫码加入灵机剪影微信群,交流使用体验、功能建议和 AI 视频创作工作流;也可以通过作者微信直接联系我。
| 微信群交流 | 联系作者 |
|---|---|
选题采集 写稿审稿 AI 视频流水线 时间线 导出 发布
灵机采风 Chrome 扩展 → original.md → TTS 语音合成 → 时间线编辑 → Remotion → 多平台
监听抖音博主 script.md 字幕解析 / 内容分析 素材 / 卡片 H.264 B站 / 视频号
待创作箱 AI 写稿 / 审稿 封面候选 / Motion Card 动画 / 字幕 MP4 抖音 / 快手 / 小红书每个环节既能由 AI 自动推进,也能在桌面端逐步手动精调;既能从「灵机采风」采集的选题开始,也能直接从已有音频 + 字幕进入编辑器。
original.md / script.md,支持多文件标签、稿件资源、搜索替换、版本历史、AI 生成、AI 审稿和批注采纳。lingji-editor MCP Server 提供 lingji_* 工具给 Claude Code / Codex / Gemini,配合 file-first 契约直接编辑项目文件。lingji CLI 在终端里驱动音频、字幕分析、卡片、封面、导出等完整流水线。更多界面截图在 宣传制作/ 和 pics/ 目录中。仓库首页宣传图位于 docs/assets/lingji-cut-hero.png。
npm install仓库包含项目级 .npmrc,默认使用 npmmirror 的 npm / Electron / Node 原生模块镜像,适合国内网络环境。npm 11 可能提示 Unknown project config "electron_mirror" 等 warning,这通常不代表安装失败。
如果 Electron 下载被本机 npm 配置忽略,可以手动设置:
export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
export npm_config_disturl="https://npmmirror.com/mirrors/node/"
npm installWindows PowerShell:
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
$env:npm_config_disturl="https://npmmirror.com/mirrors/node/"
npm installnpm run devnpm run buildmacOS:
npm run dist:macWindows:
npm run dist:win默认产物在 release/ 下:
release/灵机剪影-darwin-arm64/灵机剪影.apprelease/灵机剪影-darwin-x64/灵机剪影.app当前打包产物是本地 .app,尚未接入正式签名、notarization、DMG / PKG 分发。
npm test运行单个测试:
npx vitest run tests/editor.test.tsx…除桌面端外,仓库还提供一个无头命令行工具 lingji,用于在终端里驱动项目流水线(音频、字幕分析、卡片、封面、导出等)。它通过 MCP 服务地址与运行中的灵机剪影桌面端通信,因此使用前需保证桌面端在跑(或用 --server 指定服务地址)。
npm run install:cli该脚本会先用 esbuild 把 cli/src/index.ts 打包为 dist-cli/lingji.mjs,再通过 npm link 注册到全局,之后任意目录都能直接使用 lingji:
lingji --help
npm link是软链到本仓库的构建产物。以后改了 CLI 源码,只需重新npm run build:cli即可生效,无需再次 link。CLI 安装在「当前 Node 版本」的全局 bin 下。若使用 nvm 切换到别的 Node 版本,需要在该版本里重新执行一次
npm run install:cli。
卸载全局命令:
npm run uninstall:clilingji project current # 显示应用当前活动项目
lingji project list # 列出最近项目
lingji audio gen [--project
] --wait # 生成口播音频 (TTS)
lingji subtitle analyze --wait # 字幕分析 + 卡片生成
lingji cards list|show|update|regenerate|regen-media|convert|delete
lingji cover prompt|image|gen --wait # 封面提示词 / 出图 / 一次性
lingji export [--out ] --wait # 导出 MP4
lingji task status|list|cancel|wait # 任务查询与控制全局开关:--json(JSON 输出)、--server (覆盖 MCP 服务地址)。
script.md。Lingji Cut 主要通过应用内"设置"页面保存 AI 配置,不依赖仓库内 .env 存放密钥。
主要配置区域:
card.image、card.video)。lingji-editor 本地 MCP Server,并注册到 Claude Code / Codex / Gemini。关于内置 Pi 与外部 Agent 的完整用法,见 Agent 使用指南;关于灵机采风扩展,见 灵机采风插件使用指南。
请不要把真实 API Key、Session ID、Cookie 或访问令牌提交到源码、测试、文档或截图中。
应用运行时会把创作数据保存在用户选择的项目目录中。常见项目文件包括:
project.json:统一工程文件,包含 timeline、aiAnalysis、script 等段落。original.md:原始素材 / 转录文本。script.md:口播成稿。podcast-audio.mp3:TTS 生成的口播音频。podcast-subtitles.srt:口播字幕。podcast-subtitles.original.srt:TTS 初始字幕备份。covers/:封面候选图。ai-cards/:AI 视觉卡片资源。imports/:外部视频 / 音频导入产物。configs/prompts/:项目级提示词覆盖。历史版本中的 timeline.json、ai-analysis.json、script-state.json 会在加载旧工程时迁移到 project.json。
…electron/preload.ts 暴露,并在 src/lib/electron-api.ts 声明类型。electron/main.ts、electron/preload.ts、src/lib/electron-api.ts 和对应测试。project.json。新增工程段落前需要评估迁移、并发写锁和旧数据兼容。TimelineData 经 buildRenderPlan 编译为 Remotion 组件树,预览用 @remotion/player,导出用 @remotion/bundler + @remotion/renderer。ai-cards//motionCard.tsx),主进程用 esbuild 编译为 CJS 注入,预览与导出共用同一份编译产物。src/store/task-progress.ts 和底部 AppStatusBar 统一进度系统。DESIGN.md 的 macOS 专业创作工具规范。lingji_* MCP 工具进入编辑器状态。src/types.ts、src/store/timeline.ts、src/lib/timeline-tracks.ts、src/lib/timeline-placement.ts。src/types/ai.ts、src/types/motion.ts、src/lib/ai-persistence.ts、src/store/ai.ts、src/remotion/。src/pages/ScriptWorkbench.tsx、src/store/script.ts、src/lib/script-persistence.ts。src/lib/prompts/、electron/prompts-io.ts、electron/prompt-bindings-io.ts。electron/agent-runtime/、electron/acp/、electron/mcp/、src/components/agent/。electron/pipeline/ 与 electron/mcp/tools.ts 中的 pipeline.* 注册。src/components/publish/、src/store/publish.ts、src/lib/publish/。electron/main.ts、electron/remotion/、src/remotion/。.env、.tmp/、work/、.agents/、.claude/、构建产物和本地运行产物已加入 .gitignore。1100 × 760,暂不以移动端为主要目标。bcut 转录链路,外部服务可用性会影响结果。欢迎提交 issue、建议和 PR。建议在较大改动前先说明你想修改的模块和目标,尤其是时间线、工程存储、IPC、Remotion 导出和 AI Provider 相关改动。
yoqu2020| 微信群交流 | 联系作者 |
|---|---|
灵机剪影是免费开源项目。如果它帮你节省了时间,欢迎扫码请作者喝杯咖啡 ☕,这是项目持续维护的最大动力。
| 微信支付 | 支付宝 |
|---|---|
Apache License 2.0. See LICENSE.
暂无开放 Issues,或尚未同步最近议题。