内置使用与独立产品
Sniptra 是一个围绕“截取 → 编辑 → 交付”设计的本地截图工具。适合写文档、提交问题反馈、提取图片文字，或把参考资料固定在桌面。
默认内置于 ArcRelay，独立发行版规划中。 独立运行时拥有自己的托盘、快捷键与设置；本页暂不提供独立安装包，也不把源码中的跨平台适配等同于各平台正式发行。
| 使用方式 | 如何启动 | 运行与数据边界 |
|---|---|---|
| ArcRelay 内置组件 | 在通用设置启用“Sniptra 增强截图”，再使用截图入口或快捷键 | 按需启动，设置与缓存隔离，不额外启动独立托盘 |
| Sniptra 独立运行 | 启动应用进入托盘，通过全局快捷键或菜单截图 | 有自己的本地设置，不要求 ArcRelay 或设备配对 |
ArcRelay 当前的随包集成为 Windows 与 macOS 12.3+。默认内置不等于默认开启：增强截图开关默认关闭，用户主动启用后才接管对应截图流程。
区域、窗口与桌面截图
快捷键把当前桌面冻结到一个无边框截图画布。选区、标注、OCR 和输出都在同一画布中完成，不需要先截图再打开另一个编辑器。
- 指针移到窗口上可高亮识别到的窗口；单击选中，双击可直接复制。
- 拖动创建自定义区域，在选区内拖动调整位置，使用八个边缘控制点调整大小。
- 方向键按物理像素微调位置。
- 按 Enter 使用设置中的默认输出，Escape 取消当前操作。
- 命令行还提供区域、活动窗口、指定窗口、显示器、桌面与上次区域等模式；实际可用性由系统后端报告。
跨显示器、缩放和窗口捕获能力随系统变化。Windows、macOS、X11 可以使用原生窗口发现；Wayland 可能先由系统 Portal 选择捕获对象。
可编辑标注
标注在交付前保持为独立对象，可重新选择和修改，不是画完一次就只能撤销重来。
表达重点
提供箭头、直线和曲线、矩形与其他形状、文字、画笔、高亮及马赛克。线条可选择直线、波形或贝塞尔曲线；形状包含圆角矩形、椭圆、多边形和星形等。
精确调整
- 选中对象后修改颜色、线宽、填充、箭头大小、文字样式或马赛克强度。
- 移动、缩放、复制、删除、调整前后层级；矢量对象可旋转，曲线可调整控制点。
- 双击文字原位编辑；Command/Ctrl + Enter 确认，Escape 取消当前文字编辑。
- 方向键移动 1 像素，按住 Shift 移动 10 像素；撤销与重做保留调整空间。
马赛克用于视觉遮挡，不等于不可逆的信息脱敏。需要严格隐藏内容时使用不透明覆盖，并检查最终导出图片。马赛克区域保持轴向对齐，不提供旋转。
本地 OCR 文字识别
选择区域后按 Shift + O，在截图画布内查看并复制识别结果，不必结束截图。OCR 使用随应用提供的独立工作进程与本地模型，不上传截图，不在识别时自动下载模型，也不要求系统安装 Tesseract。
适合提取截图中的文字、错误信息或不能直接选择的内容。识别质量受图片清晰度、字体与语言影响，重要文字复制前需校对。
OCR 失败不会阻止继续截图、编辑、保存或贴图。若文字复制正常但界面显示方框，通常需要检查系统是否有对应语言的字体。
复制、保存与贴图
同一份编辑结果可复制到剪贴板、保存为图片或贴在桌面上。PNG 是默认格式，也支持 JPEG 和 WebP；JPEG 不适合保留透明背景。
贴图适合对照设计、抄录文字或跨窗口参考：可以调整缩放、恢复实际大小，并关闭不再需要的参考图。Wayland 中是否能始终置顶由桌面环境决定。
复制、保存和其他交付分别报告结果。某一步失败时，其他请求仍可完成，系统保留可恢复的输出供手动处理；不要把“复制成功”当成“文件也已保存”。
macOS 滚动截图
在添加标注之前选好区域，再从工具栏进入滚动截图。可以向上或向下扩展长图，重复滚过已捕获内容时避免重复拼接；固定的顶部与底部区域尽量只保留一次。
- 手动模式：使用滚轮或触控板缓慢滚动，不需要辅助功能权限。
- 自动模式：通过选区中心标记向目标滚动容器发送小步滚动，确认相邻画面可靠重叠后再继续。
- 自动模式需要 macOS 辅助功能权限，Mac App Store 沙盒构建不提供自动模式；不意味着 App Store 版本已经发行。
- 若中心标记落在错误的嵌套容器上，重新选区或改用手动模式。
- 重叠不可靠时暂停，保留最后安全结果；回到有明显特征的位置后可按 Space 继续。
- Command + Z 移除最近一段拼接，Enter 完成，Escape 取消并保留原始选区。
滚动截图目前是 macOS 能力，不承诺 Windows 或 Linux 同样可用。
常用快捷键
macOS 使用 Command，Windows、Linux 使用 Ctrl。应用内可用 Command/Ctrl + / 打开快捷键参考；启动组合键可以在设置中修改。
| 操作 | 快捷键 |
|---|---|
| 启动区域截图（默认） | Command/Ctrl + Shift + A |
| 复制 / 保存 / 贴图 | Command/Ctrl + C / S / P |
| 使用默认输出 | Enter |
| 运行 OCR / 复制 OCR 结果 | Shift + O / Command/Ctrl + Shift + C |
| 撤销 / 重做 | Command/Ctrl + Z / Command/Ctrl + Shift + Z |
| 选择 / 文字 / 线条 / 形状工具 | V / T / L / U |
| 复制标注 / 删除标注 | Command/Ctrl + D / Delete 或 Backspace |
| 复制当前标注颜色的十六进制值 | Option/Alt + C |
| 贴图实际大小 / 缩放 | Command/Ctrl + 0 / Plus 或 Minus |
| 关闭截图或贴图 | Command/Ctrl + W 或 Escape |
平台能力与设置
| 能力 | macOS | Windows | Linux X11 | Linux Wayland |
|---|---|---|---|---|
| 区域截图与同画布编辑 | 支持 | 支持 | 支持 | 完成 Portal 捕获后可用 |
| 窗口发现与选择 | 支持 | 支持 | 支持 | 取决于 Portal |
| 本地 OCR、复制与保存 | 支持 | 支持 | 支持 | 支持，需对应后端 |
| 手动 / 自动滚动截图 | 支持 / 非沙盒构建且有权限 | 不支持 | 不支持 | 不支持 |
| 全局快捷键、置顶贴图 | 支持 | 支持 | 支持 | 取决于桌面环境与 Portal 集成 |
| 捕获光标 | 系统后备路径可提供 | 当前不承诺 | 当前不承诺 | 当前不承诺 |
这是实现能力表，不是独立安装包发布清单。系统权限、捕获后端及所用构建决定最终结果。设置提供简体中文与英语、明暗主题、快捷键和输出偏好，保存在本机。
脚本与命令行
已安装并可执行 Sniptra 时，可用命令行组合捕获与输出。例如执行 sniptra capture --copy --save Screenshot.png --pin，把同一份结果复制、保存并贴图。
程序也支持通过 JSON 标注描述进行脚本化编辑。嵌入应用可以使用一次性调用与独立配置目录；这不要求普通用户使用终端，也不意味着需要启动常驻服务才能完成一次截图。
隐私与 ArcRelay 协同边界
Sniptra 本身无需账号，不自动联网、不发送遥测、不进行自动更新请求，也不记录截图历史。OCR 在本机按需运行。
“没有历史”不等于磁盘上绝不出现图片：你主动保存的文件会保留，交付失败会留下供恢复的临时结果；成功交付后会清理临时资产。诊断日志排除截图像素、OCR 文本、敏感窗口标题和完整文件路径。
通过 ArcRelay 复制图片后，ArcRelay 可能按自己的设置保存剪贴板历史、运行后台 OCR 或同步给获授权设备。 系统剪贴板和其他监听应用也可能读取内容。Sniptra 的无历史承诺只描述 Sniptra 自身。
常见问题
- 无法截图：检查系统屏幕捕获权限和可用后端；macOS 需向实际启动的应用授予屏幕录制权限。
- 复制失败：剪贴板可能暂时被占用；查看提示，尝试保存，不要直接丢弃当前结果。
- 自动滚动无反应：确认 macOS 辅助功能权限、非沙盒模式及选区中心所在容器。
- OCR 不可用：确认安装中包含 OCR 工作组件；其他截图和编辑能力仍可继续使用。
- 保存失败：检查目录权限与剩余空间，按恢复提示另存。