MoePeek：轻量级 macOS 划词翻译工具 #

MoePeek 是什么？ #

MoePeek 是一款使用纯 Swift 6 开发的轻量级 macOS 菜单栏划词翻译工具。你在任意应用中选中文字，即可在弹出的浮动面板里看到即时翻译；除此之外，它还提供 OCR 截图翻译、剪贴板翻译和手动输入翻译，一套快捷键覆盖绝大多数取词场景。

它主打的是轻量、快速、原生。安装体积只有约 5 MB，后台常驻内存稳定在 50 MB 左右，不做 Electron 或 WebView 那样的重型封装；同时可以调用 macOS 15 及以上系统内置的 Apple 翻译服务，让译文在设备端本地完成处理，不必上传到第三方服务器。对于每天需要频繁查词、读外文资料，又不想被大型翻译客户端拖慢系统的 Mac 用户来说，MoePeek 是一个可选项。

MoePeek 以 AGPL-3.0 协议开源，代码公开可查，也欢迎用户提交 Issue 与 PR。

MoePeek 有哪些亮点特色？ #

• 五种翻译模式覆盖全部取词场景：智能翻译按「当前选中内容 → 调用瞬间的剪贴板快照 → 手动输入」的顺序逐级回退，一次触发即可完成；此外还有独立的划词翻译、OCR 截图翻译、剪贴板翻译与手动输入模式，不必再为不同场景切换不同工具。
• 纯 Swift 6 原生开发，体积与内存极致克制：整个应用只有 4 个依赖，不含 Electron 与 WebView，安装体积约 5 MB（应用本体约 7 MB），后台运行内存稳定在约 50 MB；针对长时间常驻场景做了系统性的内存泄漏防护。
• 设备端 Apple 翻译，隐私不出本机：在 macOS 15 及以上系统中，可以直接使用系统内置的 Apple 翻译在本地完成翻译，原文不会离开你的电脑，适合处理敏感文档或内部资料。
• 十余家翻译服务自由组合：免费服务包括 Google 翻译、Bing 翻译、有道翻译、彩云小译与 DeepLX；API 服务包括 DeepL、百度、NiuTrans；大模型服务包括 OpenAI、Anthropic、DeepSeek、OpenRouter、Requesty、智谱 GLM，以及可完全本地运行的 Ollama 与 LM Studio，也可回落到系统级 Apple 翻译。
• 不抢焦点 + 三级取词策略：翻译结果以非激活浮动面板呈现，不会打断当前应用的输入焦点；文本抓取按 Accessitivy API → AppleScript → 剪贴板回退三级执行，尽可能兼容更多软件环境下的选中取词。
• 14 种语言智能识别与方向自动翻转：自动判断源语言与目标语言，必要时自动调换翻译方向，减少反复手动切换语言的操作成本。
• LLM 结果 Markdown 渲染与语音朗读：大模型返回的结果支持 Markdown 渲染，可读性更好；可选保留 Word 等应用中的富文本格式与图片；译文可调用 Apple 内置语音合成朗读出来。
• 开源可审计 + 自动更新 + PopClip 集成：项目以 AGPL-3.0 开源，构建与实现完全透明；内置 Sparkle 自动更新；同时提供 PopClip 扩展，选中文字后点一下 PopClip 工具栏图标即可翻译。

免费下载 MoePeek #

以下为官方提供的安装包，点击链接即可下载。

提示：安装包请优先从官方 GitHub Releases 获取最新版本；上表为镜像备份，版本号与文件大小请以实际下载结果为准。

MoePeek 如何使用？ #

1. 首次启动并授权：将 MoePeek.app 拖入「应用程序」后启动，应用会依次引导你授予两项权限——「辅助功能」用于通过 Accessibility API 抓取选中文本，「屏幕录制」用于 OCR 截图翻译。缺少任一权限，对应功能会失效。
2. 划词翻译（默认 ⌥D）：在任意应用中选中一段文字，按下 ⌥D，即可在浮动面板中看到翻译结果，面板不会抢走当前应用的焦点。
3. OCR 截图翻译（默认 ⌥S）：按下快捷键后框选屏幕区域，MoePeek 会识别区域内的文字并翻译，适合处理图片、视频画面或无法选中的文本。
4. 剪贴板翻译（默认 ⌥V）与手动输入（默认 ⌥A）：⌥V 直接翻译剪贴板当前内容；⌥A 打开输入框，手动键入或粘贴需要翻译的文本。
5. 启用智能翻译：智能翻译默认不绑定快捷键，需要你到「设置 → 通用」中自行设置。它的逻辑是优先使用当前选中内容，若无选中内容则使用触发瞬间的剪贴板快照，两者都为空时打开手动输入框——默认不会改动你已有的快捷键绑定。
6. 配置翻译服务：在设置中可选择免费服务、需要填写 API Key 的 API 服务、LLM 服务，或使用系统自带的 Apple 翻译；本地模型可接入 Ollama 与 LM Studio。
7. （可选）PopClip 集成：从最新 Release 下载 MoePeek.popclipext.zip 并解压，先对扩展执行 xattr -dr com.apple.quarantine /path/to/MoePeek.popclipext 去除隔离属性，再双击 MoePeek.popclipext 由 PopClip 自动安装；之后选中文字点击 PopClip 栏中的 MoePeek 图标即可翻译。

