如何用有道翻译 Alfred Workflow 实现极速单词查询？完整新手指南 🚀

你是否经常在阅读英文资料时遇到生僻单词？有道翻译 Alfred Workflow 是一款专为 macOS 用户打造的高效翻译工具，通过 Alfred 搜索框即可快速调用有道翻译 API，实现单词和语句的即时翻译，还支持发音、历史记录保存等实用功能。本文将带你从安装到精通，让翻译效率提升 10 倍！

🌟 为什么选择有道翻译 Alfred Workflow？

这款开源工具（项目路径：gh_mirrors/wh/whyliam.workflows.youdao）基于 Python 开发，核心功能通过 youdao.py 实现。与传统翻译方式相比，它的优势在于：

• ⚡ 极速响应：无需打开浏览器，Alfred 内一键完成翻译
• 📋 多操作支持：翻译结果可直接复制、发音或保存到生词本
• 🔄 历史记录：自动存储查询记录，方便复习（通过 get_history_data() 函数实现）

📥 三步完成安装与配置

1. 准备 Python 环境

确保系统已安装 Python 3.x：

python3 --version

若未安装，建议通过 Homebrew 快速安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" && brew install python

2. 下载与安装 Workflow

1. 克隆项目仓库：

git clone https://gitcode.com/gh_mirrors/wh/whyliam.workflows.youdao

2. 双击项目中的 whyliam.workflows.youdao.alfredworkflow 文件，Alfred 将自动导入工作流

3. 配置有道 API 密钥 🔑

这是实现翻译功能的核心步骤，需要有道智云账号的 API 密钥：

注册与创建应用

1. 访问 有道智云官网 注册账号（新用户可获得 100 元体验金）
2. 进入「应用总览」创建应用，服务类型勾选「文本翻译」和「语音合成」（如需发音功能）

有道翻译应用创建界面，服务类型选择示意图

获取 API 密钥

在「我的应用」中复制 应用 ID 和 应用密钥：

有道翻译 API 密钥获取位置示意图

配置到 Workflow

1. 在 Alfred 工作流列表中右键点击「Youdao」
2. 选择「Configure Workflow」，粘贴获取的密钥：

Alfred Workflow 密钥配置入口

有道 API 密钥填写界面

💡 实用功能与使用技巧

基础翻译操作

在 Alfred 中输入关键词 yd + 待翻译内容：

• yd hello world → 获取中英文互译结果
• 按 Enter 复制翻译文本
• 按 Cmd+Enter 播放单词发音（需配置语音合成服务）

高级功能

• 历史记录：输入 ydh 查看翻译历史
• 生词本同步：通过 saveword.py 脚本实现与有道云生词本同步
• 语音切换：支持美音/英音切换（通过 add_phonetic() 函数控制）

🛠️ 常见问题解决方案

依赖安装失败

若出现 ModuleNotFoundError，尝试手动安装依赖：

cd /data/web/disk1/git_repo/gh_mirrors/wh/whyliam.workflows.youdao && pip3 install -r requirements.txt

API 调用失败

• 检查密钥是否填写正确（区分「应用 ID」和「应用密钥」）
• 确认网络连接正常，服务器 IP 未被限制（不要填写应用设置中的「服务器 IP」项）
• 查看错误日志：tail -f ~/Library/Logs/AlfredWorkflowLog/whyliam.workflows.youdao.log

发音功能异常

确保创建应用时已勾选「语音合成」服务，且余额充足（免费用户有一定额度限制）

📚 扩展资源

• 官方文档：Introduction/有道翻译.md
• 核心源码：youdao.py
• Alfred Workflow 开发指南：workflow/workflow3.py

通过这款工具，你可以彻底告别切换应用翻译的繁琐流程。现在就动手配置，让英文阅读效率飞起来吧！如有问题，欢迎在项目仓库提交 Issue，开源社区将为你提供支持。