README_ZH.md

Easydict

Easy to look up words or translate text

🇨🇳 🇺🇸 🇯🇵 🇰🇷 🇫🇷 🇪🇸 🇵🇹 🇮🇹 🇷🇺 🇩🇪 🇸🇦 🇸🇪 🇳🇱 🇷🇴 🇹🇭 🇸🇰 🇭🇺 🇬🇷 🇩🇰 🇫🇮 🇵🇱 🇨🇿 🇹🇷 🇱🇹 🇱🇻 🇺🇦 🇧🇬 🇮🇩 🇲🇾 🇸🇮 🇪🇪 🇻🇳 🇮🇷 🇵🇰 🇹🇱 🇹🇦 🇮🇳 🇵🇭 🇫🇮 🇰🇭 🇱🇦 🇧🇳 🇲🇲 🇳🇴 🇷🇸 🇭🇷 🇲🇳 🇮🇱

Easydict（易词典）

Easydict 是一个简洁易用的 Raycast 词典扩展，可轻松优雅地查找单词或翻译文本，特别针对英语和中文单词进行了优化。开箱即用，能自动识别输入文本语言，目前支持 Linguee 和有道词典查询，支持 OpenAI, 🍎苹果系统翻译，DeepL，谷歌，Bing, 百度，腾讯，火山，有道和彩云翻译。

功能

• 开箱即用，便捷查找单词或翻译文本。
• 自动识别输入语言，自动查询目标偏好语言。
• 提供丰富的单词查询信息，包括基本翻译，包含该单词的考试类型，发音，多种词性和释义，形式和时态，网络翻译和网络短语。
• 支持划词查询，默认启用。配合快捷键食用效果更佳。
• 支持 OCR 截图翻译。
• 支持打开 欧路词典 快速查词（若电脑上有安装）。
• 支持自动播放单词发音。使用 Cmd + S 手动播放单词发音。
• 支持有道文本合成语音（TTS）。
• 支持手动排序查询结果。
• 支持 Arguments。
• 支持 Fallback Commands。
• 支持系统代理。
• 支持 Linguee 和有道词典查询。
• 支持 macOS 系统翻译。详情请看 如何在 Easydict 中使用 🍎 macOS 系统翻译？
• 支持 OpenAI, DeepL，Google，Bing，百度，腾讯，火山，有道和彩云翻译。
• 支持 48+ 种语言。

如果觉得这个扩展还不错，给个 Star ⭐️ 支持一下吧 (^-^)

---

推荐

我另一个项目，Easydict ，一个简洁优雅的翻译词典 macOS App。开箱即用，支持离线 OCR 识别，支持有道词典，🍎 苹果系统翻译，DeepL，谷歌，百度和火山翻译。

查单词

翻译文本

自动划词查询

OCR 截图翻译

---

Arguments

有道 - 现代汉语词典

艾

Linguee 词典：英语 <--> 中文

float

Linguee 词典：英语 <--> 法语

good

查看更多（快捷键 Cmd + M）

文本翻译

安装

Easydict 是一个 Raycast extension，因此需要先安装 Raycast。

Raycast 是一款速度极快、完全可扩展的启动器。与 Alfred 类似，但它完全免费！

从 Raycast 商店安装

手动安装

git clone https://github.com/tisfeng/Raycast-Easydict.git && cd Raycast-Easydict

npm install && npm run dev

---

进阶

实际上，你不需要做任何额外设置它就能工作得很好。以下是进阶文档，面向那些希望更好地使用 Easydict 或想了解该扩展工作原理的用户。

语言支持

目前总计支持 48 种语言：简体中文，繁体中文，英语，日语，韩语，法语，西班牙语，葡萄牙语，意大利语，德语，俄语，阿拉伯语，瑞典语，罗马尼亚语，泰语，斯洛伐克语，荷兰语，匈牙利语，希腊语，丹麦语，芬兰语，波兰语，捷克语，土耳其语，立陶宛语，拉脱维亚语，乌克兰语，保加利亚语，印尼语，马来语，斯洛文尼亚语，爱沙尼亚语，越南语，波斯语，印地语，泰卢固语，泰米尔语，乌尔都语，菲律宾语，高棉语，老挝语，孟加拉语，缅甸语，挪威语，塞尔维亚语，克罗地亚语，蒙古语，希伯来语。

语言识别

目前支持百度，腾讯，火山，苹果和 Bing，总计 5 家语种识别 API。其中苹果语种识别为 macOS 系统功能，但需要安装一个快捷指令才能使用。参考 如何在 Easydict 中使用 🍎 macOS 系统翻译？

