| 
|
## 赞赏支持
灵机剪影是免费开源项目。如果它帮你节省了时间，欢迎扫码请作者喝杯咖啡 ☕，这是项目持续维护的最大动力。
| 微信支付 | 支付宝 |
| --- | --- |
| 
| 
|
## License
Apache License 2.0. See [LICENSE](LICENSE). | |
### AI 视频创作全流程
```text
选题采集 写稿审稿 AI 视频流水线 时间线 导出 发布
灵机采风 Chrome 扩展 → original.md → TTS 语音合成 → 时间线编辑 → Remotion → 多平台
监听抖音博主 script.md 字幕解析 / 内容分析 素材 / 卡片 H.264 B站 / 视频号
待创作箱 AI 写稿 / 审稿 封面候选 / Motion Card 动画 / 字幕 MP4 抖音 / 快手 / 小红书
```
每个环节既能由 AI 自动推进，也能在桌面端逐步手动精调；既能从「灵机采风」采集的选题开始，也能直接从已有音频 + 字幕进入编辑器。
## Highlights
- **AI 写稿工作台**：管理 `original.md` / `script.md`，支持多文件标签、稿件资源、搜索替换、版本历史、AI 生成、AI 审稿和批注采纳。
- **自动口播流程**：从文稿一键触发 TTS、字幕解析、内容分析、封面候选和视觉卡片生成；AI 卡片增量流式呈现并自动落轨。
- **专业时间线编辑**：支持音频、字幕、图片、视频、文字、AI 卡片、多视觉轨、多音频轨、拖拽、吸附、拆分、裁剪、复制 / 剪切 / 粘贴和轨道锁定。
- **Motion Card 数据动画**：AI 生成自由 Remotion TSX 卡片（文字 / 数字 / 表格 / 图表），出卡前还会先生成逐拍动画指导；内置风格模板库，预览与导出共用同一份编译产物。
- **多 Provider AI 配置**：支持 OpenAI 兼容、Gemini、LM Studio 等 LLM Provider，多种图片 / 视频生成 Provider，以及多 Provider TTS 音色体系（MiniMax、Xiaomi MiMo 含克隆音色）。
- **内置 Pi Agent**：应用内开箱即用的对话 agent（零安装、复用应用 LLM 配置），可直接改稿 / 改视频，编辑器实时热重载。详见 [Agent 使用指南](docs/agent-guide.md)。
- **外部 Agent / MCP 集成**：`lingji-editor` MCP Server 提供 `lingji_*` 工具给 Claude Code / Codex / Gemini，配合 file-first 契约直接编辑项目文件。
- **灵机采风 Chrome 扩展**：监听抖音博主、采集公开视频、本地转录，并经联动桥推送到「待创作箱」做二创。详见 [灵机采风插件使用指南](docs/chrome-extension-guide.md)。
- **多平台发布**：发布选项卡内置多画幅封面工作台（16:9 / 4:3 / 3:4）、发布元数据（标题 / 简介 / 标签）与 B站分区 AI 智能推荐，支持发布到 B站 / 视频号 / 抖音 / 快手 / 小红书。
- **命令行与自动化**：无头 `lingji` CLI 在终端里驱动音频、字幕分析、卡片、封面、导出等完整流水线。
- **Remotion 导出**：通过 Remotion 渲染引擎（自带 Chrome Headless Shell + ffmpeg）导出 H.264 MP4，支持编辑器预览、时间线 seek 与导出进度展示。
- **本地优先**：项目文件保存在用户选择的本地目录，仓库不需要保存任何真实 API Key。
## Screenshots
更多界面截图在 [`宣传制作/`](宣传制作/) 和 [`pics/`](pics/) 目录中。仓库首页宣传图位于 [`docs/assets/lingji-cut-hero.png`](docs/assets/lingji-cut-hero.png)。
## Tech Stack
- Electron 41 + electron-vite
- React 19 + TypeScript 6
- Remotion 4（视频渲染引擎，自带 Chrome Headless Shell + ffmpeg）
- Zustand
- CodeMirror 6
- Framer Motion
- TailwindCSS 4 + 自研 macOS 专业工具 UI 组件
- MCP SDK + 内置 Pi Agent / 外部 Agent 集成
- 灵机采风 Chrome 扩展（Manifest V3 + CRXJS + Vite，独立工程）
- Vitest
## Quick Start
### 1. Install
```bash
npm install
```
仓库包含项目级 `.npmrc`，默认使用 npmmirror 的 npm / Electron / Node 原生模块镜像，适合国内网络环境。npm 11 可能提示 `Unknown project config "electron_mirror"` 等 warning，这通常不代表安装失败。
如果 Electron 下载被本机 npm 配置忽略，可以手动设置：
```bash
export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
export npm_config_disturl="https://npmmirror.com/mirrors/node/"
npm install
```
Windows PowerShell：
```powershell
$env:ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"
$env:npm_config_disturl="https://npmmirror.com/mirrors/node/"
npm install
```
### 2. Development
```bash
npm run dev
```
### 3. Build
```bash
npm run build
```
### 4. Package
macOS：
```bash
npm run dist:mac
```
Windows：
```bash
npm run dist:win
```
默认产物在 `release/` 下：
- `release/灵机剪影-darwin-arm64/灵机剪影.app`
- `release/灵机剪影-darwin-x64/灵机剪影.app`
当前打包产物是本地 `.app`，尚未接入正式签名、notarization、DMG / PKG 分发。
### 5. Test
```bash
npm test
```
运行单个测试：
```bash
npx vitest run tests/editor.test.tsx
```
## Common Commands
```bash
npm run dev # Start Electron + Vite dev server
npm run build # Build main, preload and renderer
npm run package:win # Package Windows app directory
npm run dist:win # Build + package Windows app directory
npm run package:mac # Package macOS .app
npm run dist:mac # Build + package macOS .app
npm test # Run Vitest
npm run test:watch # Run Vitest in watch mode
npm run build:cli # Bundle the lingji CLI into dist-cli/lingji.mjs
npm run install:cli # Build the CLI and link `lingji` globally
npm run uninstall:cli # Remove the global `lingji` command
```
## 命令行工具 (lingji CLI)
除桌面端外，仓库还提供一个无头命令行工具 `lingji`，用于在终端里驱动项目流水线（音频、字幕分析、卡片、封面、导出等）。它通过 MCP 服务地址与运行中的灵机剪影桌面端通信，因此使用前需保证桌面端在跑（或用 `--server` 指定服务地址）。
### 全局安装
```bash
npm run install:cli
```
该脚本会先用 esbuild 把 `cli/src/index.ts` 打包为 `dist-cli/lingji.mjs`，再通过 `npm link` 注册到全局，之后任意目录都能直接使用 `lingji`：
```bash
lingji --help
```
> `npm link` 是软链到本仓库的构建产物。以后改了 CLI 源码，只需重新 `npm run build:cli` 即可生效，无需再次 link。
>
> CLI 安装在「当前 Node 版本」的全局 bin 下。若使用 nvm 切换到别的 Node 版本，需要在该版本里重新执行一次 `npm run install:cli`。
卸载全局命令：
```bash
npm run uninstall:cli
```
### 常用子命令
```bash
lingji 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 | |
## 赞赏支持
灵机剪影是免费开源项目。如果它帮你节省了时间，欢迎扫码请作者喝杯咖啡 ☕，这是项目持续维护的最大动力。
| 微信支付 | 支付宝 |
| --- | --- |
| | |
## License
Apache License 2.0. See [LICENSE](LICENSE).