使用文档
ELTA 是一款专为英语精读设计的 macOS 划词/截图翻译工具。以下文档帮助你快速上手。
安装说明
方式一：手动安装（推荐）
- 前往 下载页面，按提示下载最新版 ELTA.dmg
- 双击打开 DMG，将 ELTA.app 拖入 Applications 文件夹
- 首次打开时，可能提示"无法验证"。macOS 14 及以下：右键点击 ELTA.app → "打开"
- macOS 15 (Sequoia) 及以上：打开终端，输入以下命令后回车：
xattr -cr /Applications/ELTA.app
然后再双击 ELTA 即可正常打开。 - 如若仍然无法打开，请查看页面底部常见问题。
系统要求：macOS 13.0 (Ventura) 或更高版本，支持 Intel 和 Apple Silicon（M 系列）芯片。
初始设置
- 启动 ELTA 后，点击菜单栏的 📖 图标
- 选择 "偏好设置"
- 在 API Key 标签页中，填入你选择的 AI 服务商的 API Key（优先推荐 DeepSeek 服务商）：
- DeepSeek：前往 platform.deepseek.com 获取
- OpenAI：前往 platform.openai.com 获取
- Google Gemini：前往 aistudio.google.com 获取
- 选择对应的服务商（Provider）
- 关闭偏好设置窗口，即可开始使用
使用方式
截图翻译
- 在任意页面（浏览器、PDF 阅读器、电子书等）找到需要翻译的英文
- 按下快捷键 ⌃T
- 鼠标变为十字准星，拖拽框选英文文本区域
- 松开鼠标后，ELTA 自动：
- 截取框选区域的图像
- 调用本地 OCR 识别英文文字
- 发送给 AI 后端翻译
- 在浮动面板显示翻译结果
- 拖动浮动面板可以调整位置，缩放可以调整大小
划词翻译（新增！）
- 在任意应用中选中英文文本
- 按下快捷键 ⇧⌃T（Ctrl+Shift+T）
- ELTA 自动获取选中文字 → 直接 AI 翻译（跳过截图+OCR，速度更快）
💡 对比：截图翻译适合图片/PDF 中的不可选文字；划词翻译适合网页/文档中可选中的文字。
重复翻译
再次按下 ⌃T 可以使用相同区域重复翻译（适合对比不同翻译结果）。
快捷键
| 快捷键 | 功能 | 说明 |
|---|---|---|
| ⌃T | 截图翻译 | 全局可用，框选屏幕区域 → 自动 OCR + 翻译 |
| ⇧⌃T | 划词翻译 | 选中文本后使用，跳过 OCR 直接翻译 |
| Esc（可自定义） | 关闭 | 关闭翻译结果浮动面板，可在偏好设置中修改 |
你可以在 偏好设置 → 快捷键 中自定义截图、划词以及关闭面板的快捷键。
翻译模板
ELTA 支持自定义翻译模板，在 偏好设置 → 模板 中编辑。你可以使用以下占位符：
{text}— 待翻译的英文原文
内置模板
模板名称：精读翻译
我会给你一段英文文本。请你按以下结构输出：
## 中文翻译
（遵循"信达雅"原则，自然流畅的中文翻译）
## 重要词汇
- **单词** | 词性 | 中文释义
（列出句中较重要的词汇，跳过高中大纲基础词汇）
## 常用短语与习语
- 短语/习语：中文释义
（习语请标注【习语】）
原文：
{text}
你可以在偏好设置中添加、编辑或删除自定义模板。
AI 翻译后端
ELTA 当前支持以下 AI 服务商：
| 服务商 | 模型 | 注册地址 |
|---|---|---|
| DeepSeek | deepseek-chat | platform.deepseek.com |
| OpenAI | gpt-4o-mini | platform.openai.com |
| Google Gemini | gemini-2.0-flash | aistudio.google.com |
| Anthropic | claude-3-5-sonnet | console.anthropic.com |
费用说明：ELTA 本身完全免费。翻译功能需要你自行注册 AI 服务商的 API Key，费用由服务商收取。gpt-4o-mini 的价格约为每 100 万 token 输入 $0.15，日常使用成本极低。
权限说明
ELTA 使用翻译功能时，需要两项 macOS 系统权限。首次按下 ⌃T（截图翻译）或 ⇧⌃T（划词翻译）时，系统会自动依次弹出授权提示。
需要哪些权限？为什么？
| 权限 | 用途 | 设置路径 |
|---|---|---|
| 屏幕录制 | 截图翻译功能需要截取屏幕画面进行 OCR 识别 | 系统设置 → 隐私与安全性 → 屏幕录制 |
| 辅助功能 | 划词翻译功能需要读取你在其他 App 中选中的文本 | 系统设置 → 隐私与安全性 → 辅助功能 |
关于音频提示：屏幕录制权限的系统提示中会包含"录制屏幕和音频"字样，这是 Apple 的固定文案，ELTA 不会录制任何音频，仅用于屏幕截图。
Q: 授权后仍提示无权限怎么办？
- 完全退出 ELTA（菜单栏图标 → 退出）
- 打开系统设置 → 隐私与安全性
- 进入「辅助功能」和「屏幕录制」页面
- 分别选中列表中的 ELTA，点击下方
−号删除 - 再点击下方
+号，在弹出的文件选择器中找到/Applications/ELTA.app并添加 - 确保新添加的 ELTA 开关已打开
- 重新打开 ELTA 再试一次
常见问题
Q: 打开 App 时提示"无法验证开发者"？
因为 ELTA 未加入 Apple 开发者计划。系统可能会提示：
"Apple无法验证"ELTA"是否包含可能危害Mac安全或泄漏隐私的恶意软件。"
请前往 系统设置 → 隐私与安全性，在页面最底部找到 ELTA 的提示，例如："已阻止 'ELTA' 保护 Mac"，点击 "仍要打开"。
Q: OCR 识别不出文字？
- 确保框选区域包含清晰的英文文本
- 避免框选过小（建议至少 50×20 像素）
- 确保你的 macOS 版本 ≥ 13.0（Vision OCR 需要 Ventura 以上）
Q: 翻译失败或报错？
- 检查偏好设置中的 API Key 是否正确填入
- 检查选中的 AI 服务商是否与 API Key 匹配
- 确认网络连接正常（OCR 是离线的，但翻译需要联网）
- 查看 API 账户是否有可用额度
Q: 支持 Windows 或 Linux 吗？
目前 ELTA 仅支持 macOS。核心功能依赖 Apple 的 Vision 框架和 Cocoa/AppKit，暂无跨平台计划。