截图 & 剪切板管理软件 — 截图吧
项目简介
基于 PySide6和Rust 的截图软件和剪切板管理的windows平台软件。
支持区域截图、窗口智能识别、GIF录制、长截图拼接、OCR文字识别、图像钉图、翻译等功能，并内置了完整的剪切板历史管理系统，不限图片来源可以联动截图模块生成钉图或者提取文字。
编译后单文件大小大约37MB.占用内存极低,无任何联网操作
安装前置依赖
本项目依赖4个自制 Rust 库，必须先安装这些包才能运行程序。
1. 创建并激活 Python 3.11 虚拟环境
python -m venv venv311
# Windows:
venv311\Scripts\activate2. 安装自制 Rust 包（必须）
pip install gifrecorder-0.2.1-cp311-cp311-win_amd64.whl
pip install longstitch-0.3.8-cp311-cp311-win_amd64.whl
pip install pyclipboard-0.3.13-cp311-cp311-win_amd64.whl
pip install windows_media_ocr-0.3.1-cp311-cp311-win_amd64.whl| 包名 | 版本 | 功能 |
|---|---|---|
gifrecorder |
0.2.1 | GIF/视频合成编码器 |
longstitch |
0.3.8 | 长截图拼接算法 |
pyclipboard |
0.3.13 | 剪切板底层操作 |
windows_media_ocr |
0.3.1 | Windows Media OCR Api和 oneocr.dll调用逻辑封装 |
注意： 这些
.whl文件仅适用于 Windows x86_64 + Python 3.11 环境。请勿安装到全局 Python 中。
3. 安装 Python 依赖
pip install PySide6==6.11.0
pip install PySide6-Fluent-Widgets==1.11.1
pip install PySideSix-Frameless-Window==0.8.1
pip install pillow==12.1.1
pip install mss==10.1.0
pip install pynput==1.8.1
pip install pywin32==311
pip install darkdetect==0.8.0
pip install emoji==2.15.0
pip install av==17.0.0
pip install colorama==0.4.6开发/构建依赖（可选）：
pip install pytest==9.0.2 pytest-qt==4.5.0 # 测试
pip install pyinstaller==6.17.0 # 打包
pip install maturin==1.12.6 # Rust 库构建4. 运行程序
cd main
python main_app.py目录结构总览
# 项目根目录
├── gifrecorder-0.2.1-cp311-cp311-win_amd64.whl # GIF录制 Rust 预编译包
├── longstitch-0.3.8-cp311-cp311-win_amd64.whl # 长截图拼接 Rust 预编译包
├── pyclipboard-0.3.13-cp311-cp311-win_amd64.whl # 剪切板 Rust 预编译包
├── windows_media_ocr-0.3.1-cp311-cp311-win_amd64.whl # OCR Rust 预编译包
│
├── main/ # Python 主程序
│ ├── main_app.py # 应用入口，系统托盘、全局快捷键、生命周期管理
│ ├── compile_translations.py # 翻译文件编译工具（.xml → .qm）
│ │
│ ├── canvas/ # 画布模块 — 图形编辑核心
│ ├── capture/ # 截图捕获模块 — 屏幕截图与窗口识别
│ ├── clipboard/ # 剪切板管理模块 — 历史记录、分组/快速启动、导入导出、搜索
│ ├── core/ # 核心基础模块 — 启动引导、日志、资源、主题、国际化、快捷键
│ ├── gif/ # GIF录制模块 — 屏幕录制、编辑、回放、导出
│ ├── ocr/ # OCR模块 — 多引擎文字识别
│ ├── pin/ # 钉图模块 — 截图置顶、编辑、OCR、翻译
│ ├── settings/ # 设置模块 — 统一配置管理
│ ├── stitch/ # 长截图拼接模块 — 滚动截图、自动拼接
│ ├── tools/ # 绘图工具模块 — 笔、矩形、箭头、文字等
│ ├── translation/ # 翻译模块 — DeepL API 翻译服务
│ ├── translations/ # 语言资源 — 中/英/日语言文件
│ ├── ui/ # 用户界面模块 — 通用UI组件库
│ └── tests/ # 测试模块 — 单元测试与集成测试
│
├── rust_libs/ # Rust 库源码（可自行编译）
│ ├── gifrecorder/ # GIF/视频合成编码器源码
│ ├── longstitch/ # 长截图拼接算法源码
│ ├── pyclipboard/ # 剪切板底层操作源码
│ └── windows_media_ocr/ # Windows Media OCR 封装源码
│
└── svg/ # SVG 图标资源模块详细说明
canvas/ — 画布模块
图形编辑画布系统，提供场景管理、视图渲染、图形项选择和撤销/重做功能。
canvas/
├── __init__.py
├── scene.py # CanvasScene — 画布场景，继承 QGraphicsScene
├── view.py # CanvasView — 画布视图，继承 QGraphicsView，负责渲染和交互
├── selection_model.py # SelectionModel — 管理被选中的图形项，支持多选
├── undo.py # CommandUndoStack — 撤销/重做栈，支持添加、删除、批量删除、编辑命令
├── smart_edit_controller.py # SmartEditController — 智能编辑控制器，处理选择与编辑模式切换
├── handle_editor.py # LayerEditor / EditHandle — 图层编辑器，提供控制点拖拽编辑
└── items/ # 绘制图形项
├── __init__.py
├── drawing_items.py # StrokeItem / RectItem / EllipseItem / ArrowItem / TextItem / NumberItem — 所有绘制项目
├── background_item.py # BackgroundItem — 选区背景底图
└── selection_item.py # SelectionItem — 选中项的边界显示框核心功能：
- 基于 Qt Graphics View Framework 的画布系统
- 支持自由绘制、矩形、椭圆、箭头、文字、编号等图形项
- 完整的撤销/重做机制（基于 QUndoStack）
- 智能编辑控制器实现选择与绘制模式无缝切换
- 控制点编辑器支持图形变换
capture/ — 截图捕获模块
屏幕截图和窗口智能识别的核心服务。
capture/
├── __init__.py
├── capture_service.py # CaptureService — 截图服务，屏幕截图核心逻辑
└── window_finder.py # WindowFinder — 窗口查找器，智能选择窗口，识别光标下的窗口核心功能：
- 全屏截图和区域截图
- 智能窗口识别与选择（自动排除窗口阴影）
- 光标位置窗口检测
clipboard/ — 剪切板管理模块
类似 Ditto 的剪切板历史管理系统，现已拆分为 controllers、core、services、ui 四层结构，支持文本、图片、HTML、文件等类型。
不仅能保存截图历史，还提供独立的三栏管理窗口用于维护分组与内容，并可从历史记录生成钉图。
clipboard/
├── __init__.py
├── controllers/ # 控制层 — 历史加载、粘贴流程、右键菜单、选择状态
│ ├── clipboard_controller.py # ClipboardController — 历史加载、粘贴和菜单逻辑
│ ├── selection_manager.py # SelectionManager — 列表选择状态管理
│ └── __init__.py
├── core/ # 数据层 — pyclipboard 封装、数据模型、分组类型
│ ├── manager.py # ClipboardManager — 数据存储、监听、粘贴 API
│ ├── models.py # ClipboardItem / Group — 剪切板数据模型
│ ├── enums.py # GroupType — 分组类型定义
│ └── __init__.py
├── services/ # 服务层 — 文件 payload、分组规则、导入导出、保存逻辑
│ ├── file_payload_service.py # file 类型 JSON payload 与旧格式兼容
│ ├── group_service.py # 分组图标、命名与删除确认辅助
│ ├── import_export_service.py # 文本条目 CSV 导入/导出
│ └── manage_dialog_service.py # 管理窗口保存逻辑
├── ui/
│ ├── dialogs/
│ │ └── manage_dialog.py # 三栏管理窗口：分组、内容、导入导出
│ ├── forms/
│ │ ├── group_form.py
│ │ ├── text_content_form.py
│ │ ├── file_content_form.py
│ │ ├── import_export_form.py
│ │ └── group_icon_picker.py
│ ├── mixins/
│ │ └── frameless_mixin.py
│ ├── panels/
│ │ └── setting_panel.py
│ ├── resources/
│ │ └── emoji_data.py
│ ├── theme/
│ │ ├── themes.py
│ │ └── theme_styles.py
│ ├── widgets/
│ │ ├── draggable_list_widget.py
│ │ ├── group_bar.py
│ │ ├── item_delegate.py
│ │ ├── item_widget.py
│ │ └── preview_popup.py
│ └── windows/
│ ├── clipboard_window.py # 历史窗口、搜索、预览与快捷粘贴
│ └── pin_window.py # 从历史条目创建钉图核心功能：
- 监听系统剪切板变化，自动保存历史记录
- 支持文本、图片、HTML、文件等多种格式
- 支持通用分组、快速启动分组、收藏与搜索
- 独立三栏管理窗口，可编辑分组、文本内容和文件内容
- 文本条目支持 CSV 导入/导出
- 多主题 UI（亮色/暗色等）
- 快捷键快速粘贴历史内容
- 预览弹窗支持大图/长文查看
core/ — 核心基础模块
提供日志、资源加载、主题管理、国际化、快捷键等基础设施。
core/
├── __init__.py
├── bootstrap.py # PreloadManager — 启动引导，环境初始化、DPI感知、单实例控制、链式预加载
├── logger.py # Logger — 文件+控制台日志系统，支持多级别 (debug/info/warning/error/exception)
├── crash_handler.py # install_crash_hooks() — 全局异常和线程异常捕获
├── resource_manager.py # ResourceManager — SVG/图片等资源加载管理
├── theme.py # ThemeManager — 应用级主题颜色管理
├── i18n.py # I18nManager / XmlTranslator / tr() — 国际化管理，多语言支持
├── shortcut_manager.py # HotkeySystem / ShortcutManager — 全局热键和应用内快捷键管理
├── save.py # SaveService — 文件保存服务（自动命名、路径管理）
├── export.py # ExportService — 图像导出服务
├── clipboard_utils.py # copy_image_to_clipboard() — 图像复制到系统剪切板
├── platform_utils.py # DPI感知设置、AppUserModelID、进程管理等 Windows API 工具
├── qt_utils.py # safe_disconnect() — Qt 信号安全断开工具
└── constants.py # 全局常量定义（字体、路径等）核心功能：
- 统一的日志系统，支持文件输出和控制台输出
- 全局崩溃处理，自动捕获未处理异常
- SVG/图片资源统一加载
- 应用级亮色/暗色主题管理
- XML 格式的多语言国际化系统（中/英/日）
- 全局热键系统（基于 Windows API）和应用内快捷键管理
- 文件保存/导出服务
gif/ — GIF 录制模块
屏幕录制、编辑、回放和导出为 GIF/视频。
gif/
├── __init__.py
├── record_window.py # GifRecordWindow / AppState — 主控制窗口，状态机协调器（管理3层窗口）
├── overlay.py # CaptureOverlay / OverlayMode — 捕获覆盖层，选区调整界面
├── drawing_view.py # GifDrawingView / GifDrawingScene — 录制中绘图编辑视图
├── drawing_toolbar.py # GifDrawingToolbar — 绘制工具栏
├── record_toolbar.py # RecordToolbar — 录制控制工具栏（开始/暂停/停止）
├── frame_recorder.py # FrameRecorder / FrameData / CursorSnapshot — 帧录制器，采样屏幕帧和光标
├── playback_engine.py # PlaybackEngine / PlayState — 回放引擎，帧播放和预览
├── playback_controller.py # PlaybackController — 回放控制器，管理回放UI和导出
├── playback_toolbar.py # PlaybackToolbar / RangeSlider — 回放工具栏，进度条、速度控制
├── composer.py # _ComposeWorker / ComposerProgressDialog — GIF合成，将帧合成为GIF/视频
├── cursor_overlay.py # CursorOverlay — 光标渲染和点击动画
└── _widgets.py # ClickMenuButton / svg_icon() — 自定义小部件核心功能：
- 以状态机模式管理录制流程（选区 → 录制 → 回放 → 导出）
- 三层窗口架构：覆盖层（选区）、绘制层（标注）、工具栏层
- 帧采样录制，支持光标捕获和点击动画
- 回放预览，支持范围裁剪、速度调节
- 导出为 GIF 或视频格式（调用 Rust 库 gifrecorder）
ocr/ — OCR 文字识别模块
支持多种 OCR 引擎的文字识别管理。
ocr/
├── __init__.py
└── ocr_manager.py # OCRManager — 支持 Windows Media OCR 和 oneocr 双引擎核心功能：
- 自动检测可用 OCR 引擎
- 支持 Windows Media OCR（轻量级，系统自带）和 oneocr 高精度引擎（通过 Rust FFI 调用）
- 支持中/英/日文识别
- 单例模式管理，统一的识别接口，返回文字和位置信息
pin/ — 钉图模块
将截图固定在屏幕上，支持编辑、缩放、OCR识别、翻译等。
pin/ ├── init.py ├── pin_window.py # PinWindow — 钉图主窗口，可拖动、缩放、编辑的置顶窗口 ├── pin_canvas_view.py # PinCanvasView — 钉图画布视图（唯一内容渲染者） ├── pin_canvas.py # 钉图画布对象 ├── pin_manager.py # PinManager — 管理所有钉图窗口（单例） ├── pin_toolbar.py # PinToolbar — 钉图工具栏 ├── pin_controls.py # PinControlButtons — 控制按钮（关闭、编辑、复制等） ├── pin_context_menu.py # PinContextMenu — 右键菜单 ├── pin_border_overlay.py # PinBorderOverlay — 边框效果覆盖层 ├── pin_ocr_manager.py # PinOCRManager / _OCRThread — 钉图OCR管理（异步识别） ├── pin_shortcut.py # PinShortcutController — 快捷键控制（普通模式/编辑模式） ├── pin_thumbnail.py # PinThumbnailMode — 缩略图模式 ├── pin_translation.py # PinTranslationHelper — 翻译助手 ├── pin_image_transform.py # PinImageTransform — 图像变换（旋转、翻转等） └── ocr_text_layer.py # OCRTextLayer / OCRTextItem — OCR文字层显示
**核心功能：**
- 截图结果钉在屏幕最前端，支持拖拽移动和滚轮缩放
- 钉图上可直接进行绘制编辑
- 集成 OCR 识别，显示可选中文字层
- 集成翻译功能，可直接翻译钉图中的文字
- 快捷键支持普通模式和编辑模式
---
### settings/ — 设置模块
统一的配置管理系统。
settings/ ├── init.py └── tool_settings.py # ToolSettingsManager / ToolSettings — 管理工具颜色、大小、热键等配置
**核心功能：**
- 单例模式的配置管理器
- 管理各绘图工具的颜色、线宽、字体大小等参数
- 持久化存储到 QSettings
---
### stitch/ — 长截图拼接模块
滚动截图和自动拼接功能。
stitch/ ├── init.py ├── jietuba_long_stitch.py # 长截图拼接算法核心 ├── jietuba_long_stitch_unified.py # 统一长截图接口 ├── scroll_window.py # ScrollCaptureWindow — 滚动截图窗口 └── scroll_toolbar.py # 滚动截图工具栏
**核心功能：**
- 滚动页面并截图，支持横向和竖向
- 基于图像匹配的智能拼接算法（查找重叠区域）
- 统一的长截图接口（调用 Rust 库 longstitch 加速）
---
### tools/ — 绘图工具模块
提供各种绘图工具的实现。
tools/ ├── init.py ├── base.py # Tool / ToolContext — 工具抽象基类和工具上下文 ├── controller.py # ToolController — 工具控制器，管理工具切换和状态 ├── action.py # ActionTools — 动作工具（复制、保存、取消等） ├── pen.py # PenTool — 自由绘制笔工具 ├── rect.py # RectTool — 矩形工具（实心/空心） ├── ellipse.py # EllipseTool — 椭圆工具 ├── arrow.py # ArrowTool — 箭头工具 ├── text.py # TextTool — 文字工具 ├── number.py # NumberTool — 数字编号工具（自动递增） ├── highlighter.py # HighlighterTool — 荧光笔/马赛克工具 ├── cursor.py # CursorTool — 光标/选择工具 ├── eraser.py # EraserTool — 橡皮擦工具 └── cursor_manager.py # CursorManager — 光标样式管理器
**核心功能：**
- 统一的工具基类架构（Tool → 各具体工具）
- 11种绘图工具：笔、矩形、椭圆、箭头、文字、数字、荧光笔、光标、橡皮擦等
- 工具控制器负责工具切换、鼠标事件分发
- 工具上下文（ToolContext）提供场景、视图、设置等依赖注入
---
### translation/ — 翻译模块
基于 DeepL API 的文字翻译服务。
translation/ ├── init.py ├── deepl_service.py # DeepLService / TranslationThread — DeepL API 异步翻译 ├── languages.py # SupportedLanguages — DeepL 支持的语言列表与语言代码 ├── translation_manager.py # TranslationManager — 翻译窗口管理器（单例） ├── translation_dialog.py # TranslationDialog / TranslationLoadingDialog — 翻译结果显示窗口 └── ui/ ├── init.py ├── dialog.py # 翻译对话框UI组件 └── widgets.py # 翻译相关小部件
**核心功能：**
- 调用 DeepL API 进行文字翻译
- 异步翻译，不阻塞 UI
- 翻译结果弹窗显示，支持复制
---
### translations/ — 语言资源
多语言翻译文件存放目录。
translations/ ├── app_zh.xml # 中文翻译源文件 ├── app_en.xml # 英文翻译源文件 ├── app_ja.xml # 日文翻译源文件 ├── app_zh.qm # 中文编译后二进制文件 ├── app_en.qm # 英文编译后二进制文件 └── app_ja.qm # 日文编译后二进制文件
**说明：** `.xml` 为可编辑的翻译源文件，`.qm` 为 Qt 运行时加载的编译文件。修改翻译后需运行 `compile_translations.py` 重新编译。
---
### ui/ — 用户界面模块
通用 UI 组件库，为各模块提供统一的界面元素。
ui/ ├── init.py ├── toolbar.py # Toolbar / _DragHandle — 可拖动工具栏基类 ├── screenshot_window.py # ScreenshotWindow — 截图主窗口（全屏覆盖、选区绘制） ├── dialogs.py # StandardDialog / 对话框函数集 — 确认、警告、信息、错误对话框 ├── magnifier.py # MagnifierOverlay — 放大镜覆盖层（像素级取色） ├── color_picker_dialog.py # ColorPickerDialog — 自定义HSV颜色选择器 ├── color_picker_button.py # ColorPickerButton — 颜色选择按钮 ├── hotkey_edit.py # HotkeyEdit — 全局快捷键编辑框 ├── inapp_key_edit.py # InAppKeyEdit — 应用内快捷键编辑框 ├── mask_overlay.py # 遮罩覆盖层 ├── base_settings_panel.py # BaseSettingsPanel / StepperWidget — 设置面板基类 ├── paint_settings_panel.py # PaintSettingsPanel — 画笔设置面板 ├── shape_settings_panel.py # ShapeSettingsPanel — 形状设置面板 ├── text_settings_panel.py # TextSettingsPanel — 文字设置面板 ├── arrow_settings_panel.py # ArrowSettingsPanel — 箭头设置面板 ├── number_settings_panel.py # 数字工具设置面板 │ ├── settings_ui/ # 应用设置对话框 │ ├── init.py │ ├── dialog.py # SettingsDialog — 主设置对话框（选项卡式） │ ├── components.py # SettingCardGroup / ToggleSwitch — 设置组件库 │ ├── page_appearance.py # 外观设置页（主题、语言等） │ ├── page_capture.py # 截图设置页 │ ├── page_clipboard.py # 剪切板设置页 │ ├── page_hotkey.py # 快捷键设置页 │ ├── page_translation.py # 翻译设置页 │ ├── page_log.py # 日志设置页 │ ├── page_developer.py # 开发者设置页 │ ├── page_misc.py # 杂项设置页 │ ├── page_about.py # 关于页面 │ └── mock_config.py # MockConfig — 测试用模拟配置 │ ├── welcome/ # 首次启动欢迎向导 │ ├── init.py │ ├── wizard.py # WelcomeWizard — 欢迎向导主窗口（多页滑动） │ ├── base_page.py # BasePage — 向导页面基类 │ ├── page1_welcome.py # 欢迎页 │ ├── page2_screenshot.py # 截图快捷键设置页 │ ├── page3_clipboard.py # 剪切板快捷键设置页 │ ├── page4_smart_select.py # 智能选择说明页 │ ├── page5_translation.py # 翻译功能说明页 │ └── page6_finish.py # 完成页 │ └── selection_info/ # 选区信息UI ├── init.py ├── controller.py # 选区信息控制器 ├── panel.py # 选区信息面板（尺寸、坐标） ├── hook_manager.py # 钩子管理 ├── border_shadow.py # 选区边框阴影效果 ├── lock_ratio.py # 锁定宽高比功能 └── rounded_corners.py # 圆角截图功能
**核心功能：**
- 可拖动工具栏基类，所有工具栏继承自此
- 全屏截图窗口，处理选区绘制和交互
- 放大镜、颜色选择器等精细UI组件
- 完整的应用设置对话框（外观/截图/热键/翻译等多个页面）
- 首次启动欢迎向导（6页引导流程）
- 选区信息面板（尺寸显示、宽高比锁定、圆角等）
---
### tests/ — 测试模块
单元测试和集成测试。
tests/ ├── conftest.py # pytest 配置和公共 fixture ├── pytest.ini # pytest 运行配置 ├── run_tests.py # 测试运行脚本 ├── test_undo_stack.py # 撤销栈测试 ├── test_selection_model.py # 选择模型测试 ├── test_clipboard_api.py # 剪切板公共 API 测试 ├── test_clipboard_data.py # 剪切板数据层测试 ├── test_clipboard_manage_dialog.py # 剪切板管理窗口测试 ├── test_clipboard_services.py # 剪切板服务层测试 ├── test_clipboard_themes.py # 主题系统测试 ├── test_clipboard_utils.py # 剪切板工具函数测试 ├── test_core_utils.py # 核心工具类测试 ├── test_crash_handler.py # 崩溃处理测试 ├── test_emoji_data.py # Emoji数据测试 ├── test_gif_data.py # GIF数据结构测试 ├── test_i18n.py # 国际化系统测试 ├── test_resource_manager.py # 资源管理器测试 ├── test_save_service.py # 保存服务测试 ├── test_stitch_algorithm.py # 拼接算法测试 ├── test_theme_manager.py # 主题管理器测试 ├── test_tool_settings.py # 工具设置测试 └── test_tools_base.py # 工具基类测试
---
## 外部 Rust 库依赖
主程序调用了以下自制 Rust 库（位于 `rust_libs/` 目录）：
| 库名 | 功能 |
|------|------|
| `gifrecorder` | GIF/视频合成编码器 |
| `longstitch` | 长截图拼接加速 |
| `pyclipboard` | 剪切板底层操作 |
| `windows_media_ocr` | Windows Media OCR 引擎封装 |
---