LeeSnap 使用教程：从截图、翻译到剪贴板增强的完整上手指南

LeeSnap 不是单一功能的截图小工具，而是一套围绕 macOS 菜单栏展开的工作流工具。按照当前代码结构，它把能力明确拆成了 7 个长期设置页：系统、截图、翻译与 AI、状态栏与提醒、剪贴板、隐私、鼠标增强。也就是说，这个应用的正确打开方式不是“装完只按一次截图快捷键”，而是先把权限、快捷键、AI 提供商、剪贴板策略和鼠标动作一次性配好，再进入日常高频使用。

这篇教程按现有实现来写，不做想象式扩展。你可以把它当成一份面向真实使用者的上手文档，也可以把它当成 LeeSnap 当前产品结构的功能地图。

1. 先理解 LeeSnap 的工作方式

LeeSnap 默认是一个菜单栏常驻应用，不走传统 Dock 主窗口路线。启动后，主要入口来自菜单栏图标和全局快捷键，常用动作有 3 个：

功能	默认快捷键	说明
截图	⌘ + Shift + A	打开截图与标注流程
划词翻译	⌥ + Shift + T	触发选中文本翻译
剪贴板历史	⌥ + Shift + V	打开剪贴板增强面板

菜单栏里还能直接看到这些动作入口，以及“快速设置提醒”“偏好设置”“关于 LeeSnap”“退出 LeeSnap”。如果你不习惯记快捷键，完全可以先从菜单栏入口开始。

2. 第一次安装与启动

建议按这个顺序完成首次配置：

1. 把 LeeSnap.app 放进 /Applications。
2. 第一次打开时，使用 macOS 的“右键打开”方式通过系统安全确认。
3. 进入 LeeSnap 的“偏好设置”，先看“系统”页。

当前代码里，系统页明确管理两类核心权限：

• 屏幕录制权限：没有它就无法开始截图。
• 辅助功能权限：没有它，自动粘贴和跨应用注入会降级为“仅复制”。

另外，系统页还提供：

• 开机自动启动
• 截图放大镜开关
• 权限状态查看与跳转系统设置

如果你希望 LeeSnap 真正融入日常流程，第一步就应该先把权限和开机启动配好。否则后面看到的很多功能都只是“看起来存在”，实际无法完整工作。

3. 截图功能怎么用

“截图”页对应的是 LeeSnap 最核心的一条工作流。它不只负责拉起截图，还负责默认标注行为、滚轮灵敏度和与其他模块的衔接。

开始截图

你可以通过 3 种方式开始截图：

• 使用默认快捷键 ⌘ + Shift + A
• 点击菜单栏中的“截图”
• 在“鼠标增强”里把某个中键、侧键或自定义动作绑定成“触发截图”

当前实现里，截图入口统一由 WindowManager 协调，所以无论你从快捷键、菜单还是鼠标动作进入，后续流程是一致的。

选择区域与标注

进入截图后，LeeSnap 支持的标注工具已经不只是基础矩形。按当前代码和工具枚举，至少包括这些常见能力：

• 箭头
• 矩形
• 椭圆
• 直线
• 画笔
• 马赛克
• 文字

“截图”设置页里可以提前定义默认标注状态：

• 默认工具
• 默认颜色
• 默认线宽
• 箭头是否默认双向
• 标注工具滚轮灵敏度

这意味着如果你平时总是用红色箭头或固定粗细，不需要每次截图再手动调。首次配置好之后，LeeSnap 会按你的偏好直接进入可用状态。

截图后的保存与管理

当前设置结构里，截图自动保存目录已经并入“剪贴板”页统一管理，不再单独散落在截图设置里。实际含义是：

• 截图产物和剪贴板历史走统一存储目录
• 后续清理策略也能统一配置
• 截图不只是一次性动作，而是会进入后续回看、再粘贴、分类和清理流程

如果你把 LeeSnap 当成长期使用的工作台，而不是“一次性截图后就扔掉”的工具，这个设计会非常有用。

4. 划词翻译与 AI 应该怎么配

