TZshot/
├─ src/
│  ├─ app/
│  ├─ widgets/
│  ├─ model/
│  ├─ viewmodel/
│  ├─ paint_board/
│  ├─ shortcut_key/
│  ├─ ocr/
│  └─ ai_call/
├─ i18n/
├─ resource/
├─ thirdpart/
└─ CMakeLists.txt

环境要求

CMake >= 3.16
Qt 6.x
C++17 编译器

Windows:

MSVC 2019/2022（推荐使用 Qt Creator 对应 Kit）

Linux:

X11/xcb 相关开发库

构建与运行

方式一：Qt Creator（推荐）

打开项目根目录 CMakeLists.txt
选择 Qt 6 Kit
Configure -> Build -> Run

方式二：命令行

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

运行（Windows，Visual Studio 生成器）：

./build/Release/TZshot.exe

运行（Windows，Qt Creator + Ninja 常见路径）：

./build/<kit-name>/TZshot.exe

运行（Linux，路径以实际生成为准）：

./build/TZshot

OCR 依赖说明（Windows）

首次配置/构建时，CMake 会自动从 GitHub 拉取并构建 Leptonica、Tesseract（输出到项目根目录 thirdpart/ocr-install）。
项目默认不自动下载语言数据文件（tessdata）。
请手动准备并放置：
- thirdpart/ocr-install/share/tessdata/chi_sim.traineddata
- thirdpart/ocr-install/share/tessdata/eng.traineddata
若缺少上述文件，运行时会出现 Tesseract Init 失败：未找到可用 tessdata。

默认快捷键

Alt + A: 截图
Alt + S: 截图并保存
Alt + P: 贴图到桌面
Alt + Q: 显示/隐藏窗口

配置项（QSettings）

AI
- AI/apiKey
- AI/selectedModel
快捷键
- Shortcuts/screenshot
- Shortcuts/screenshotSave
- Shortcuts/sticky
- Shortcuts/toggle
通用
- App/language（zh_CN / en）
- ImageSaver/savePath

已知说明

Linux 全局快捷键目前基于 X11（暂不覆盖 Wayland 原生实现）
部分浮层/置顶窗口交互仍以 Windows 体验最完整
GIF、OCR 与长截图能力仍可继续做跨平台增强

贡献与安全提示

请勿提交任何真实的 API Key、令牌或个人隐私数据。
提交前建议自查编码与换行：UTF-8（无 BOM） + LF。
若修改第三方依赖，请同步补充其许可证说明。

English

License

This project is licensed under GNU General Public License v3.0 (GPL-3.0-only).
See LICENSE in the repository root.

Overview

TZshot is a screenshot and pin-image utility built with Qt 6 Widgets + C++.
It supports multi-screen capture, region annotations, sticky image editing, long screenshots, OCR, GIF recording, global shortcuts, tray integration, and AI image editing.

Key Features

Multi-screen capture (virtual desktop coordinates)
Capture overlay:
- Region selection, moving, and 8-direction resize
- Magnifier preview with pixel color readout
- Enter performs the default action, Esc cancels
Annotation tools:
- Rectangle, circle, arrow, freehand pen
- Text annotation (text content + background toggle)
- Number annotation (auto-increment supported)
- Mosaic (adjustable intensity)
- Blur
- Undo
Output actions:
- Copy to clipboard
- Save to file
- Pin to desktop (sticky window)
- OCR
- Long screenshot
- GIF recording
Sticky window:
- Drag, opacity control
- Zoom, rotate, mirror, reset-to-1:1
- Annotate, OCR, context menu actions
- Apply-and-copy / save-as / overwrite workflow
Long screenshot controller with floating preview
GIF recording for a selected region, with save folder auto-open after encoding
OCR result window
Configurable global shortcuts (persisted)
System tray menu
Chinese/English UI switching (app restarts after switching)
AI image editing with configurable model/API key

Tech Stack

C++17
Qt 6 (Core / Gui / Widgets / Network / Concurrent / LinguistTools)
CMake
Global shortcuts:
- Windows: RegisterHotKey
- Linux(X11): xcb_grab_key

Current Architecture

src/app/
- App bootstrap, service wiring, and widget runtime management
src/widgets/
- Capture overlay, sticky windows, settings dialog, OCR result window, about dialog, and related UI
src/viewmodel/
- Business logic for capture, sticky images, long screenshot, GIF, OCR, storage, and AI
src/model/
- Desktop snapshot and persisted app settings
src/paint_board/shape/
- Annotation shape implementations
resource/
- Icons and QSS resources
i18n/
- Chinese and English translations

Project Structure

TZshot/
├─ src/
│  ├─ app/
│  ├─ widgets/
│  ├─ model/
│  ├─ viewmodel/
│  ├─ paint_board/
│  ├─ shortcut_key/
│  ├─ ocr/
│  └─ ai_call/
├─ i18n/
├─ resource/
├─ thirdpart/
└─ CMakeLists.txt

Requirements

CMake >= 3.16
Qt 6.x
C++17 compiler

Windows:

MSVC 2019/2022 (Qt Creator kit recommended)

Linux:

X11/xcb development libraries

Build & Run

Option 1: Qt Creator (Recommended)

Open CMakeLists.txt in project root
Select a Qt 6 kit
Configure -> Build -> Run

Option 2: Command Line

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release

Run on Windows:

./build/Release/TZshot.exe

Run on Windows with a typical Qt Creator + Ninja kit:

./build/<kit-name>/TZshot.exe

Run on Linux (path may vary by generator):

./build/TZshot

OCR Notes (Windows)

On first configure/build, CMake auto-fetches and builds Leptonica and Tesseract from GitHub into thirdpart/ocr-install (project root).
This project does not auto-download language data (tessdata).
Please add these files manually:
- thirdpart/ocr-install/share/tessdata/chi_sim.traineddata
- thirdpart/ocr-install/share/tessdata/eng.traineddata
If they are missing, OCR will fail at runtime with Tesseract Init failed: no usable tessdata found.

Default Shortcuts

Alt + A: Screenshot
Alt + S: Screenshot and Save
Alt + P: Pin to Desktop
Alt + Q: Show/Hide Window

Configuration (QSettings)

AI
- AI/apiKey
- AI/selectedModel
Shortcuts
- Shortcuts/screenshot
- Shortcuts/screenshotSave
- Shortcuts/sticky
- Shortcuts/toggle
General
- App/language (zh_CN / en)
- ImageSaver/savePath

Notes

Linux global shortcuts currently rely on X11 (no native Wayland implementation yet)
Windows currently has the most complete floating-window experience
GIF, OCR, and long-screenshot flows still have room for more cross-platform refinement

Contributing & Security

Do not commit real API keys, tokens, or private data.
Keep source files in UTF-8 (no BOM) with LF line endings.
When adding/updating third-party dependencies, include their license notices.

README.md Unescape Escape

TZshot

中文

开源许可

项目简介

主要功能

技术栈

当前架构

目录结构