# VideoEpicCreator

**Repository Path**: zyxgame/VideoEpicCreator

## Basic Information

- **Project Name**: VideoEpicCreator
- **Description**: 一款基于Python和PyQt6开发的智能视频混剪工具，专为短剧创作者设计。利用多种AI大模型实现自动字幕识别、智能混剪、特效添加等功能，并与剪映等主流剪辑软件深度集成。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-07-14
- **Last Updated**: 2025-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VideoEpicCreator

一款基于Python和PyQt6开发的智能视频混剪工具，专为短剧创作者设计。利用多种AI大模型实现自动字幕识别、智能混剪、特效添加等功能，并与剪映等主流剪辑软件深度集成。

## 主要功能

* 视频管理：导入、编辑、删除、批量操作
* AI字幕识别：自动识别视频中的语音内容
* 智能混剪：基于AI大模型的内容理解实现智能混剪
* 剪映集成：导出剪映草稿，无缝衔接专业剪辑
* 多AI模型支持：集成通义千问、文心一言、ChatGPT等多种AI大模型

## 截图展示

*即将更新...*

## 安装与使用

### 环境要求

* Python 3.9+
* FFmpeg
* 支持的操作系统：Windows 10/11, macOS 10.15+, Linux

### 安装步骤

1. 克隆仓库  
```bash
git clone https://github.com/agions/VideoEpicCreator.git
cd VideoEpicCreator
```

2. 安装依赖  
```bash
pip install -r requirements.txt
```

3. 运行应用  
```bash
python main.py
```

## 配置AI模型

1. 在设置界面中选择需要使用的AI模型
2. 填入对应的API Key
3. 测试连接确保API正常工作

## 项目结构

```
VideoEpicCreator/
├── app/                  # 应用代码
│   ├── core/             # 核心功能
│   ├── ui/               # UI组件
│   ├── models/           # AI模型接口
│   └── utils/            # 工具函数
├── resources/            # 资源文件
│   ├── icons/            # 图标
│   │   └── svg/          # SVG源文件
│   └── styles/           # 样式表
├── tools/                # 工具脚本
│   └── generate_icons.py # 图标生成工具
├── tests/                # 测试代码
├── main.py               # 程序入口
└── requirements.txt      # 依赖列表
```

## 图标与UI资源

项目使用SVG格式设计图标，并通过Python脚本转换为PNG格式。这种方式可以确保图标在不同分辨率下保持清晰，且便于维护与更新。

### 图标生成

图标生成流程如下：

1. 在`resources/icons/svg/`目录下创建或编辑SVG格式图标
2. 使用生成工具转换为PNG格式：
```bash
# 安装cairosvg库
pip install cairosvg

# 运行图标生成脚本
python tools/generate_icons.py
```

### 自定义图标

如需添加新图标，请：

1. 在`resources/icons/svg/`目录下创建SVG文件
2. 在`tools/generate_icons.py`的`ICON_CONFIG`中添加新图标配置
3. 执行生成脚本

## 开发进度摘要

当前版本为v0.1.0，已完成了以下核心工作：

1. **视频播放功能**: 实现了专业级视频播放控制，包括帧进帧退、关键帧检测与导航、时间标记、实时特效预览等功能。
  
2. **界面优化**: 完成了界面布局优化，将AI配置从主界面移至设置菜单，实现了更加简洁高效的UI设计。

3. **基础架构**: 建立了清晰的项目结构，实现了模块化设计，方便后续功能扩展。

4. **AI模型支持**: 已支持多种AI大模型接入，包括通义千问、文心一言、ChatGPT等。

### 开发难点突破
- ✅ 视频关键帧自动检测与导航
- ✅ 实时视频特效预览
- ✅ 播放器与时间线组件集成

### 下一版本计划
计划在v0.2.0版本中重点实现：
- 完整的视频导入与管理功能
- 多轨道时间线编辑
- 初步的智能字幕生成功能

## 开发计划与改进建议

### 当前进度
- [x] 基础UI框架
- [x] 高质量SVG图标设计与生成系统
- [x] 视频播放器功能完善
- [x] 界面优化与布局调整

### 已完成功能
#### 视频播放器功能
- [x] 播放控制（帧进、帧退、倍速播放）
- [x] 关键帧自动检测与定位
- [x] 视频标记功能（添加、管理、导航）
- [x] 实时效果预览（多种视频特效支持）
- [x] 片段设置（入点、出点、片段创建）
- [x] 截图功能
- [x] 上下文菜单与快捷键支持

#### 界面优化
- [x] 紧凑型视频播放器控制面板
- [x] 菜单组织优化（主菜单、上下文菜单）
- [x] AI设置面板移至独立对话框
- [x] 添加紧凑视图模式
- [x] 支持侧边栏切换

### 近期开发计划（优先级从高到低）
- [ ] 视频导入与缩略图生成
  - [ ] 支持拖放导入视频
  - [ ] 使用FFmpeg自动生成视频缩略图
  - [ ] 视频元数据提取与显示（分辨率、时长、帧率等）
  - [ ] 批量导入管理
- [ ] 时间线编辑功能
  - [ ] 多轨道支持
  - [ ] 拖拽式片段管理
  - [ ] 剪切、分割、合并片段
  - [ ] 时间线缩放与定位
  - [ ] 关键帧标记

### 中期开发计划
- [x] 智能分段与场景识别
- [x] 智能调色与场景匹配
- [x] 节奏感分析与智能转场
- [x] 自定义混剪风格
- [x] AI大模型设置与管理
- [ ] 智能字幕生成
- [ ] 一键导出多平台格式
- [ ] 主题定制系统（明亮/暗黑模式）
- [ ] 工作区布局自定义与保存
- [ ] 快捷键系统进一步优化

### 长期开发计划
- [ ] 剪映导出与集成
  - [ ] 剪映项目(.proj)格式解析
  - [ ] 剪映素材无损导出
  - [ ] 项目资源包导出
- [ ] 跨平台应用支持
  - [ ] Windows、macOS打包优化
  - [ ] 移动端远程控制
- [ ] 功能完善
  - [ ] 项目自动保存与恢复
  - [ ] 云同步功能（项目、资源、设置）
  - [ ] 视频资源库管理
  - [ ] 内置特效模板市场
  - [ ] 用户社区分享与协作
  - [ ] 性能监控与优化工具
  - [ ] 插件系统支持第三方扩展

## 贡献指南

欢迎提交Pull Request或Issue来帮助改进本项目。

## 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

## 联系方式

* 项目维护者: 1051736049@qq.com
* 项目主页: <https://github.com/agions/VideoEpicCreator>