StickySnap

把截图钉在桌面上。
Pin a screenshot to your desktop.

Snipaste 式截图 + 贴图工具 · Windows 原生 + macOS Qt 6 预览 · 免费无广告 · 纯本地

官网 · 下载 · 产品文档 · 问题反馈

---

它是什么

StickySnap 是一个把「贴图」当作第一优先级刚需的截图工具。核心循环只有三个动作：

F1 截图 → Enter 贴到桌面 → F3 把剪贴板贴出来

贴图是常驻的桌面工作台：可拖动、缩放、调透明度、鼠标穿透，重启后自动恢复。所有处理都在本地完成，不联网、无广告、无账号。

English: StickySnap is a Snipaste-style screenshot and pin tool. The Windows build is native C++17/Win32; the cross-platform build uses C++20 and Qt 6. Press F1 to capture with window snapping, Enter to pin to the desktop, F3 to pin the clipboard. Pins persist across reboots. Local-only, free, no ads.

平台与状态

平台	实现	状态
Windows 10/11 x64	C++17 / Win32	✅ M0 主力版本，功能最完整
macOS 14+	C++20 / Qt 6.5+	🚧 Qt 预览版，目前从源码构建
Linux	Qt 6	⬜ 规划中

Qt 预览版与 Windows 版共享同一套选区、标注、设置和会话模型（portable/src/core）；Windows 原生版仍是参考实现。

当前状态：M0

能力	Windows 原生	macOS Qt 预览
全局热键截图 / 贴剪贴板	✅ F1 / F3	✅ ⌃⌘A / F3，可在设置中修改
全屏冻结遮罩选区（多显示器、HiDPI）	✅	✅
窗口检测高亮（单击吸附）	✅	✅
放大镜 + 十六进制取色 + 尺寸提示	✅	✅
Enter/双击贴图，复制、取消、选区微调	✅	✅
贴图窗：置顶、拖动、滚轮缩放、透明度、穿透	✅	✅
贴图右键菜单：穿透 / 复制 / 另存为 / 关闭	✅	✅
贴图不进入后续截图	✅	—
标注工具栏（6 种工具 + 撤销 + 4 个动作）	✅	✅
标注引擎：矩形/椭圆/箭头/画笔/荧光笔/马赛克，9 色 × 3 粗细，Ctrl+Z 撤销	✅	✅
会话持久化（贴图图片 + 位置自动恢复）	✅	✅
托盘菜单 + Explorer 重启自动恢复图标	✅	✅（macOS 菜单栏）
GIF/APNG 贴图、贴图上标注、标注二次编辑、UI 元素级吸附	⬜ M1	⬜ M1

下载

• Windows 体验版：Releases（推送 v* tag 后由 CI 自动构建并发布）
• Windows CI 产物：windows-build 每次 push 都会上传 StickySnap-windows-x64.zip（需登录 GitHub 下载）
• macOS Qt 预览版：目前从源码构建，见下方「macOS（Qt 6）」。尚未提供签名/公证的安装包。

Windows 可执行文件未做代码签名，首次运行若被 SmartScreen 拦截，选择「更多信息 → 仍要运行」。macOS 首次截图需要在「系统设置 → 隐私与安全性 → 屏幕录制」中授权 StickySnap。

使用

1. 运行 StickySnap.exe（Windows）或 StickySnap.app（macOS），无主窗口，托盘/菜单栏出现图标
2. F1（macOS 为 ⌃⌘A）：进入截图 → 拖拽选区（或单击高亮窗口）→ Enter 贴图 / Ctrl+C（macOS ⌘C）复制 / Esc 取消
3. F3：把剪贴板中的图片直接贴上桌面
4. 贴图上：拖动移动、滚轮缩放、Ctrl+滚轮（macOS ⌘+滚轮）调透明度、右键菜单、双击关闭
5. 重启后贴图自动恢复

快捷键

按键（Windows）	按键（macOS）	作用
F1	⌃⌘A	截图（拖拽选区 / 单击吸附窗口）
Enter / 双击	Enter / 双击	把当前选区贴到桌面
Ctrl+C	⌘C	复制选区（含标注）到剪贴板
Ctrl+Z	⌘Z	撤销上一笔标注
Esc	Esc	取消截图
F3	F3	把剪贴板图片贴到桌面
Ctrl+滚轮	⌘+滚轮	调整贴图透明度

macOS 上功能键若被系统占用，可在「系统设置 → 键盘 → 键盘快捷键」中调整，或在 StickySnap 设置里改成其它组合键。

