AIcut - 全自动 AI 视频剪辑引擎

AIcut 是一款 AI 原生 的自动化视频制作工具。它将**专业时间轴（Timeline）**与 Python AI 逻辑 深度结合，通过双向实时同步实现“所写即所得”的自动化剪辑体验。

---

🚀 快速启动

1. 环境要求

• Node.js: 18.0+
• Python: 3.10+
• 推荐工具: pnpm (前端), uv (Python)

2. 一键配置 (Windows)

在根目录下运行安装脚本，自动处理依赖、虚拟环境及素材映射：

./setup.ps1

3. 启动项目

只需执行以下指令：

cd AIcut-Studio\apps\web
pnpm run app

💡 说明: 该指令会同时启动 Next.js 前端和 Electron 壳。Electron 启动后会自动在后台唤起 Python AI 后端，无需手动干预。

---

🧠 核心架构：文件驱动同步

AIcut 采用 UI 渲染与逻辑控制解耦 的设计，所有状态存储于 project-snapshot.json：

1. 读取状态: AI 脚本通过 Python 加载 ai_workspace/project-snapshot.json。
2. 计算修改: AI 根据逻辑（如“自动配图”、“生成字幕”）计算新的 tracks 结构。
3. 指令写入: AI 直接修改并保存该 JSON 文件。
4. 实时预览: 编辑器监听文件变化，通过 SSE 实现 UI 的“热重载”。

---

📁 关键目录说明

AIcut/
├── AIcut-Studio/          # 前端编辑器 (Next.js + Electron + Remotion)
├── projects/              # 项目资产库 (多项目管理)
│   └── demo/
│       ├── assets/        # 视频/图片/音频原件
│       └── snapshot.json  # 项目持久化存档
├── ai_workspace/          # AI 实时同步区
│   └── project-snapshot.json # 核心通信文件 (AI 读写此文件)
├── tools/                 # AI 剪辑脚本工具箱
│   ├── core/              # SDK (AIcutClient) 与守护进程
│   └── demos/             # 自动化剪辑示例脚本
├── exports/               # 导出的最终视频 (MP4)
└── setup.ps1              # 一键环境配置脚本

---

🤖 AI 开发者指南

⚠️ 重要提示: 如果你正在使用 AI 助教 (Antigravity/Claude 等) 协助开发，请务必要求其优先查阅 AIcut Editing Skill。该文档定义了时间轴的 数据契约 (Data Schema)，是确保 Python 逻辑与前端 UI 渲染一致的唯一准则。

使用 Python SDK 操作

我们封装了 AIcutClient 以简化对时间轴的操作：

from tools.core.aicut_sdk import AIcutClient

client = AIcutClient()

# 示例：快速添加字幕
client.add_multiple_subtitles([
    {"text": "欢迎使用 AIcut 自动化剪辑", "startTime": 0, "duration": 5}
])

让 LLM 直接控制剪辑

若使用 ChatGPT/Claude 等模型，建议将 ai_workspace/project-snapshot.json 作为上下文发送。详见 docs/SYSTEM_PROMPT.md。

---

⭐ AIcut 让视频剪辑不再是重复劳动，而是可编程的生产力。