SlimSnap

什么是 SlimSnap？

SlimSnap 是一款 macOS 应用，可将截图转换为终端编码代理可读的 JSON。它适用于你想向 Claude Code、Aider 或 Codex CLI 等工具传达界面细节，但又不想直接粘贴图片的场景。

该工作流结合了截图、标注、OCR 和导出。用户选择屏幕上的一个区域，添加箭头或标注框等可视标记，然后复制包含元素文本、边界框和标注数据的结构化 JSON 表示。其目标是让截图内容可用于纯文本环境，同时保持捕获过程完全在 Mac 本地完成。

SlimSnap 还在 GitHub 上以 MIT 许可证发布了开放的 JSON schema，因此导出的格式可以在应用外进行验证或复用。产品页将其定位为一种把截图上下文带到不接受图片的地方的方法，例如终端、SSH 会话和其他纯文本工作流。

主要功能

• 原生 macOS 屏幕截图：用户按下 ⌘⇧S，拖动选择区域，然后松开即可捕获截图区域。
• 标注工具：箭头、标注框和高亮可帮助用户让代理关注特定 UI 元素或问题。
• JSON 导出：截图会以结构化 JSON 形式复制，便于粘贴到终端代理和其他纯文本工具中。
• 内置 OCR：应用会读取截图中的可见标签、按钮和错误消息，并将其包含在输出中。
• 元素边界框：输出元素包含标准化坐标，有助于下游工具理解布局和位置。
• Mac 本地处理：截图和 OCR 都在设备上运行，无需账户或服务器上传。
• 开放 schema：JSON schema 已在 GitHub 上以 MIT 许可证发布，支持校验或自定义导出器。

如何使用 SlimSnap

安装 Mac 应用后，使用截图快捷键选择要分享的屏幕部分。根据需要添加标注，例如高亮按钮或标记错误消息，以引导注意力。

截图完成后，复制生成的 JSON，并将其粘贴到接受文本的工具中，例如 CLI 编码代理。如果你使用 Claude Code skill，SlimSnap 还会写入一个本地小型配置文件，以便该 skill 自动找到保存的 JSON 截图。

使用场景

• 终端代理中的 UI 调试：分享一张出问题界面的截图，布局和文本细节已提前提取到 JSON 中。
• 迭代式代码审查或修复提示：让代理关注特定按钮、表单字段或错误状态，而无需写很长的视觉描述。
• SSH 或远程会话：把截图上下文带到无法直接粘贴图片的环境中。
• CI 或基于日志的排障：当截图不适合放入时，把结构化 UI 上下文粘贴到纯文本日志或提交信息中。
• 自定义工作流：使用已发布的 schema，从其他 OCR 流水线或手写导出器生成兼容的 JSON。

常见问题

SlimSnap 会把我的截图上传到服务器吗？ 不会。页面说明截图和 OCR 都在你的 Mac 本地运行，截图不会离开设备。

它能用于无法读取图片的工具吗？ 可以。该产品就是为终端代理和其他无法直接粘贴截图的纯文本目标而设计的。

这个 schema 是开放的吗？ 是的。JSON schema 已在 GitHub 上以 MIT 许可证发布，页面还说明 Claude Code skill 也是开源的。

使用 Claude Code skill 需要 Mac 应用吗？ 不需要。该 skill 可与任何有效的 SlimSnap JSON 文件配合使用，即使它是在应用外创建的。

SlimSnap 目前支持 Windows 或 Linux 吗？ 目前不支持。页面说明它现在仅支持 Mac，并欢迎用户提出其他平台需求。

替代方案

• AI 聊天应用中的原生截图分享：适合一次性的图片问题，但并非为终端代理或纯文本工作流设计。
• 对 UI 进行手动文字描述：界面简单时可行，但对于复杂布局更慢，也更容易出错。
• OCR 加自定义 JSON 导出器：适合希望从截图到结构化文本自建流程的团队。
• 通用录屏或标注工具：可以捕获并标记界面，但通常不会导出带 OCR 和边界框、可供代理读取的 JSON。