MoePeek 的常见问题？ #

提示「MoePeek.app 已损坏，无法打开」怎么办？ 这是 macOS Gatekeeper 的拦截，并非文件真的损坏——应用未经过 Apple 公证（notarization）。在终端执行 sudo xattr -r -d com.apple.quarantine /Applications/MoePeek.app，然后正常启动即可。

首次引导页没有出现，或者想重新触发引导？ 重置用户偏好即可恢复首次启动状态：在终端执行 defaults delete com.nahida.MoePeek，然后重新启动应用。

PopClip 扩展安装时报错？ 通常是隔离属性未完全清除。除了对 MoePeek.popclipext 执行 xattr -dr com.apple.quarantine，还需要确认 MoePeek.app 本身也已解除隔离（参考上一条），再重新双击安装扩展。

MoePeek 需要付费吗？ 不需要。MoePeek 以 AGPL-3.0 协议开源发布，可免费使用。如果你选择接入 DeepL、OpenAI、百度等第三方 API 服务，费用由对应服务商按其自身定价收取；使用 Google、Bing、有道、Apple 翻译等免费通道则无需额外付费。

翻译功能没有反应，可能是什么原因？ 先检查「系统设置 → 隐私与安全性」中是否已为 MoePeek 开启「辅助功能」（取词必需）和「屏幕录制」（OCR 截图必需）；其次确认快捷键是否被其他应用占用，可在「设置 → 通用」中重新绑定；OCR 场景还需确认框选区域中确实存在可识别文字。

MoePeek 适合替代商业翻译软件吗？ MoePeek 作者明确表示这是一个个人开发的 AI 辅助项目，并非打磨到生产级水准的商业工具，文本选中与窗口处理上仍存在不少边缘情况，作者也建议对稳定性有更高要求的用户考虑 Clicknow、PopClip 等成熟产品。享受它的轻量与开源特性时，也应对偶发的兼容性问题有心理预期。

MoePeek 如何安装？ #

MoePeek 目前仅提供 macOS 版本，安装方式为标准的 DMG 安装：

1. 下载安装包：从上方的下载表格或 GitHub Releases 页面获取最新的 .dmg 或 .zip 文件。
2. 挂载并拖入应用程序：双击 .dmg 打开磁盘映像，将 MoePeek.app 拖拽到「应用程序」（/Applications）文件夹；若下载的是 .zip，解压后同样将 MoePeek.app 拖入「应用程序」。
3. 首次启动授权：打开 MoePeek，按引导流程在「系统设置 → 隐私与安全性」中授予「辅助功能」与「屏幕录制」权限。授权后可能需要重启应用才能生效。
4. 处理 Gatekeeper 拦截（如遇到）：若系统提示应用「已损坏」而无法打开，在终端执行：

   sudo xattr -r -d com.apple.quarantine /Applications/MoePeek.app
   

   随后重新启动应用即可。
5. （可选）安装 PopClip 扩展：如使用 PopClip，按上文「如何使用」中的步骤安装 MoePeek.popclipext 扩展。

说明：MoePeek 未提供 Homebrew Cask 等命令行安装方式，官网亦未说明 Mac App Store 上架计划，请以 GitHub Releases 发布的安装包为准。

MoePeek 如何卸载？ #

卸载 MoePeek 非常简单，按以下步骤操作即可：

1. 退出应用：点击菜单栏中的 MoePeek 图标，选择退出；或在「活动监视器」中结束 MoePeek 进程。
2. 删除主程序：打开「访达 → 应用程序」，将 MoePeek.app 拖入废纸篓，然后清空废纸篓。
3. 清理偏好设置与缓存：MoePeek 的部分配置保存在系统偏好中，如需彻底清理，可在终端执行：

   defaults delete com.nahida.MoePeek
   

   同时可检查 ~/Library/Preferences/、~/Library/Caches/ 与 ~/Library/Application Support/ 下是否存在以 com.nahida.MoePeek 命名的残留文件并手动删除。
4. 移除 PopClip 扩展（如已安装）：打开 PopClip 偏好设置，在扩展列表中找到 MoePeek 并移除，或直接删除此前解压的 MoePeek.popclipext 文件。
5. 回收系统权限：如不再使用，可前往「系统设置 → 隐私与安全性 → 辅助功能 / 屏幕录制」中将 MoePeek 的授权条目移除。