Files

congsh c4a77f8aa4 feat: 实现CutThenThink P0阶段核心功能

项目初始化
- 创建完整项目结构（src/, data/, docs/, examples/, tests/）
- 配置requirements.txt依赖
- 创建.gitignore

P0基础框架
- 数据库模型：Record模型，6种分类类型
- 配置管理：YAML配置，支持AI/OCR/云存储/UI配置
- OCR模块：PaddleOCR本地识别，支持云端扩展
- AI模块：支持OpenAI/Claude/通义/Ollama，6种分类
- 存储模块：完整CRUD，搜索，统计，导入导出
- 主窗口框架：侧边栏导航，米白配色方案
- 图片处理：截图/剪贴板/文件选择/图片预览
- 处理流程整合：OCR→AI→存储串联，Markdown展示，剪贴板复制
- 分类浏览：卡片网格展示，分类筛选，搜索，详情查看

技术栈
- PyQt6 + SQLAlchemy + PaddleOCR + OpenAI/Claude SDK
- 共47个Python文件，4000+行代码

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

2026-02-11 18:21:31 +08:00

5.1 KiB

Raw Blame History

主窗口框架实现文档

概述

P0-6 任务已完成，实现了应用程序的主窗口框架，包括侧边栏导航、主内容区域和米白色配色方案。

已实现的文件

1. `src/gui/main_window.py`

主窗口实现，包含以下组件：

类

MainWindow: 主窗口类
- 窗口标题："CutThenThink - 智能截图管理"
- 默认大小：1200x800
- 最小大小：1000x700
NavigationButton: 导航按钮类
- 支持图标和文本
- 可选中状态
- 悬停效果

功能

侧边栏导航
- 📷 截图处理
- 📁 分类浏览
- ☁️ 批量上传
- ⚙️ 设置
主内容区域
- 使用 QStackedWidget 实现页面切换
- 四个独立页面：截图处理、分类浏览、批量上传、设置
- 响应式布局，支持窗口大小调整
页面设计
- 截图处理页面：欢迎卡片、快捷操作按钮
- 分类浏览页面：浏览功能介绍
- 批量上传页面：上传功能介绍
- 设置页面：使用滚动区域，包含 AI、OCR、云存储、界面配置

2. `src/gui/styles/colors.py`

颜色方案定义，采用温暖的米白色系：

# 主色调 - 米白色系
background_primary: "#FAF8F5"    # 主背景色
background_secondary: "#F0ECE8"  # 次要背景色
background_card: "#FFFFFF"       # 卡片背景色

# 文字颜色
text_primary: "#2C2C2C"          # 主要文字
text_secondary: "#666666"        # 次要文字

# 强调色 - 温暖的棕色系
accent_primary: "#8B6914"        # 主要强调色 - 金棕
accent_secondary: "#A67C52"      # 次要强调色 - 驼色

类和函数

ColorScheme: 颜色方案数据类
COLORS: 全局颜色方案实例
get_color(name): 获取颜色值的快捷函数

3. `src/gui/styles/theme.py`

主题样式表（QSS），定义完整的 UI 样式：

样式覆盖

主窗口
侧边栏和导航按钮
主内容区域
按钮（主要/次要）
输入框和文本框
下拉框
滚动条
分组框
标签页
复选框和单选框
进度条
菜单
列表
状态栏
工具提示

类和方法

ThemeStyles: 主题样式表类
- get_main_window_stylesheet(): 获取主窗口样式表
- apply_style(widget): 应用样式到部件

4. `src/gui/styles/init.py`

样式模块的导出接口，统一导出：

ColorScheme
COLORS
get_color
ThemeStyles

5. `src/gui/init.py`

GUI 模块导出，使用延迟导入避免 PyQt6 依赖问题：

样式模块直接导入
主窗口通过 get_main_window_class() 延迟导入

使用示例

基本使用

from PyQt6.QtWidgets import QApplication
from src.gui import get_main_window_class

# 创建应用程序
app = QApplication([])

# 获取主窗口类并创建实例
MainWindow = get_main_window_class()
window = MainWindow()
window.show()

app.exec()

直接使用样式

from src.gui.styles import COLORS, ThemeStyles
from PyQt6.QtWidgets import QPushButton

# 使用颜色
button = QPushButton("按钮")
button.setStyleSheet(f"""
    QPushButton {{
        background-color: {COLORS.accent_primary};
        color: {COLORS.button_primary_text};
    }}
""")

# 应用完整主题
from src.gui import get_main_window_class
MainWindow = get_main_window_class()
window = MainWindow()
window.show()

设计特点

1. 米白色配色方案

温暖、舒适的视觉体验
适合长时间使用
专业的界面呈现

2. 模块化设计

样式与逻辑分离
颜色统一管理
易于维护和扩展

3. 响应式布局

自适应窗口大小
支持不同屏幕分辨率
优雅的空间利用

4. 完整的样式覆盖

所有 Qt 部件都有统一样式
支持悬停、选中、禁用等状态
符合现代 UI 设计规范

后续扩展

短期（P1 任务）

实现截图处理页面的实际功能
添加分类浏览页面的内容展示
实现批量上传功能
完善设置页面的配置项

长期

添加深色主题支持
实现自定义主题
添加动画效果
国际化支持

测试

运行测试脚本查看效果（需要安装 PyQt6）：

# 安装依赖
pip install -r requirements.txt

# 运行测试
python3 test_main_window.py

技术栈

GUI 框架: PyQt6
样式: QSS (Qt Style Sheets)
Python 版本: 3.8+

注意事项

需要 PyQt6 才能运行主窗口
样式模块可以独立导入，不需要 PyQt6
主窗口类使用延迟导入，避免模块加载时的依赖问题
所有颜色和样式统一在 styles 模块中管理

5.1 KiB Raw Blame History Unescape Escape