使用文档
ELTA 是一款专为英语精读设计的 macOS 截图/划词翻译工具。还没安装？请先看 安装教程。
使用方式
截图翻译
- 在任意页面（浏览器、PDF 阅读器、电子书等）找到需要翻译的英文
- 按下快捷键 ⌃T
- 鼠标变为十字准星，拖拽框选英文文本区域
- 松开鼠标后，ELTA 自动：
- 截取框选区域的图像
- 调用本地 OCR 识别英文文字
- 发送给 AI 后端翻译
- 在浮动面板显示翻译结果
- 拖动浮动面板可以调整位置，缩放可以调整大小
划词翻译
- 在任意应用中选中英文文本
- 按下快捷键 ⇧⌃T（Ctrl+Shift+T）
- ELTA 自动获取选中文字 → 直接 AI 翻译（跳过截图+OCR，速度更快）
💡 对比：截图翻译适合图片/PDF 中的不可选文字；划词翻译适合网页/文档中可选中的文字。
拆分翻译（逐句对照）
- 翻译完成后，在结果弹窗顶部点击 「拆分」（或按 ⌃D），切换到逐句对照视图
- 拆分模式将译文按句拆分，与原文一句一句上下对照，精读长难句更直观
- 点回「整段」即可恢复完整译文
- 表格、单个单词等不适合拆分的内容会自动回退为整段显示
💡 适用场景：逐句精读长段落、对照学习复杂句式时，拆分视图比整段译文更清晰。若译文与原文句数不一致，拆分页顶部会提示「可能错位」。
重复翻译
再次按下 ⌃T 可以使用相同区域重复翻译（适合对比不同翻译结果）。
取消翻译
翻译进行中（出现转圈提示时）按 Esc 即可取消本次翻译任务。
使用场景
场景一：精读英文论文 PDF
读学术论文时，不仅要译文，还想顺便记下术语和固定表达，用「精读翻译」模板最合适。
- 用任意 PDF 阅读器（Preview、Acrobat 等）打开论文。
- 按下 ⌃T，拖拽框选一段英文正文。
- ELTA 自动截图 → 本地 OCR → AI 翻译，结果按「中文翻译 / 重要词汇 / 常用短语与习语」结构化输出。
- 重点看「重要词汇」——列出句中较关键的单词（词性 + 释义），自动跳过高中基础词汇，专攻学术难点。
场景二：浏览英文网页 / 新闻
网页和文档里的文字可以选中，这时用「划词翻译」最快——跳过截图和 OCR，直接翻译选中文字。
- 在网页里选中想翻译的英文句子或段落。
- 按下 ⇧⌃T（Ctrl+Shift+T）。
- ELTA 直接获取选中文字并调用 AI 翻译，结果立刻显示。
场景三：图片 / 视频字幕里的文字
截图、漫画、海报、视频字幕里的英文无法被选中，只能用「截图翻译」靠 OCR 提取。
- 按下 ⌃T。
- 框选图片或视频里包含英文的区域。
- ELTA 本地 OCR 识别出文字，再交给 AI 翻译。
场景四：积累词汇与短语
内置的「精读翻译」模板除了译文，还会输出「重要词汇」和「常用短语与习语」两栏，适合一边读一边做笔记。
- 用截图或划词翻译一段英文。
- 在结果面板查看「重要词汇」（词性 + 释义）和「常用短语与习语」。
- 想换风格，可在偏好设置 → 模板里自定义提示词，比如改成「文学翻译」或「新闻翻译」风格。
{text}，可自由定制输出结构，详见下方翻译模板。
快捷键
| 快捷键 | 功能 | 说明 |
|---|---|---|
| ⌃T（可自定义） | 截图翻译 | 全局可用，框选屏幕区域 → 自动 OCR + 翻译 |
| ⇧⌃T（可自定义） | 划词翻译 | 选中文本后使用，跳过 OCR 直接翻译 |
| ⌃D（可自定义） | 整段 / 拆分切换 | 翻译弹窗可见时，在整段译文与逐句对照之间切换 |
| `（可自定义） | 切换弹窗位置 | 翻译弹窗可见时，一键切换弹窗到屏幕另一侧 |
| Esc（可自定义） | 关闭 | 关闭翻译结果浮动面板，可在偏好设置中修改 |
你可以在 偏好设置 → 快捷键 中自定义截图、划词、切换弹窗以及关闭面板的快捷键。
翻译模板
ELTA 支持自定义翻译模板，在 偏好设置 → 模板 中编辑。你可以使用以下占位符：
{text}— 待翻译的英文原文
内置模板
我会给你一段英文文本。请你按以下结构输出：
原文：
{text}
## 中文翻译
（遵循"信达雅"原则，自然流畅的中文翻译）
## 重要词汇
- **单词** | 词性 | 中文释义
（列出句中较重要的词汇，跳过高中大纲基础词汇）
## 常用短语与习语
- 短语/习语：中文释义
（习语请标注【习语】）
你可以在偏好设置中添加、编辑或删除自定义模板。
AI 翻译后端
ELTA 当前支持以下 AI 服务商：
| 服务商 | 模型 | 注册地址 |
|---|---|---|
| DeepSeek | deepseek-v4-flash（可选 deepseek-v4-pro） | platform.deepseek.com |
| 千问（阿里云） | qwen-plus（可选 qwen-turbo / qwen-max） | bailian.console.aliyun.com |
常见问题
Q: OCR 识别不出文字？
- 确保框选区域包含清晰的英文文本
- 避免框选过小（建议至少 50×20 像素）
- 确保你的 macOS 版本 ≥ 13.0（Vision OCR 需要 Ventura 以上）
Q: 翻译失败或报错？
- 检查偏好设置中的 API Key 是否正确填入
- 检查选中的 AI 服务商是否与 API Key 匹配
- 确认网络连接正常（OCR 是离线的，但翻译需要联网）
- 查看 API 账户是否有可用额度
Q: 快捷键与其他 App 冲突怎么办？
默认截图翻译快捷键 ⌃T 可能与浏览器（Chrome 新标签页）或其他工具冲突。在 ELTA 偏好设置 → 快捷键 中，点击对应输入框，按下新的快捷键组合即可替换（例如改为 ⌥⌃T）。
Q: 支持自定义 API 端点吗？
暂不支持自定义 API 端点。当前版本仅提供 DeepSeek 与 千问（阿里云） 两个官方服务商（均为 OpenAI 兼容格式），在「偏好设置 → API Key」中选择对应服务商并填入官方 API Key 即可使用。
Q: API Key 存储安全吗？
安全。API Key 存储在 macOS 系统 Keychain 中，不会以明文形式写入任何文件。其他应用无法读取 ELTA 保存的 Key。
Q: 翻译结果格式异常怎么办？
- 确认 偏好设置 → API Key 中选择了正确的 AI 后端（DeepSeek / 千问）
- 确保所选模型在服务商侧可用（DeepSeek 默认
deepseek-v4-flash，千问默认qwen-plus） - 可在偏好设置中尝试切换到另一个 provider 测试是否恢复正常
Q: 多显示器/外接屏幕弹窗不显示？
翻译弹窗默认在鼠标当前所在的屏幕上出现。若弹窗跑到另一块屏幕，按下 `（可自定义）即可切换到当前屏幕。
反馈
遇到问题或有建议？欢迎直接发邮件给我：
建议在邮件中附上：问题描述、macOS 版本、使用的翻译方式（截图 / 划词），如能附上截图更好。