L-mimimi/SnapShot

SnapShot 截图助手

一款 Windows 截图工具：截图 · 离线 OCR 文字识别 · 桌面置顶钉图，单文件绿色版，双击即用，无需安装、无需联网。

功能

| 功能 | 说明 |
| --- | --- |
| 截图 | 全局热键 / 托盘菜单，拖拽选择区域，自动保存 + 自动复制到剪贴板 |
| 离线提取文字 (OCR) | 调用 Windows 系统自带 OCR 引擎（Windows.Media.Ocr），完全离线、无需联网、无需捆绑模型；内置图像预处理（小图放大 + 灰度 + 自动对比度增强），小字与中文识别效果显著提升；智能自动识别：含中文的图片自动切换中文引擎，纯英文图片使用英文引擎；识别结果原样保留空格与排版 |
| 修改截图快捷键 | 设置界面点击输入框后直接按下新组合键即可修改（含"识别文字"快捷键） |
| 更改图片存储位置 | 设置界面自由选择存储文件夹，截图自动按时间戳命名保存 |
| 桌面钉图 | 任意图片（文件 / 剪贴板 / 截图）钉在桌面上，始终置顶不被其他窗口覆盖，可拖动、缩放、调透明度 |
| 鼠标穿透 | 钉图可开启鼠标穿透：图片留在桌面最上层但完全不阻挡鼠标操作，点击会落到下方窗口 |

使用方法

1. 双击运行 SnapShot.exe，程序驻留任务栏右下角托盘（蓝色 T 图标）。
2. 截图：按 Ctrl + Alt + A（可在设置中修改），拖拽选择区域后松手，图片自动保存并复制到剪贴板，选区旁出现工具条：
- 识别文字：离线 OCR 提取图中文字（可复制 / 保存为 TXT）
- 复制 / 另存为 / 钉在桌面 / 关闭
3. 截图并识别：按 Ctrl + Alt + S，截图后直接进入文字识别窗口。
4. 钉图：托盘菜单 →「钉住图片…（从文件）」或「钉住剪贴板图片」；也可以把截图通过工具条钉在桌面。
- 拖动图片移动位置；滚轮缩放；双击在"原始大小 / 适应屏幕"间切换
- 右键菜单：鼠标穿透、复制、另存为、放大/缩小、恢复原始大小、适应屏幕、透明度、关闭
- 鼠标穿透：勾选后图片不再响应鼠标（窗口右下角显示"鼠标穿透中"角标），点击会直接作用于下方窗口。恢复方式：托盘菜单「取消所有钉图穿透」或按 Ctrl + Alt + P
- 透明度：右键菜单快速档位（30%~100%）或「自定义…」滑块精确调整（10%~100%），可勾选"设为默认透明度"
- 置顶机制：窗口每 400ms 自动重新锁定为最顶层，即使被其他置顶窗口抢占也能立即回到最前
5. 设置：托盘菜单 →「设置…」，可修改：
- 截图快捷键 / 识别文字快捷键（点击输入框 → 直接按新组合键；Esc 取消、Delete 清除）
- 图片存储位置、是否自动保存 / 自动复制
- OCR 默认语言（默认英文 en-US；选择「自动识别」时智能检测：图片含中文自动用中文引擎，纯英文用英文引擎；强制识别中文请选择"中文(简体)"）
6. 配置保存在 %APPDATA%\SnapShot\settings.json，日志在 %APPDATA%\SnapShot\logs\。

系统要求

- Windows 10 / Windows 11（x64 或 x86，自带 .NET Framework 4.8，无需安装运行库）
- 中文 OCR 需要系统已安装「中文(简体)」语言并启用「基本文字识别」：
设置 → 时间和语言 → 语言和区域 → 添加语言 → 中文(简体) → 语言选项 → 基本文字识别（仅需安装一次，之后完全离线可用；未安装时自动回退英文/自动识别）

开发与构建

- 技术栈：C#（.NET Framework 4.8）+ WinForms + Windows.Media.Ocr（系统 WinRT OCR）
- 编译器：Windows 自带的 csc.exe，无需安装任何 SDK，构建过程完全离线
- 构建：在 PowerShell 中运行 .\build.ps1，产物为 dist\SnapShot.exe（约 50 KB 单文件）
- 自检：SnapShot.exe --diagnose  检测 OCR 语言、离线识别与热键注册
- 自动化测试：.\build_test.ps1 构建 SnapShot_test.exe（设置序列化、屏幕截图、钉图置顶机制）

目录结构

SnapShot/
├── SnapShot.exe          # 成品（dist 目录）
├── src/                  # 源码
│   ├── Program.cs        # 入口、单实例、DPI
│   ├── AppContext.cs     # 托盘、菜单、截图流程编排
│   ├── HotkeyManager.cs  # 全局热键（RegisterHotKey）
│   ├── CaptureOverlay.cs # 全屏选区截图
│   ├── OcrService.cs     # 离线 OCR（Windows.Media.Ocr）
│   ├── OcrForm.cs        # 识别结果窗口
│   ├── ToolbarForm.cs    # 截图后工具条
│   ├── PinForm.cs        # 桌面置顶钉图
│   ├── SettingsForm.cs   # 设置界面
│   └── ...
├── assets/               # 图标、应用清单
├── tools/                # 自动化测试
├── build.ps1             # 构建脚本
└── build_test.ps1        # 测试构建脚本

常见问题

- 识别不了中文：请先确认系统中已安装「中文(简体)基本文字识别」语言组件（见上文），并在识别窗口或设置中将语言切换为中文。
- 识别效果不佳：内置预处理会自动放大过小的图片并增强对比度；截图时尽量框选清晰、正立的文字区域，避免反光、渐变背景与艺术字体。
- 快捷键无效：可能与其他程序冲突，请在设置中更换组合键。
- 钉图被覆盖：钉图窗口是置顶窗口，会被定时器持续锁回最顶层；若与全屏独占游戏/远程桌面共存，请将游戏切到窗口化。
- 穿透后无法操作钉图：这是预期行为。按 Ctrl + Alt + P 或托盘菜单「取消所有钉图穿透」即可恢复。
- 杀毒软件提示：本程序未签名，个别杀软可能误报；可通过"仍要运行"放行，或在源码基础上自行构建。