为保护用户隐私，默认只启用了 Bing 语种识别（不需要 App Key，也不会记录任何用户个人数据！），而其他语种识别 API 仅在对应的翻译功能开启时才启用。但注意，通常来说开启的语种识别 API 种类越多，识别文本的准确度会越高，响应速度也会越快。

各家语种识别服务支持的语言详情如下：

语言	Bing	🍎 苹果	百度	火山	腾讯
中文（简体）	✅	✅	✅	✅	✅
中文（繁体）	✅	❌	❌	✅	❌
英语	✅	✅	✅	✅	✅
日语	✅	✅	✅	✅	✅
韩语	✅	✅	✅	✅	✅
法语	✅	✅	✅	✅	✅
西班牙语	✅	✅	✅	✅	✅
葡萄牙语	✅	✅	✅	✅	✅
意大利语	✅	✅	✅	✅	✅
德语	✅	✅	✅	✅	✅
俄语	✅	✅	✅	✅	✅
阿拉伯语	✅	✅	✅	✅	❌
瑞典语	✅	✅	✅	✅	❌
罗马尼亚语	✅	✅	✅	✅	❌
泰语	✅	✅	✅	✅	✅
斯洛伐克语	✅	✅	✅	✅	❌
荷兰语	✅	✅	✅	✅	❌
匈牙利语	✅	✅	✅	✅	❌
希腊语	✅	✅	✅	✅	❌
丹麦语	✅	✅	✅	✅	❌
芬兰语	✅	✅	✅	✅	❌
波兰语	✅	✅	✅	✅	❌
捷克语	✅	✅	✅	✅	❌
土耳其语	✅	✅	✅	✅	❌
立陶宛语	✅	✅	✅	✅	❌
拉脱维亚语	✅	✅	✅	✅	❌
乌克兰语	✅	✅	✅	✅	❌
保加利亚语	✅	✅	✅	✅	❌
印尼语	✅	✅	✅	✅	✅
马来语	✅	✅	✅	✅	✅
斯洛文尼亚语	✅	✅	✅	✅	❌
爱沙尼亚语	✅	✅	✅	✅	❌
越南语	✅	✅	✅	✅	✅
波斯语	✅	✅	✅	✅	❌
印地语	✅	✅	✅	✅	❌
泰卢固语	✅	✅	✅	✅	❌
泰米尔语	✅	✅	✅	✅	❌
乌尔都语	✅	✅	✅	✅	❌
菲律宾语	✅	✅	✅	✅	❌
高棉语	✅	✅	✅	✅	❌
老挝语	✅	✅	✅	✅	❌
孟加拉语	✅	✅	✅	✅	❌
缅甸语	✅	✅	✅	✅	❌
挪威语	✅	✅	✅	✅	❌
塞尔维亚语	✅	✅	✅	✅	❌
克罗地亚语	✅	✅	✅	✅	❌
蒙古语	✅	✅	✅	✅	❌
希伯来语	✅	✅	✅	✅	❌

词典

有道词典

支持 5 种语言，（中文），英语，法语，日语，韩语。

Linguee 词典

支持 19 种语言，（中文，日语，俄语），英语，法语，西班牙语，葡萄牙语，意大利语，德语，瑞典语，罗马尼亚语，斯洛伐克语，荷兰语，匈牙利语，希腊语，丹麦语，芬兰语，波兰语，捷克语。

Linguee 默认支持系统代理。

翻译

目前支持 DeepL，Google，Bing，🍎 系统翻译，百度，腾讯，火山，有道和彩云翻译，总计 9 家翻译服务。

其中 Google 和 DeepL 翻译默认会走系统代理（DeepL 不走代理也能用，但有时会请求超时）。

注意 ⚠️：由于目前 Google 翻译中国版无法使用，只能使用国际版，因此需要走代理才能使用 Google 翻译。

各项翻译服务支持的语言详情如下：

