Skip to content

Latest commit

 

History

History
171 lines (114 loc) · 6.15 KB

File metadata and controls

171 lines (114 loc) · 6.15 KB

MoePeek Icon

MoePeek

轻量原生的 macOS 菜单栏翻译工具,选中即译。

English | 中文

GitHub Release Downloads Platform Swift License

MoePeek 预览

功能

翻译方式

  • 划词翻译:在任意应用中选中文字,浮窗即时展示翻译结果
  • OCR 截图翻译:框选屏幕区域,识别并翻译其中的文字
  • 剪贴板翻译:一键翻译剪贴板中的内容
  • 手动输入:输入或粘贴文字进行翻译

内置翻译服务

免费 API LLM 系统
Google 翻译 DeepL OpenAI Apple 翻译
Bing 翻译 百度翻译 Anthropic (macOS 15+,离线可用)
有道翻译 小牛翻译 DeepSeek
彩云小译 OpenRouter
DeepLX 智谱 GLM
Ollama(本地)
LM Studio(本地)

更多特性

  • 智能语言检测,支持 14 种语言,自动切换翻译方向
  • 翻译结果文本朗读,基于 Apple 内置语音合成
  • 非激活浮窗,永远不会抢走当前应用焦点
  • 三层文本抓取:Accessibility API → AppleScript → 剪贴板逐级回退
  • 所有快捷键均可自定义
  • 内置 Sparkle 自动更新

为什么选择 MoePeek

  • 约 5 MB 安装体积:纯 Swift 6 构建,仅 3 个依赖。没有 Electron,没有 WebView。
  • 约 50 MB 后台内存:系统性防控内存泄漏,长时间挂后台也稳定。
  • 注重隐私:Apple 翻译完全在设备端运行。
  • 开源项目:AGPL-3.0 协议,欢迎提 Issue 和反馈。

局限性与替代方案

MoePeek 是一个纯 AI vibe coding 的自用项目。它能满足我个人的使用需求,但并不追求做成一个完善的商业级产品——划词、窗口交互中有大量的 edge case,商业工具花了多年时间才踩完这些坑,MoePeek 肯定还漏掉了不少。

如果你需要更健壮的解决方案,以下工具非常优秀:

  • Clicknow — 功能丰富、持续维护的划词翻译工具
  • PopClip — macOS 划词操作的标杆之作,拥有丰富的插件生态

安装

GitHub Releases 下载最新的 .dmg.zip,将 MoePeek.app 拖入 /Applications

使用

首次启动时,MoePeek 会引导你完成权限设置:

  • 辅助功能:用于通过 Accessibility API 获取选中文本
  • 屏幕录制:用于 OCR 截图翻译

默认快捷键

操作 快捷键
划词翻译 ⌥ D
OCR 截图 ⌥ S
手动输入 ⌥ A
剪贴板翻译 ⌥ V

所有快捷键均可在设置 → 通用中自定义。

PopClip 集成

如果你使用 PopClip,可以直接从 PopClip 菜单栏一键触发 MoePeek 翻译。

安装扩展:

  1. 确保 MoePeek 已安装并正在运行。
  2. 从最新 Release 下载 MoePeek.popclipext.zip 并解压。
  3. 移除隔离属性,否则 macOS 可能阻止加载扩展:
    xattr -dr com.apple.quarantine /解压后的路径/MoePeek.popclipext
  4. 双击 MoePeek.popclipext,PopClip 会自动完成安装。
  5. 在任意应用中选中文字 → 点击 PopClip 栏中的 MoePeek 图标即可翻译。

提示: 如果 PopClip 仍报错,请确认 MoePeek.app 本身也已移除隔离属性——参见下方常见问题。(相关 Issue

常见问题

macOS 提示"已损坏,无法打开"

由于应用未经 Apple 公证,macOS Gatekeeper 可能会拦截。这并非文件损坏,而是系统安全机制。解决方法:

  1. 打开终端(Terminal)
  2. 执行:
sudo xattr -r -d com.apple.quarantine /Applications/MoePeek.app

之后即可正常打开。

引导页未显示 / 想重新触发引导流程

重置所有用户偏好设置,恢复到首次启动状态:

defaults delete com.nahida.MoePeek

重新打开应用即可。

参与贡献

欢迎提 Issue 和 PR!有几点说明:

  • 平时上班较忙,可能无法及时回复,通常会集中在周末统一处理 Issue 和 PR。
  • 欢迎 Fork 进行二次开发。根据 AGPL-3.0 协议,衍生项目必须同样开源

致谢

MoePeek 的诞生受到了 EasydictBob 的启发,感谢这些项目的开拓与贡献。

依赖库:

贡献者

赞助

在爱发电上赞助

Star History

Star History Chart

许可证

AGPL-3.0