Skip to content

XePope/CineAIStudio

 
 

Repository files navigation

CineAIStudio v2.0 - 专业AI视频编辑器

🎬 项目概述

CineAIStudio v2.0 是一个基于 PyQt6 构建的专业AI视频编辑器,采用现代化的双页面架构设计,集成了强大的AI功能和专业的视频编辑工具。

主要特色

  • 🤖 AI驱动: 集成多种AI功能,包括视频分析、字幕生成、配音制作等
  • 🎬 专业编辑: 提供多轨道时间线、特效系统、专业调色工具
  • 🎯 双页面架构: 视频编辑页面 + AI对话页面,操作更加直观
  • 🌟 现代化UI: 基于Material Design 3的现代化界面设计
  • 高性能: GPU加速渲染,支持4K视频编辑
  • 🔄 剪映兼容: 完美支持剪映项目格式导入导出

🏗️ 项目架构

核心架构

CineAIStudio v2.0/
├── app/                          # 应用程序核心
│   ├── core/                     # 核心模块
│   │   ├── application.py        # 应用程序核心
│   │   ├── service_container.py  # 服务容器(依赖注入)
│   │   ├── event_bus.py         # 事件总线
│   │   ├── config_manager.py    # 配置管理
│   │   └── logger.py           # 日志系统
│   ├── ui/                       # 用户界面
│   │   ├── main/               # 主窗口模块
│   │   │   ├── main_window.py   # 主窗口
│   │   │   ├── components/      # 主窗口组件
│   │   │   ├── layouts/        # 布局组件
│   │   │   └── pages/          # 页面组件
│   │   ├── common/             # 公共UI组件
│   │   │   └── widgets/        # 可复用组件
│   │   └── theme/             # 主题系统
│   ├── services/                # 业务服务
│   ├── models/                  # 数据模型
│   ├── config/                  # 配置文件
│   └── utils/                   # 工具模块
├── tests/                        # 测试文件
├── docs/                         # 文档
└── main.py                      # 程序入口

设计模式

  • 依赖注入: 使用ServiceContainer实现依赖注入
  • 观察者模式: 通过EventBus实现组件间通信
  • 工厂模式: 组件创建使用工厂模式
  • 策略模式: 主题切换和AI服务切换

技术栈

  • 前端框架: PyQt6
  • 架构模式: MVC + 分层架构
  • 设计模式: 依赖注入、观察者、工厂、策略
  • 日志系统: Python logging + 自定义Logger
  • 配置管理: QSettings + JSON
  • 错误处理: 统一错误处理和报告

🚀 快速开始

环境要求

  • Python 3.8+
  • PyQt6
  • 其他依赖见 requirements.txt

安装步骤

  1. 克隆项目

    git clone <repository-url>
    cd CineAIStudio/v2.0
  2. 安装依赖

    pip install -r requirements.txt
  3. 运行程序

    python main.py

使用说明

  1. 启动程序: 运行 main.py 启动应用程序
  2. 页面切换: 使用导航栏或快捷键 Ctrl+1/Ctrl+2 切换页面
  3. 视频编辑: 在视频编辑页面进行专业视频编辑
  4. AI对话: 在AI对话页面与AI助手交互

🎯 主要功能

视频编辑页面

  • 📁 媒体库管理: 管理视频、音频、图片等媒体文件
  • 🎬 视频预览: 实时视频预览和播放控制
  • ⏱️ 时间线编辑: 多轨道时间线编辑
  • 特效系统: 丰富的视频特效和转场
  • ⚙️ 属性面板: 视频参数调整和属性设置

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组件

下阶段计划

  • 🔄 完善视频编辑功能组件
  • 🔄 集成真实的AI服务
  • 🔄 实现项目管理功能
  • 🔄 添加文件导入导出功能
  • 🔄 完善错误处理和日志系统
  • 🔄 添加单元测试
  • 🔄 性能优化和内存管理

🤝 贡献指南

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

开发规范

  • 遵循PEP 8代码风格
  • 使用类型提示
  • 编写文档字符串
  • 添加单元测试

提交规范

  • feat: 新功能
  • fix: 修复bug
  • docs: 文档更新
  • style: 代码格式化
  • refactor: 代码重构
  • test: 测试相关
  • chore: 构建或辅助工具变动

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

🙏 致谢

感谢所有为CineAIStudio项目做出贡献的开发者和用户。


CineAIStudio Team 让视频编辑更智能,让创作更简单

About

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Python 100.0%