语言	有道翻译	DeepL	Google 翻译	Bing 翻译	🍎 系统翻译	百度翻译	火山翻译	腾讯翻译	彩云小译
中文（简体）	✅	✅	✅	✅	✅	✅	✅	✅	✅
中文（繁体）	✅	⚠️	✅	✅	⚠️	✅	✅	✅	⚠️
英语	✅	✅	✅	✅	✅	✅	✅	✅	✅
日语	✅	✅	✅	✅	✅	✅	✅	✅	✅
韩语	✅	❌	✅	✅	✅	✅	✅	✅	❌
法语	✅	✅	✅	✅	✅	✅	✅	✅	❌
西班牙语	✅	✅	✅	✅	✅	✅	✅	✅	❌
葡萄牙语	✅	✅	✅	✅	✅	✅	✅	✅	❌
意大利语	✅	✅	✅	✅	✅	✅	✅	✅	❌
德语	✅	✅	✅	✅	✅	✅	✅	✅	❌
俄语	✅	✅	✅	✅	✅	✅	✅	✅	❌
阿拉伯语	✅	❌	✅	✅	✅	✅	✅	✅	❌
瑞典语	✅	✅	✅	✅	❌	✅	✅	❌	❌
罗马尼亚语	✅	✅	✅	✅	❌	✅	✅	❌	❌
泰语	✅	❌	✅	✅	❌	✅	✅	✅	❌
斯洛伐克语	✅	✅	✅	✅	❌	✅	✅	❌	❌
荷兰语	✅	✅	✅	✅	✅	✅	✅	❌	❌
匈牙利语	✅	✅	✅	✅	❌	✅	✅	❌	❌
希腊语	✅	✅	✅	✅	❌	✅	✅	❌	❌
丹麦语	✅	✅	✅	✅	❌	✅	✅	❌	❌
芬兰语	✅	✅	✅	✅	❌	✅	✅	❌	❌
波兰语	✅	✅	✅	✅	✅	✅	✅	❌	❌
捷克语	✅	✅	✅	✅	❌	✅	✅	❌	❌
土耳其语	✅	❌	✅	✅	✅	✅	✅	✅	❌
立陶宛语	✅	✅	✅	✅	❌	✅	✅	❌	❌
拉脱维亚语	✅	✅	✅	✅	❌	✅	✅	❌	❌
乌克兰语	✅	✅	✅	✅	❌	✅	✅	❌	❌
保加利亚语	✅	✅	✅	✅	❌	✅	✅	❌	❌
印尼语	✅	✅	✅	✅	✅	✅	✅	✅	❌
马来语	✅	❌	✅	✅	❌	✅	✅	✅	❌
斯洛文尼亚语	✅	✅	✅	✅	❌	✅	✅	❌	❌
爱沙尼亚语	✅	✅	✅	✅	❌	✅	✅	❌	❌
越南语	✅	❌	✅	✅	✅	✅	✅	✅	❌
波斯语	✅	❌	✅	✅	❌	✅	✅	❌	❌
印地语	✅	❌	✅	✅	❌	✅	✅	❌	❌
泰卢固语	✅	❌	✅	✅	❌	✅	✅	❌	❌
泰米尔语	✅	❌	✅	✅	❌	✅	✅	❌	❌
乌尔都语	✅	❌	✅	✅	❌	✅	✅	❌	❌
菲律宾语	✅	❌	✅	✅	❌	✅	✅	❌	❌
高棉语	✅	❌	✅	✅	❌	✅	✅	❌	❌
老挝语	✅	❌	✅	✅	❌	✅	✅	❌	❌
孟加拉语	✅	❌	✅	✅	❌	✅	✅	❌	❌
缅甸语	✅	❌	✅	✅	❌	✅	✅	❌	❌
挪威语	✅	❌	✅	✅	❌	✅	✅	❌	❌
塞尔维亚语	✅	❌	✅	✅	❌	✅	✅	❌	❌
克罗地亚语	✅	❌	✅	✅	❌	✅	✅	❌	❌
蒙古语	✅	❌	✅	✅	❌	✅	✅	❌	❌
希伯来语	✅	❌	✅	✅	❌	✅	✅	❌	❌

注意：⚠️ 表示不支持将源语言翻译为繁体中文，如 DeepL 和系统翻译。若输入繁体中文进行翻译，将被视为简体中文。

注意：⚠️ 有道翻译在使用个人 App Key 时才支持所有语言，不带 App Key 版本仅支持部分翻译语言。

注意：⚠️ 百度翻译对于非常见语种，仅企业已认证的尊享版用户可调用，未认证的非尊享版用户调用将返回错误。（个人 App Key）

偏好语言

默认偏好语言为简体中文和英文。您可以根据自己的喜好进行更改。

偏好语言有两个主要功能：

首先，它提高了输入文本语言自动识别的准确性。

在自动识别过程中，偏好语言将按顺序优先。这是因为一些单词可能同时代表多种语言，自动识别程序无法按预期工作。在大多数情况下，输入文本的自动识别功能都能正常工作，只有极少数特殊情况除外。例如，有道翻译会自动将英语单词 heel 识别为荷兰语，然后翻译结果就不是我们所期望的。此时，如果您的 Easydict 偏好语言包含英语，它将首先被识别为英语并正确翻译。