LeeSnap 的“翻译与 AI”页不是简单塞一个 API Key 输入框，而是把翻译、天气和模型配置放在同一个操作域里，说明它的目标不是单次聊天，而是围绕文本处理建立完整体验。

划词翻译入口

默认快捷键是 ⌥ + Shift + T。如果你经常在浏览器、文档或聊天窗口里读中英文内容，这个入口适合做成肌肉记忆。

当前设置里可以预设：

• 翻译快捷键
• 默认目标语言

如果你不想每次判断中译英还是英译中，直接保留“自动检测”即可。

AI 提供商配置

按现有代码，LeeSnap 已经支持这些 AI 提供商配置：

• DeepSeek
• OpenAI
• Claude
• 智谱 GLM
• 豆包
• 自定义接口

每个提供商都可以分别设置：

• API 密钥
• Base URL
• 模型名

而且当前实现里做了几层基础校验：

• API Key 长度太短会报错
• Base URL 必须是 HTTPS
• 模型名只能包含字母、数字、点、下划线、连字符

所以如果你保存失败，优先检查的不是“是不是 UI 出 bug 了”，而是配置本身是否不符合格式要求。

LeeSnap 当前的 AI 工作方式

从 AIService 的实现看，LeeSnap 不是把整张图片原样丢给远端模型。它会优先做本地 OCR，再把文本交给远端模型处理。这带来两个直接好处：

• 更省 token
• 翻译、提取、问 AI 三种模式可以复用 OCR 结果

对实际用户来说，这意味着：

• 提取模式适合 OCR
• 翻译模式适合把选区文字快速转成目标语言
• 问 AI 更适合围绕识别出的文字继续追问

如果你主要处理截图里的文本，LeeSnap 这套结构会比“单纯调用一次多模态接口”更稳，也更可控。

天气与日期配置

同一个页面里还有天气 API 配置，结合状态栏模板使用。你可以设置：

• 地区
• 和风天气 API Key
• 接口地址

这部分不是独立玩具功能，它会直接影响状态栏显示内容和提醒使用场景。

5. 剪贴板增强是 LeeSnap 的第二核心模块

很多人会把剪贴板历史当成附属功能，但从当前代码体量看，LeeSnap 的剪贴板模块已经接近独立产品级别。它有自己的协调器、面板窗口、历史存储、隐私策略、链接预览、分类板和自动清理逻辑。

你能直接用到的能力

在“剪贴板”页里，当前可配置的重点包括：

• 剪贴板历史快捷键
• 是否开启监听
• 粘贴目标是“当前活动应用”还是“仅写回剪贴板”
• 是否总是以纯文本粘贴
• 历史上限
• 不同内容类型的保留天数
• 是否自动清理
• 是否只做连续去重
• 分类板和显示策略
• 统一存储目录

默认快捷键是 ⌥ + Shift + V。打开后，你会进入一个底部横向卡片式面板，可以做这些事：

• 搜索历史内容
• 浏览不同分类板
• 查看图文卡片预览
• 新建和管理分类板
• 继续编辑标题或内容

这套结构很适合下面几类用户：

• 高频复制粘贴的内容运营
• 需要反复复用片段文本的客服
• 会把截图、文本、链接和文件都暂存在同一个工作流里的用户

为什么要认真配存储与清理

LeeSnap 当前实现已经把文本、图片、视频、文件的保留策略拆开了。也就是说，你可以：

• 让文本保留更久
• 让图片更快清掉
• 让视频和文件用更保守的周期

如果你经常做截图和剪贴板中转，这一步很关键。否则历史很容易膨胀成“功能很强，但越来越重”的状态。

6. 隐私页不要跳过

LeeSnap 的“隐私”页不是装饰项，它决定剪贴板模块在真实办公环境里是否安全可用。

当前可以控制的主要策略有：

• 屏幕共享期间是否显示剪贴板面板
• 共享检测模式
• 手动标记“正在共享”
• 是否生成链接预览
• 敏感内容检测模式
• 是否忽略瞬时内容
• 忽略哪些应用程序

这几个开关背后的使用逻辑很明确：

