安装指南

从下载到第一次划词，大约五分钟。需要 macOS 15 或更新版本，以及 Apple Silicon 的 Mac。

下载 lexi 0.5.1zip 压缩包，约 3 MB

1. 下载并解压

下载 lexi-0.5.1.zip，在「下载」文件夹里双击解压。
把 lexi.app 拖到「应用程序」文件夹。

2. 首次打开：处理「无法验证开发者」提示

lexi 目前不在 Mac App Store 上架，也未经 Apple 公证，所以第一次打开会被 macOS 拦下，这是正常现象，只需要处理一次。

双击 lexi。macOS 弹出「无法打开“lexi”，因为 Apple 无法检查其是否包含恶意软件」之类的提示，点「完成」，不要点「移到废纸篓」。
打开「系统设置 › 隐私与安全性」，向下滚动到「安全性」一栏，会看到「已阻止“lexi”以保护 Mac」，点旁边的「仍要打开」。
输入登录密码或使用触控 ID 确认，再点一次「打开」。

之后再打开 lexi 就和普通应用一样。习惯用终端的读者也可以直接去掉隔离标记：

xattr -dr com.apple.quarantine /Applications/lexi.app

lexi 的源码公开在 GitHub，不放心的话可以自行编译。

3. 开启辅助功能权限

macOS 只允许拥有辅助功能权限的应用读取其他应用里选中的文字，这是划词翻译的前提。

lexi 启动后会出现在菜单栏右侧，显示为「lexi」。点它，选「开启划词权限…」，系统会跳到对应设置页。
在「系统设置 › 隐私与安全性 › 辅助功能」列表里，把 lexi 的开关打开。
回到 lexi 设置 › 阅读，「权限」一栏会显示「划词权限已开启」。

lexi 只在你触发取词的那一刻读取当前选区，密码框内容永远不会被读取。

4. 下载翻译语言包

Apple 的翻译引擎需要先下载对应语言包，每种语言下载一次，之后离线可用。汉字读音不需要语言包。

打开 lexi 设置 › 语言，在「本机语言包」里点英语（或日语、韩语、法语）旁边的「下载」，按系统提示完成。
也可以到「系统设置 › 通用 › 语言与地区 › 翻译语言」下载。德语、西班牙语、俄语等在那里下载。

5. 选一个顺手的快捷键

组合	适合
`⌥` `（默认）	左手一次按到，和大多数软件不冲突
`⌃` `⌥` `T`	Option + ` 被终端或输入法占用时
双击左侧 `⌘`	不想记组合键；注意误触

在常用阅读应用里（Preview、Word、Chrome、Safari、Obsidian 等），还可以打开「选中文字后自动翻译」，松开鼠标浮窗就出现。菜单栏里的「划词自动翻译」可以随时开关。

6. 开始使用

在任何应用里选中一个词，按下快捷键。浮窗出现在光标旁边，显示翻译；点「词典与来源」展开释义、牛津和剑桥链接；点扬声器朗读。按 Esc 或点击别处，窗口退回去。

更新

下载新版本的 zip，解压后把 lexi.app 拖到「应用程序」替换旧版即可。设置、词典密钥、语言偏好和授权码都会保留。更新后如果快捷键无反应，到「辅助功能」里把 lexi 的开关关掉再打开；仍不行就用「−」删除 lexi，再从「应用程序」重新添加。

卸载

退出 lexi，把「应用程序」里的 lexi.app 移到废纸篓。若想清除设置，再删除 ~/Library/Application Support/lexi 文件夹，并在「辅助功能」列表里移除 lexi。钥匙串里保存的可选密钥可以在「钥匙串访问」中搜索 com.lexilens.reader 删除。

常见问题

菜单栏没有 lexi。菜单栏图标太多时会被挤到屏幕外，试试关闭几个其他菜单栏应用，或直接再双击一次 lexi，它会弹出翻译窗口。
提示「没有取得选区」。个别应用不向系统暴露选区。先按 ⌘ C 复制，再从菜单栏选「翻译剪贴板」；或者在设置里确认「取词兼容模式」已开启。
英文短词被识别成法语或德语。在浮窗「词典与来源」里把原文语言固定为英语。

更多问题见常见问题。