Sniptra 使用说明

选择你的使用方式

Sniptra 默认内置于 ArcRelay 的 Windows 和 macOS 12.3+ 桌面集成，但需要在截图设置中开启增强截图。内置方式按需启动，不要求再运行一个独立托盘。

独立发行版仍在规划中。如果你使用的是从源码运行的独立版本，入口和平台支持以该版本为准；这里不提供尚未发布的独立安装包。两种运行方式使用隔离的配置。

完成第一张截图

1. 内置用户从 ArcRelay 截图入口开始；独立运行用户从 Sniptra 托盘、配置的快捷键或命令行入口开始。
2. 按系统要求确认屏幕捕获权限。macOS 权限变化后可能需要重新启动相关应用；Wayland 捕获由桌面 Portal 参与。
3. 拖动选择区域，或使用当前平台支持的窗口、桌面捕获方式。
4. 检查选区，进入编辑后添加必要标注。
5. 选择复制或保存，在目标应用或文件夹中确认结果。

不需要这次捕获时按 Escape 退出。先用普通内容试一次，熟悉选区与退出方式后再处理敏感画面。

添加与修改标注

选择矩形、椭圆、箭头、线条、文本或画笔等工具，突出需要说明的部分。编辑时标注仍是可选中的对象，可以移动、缩放、调整样式和层级，而不是每画一次就永久写进底图。

• 需要修改已有标注时，先选中对象再调整。
• 不满意的操作可撤销、重做；常用按键见编辑器的快捷键帮助。
• 敏感文字可以遮挡或使用模糊等工具；导出前应放大检查，确认原内容确实不可辨认。
• 保存为 PNG、JPEG 或 WebP 后得到的是交付图片，不要把它当成保留全部可编辑对象的工程文件。

使用本地 OCR

1. 捕获包含文字的画面，并选取需要识别的区域。
2. 使用 OCR 工具，等待本地识别完成。
3. 检查识别结果，尤其是数字、路径、代码和混合语言，再复制到目标应用。

OCR 在本地工作，不需要把截图上传到云端识别。首次运行或本地 worker 启动失败时，先检查当前版本的运行环境；识别结果并非完全准确。

复制、保存与贴图

Sniptra 本身不建立截图历史，但你主动保存的文件和失败恢复资产可能保留。复制到系统剪贴板后，ArcRelay 可能按自己的设置记录或同步截图，请在使用前检查相关开关。

macOS 滚动截图

滚动捕获目前仅支持 macOS，其他平台不要按相同能力预期使用。

1. 选择可滚动的目标区域，在添加标注之前开始滚动捕获。
2. 按界面指引保持目标位置稳定，滚动内容并观察拼接结果。
3. 自动滚动可能需要辅助功能权限；沙盒环境存在限制，不代表所有发行方式都支持自动滚动。
4. 到达需要的位置后结束，检查重叠、缺行和固定悬浮元素，再标注或导出。

拼接异常时，缩小目标区域或降低滚动幅度，避免在捕获过程中移动窗口或改变布局。

快捷键与退出

在编辑器中使用 Command/Ctrl + / 打开快捷键帮助，以当前版本显示为准。常用复制、保存、撤销与重做遵循编辑器对应操作；全局捕获快捷键可在设置中检查，Wayland 上取决于桌面环境。

Escape 用于取消或退出当前捕获。关闭编辑窗口后，到目标应用确认复制或保存结果，避免把“窗口关闭”误认为“文件已保存”。

常见问题

更多平台对照、CLI 与隐私边界请阅读 Sniptra 功能文档。