构建

Windows（MSVC）

build-local.bat        :: 需要 VS Build Tools（vcvars64），产物 build\StickySnap.exe

Windows（CMake / MinGW-w64）

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

MinGW 手动编译：

windres res/app.rc -O coff -o app_res.o
g++ -std=c++17 -O2 -municode -mwindows src/*.cpp app_res.o -o StickySnap.exe ^
  -luser32 -lgdi32 -lshell32 -ldwmapi -lmsimg32 -lcomdlg32 -lgdiplus -lole32

macOS（Qt 6）

需要 macOS 14+、Xcode Command Line Tools、CMake 3.21+ 和 Qt 6.5+：

brew install qt cmake
cmake -S portable -B build-qt -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_PREFIX_PATH="$(brew --prefix qt)"
cmake --build build-qt -j
ctest --test-dir build-qt --output-on-failure
open build-qt/StickySnap.app

调试时可用 --capture 和 --pin-clipboard 参数直接触发截图/贴剪贴板。

CI

工作流	触发	作用
windows.yml	push / PR / 手动	构建 Windows 版并上传 zip artifact
release.yml	推送 v* tag	构建并发布 GitHub Release
pages.yml	site/ 变更 / 手动	部署落地页到 GitHub Pages

架构

src/                 Windows 原生版（Win32）
  main.cpp           入口：单实例互斥、Per-Monitor-V2 DPI、COM/GDI+ 初始化
  app.{h,cpp}        主窗口（隐藏）、热键调度、模块编排
  capture.{h,cpp}    虚拟屏幕一次性捕获（GDI BitBlt，32bpp top-down DIB）
  overlay.{h,cpp}    冻结遮罩选区窗（窗口检测/放大镜/选区标注）
  toolbar.{h,cpp}    选区旁图标工具栏
  pin.{h,cpp}        贴图窗（layered window：缩放/透明度/穿透/菜单）
  pinmanager.{h,cpp} 贴图集合管理 + 延迟保存
  session.h          会话读写（index.txt，崩溃安全：tmp + MoveFileEx 替换）
  clipboard.{h,cpp}  CF_DIB + PNG 双格式剪贴板图片读写
  tray.{h,cpp}       托盘图标与菜单
  settings.h         用户设置
  gdiutil.h          GDI+ 封装（PNG/JPEG 编解码）
  config.h           常量（类名/热键/缩放参数/菜单 ID/品牌色）
  util.h             DPI、单实例、%APPDATA%、ExcludeFromCapture 等

portable/            Qt 6 跨平台版
  src/core/          选区模型、标注模型、设置、会话（与 UI 无关）
  src/ui/            Qt 遮罩窗、工具栏、贴图窗、托盘、设置对话框
  src/platform/      平台抽象；macOS 已实现（ScreenCaptureKit / Carbon 热键）
  tests/             Qt Test 单元测试与离屏渲染测试

两个关键设计：

• 坐标一律使用物理像素（Windows 版声明 Per-Monitor-V2 aware），多屏与 HiDPI 下不串位
• 贴图图片在创建时即落盘，会话文件只存引用——进程崩溃也不丢贴图

路线图

• M0（当前）：贴图成立的最小集，见上表
• M1：贴图标注、GIF/APNG 动图贴图、文本/颜色贴图、贴图分组、热键自定义、UI 元素级检测（UI Automation）、OCR（Windows.Media.Ocr）、macOS Qt 预览与 Windows 功能对齐
• M2：虚拟桌面绑定、Solo 模式、批量操作、AI 功能（按 PRD）、Linux（Qt 6）
• 平台：Windows ✅ → macOS 🚧（Qt 预览）→ Linux ⬜

详细验收标准见 docs/PRD-M0.md。

项目结构

.github/workflows/   CI：Windows 构建、Release、Pages
assets/              品牌源图与生成的应用图标
site/                落地页（GitHub Pages 源目录）
src/                 Windows 原生版源码
portable/            Qt 6 跨平台版（macOS 平台层已实现）
res/                 Windows 图标与工具栏资源
docs/                产品文档
test/                手工测试与截图脚本
tools/               图标与品牌资源生成脚本

品牌资源统一由 python3 tools/make_brand_assets.py 从 assets/logo.png 生成。

反馈

遇到问题或有功能建议，欢迎开 Issue。反馈截图类问题时，附上系统版本、显示器缩放比例和复现步骤会很有帮助。

许可

当前仓库尚未添加开源许可证文件；在补充 LICENSE 之前，保留所有权利。