欢迎使用 yuSnip！本手册将详细介绍软件的全部功能，帮助您快速上手并充分发挥其强大能力。

系统要求

• 操作系统：Windows 10 19041 及以上版本，或 Windows 11
• 架构：x64

安装与启动

yuSnip 是一款单文件绿色软件，无需安装。双击 yuSnip.exe 即可启动，启动后程序将在系统托盘显示图标并在后台运行。

首次截图

1. 按下 Ctrl+Alt+A（默认截图快捷键）启动截图模式
2. 屏幕变暗后，用鼠标拖拽选取目标区域
3. 释放鼠标进入标注编辑界面
4. 使用工具栏中的工具进行标注（如需要）
5. 选择「贴图」将截图钉在桌面，或选择「保存」保存为文件

托盘菜单

右键系统托盘图标可快速访问以下功能：

区域截图

按下截图快捷键后，屏幕将变暗并进入截图模式。用鼠标拖拽即可选取任意矩形区域，选区过程中会实时显示尺寸信息标签。

智能检测

截图时软件支持自动检测鼠标下方的窗口和 UI 元素，实现智能吸附：

可在「设置 → 交互与快捷键 → 自动检测模式」中切换。检测到目标时，候选区域以高亮边框显示，并带有平滑过渡动画。

放大镜与精准取色

选区阶段，鼠标附近会显示像素级放大镜，帮助精准选取边界。放大镜具备智能避障功能，会自动调整位置避免遮挡选区。

按下 C 键可提取放大镜中心像素的颜色信息，自动生成包含 RGB、HSV、HSL、HEX 多种格式的颜色贴图。

截图后操作

截图完成后（释放鼠标），工具栏提供以下操作：

截图后进入标注编辑界面，工具栏提供丰富的标注工具。每种工具可通过快捷键快速切换。

画笔（快捷键 B）

自由绘制线条，可自定义颜色和粗细。适合在截图上做自由标记。

箭头（快捷键 A）

绘制带箭头的指示线，可自定义颜色、粗细和样式。适合指向截图中的特定位置。

矩形 / 椭圆（快捷键 R）

绘制矩形或椭圆框，可自定义颜色、粗细和填充。适合框选截图中的重点区域。

文字标注（快捷键 T）

在截图上添加文字，支持设置字体、大小、粗体、斜体、描边、背景色和旋转角度。点击截图区域开始输入文字。

模糊 / 马赛克（快捷键 M）

对选定区域进行高斯模糊或马赛克遮盖，保护敏感信息。强度可在工具栏中调节。

聚光灯（快捷键 S）

高亮特定区域，同时暗化其他区域。支持矩形和椭圆两种形状，可自定义边框颜色和粗细。

计数标号（快捷键 C）

在截图上添加带序号的标记点，适合标注步骤或要点。序号自动递增。

撤销与重做

• Ctrl+Z：撤销上一步标注
• 支持最多 100 步撤销历史

橡皮擦

一键清除所有标注，恢复原始截图。

颜色选择器

点击工具栏的颜色块可打开完整拾色器，支持 HSV 面板、透明度滑条、Hex 输入和预设色。

保存为文件

截图统一保存为 PNG 格式，保留完整元数据。文件名按模板自动生成，默认格式为 Screenshot_{yyyyMMdd_HHmmss}。

文件名模板

在「设置 → 基础与存储 → 文件名模板」中可自定义命名规则，支持以下时间占位符：

复制到剪贴板

截图可复制到剪贴板，支持 CF_DIB、PNG、CF_BITMAP 多种格式，完整保留透明通道。

保存后自动复制

开启「设置 → 基础与存储 → 截图保存后自动复制到剪贴板」后，保存文件的同时自动复制图片到剪贴板。

PNG 元数据

保存的 PNG 文件中会嵌入截图坐标、DPI 和时间戳等元数据信息。

保存通知

开启保存通知后，保存成功时会弹出 Toast 通知，点击可打开文件所在目录。

保存提示音

开启后，保存时播放系统提示音。

贴图（钉屏）是 yuSnip 的核心功能之一，可将截图或剪贴板内容钉在桌面始终置顶显示。

创建贴图

以下方式均可创建贴图：

• 截图后点击工具栏「贴图」按钮
• 按下 F3（默认贴图快捷键）从剪贴板创建贴图
• 截图进行中按 F3 将选区转为贴图

移动与缩放

• 移动：鼠标拖拽贴图即可移动位置
• 滚轮缩放：鼠标滚轮调节贴图大小，以左上角为锚点，无抖动无卡顿
• 边缘缩放：鼠标贴近贴图边缘可拖拽调整窗口大小

贴图焦点管理

同时存在多个贴图时，只有一个处于焦点状态：

• 焦点贴图：蓝色阴影边框
• 非焦点贴图：灰色阴影边框

点击任意贴图可使其获得焦点。

锁定贴图（Ctrl+L）

锁定后贴图不可移动和缩放，阴影变为橙色。右键菜单可解锁。

鼠标穿透（Ctrl+P）

开启穿透后，贴图完全透明点击，鼠标可操作贴图下方的窗口。阴影变为绿色。穿透模式下右键可直接解除穿透并弹出菜单。

缩略图模式（R 键）

按 R 键或 Shift+双击进入缩略图模式，贴图缩小为 150×150 视口展示中心区域，减少屏幕阻挡。缩略图拥有专属状态边框色：