其次，它用于确认目标翻译语言。

例如，如果您任意输入一个句子，它将被翻译成第一种偏好语言。如果输入句子自动识别的语言与第一种偏好语言相同，它将自动翻译为第二种偏好语言。

划词查询

自动查询最前应用程序选定文本，默认开启。

为了更好地配合划词查询功能，建议为 Easydict 设置一个快捷键，例如 Cmd + E，这样在鼠标取词后，您可以直接通过快捷键唤醒 Easydict 查词，这将非常流畅和优雅。

自动播放单词发音

查询单词后自动播放单词发音，默认开启。

注意，当该选项开始时，仅当查询的内容被判定为 `is_Word` 且为英语时才会自动播放语音，例如 `good`, `look for` 等。其他查询内容，可通过快捷键 `Cmd + S` 播放语音。 播放语音的内容：英语单词优先采用在线的有道词典发音，其他则使用有道翻译的 TTS 服务（若有有道 App Key）。长文本播放使用 say 命令。

使用快捷键 Cmd + S 播放单词发音。

选择目标语言

指定目标语言功能。默认关闭。

默认情况下，扩展将自动选择偏好语言作为目标翻译语言。但有时如果您想手动指定某一种语言作为目标语言，您就可以在偏好设置中开启该选项，然后就能在操作面板中临时选择另一种目标语言。

手动排序查询结果

你可以按照自己的偏好对查询结果显示进行排序，默认是 Youao Dictionary, Linguee dictionary, OpenAI, DeepL, Google, Bing, Apple, Baidu, Tencent, Volcano, Youdao, Caiyun。

大小写不敏感，使用逗号分隔开。例如：youdao dictionary, linguee dictionary, openai, deepl, google, bing, apple, baidu, tencent, volcano, youdao, caiyun。 也可仅指定部分排序，如：youdao dictionary, apple, tencent，此时程序实际排序是：youdao dictionary, apple, tencent, linguee dictionary, openai, deepl, google, bing, baidu, volcano, youdao, caiyun。

注意：以上排序是总体排序，若某项翻译服务未开启，排序会自动忽略。

苹果 🍎 系统翻译

Easydict 支持 MacOS 系统翻译，需搭配快捷指令食用，详情请看 如何在 Easydict 中使用 macOS 苹果系统翻译？

支持系统代理

开启该功能后，Easydict 会尝试获取 Mac 系统代理，若成功，则后续的网络请求都会通过系统代理发送。默认关闭。此功能是为了对抗 IP 封锁（某些服务如 Linguee 对 IP 有频率限制），但开启后会使请求响应速度变慢，因此请仅在有需要时启用。

注意 ⚠️：请不要在使用抓包工具 MitM 的情况下开启 Use System Proxy，否则部分服务请求会报证书错误，例如 https://github.com/tisfeng/Raycast-Easydict/issues/18。

PopClip 调用

你需要先安装 PopClip，然后为 Easydict添加一个快捷键，如 Cmd + E，那么你就可以通过 PopClip 快速打开 Easydict 啦！

使用方法：选中以下代码块，PopClip 会显示 "安装 Easydict"，点击它即可。

# popclip

  name: Easydict
  icon: search E
  key combo: command E

参考：https://github.com/pilotmoon/PopClip-Extensions#extension-snippets-examples

翻译服务

为了方便使用，我们提供了一些内置翻译服务的 appId 和 appKey，但这些服务本身是有请求频率限制的。如果许多人同时使用它们，它可能会变慢甚至停止。因此，为了获得更好的使用体验，您最好申请自己的 appId 和 appKey，替换内置的服务。

别担心，这些翻译服务有免费配额。一般来说个人使用足够了。

下列申请教程来自 Bob，跟随教程应该很快就能完成申请。

• 有道翻译：服务需勾选 文本翻译 和 语音合成。（注：有道向每个账户赠送 50 元体验金，目测可免费使用 1 年以上～）

• 百度翻译

• 腾讯翻译

• 火山翻译

• 彩云小译

• DeepL

致谢

• 这个项目的灵感来自 raycast-Parrot 和 Bob，且初始版本是以 raycast-Parrot 为基础而开发的。Easydict 改进了许多 UI 显示，添加了更实用的功能，删除了一些复杂或不适当的操作，并对原始项目进行了大量优化和改进。
• OCR 截图翻译功能参考了 ScreenOCR，感谢 aidevjoe 的 PR feat: add OCR recognition。