ClipFlow

AI 驱动的智能视频剪辑桌面应用

---

⭐ 为什么选择 ClipFlow？

特性	说明
🤖 AI 智能剪辑	自动识别精彩片段，一键生成精彩集锦
📝 智能字幕	语音转文字 + 多语言翻译 + 风格化字幕
🎵 自动配乐	根据视频情绪智能匹配背景音乐
🔒 本地运行	所有数据本地处理，保护隐私安全
💻 桌面应用	Tauri 构建，轻量流畅

---

🚀 快速开始

环境要求

要求	版本
Node.js	>= 18
npm	>= 9
Rust	最新稳定版 (可选)

安装

# 克隆项目
git clone https://github.com/agions/clipflow.git
cd clipflow

# 安装依赖
npm install

# 启动开发
npm run dev

构建

# 开发模式
npm run dev

# 生产构建
npm run build

# Tauri 桌面应用
npm run tauri dev    # 开发
npm run tauri build  # 打包

常用命令

命令	说明
npm run dev	前端开发模式
npm run build	前端生产构建
npm run tauri dev	Tauri 开发模式
npm run tauri build	Tauri 打包
npm run type-check	TypeScript 类型检查
npm run lint	ESLint 检查
npm run test	运行测试
npm run docs:dev	文档开发服务器

---

🎯 核心功能

1. AI 智能剪辑

• 场景切换检测
• 音频峰值识别（笑声、掌声）
• 运动强度分析
• 自动生成精彩集锦

2. 智能字幕

• 语音转字幕 (ASR)
• 多语言翻译
• 字幕风格化
• 导出 SRT/ASS/VTT

3. 自动配乐

• 情绪匹配音乐
• 本地音乐库
• 淡入淡出
• 音量调节

4. 多模型接入

厂商	模型
OpenAI	GPT-5.3
Anthropic	Claude 4.6
Google	Gemini 3 Ultra
阿里通义	Qwen 3.5
智谱	GLM-5
DeepSeek	DeepSeek R1
月之暗面	Kimi k2.5

---

🛠️ 技术栈

类别	技术
前端框架	React 18 + TypeScript 5
UI 组件	Ant Design 5
状态管理	Zustand 5
桌面客户端	Tauri 2.x (Rust)
构建工具	Vite 6
AI 服务	OpenAI + Claude API
测试框架	Vitest

---

📂 项目结构

clipflow/
├── src/                        # 前端源码
│   ├── components/             # React 组件
│   │   ├── editor/            # 编辑器组件
│   │   ├── AIPanel/          # AI 功能面板
│   │   └── common/            # 通用组件
│   ├── core/                  # 核心逻辑
│   │   ├── services/          # 业务服务
│   │   │   └── workflow/     # 工作流服务
│   │   └── types/             # 类型定义
│   ├── pages/                 # 页面组件
│   ├── hooks/                 # 自定义 Hooks
│   ├── store/                 # Zustand 状态管理
│   └── utils/                 # 工具函数
├── src-tauri/                 # Tauri/Rust 后端
├── docs/                      # 文档
├── scripts/                   # 构建脚本
└── tests/                     # 测试文件

---

📊 代码质量

指标	状态
TypeScript	0 errors
ESLint	0 warnings
测试覆盖	180+ tests
构建时间	~15s

---

🤝 贡献指南

欢迎贡献！

# 克隆项目
git clone https://github.com/agions/clipflow.git

# 创建分支
git checkout -b feature/your-feature

# 安装依赖
npm install

# 开发
npm run dev

# 提交
git commit -m 'feat: 添加新功能'

# 推送
git push origin feature/your-feature

---

📖 文档

• 📚 在线文档
• 🔥 快速开始
• ⚙️ 模型配置
• 💡 AI 工作流

---

📝 更新日志

查看 CHANGELOG.md 了解版本更新。

---

💬 交流社区

• GitHub Issues - 报告 Bug
• Discussions - 功能讨论

---

📄 License

MIT License - 自由使用，商用欢迎！

---

如果这个项目对你有帮助，欢迎点个 ⭐ Star！