# VideoEpicCreator **Repository Path**: Agions/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**: 7 - **Forks**: 4 - **Created**: 2025-03-17 - **Last Updated**: 2026-01-30 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # AI-EditX v3.0 - 企业级智能视频编辑平台 ## 🎬 项目概述 AI-EditX 是一个具备企业级特性的专业视频编辑平台，集成了 AI 智能功能、插件生态系统和现代化的架构设计。从 v3.0 开始，AI-EditX 已从一个基础视频编辑器升级为功能完整、性能优秀的生产级应用。 ### ✨ 核心特性 - 🤖 **AI 驱动**: 集成多种 AI 功能，包括视频分析、字幕生成、配音制作等 - ⚡ **GPU 加速**: 支持 NVIDIA NVENC、AMD AMF、Intel QSV、Apple VideoToolbox - 🔌 **插件生态**: 完整的插件系统，支持无限功能扩展 - 📊 **性能监控**: 实时性能监控、资源分析和智能优化建议 - 🔧 **撤销重做**: 基于命令模式的完整撤销/重做系统 - 💾 **自动保存**: 智能自动保存、项目备份和冲突解决 - ⌨️ **快捷键系统**: 全局快捷键管理，支持自定义和冲突检测 - 🔒 **安全防护**: 全面的输入验证、XSS 防护和安全加固 - 🎬 **专业编辑**: 多轨道时间线、特效系统、专业调色工具 - 🎯 **现代架构**: 微服务架构、事件驱动、依赖注入 ## 🏗️ 项目架构 ### 架构概览 ``` AI-EditX v3.0/ ├── 📁 app/ # 应用程序核心 │ ├── 🏗️ core/ # 核心架构模块 │ │ ├── application.py # 应用程序核心 │ │ ├── service_registry.py # 服务注册表（NEW） │ │ ├── service_config.py # 服务配置系统（NEW） │ │ ├── service_bootstrap.py # 服务启动器（NEW） │ │ ├── service_container.py # 服务容器（依赖注入） │ │ ├── event_bus.py # 增强事件总线 │ │ ├── error_manager.py # 错误管理系统（NEW） │ │ ├── undo_system.py # 撤销/重做系统（NEW） │ │ ├── auto_save.py # 自动保存系统（NEW） │ │ └── logger.py # 日志系统 │ ├── 🎨 ui/ # 用户界面 │ │ ├── main/ # 主窗口模块 │ │ │ ├── main_window.py # 主窗口 │ │ │ ├── components/ # 主窗口组件 │ │ │ ├── layouts/ # 布局组件 │ │ │ └── pages/ # 页面组件 │ │ ├── input/ # 输入处理（NEW） │ │ │ └── hotkey_manager.py # 快捷键管理 │ │ ├── common/ # 公共UI组件 │ │ │ └── widgets/ # 可复用组件 │ │ └── theme/ # 主题系统 │ ├── 🔌 plugins/ # 插件生态系统（NEW） │ │ ├── plugin_interface.py # 插件接口定义 │ │ ├── plugin_manager.py # 插件管理器 │ │ ├── plugin_registry.py # 插件注册表 │ │ ├── plugin_loader.py # 插件加载器 │ │ └── plugin_service.py # 插件服务集成 │ ├── 📊 monitoring/ # 性能监控系统（NEW） │ │ ├── performance_monitor.py # 性能监控器 │ │ ├── metrics_collector.py # 指标收集器 │ │ ├── resource_monitor.py # 资源监控器 │ │ ├── operation_profiler.py # 操作分析器 │ │ └── alert_system.py # 告警系统 │ ├── 🔒 security/ # 安全系统（NEW） │ │ ├── input_validator.py # 输入验证器 │ │ ├── security_manager.py # 安全管理器 │ │ ├── access_control.py # 访问控制 │ │ └── encryption_manager.py # 加密管理 │ ├── 🎬 services/ # 业务服务 │ │ ├── video_service/ # 视频服务 │ │ │ ├── gpu_renderer.py # GPU渲染器（NEW） │ │ │ └── performance_optimizer.py # 性能优化器（NEW） │ │ ├── ai_service/ # AI服务 │ │ └── export_service/ # 导出服务 │ ├── 📋 models/ # 数据模型 │ ├── ⚙️ config/ # 配置文件 │ └── 🛠️ utils/ # 工具模块 ├── 🧪 tests/ # 测试框架（NEW） │ ├── conftest.py # pytest配置 │ ├── test_core/ # 核心测试 │ └── test_plugins/ # 插件测试 ├── 📚 docs/ # 文档 ├── 💡 examples/ # 示例和教程（NEW） │ └── plugins/ # 插件示例 ├── 📄 QUICK_START.md # 快速开始指南（NEW） ├── 📋 CHANGELOG.md # 版本发布记录 ├── 📊 PROJECT_IMPROVEMENT_SUMMARY.md # 项目改进总结（NEW） └── 🚀 main.py # 程序入口 ``` ### 架构特点 #### 🏗️ 微服务架构 - **服务注册表**: 自动发现和依赖管理 - **生命周期管理**: 服务的启动、运行和关闭 - **健康检查**: 实时监控服务状态 - **热重载**: 支持服务的动态加载和卸载 #### 📡 事件驱动架构 - **异步事件处理**: 高性能事件总线 - **事件优先级**: 确保关键事件优先处理 - **事件持久化**: 支持事件重放和恢复 - **智能路由**: 基于内容的事件分发 #### 🔌 插件化设计 - **标准接口**: 统一的插件开发规范 - **依赖管理**: 自动解析插件依赖关系 - **安全沙箱**: 隔离插件执行环境 - **热加载**: 运行时插件安装和卸载 #### 📊 性能监控 - **实时监控**: 系统资源和应用性能 - **智能告警**: 基于规则的自动告警 - **性能分析**: 操作耗时和瓶颈识别 - **优化建议**: AI 驱动的性能优化建议 ### 技术栈 #### 核心技术 - **前端框架**: PyQt6 6.6.0+ - **架构模式**: 微服务 + 事件驱动 + 插件化 - **编程语言**: Python 3.8+ (推荐 3.12+) - **GPU 加速**: CUDA, OpenCL, VideoToolbox - **多线程**: concurrent.futures, asyncio #### 数据处理 - **视频处理**: FFmpeg, MoviePy - **AI 框架**: PyTorch, TensorFlow (可选) - **图像处理**: OpenCV, Pillow - **音频处理**: librosa, pydub #### 开发工具 - **测试框架**: pytest, coverage - **性能监控**: psutil, pynvml (可选) - **安全加固**: bleach, hashlib - **文档生成**: Sphinx, autodoc ## 🚀 快速开始 ### 📋 系统要求 #### 最低配置 - **操作系统**: Windows 10+, macOS 10.15+, Ubuntu 20.04+ - **Python**: 3.8+ (推荐 3.12+) - **内存**: 8GB RAM - **存储**: 2GB 可用空间 - **GPU**: 支持 OpenGL 4.0+的显卡 #### 推荐配置 - **操作系统**: Windows 11, macOS 13+, Ubuntu 22.04+ - **Python**: 3.12+ - **内存**: 16GB+ RAM - **存储**: 10GB+ SSD - **GPU**: NVIDIA GTX 1060+ / AMD RX 580+ / Apple Silicon M1+ ### ⚡ 快速安装 ```bash # 1. 克隆项目 git clone https://github.com/agions/AI-EditX.git cd AI-EditX # 2. 创建虚拟环境 python -m venv venv source venv/bin/activate # Linux/macOS # 或 venv\Scripts\activate # Windows # 3. 安装依赖 pip install -r requirements.txt # 4. 启动应用 python main.py ``` ### 🎯 主要功能 #### 视频编辑功能 - **时间线编辑**: 多轨道视频、音频、字幕编辑 - **实时预览**: GPU 加速的实时预览和播放控制 - **特效系统**: 丰富的内置效果和插件效果 - **调色工具**: 专业级色彩校正和分级 #### AI 智能功能 - **视频分析**: AI 自动识别场景、人物、物体 - **字幕生成**: 自动语音识别和字幕生成 - **配音制作**: AI 语音合成和多语言配音 - **智能剪辑**: AI 驱动的自动剪辑和混剪 #### 系统功能 - **撤销重做**: 基于命令模式的完整历史管理 - **自动保存**: 智能保存和项目恢复 - **快捷键**: 全局快捷键管理和自定义 - **性能监控**: 实时性能监控和优化建议 ### 🔌 插件生态 AI-EditX v3.0 引入了完整的插件系统： #### 插件类型 - **视频效果插件**: 自定义视频特效和滤镜 - **音频效果插件**: 音频处理和特效 - **转场插件**: 自定义转场效果 - **AI 增强插件**: AI 功能扩展 - **导出插件**: 自定义导出格式 #### 安装插件 ```python # 应用内安装 设置 > 插件管理 > 浏览市场 > 安装 # 命令行安装 pip install aieditx-plugin-name ``` #### 开发插件 详细开发指南请参考: [app/plugins/README.md](app/plugins/README.md) ### 📊 性能监控 AI-EditX v3.0 内置了全面的性能监控系统： ```python # 获取性能报告 from app.monitoring.performance_monitor import get_performance_monitor monitor = get_performance_monitor() report = monitor.generate_report() print(f"性能级别: {report.performance_level}") print(f"瓶颈数量: {len(report.bottlenecks)}") ``` 监控内容包括： - **CPU、内存、磁盘、网络使用率** - **GPU 使用率和温度** - **操作执行时间分析** - **智能告警和优化建议** ## 🎯 主要功能 ### 视频编辑页面 - 📁 **媒体库管理**: 管理视频、音频、图片等媒体文件 - 🎬 **视频预览**: 实时视频预览和播放控制 - ⏱️ **时间线编辑**: 多轨道时间线编辑 - ✨ **特效系统**: 丰富的视频特效和转场 - ⚙️ **属性面板**: 视频参数调整和属性设置 ### AI 对话页面 - 🤖 **AI 助手**: 智能对话和问题解答 - 💡 **智能建议**: 根据上下文提供操作建议 - 📝 **对话历史**: 保存和管理对话记录 - ⚙️ **AI 设置**: 配置 AI 服务和参数 ### AI 功能集成 - 🎯 **视频分析**: AI 分析视频内容和场景 - 🎤 **字幕生成**: 自动生成视频字幕 - 🗣️ **配音制作**: AI 语音合成和配音 - 🎨 **画质增强**: AI 增强视频画质 - ⚡ **智能剪辑**: AI 高能片段提取和混剪 ## 🔧 开发指南 ### 项目结构说明 #### 核心模块 - **Application**: 应用程序生命周期管理 - **ServiceContainer**: 依赖注入容器 - **EventBus**: 事件总线系统 - **ConfigManager**: 配置管理器 - **Logger**: 统一日志系统 #### UI 组件 - **MainWindow**: 主窗口，实现双页面架构 - **BasePage**: 页面基类，统一页面生命周期 - **NavigationBar**: 导航栏组件 - **StatusBar**: 状态栏组件 - **ThemeManager**: 主题管理器 ### 添加新功能 1. **创建页面**: 继承 BasePage 类 2. **注册服务**: 在 ServiceContainer 中注册 3. **添加导航**: 在 NavigationBar 中添加导航项 4. **连接事件**: 通过 EventBus 连接组件间事件 ### 自定义主题 1. **修改主题配置**: 在 ConfigManager 中修改主题设置 2. **扩展主题样式**: 在 ThemeManager 中添加新的样式 3. **应用主题**: 调用 ThemeManager.apply_theme() ## 📝 开发日志 ### 已完成功能 - ✅ 修复了现有代码的 QShortcut 导入错误 - ✅ 建立了新的项目目录结构 - ✅ 实现了核心架构组件 - ✅ 创建了双页面架构的 UI 框架 - ✅ 实现了基础的主题管理系统 - ✅ 建立了统一的事件系统 - ✅ 实现了依赖注入容器 - ✅ 创建了基础的 UI 组件 - ✅ 实现了剪映导出功能（JY004） - ✅ 实现了转场效果系统（VE003） - ✅ 实现了音频处理功能（VE004） - ✅ 实现了 APIKEY 管理功能（AI002） - ✅ 实现了配音生成功能（AI005） - ✅ 实现了视频分析功能（AI007） - ✅ 实现了实时预览优化（VE005） - 帧缓存机制 - 预览质量切换 - 视频缩略图生成 - ✅ 集成了 Mock AI 服务用于测试 - ✅ 实现了安全密钥管理系统 - ✅ 支持多种 AI 服务提供商 - ✅ 实现了专业的视频预览面板 - ✅ 优化了系统密钥库初始化逻辑 ### 未来计划 - 📌 集成更多真实 AI 服务提供商 - 📌 实现 4K 视频实时渲染优化 - 📌 添加更多视频特效和转场效果 - 📌 实现项目管理和版本控制 - 📌 添加更多文件格式支持 - 📌 实现更高级的 AI 剪辑功能 - 📌 支持团队协作功能 ## 🤝 贡献指南 欢迎提交 Issue 和 Pull Request 来帮助改进项目。 ### 开发规范 - 遵循 PEP 8 代码风格 - 使用类型提示 - 编写文档字符串 - 添加单元测试 ### 提交规范 - feat: 新功能 - fix: 修复 bug - docs: 文档更新 - style: 代码格式化 - refactor: 代码重构 - test: 测试相关 - chore: 构建或辅助工具变动 ## 📄 许可证 本项目采用 MIT 许可证。详见 [LICENSE](LICENSE) 文件。 ## 🙏 致谢 感谢所有为 AI-EditX 项目做出贡献的开发者和用户。 --- **AI-EditX** _让视频编辑更智能，让创作更简单_