7.9 KiB
7.9 KiB
MetaCore 项目总览
🎯 项目简介
MetaCore是一个现代化的项目管理平台，现在提供两个版本：
- Web版本：基于HTML/CSS/JavaScript的浏览器应用
- PyQt5版本：基于Python PyQt5的桌面应用
两个版本功能完全一致，界面设计完全相同，为用户提供了不同平台的选择。
📁 完整项目结构
MetaCore/
├── 📄 Web版本文件
│ ├── index.html # 主页面
│ ├── script.js # JavaScript逻辑
│ ├── styles.css # 样式表
│ └── test-cards.html # 测试页面
│
├── 🐍 PyQt5版本文件
│ ├── main.py # 主程序入口
│ ├── run_app.py # 启动脚本
│ ├── requirements.txt # 依赖包
│ ├── data/ # 数据模块
│ │ ├── __init__.py
│ │ ├── project_manager.py # 项目管理器
│ │ └── projects.json # 数据文件（自动生成）
│ └── ui/ # 界面模块
│ ├── __init__.py
│ ├── main_window.py # 主窗口
│ ├── sidebar.py # 侧边栏
│ ├── project_area.py # 项目区域
│ ├── project_card.py # 项目卡片
│ ├── create_project_dialog.py # 创建对话框
│ ├── import_project_dialog.py # 导入对话框
│ └── styles.py # 样式定义
│
└── 📚 文档文件
├── README_PyQt5.md # PyQt5版本说明
├── 快速开始.md # 快速开始指南
├── 安装PyQt5指南.md # 安装指南
├── 功能对比说明.md # 版本对比
├── PyQt5版本完成总结.md # 完成总结
├── 创建项目1-3布局说明.md # 布局优化说明
├── 创建项目布局优化说明.md # 布局说明
├── 项目卡片更新说明.md # 卡片更新说明
├── 功能演示.md # 功能演示
└── 项目总览.md # 本文档
🚀 快速开始
Web版本
# 直接在浏览器中打开
open index.html
PyQt5版本
# 1. 安装依赖
pip install PyQt5
# 2. 运行应用
python main.py
✨ 核心功能
🎨 界面特性
- ✅ 现代化设计：深色主题，简洁美观
- ✅ 响应式布局：自适应不同屏幕尺寸
- ✅ 三段式卡片：标题+图片+时间的经典布局
- ✅ 2:1对话框：创建项目的黄金比例布局
- ✅ 悬停效果：丰富的交互反馈
📊 项目管理
- ✅ 项目创建：多种模板选择
- ✅ 项目导入：支持文件拖拽
- ✅ 项目编辑：重命名、描述修改
- ✅ 项目删除：安全删除确认
- ✅ 收藏功能：快速标记重要项目
🔍 搜索过滤
- ✅ 实时搜索：按项目名称搜索
- ✅ 类型过滤：按项目类型筛选
- ✅ 收藏过滤：查看收藏的项目
- ✅ 时间排序：按创建时间排序
👁️ 视图模式
- ✅ 网格视图：卡片式展示
- ✅ 列表视图：紧凑式展示
- ✅ 视图切换：一键切换显示模式
🎯 版本对比
| 特性 | Web版本 | PyQt5版本 |
|---|---|---|
| 运行环境 | 浏览器 | 桌面应用 |
| 安装要求 | 无 | Python + PyQt5 |
| 性能表现 | 依赖浏览器 | 原生性能 |
| 文件操作 | 受限 | 完全访问 |
| 离线使用 | 支持 | 完全支持 |
| 系统集成 | 有限 | 完全集成 |
| 更新方式 | 刷新页面 | 重启应用 |
🛠️ 技术栈
Web版本
- 前端：HTML5 + CSS3 + JavaScript ES6
- 样式：CSS Grid + Flexbox
- 图标：Font Awesome + Emoji
- 存储：localStorage
PyQt5版本
- 框架：Python 3.7+ + PyQt5
- 架构：MVC模式 + 信号槽机制
- 界面：Qt样式表 + 自定义组件
- 存储：JSON文件
📈 开发历程
第一阶段：Web版本开发
- ✅ 基础界面搭建
- ✅ 项目卡片设计
- ✅ 侧边栏导航
- ✅ 创建项目功能
- ✅ 搜索过滤功能
第二阶段：界面优化
- ✅ 三段式卡片布局
- ✅ 1/3布局对话框
- ✅ 悬停效果优化
- ✅ 响应式设计
- ✅ 文件选择集成
第三阶段：PyQt5移植
- ✅ 架构设计
- ✅ 组件开发
- ✅ 样式移植
- ✅ 功能实现
- ✅ 测试优化
🎨 设计亮点
1. 三段式项目卡片
┌─────────────────┐
│ 标题 ⋮ │ ← 头部：项目名称 + 菜单
├─────────────────┤
│ 🏭 │ ← 中部：项目图标 + 类型
│ 工业项目 │
├─────────────────┤
│ 2024-06-08 15:56│ ← 底部：创建时间
└─────────────────┘
2. 2:1创建对话框
┌─────────────────────────────────────┐
│ 创建新的项目 ✕ │
├─────────────────────────────────────┤
│ 模板选择 (2/3) │ 项目信息 (1/3) │
│ ┌─────┐ ┌─────┐ │ 项目名称 │
│ │ 📁 │ │ 🏭 │ │ ┌─────────────┐ │
│ │空白 │ │工业 │ │ │ │ │
│ └─────┘ └─────┘ │ └─────────────┘ │
│ ┌─────┐ ┌─────┐ │ 项目描述 │
│ │ 🥽 │ │ 💧 │ │ ┌─────────────┐ │
│ │VR │ │智能 │ │ │ │ │
│ └─────┘ └─────┘ │ └─────────────┘ │
└─────────────────────────────────────┘
3. 深色主题配色
- 主背景：#1a1a1a（深黑）
- 卡片背景：#2a2a2a（深灰）
- 边框色：#3a3a3a（中灰）
- 强调色：#8b5cf6（紫色）
- 文字色：#ffffff（白色）
🔮 未来规划
短期目标
- 添加项目模板管理
- 实现真实的文件操作
- 添加项目统计功能
- 支持主题切换
中期目标
- 集成版本控制系统
- 添加协作功能
- 实现云同步
- 开发移动端版本
长期目标
- 构建插件生态
- 企业级功能
- AI辅助功能
- 跨平台统一
📞 技术支持
文档资源
- 📖 详细说明：README_PyQt5.md
- 🚀 快速开始：快速开始.md
- 🔧 安装指南：安装PyQt5指南.md
- 📊 功能对比：功能对比说明.md
常见问题
- PyQt5安装问题：参考安装PyQt5指南.md
- 功能使用问题：参考快速开始.md
- 版本选择问题：参考功能对比说明.md
🏆 项目成就
✅ 完成的里程碑
- 完整功能实现：100%复制Web版本功能
- 视觉效果还原：像素级还原界面设计
- 性能优化：提供更好的桌面体验
- 文档完善：提供完整的使用文档
🎯 技术价值
- 展示了Web到桌面的完整转换过程
- 提供了PyQt5开发的最佳实践
- 建立了可复用的组件架构
- 创建了完整的文档体系
🎉 MetaCore项目现在提供了Web和桌面两种完整的解决方案！
无论您喜欢在浏览器中使用还是作为桌面应用运行，都能获得完全相同的功能和体验。选择最适合您的版本，开始管理您的项目吧！