阴影切换（Y 键）

按 Y 键切换焦点贴图的阴影显示。可在设置中配置切换时是否显示 Toast 提示。

文字贴图

当剪贴板中包含文字时，使用贴图快捷键会将文字渲染为带样式的图片贴图。自动检测代码内容并使用等宽字体（Consolas）+ 灰底边框渲染，支持 CJK 逐字断行。

Markdown 贴图

当剪贴板内容为 Markdown 格式时，软件会自动识别并使用 Markdown 渲染引擎实时渲染（非位图），支持文本选择。

颜色贴图

当剪贴板内容为颜色字符串（如 #FF5733、rgb(255,87,51)）时，自动生成包含 RGB、HSV、HSL、HEX 多种格式信息的色板贴图。

贴图右键菜单

关闭贴图

按 Esc 键：首次按取消焦点，再次按关闭贴图。

显示 / 隐藏所有贴图

通过托盘菜单「显示贴图」复选框，或脚本 yuSnip.toggleAllStickers() 可一键显示或隐藏所有贴图。

yuSnip 内置 RapidOCR（基于 PaddleOCR v4 模型）文字识别引擎，支持中英文识别，引擎及模型文件已内嵌至 exe 中。

区域 OCR

在截图编辑界面，点击工具栏「OCR」按钮，对当前选区进行文字识别。识别结果会叠加显示在原图上。

文字选择与复制

OCR 识别后，可在识别结果上拖拽选择文字，选中的文字可复制到剪贴板。支持字级（OcrWordRegion）精确选择。

贴图 OCR 提取

对已创建的贴图，右键菜单选择「复制全部文本」，软件会对贴图图片执行 OCR 识别并复制全文到剪贴板。

OCR 引擎特性

• 引擎：RapidOCR-json（PaddleOCR v4 模型）
• 通信方式：进程间 JSON 通信
• 预热：启动时异步预热，减少首次使用延迟
• 内嵌：OCR 引擎及模型文件作为嵌入资源打包进 exe，无需额外安装

yuSnip 集成百度翻译和有道智云两大翻译服务商，支持文本翻译和图片翻译。

服务商配置

在「设置 → 翻译」中配置：

1. 选择翻译服务商（百度翻译 / 有道智云）
2. 填入对应平台的 API 密钥（APP ID 和 Secret Key）
3. 点击「验证密钥」确认密钥可用
4. 配置源语言和目标语言

API 密钥按服务商独立配置，切换服务商时自动显示 / 隐藏对应配置卡片。

翻译模式

截图翻译

在截图编辑界面，点击工具栏「翻译」按钮或按 Ctrl+Q，翻译模式跟随设置页配置。

贴图翻译

对贴图右键选择「翻译」或按 Ctrl+Q：

• 文本贴图：走文本翻译
• 图片贴图：走图片翻译

翻译结果窗口

翻译结果以原文 / 译文对照方式展示，支持：

• 药丸式语言切换（Flyout 弹出）
• 字符计数
• 一键复制反馈
• 加载中 / 错误 / 成功状态显示
• 图片翻译预览

译文颜色自适应

图片到图片模式下，根据背景色亮度自动选择深色或浅色文字颜色，并通过 WCAG 对比度验证确保可读性。

脚本翻译

通过脚本指令支持更多翻译场景：

长截图（滚动截图）功能可截取超出屏幕高度的内容，如长网页、长文档等。

使用方法

1. 在截图编辑界面，点击工具栏「长截图」按钮
2. 选定截取区域（限单显示器内）
3. 软件自动模拟鼠标滚轮滚动，逐帧截取（约 60fps）
4. 智能拼接算法自动合并各帧
5. 实时预览拼接结果
6. 完成后可保存或复制

智能拼接

• 基于逐行哈希匹配和像素级对比的重叠检测
• 自动识别并处理粘性头部 / 底部（如网页固定导航栏）
• 固定层比例 12%，最大高度 120px
• 合成长图最大高度 28888px

实时预览

拼接过程中实时显示预览窗口，可随时查看进度。支持保存、复制或取消。

性能优化

• 使用位图对象池减少 GC 压力
• 使用原生 GDI 窗口绘制截图区域边框，避免 Avalonia 窗口开销
• 自动检测滚动终止

yuSnip 支持脚本自动化，可通过命令行、AutoHotkey、Quicker 等工具调用。

脚本语法

• 以行为单位执行，每行一个方法调用
• 支持 // 注释，行尾分号可选
• 前缀为 yuSnip.
• 支持拼写容错（如 pinFromCilpBoard、destoryAllPin）

支持的命令

命令行调用

yuSnip.exe -r "yuSnip.screenShot('Ocr');"
yuSnip.exe -f "C:\path\to\script.txt"

IPC 机制

当第二个实例启动时，如果携带脚本参数（-r / -f），会通过命名管道 yuSnip_IPC_Pipe 将脚本转发给正在运行的实例执行，然后退出。

预设指令库

在「设置 → 高级与自动化 → 预设指令库」中提供常用指令快捷选择，包括截图、翻译、贴图等分类，可直接复制或测试运行。

全局快捷键

截图窗口快捷键

贴图窗口快捷键

配置文件路径：%APPDATA%/yuSnip/settings.ini

基础与存储

交互与快捷键

翻译

配置云存储