• 开会演示时，避免剪贴板面板误弹出来
• 在包含 Token、密码或私密内容时降低误收录风险
• 对某些不希望进入历史的应用做排除

如果你的工作环境经常涉及会议共享、客服后台、测试账号或生产环境密钥，这一页建议尽早配置。

7. 状态栏与提醒适合做轻量日程中枢

LeeSnap 不是只有截图图标。按当前实现，状态栏还能承载：

• 时间模板切换
• 时区设置
• 天气信息
• 独立闹钟提醒

在“状态栏与提醒”页里，你可以设置：

• 状态栏显示模板
• 显示时区
• 新增闹钟
• 管理启用中、暂停中、已结束的提醒

菜单栏里也保留了“快速设置提醒”入口，适合临时增加一个提醒，而不用每次完整进入设置层级。

如果你平时要盯跨时区协作、固定时间点操作，或者只是想把提醒留在一个轻量工具里，这个模块是可以直接投入日常的。

8. 鼠标增强更适合重度用户

“鼠标增强”页是 LeeSnap 里最偏高级用户的一块。它不是简单录一个鼠标按键，而是完整处理了设备、权限、动作监听、配置目标和应用覆盖。

使用前提

当前实现要求两类权限同时打开，功能才完整：

• 监听权限
• 注入权限

页面里也明确写了，如果这 2 个权限没有同时满足，鼠标增强不会进入完整可用状态。

能做什么

按当前界面结构，你可以：

• 启用或关闭鼠标增强
• 看到已连接的外接 USB / 蓝牙鼠标
• 录制最近一次鼠标动作做测试
• 给不同设备或配置目标建立规则
• 在全局层或指定 App 覆盖层设置绑定
• 把动作映射到以下目标：
  • 自定义快捷键
  • 触发截图
  • 触发翻译
  • 打开剪贴板增强
  • 禁用默认动作

如果你已经习惯用鼠标中键、侧键或滚轮手势来触发工具，这个模块能明显减少键盘切换成本。

9. 一套推荐的新用户配置顺序

如果你不想一上来就被所有功能淹没，可以按这个顺序开通：

1. 在“系统”页确认屏幕录制和辅助功能权限。
2. 在“截图”页设置默认工具、颜色和线宽。
3. 在“翻译与 AI”页填好 API Key、Base URL、模型名。
4. 在“剪贴板”页决定历史上限、粘贴目标和保留天数。
5. 在“隐私”页处理屏幕共享与敏感内容策略。
6. 在“状态栏与提醒”页设置时间模板和常用提醒。
7. 如果你使用外接鼠标，再进入“鼠标增强”页做动作绑定。

这套顺序的好处是，你会先得到稳定基础能力，再逐步打开进阶模块，而不是一开始就把所有高级功能混在一起试。

10. 常见问题排查

不能截图

先检查“系统”页里的屏幕录制权限。如果这里没开，截图入口会直接失效。

可以复制，但不能自动粘贴

这通常先看辅助功能权限。当前代码逻辑下，缺少这项权限时，自动粘贴会退化成仅复制到剪贴板。

AI 配置保存失败

优先检查 3 件事：

• API Key 是否过短
• Base URL 是否为 HTTPS
• 模型名是否包含非法字符

开会时不想让剪贴板面板弹出来

去“隐私”页，把屏幕共享期间显示策略和手动共享状态配置好。

鼠标绑定看起来录进去了，但没有效果

先检查监听权限和注入权限，再确认当前设备确实被识别为外接鼠标，并且绑定目标没有被设置成“禁用默认动作”。

11. 结语

从当前代码结构看，LeeSnap 已经不是“截图 + 一个 AI 按钮”这么简单。它真正的价值在于把截图、翻译、AI、剪贴板历史、隐私控制、提醒和鼠标动作整合成一个长期运行的个人工作台。

如果你只是偶尔截一张图，LeeSnap 当然也能用。但如果你的工作是高频复制、高频截图、高频翻译和跨应用切换，那么把这 7 个设置页认真配一次，才会真正感受到它的效率优势。