故障排查
哪里不对劲？在下面找到你的问题。如果你看到的报错就在这里，它会告诉你这是什么意思、该怎么办。
快捷键与选区
划词翻译没反应
划词翻译 ⌥D 靠辅助功能权限读取你选中的文字。有些 App 不把选区交给它：Electron App（很多聊天和笔记 App 是这么做的）、终端，以及少数浏览器。在这些地方，按了没反应。
你有好几个不依赖读取选区的替代办法：
- 剪贴板翻译 ⌥C。自己用 ⌘C 复制文字，再按 ⌥C。这个不需要权限。
- 复制两次即翻译。在设置 ▸ 快捷键 ▸ 快捷操作里打开，然后快速按两次 ⌘C。它在每个 App 里都能用，包括 Electron App 和终端。
- PopClip 或 Raycast，同样不需要辅助功能权限。
静默划词翻译 ⇧⌥D 是把结果粘贴进去，而不是写进去，所以它比普通划词翻译能用的地方更多，上面那些 App 里也大多能用。
快捷键按了没反应
多半是别的 App 占用了这个组合键。同一个全局快捷键只能被一个 App 持有，而 TransOne 无法替你察觉这种冲突。在设置 ▸ 快捷键里换录一个别的组合。详见键盘快捷键。
复制两次没触发
你两次按 ⌘C 靠得太近了。间隔小于约 0.2 秒的两次按键会被当成一次复制，什么都不会发生。把 ⌘C 按得稍微慢一点，两次之间留一点点间隔。
复制两次不该触发时却触发了
有个剪贴板管理器或同步工具在你复制之后紧接着往剪贴板里写东西，看起来就像第二次 ⌘C。在设置 ▸ 快捷键 ▸ 快捷操作里关掉这个手势，改用剪贴板翻译 ⌥C。
截图与权限
截图功能仍然说缺权限
屏幕录制权限要在 TransOne 退出并重新打开之后才生效，光授权还不够。弹出的引导卡片上有一个退出并重新打开按钮，点它，截图功能就能用了。
更新后辅助功能失效了
TransOne 更新之后，macOS 有时会把更新过的 App 从辅助功能列表里剔掉，于是你之前给的权限就失声了。打开系统设置 ▸ 隐私与安全性 ▸ 辅助功能，把 TransOne 重新打开。如果还不行，用减号把 TransOne 从列表里移除，再重新加进去。这是 macOS 的行为，不是 TransOne 能控制的。详见权限。
菜单栏图标不见了
TransOne 没有程序坞图标，也没有主窗口，所以它的菜单栏图标一旦不见，就像整个 App 消失了一样。通常只是菜单栏太挤，被 macOS 藏起来了。按住 ⌘ 拖动菜单栏图标，重新排一下、腾出空位。你也可以在设置 ▸ 通用里更换或恢复图标。
引擎与密钥
下面每条消息，都是某个引擎在翻译失败时给出的提示。
「认证失败。请在偏好设置中检查 API 密钥。」
引擎拒绝了你的凭据。API 密钥（或 ID 和 secret）填错了、过期了，或者填成了别的服务的。从菜单栏图标打开偏好设置，进入设置 ▸ 翻译服务，重新填这个引擎的密钥。详见翻译引擎。
「服务请求频率受限。请稍候片刻后重试。」
你发请求的速度超过了引擎允许的上限。稍等一会儿再试。免费接口，比如 Google 翻译（免费），更容易出现这种情况。
「网络错误。请检查你的网络连接。」
TransOne 连不上引擎。检查一下 Mac 是否联网。如果你用了代理，去设置 ▸ 通用 ▸ 代理里检查代理设置。
「请求超时。请重试。」
引擎没在规定时间内回应。通常是一时的网络波动，或者服务繁忙。再试一次。
「服务返回了空译文。」
引擎回应了，却什么内容都没返回。再试一次，或者换个引擎翻这段文字。
「无法判断这是哪种语言，请选择源语言后重试。」
自动检测判断不出这是什么语言，往往是因为文字太短或混了多种语言。在翻译窗口的语言栏里手动指定源语言，再试一次。
「X 的语言包尚未安装。」
这是「系统（设备端）」引擎。Apple 按语言对、按需下载语言包。缺哪个语言包时，翻译窗口会显示一个下载按钮，点它，等下载完成。
「此语言对不支持设备端翻译。」
Apple 的端上翻译不支持这一对语言。换个引擎来翻。详见翻译引擎。
「授权可能已失效，请在设置里更新令牌。」
这来自生词本同步。欧路词典或墨墨背单词的令牌已经失效。打开设置 ▸ 翻译设置，找到生词本那一节，填入一个新的令牌，再点验证。
端上翻译说需要 macOS 15，或者给出一个「下载」按钮
「系统（设备端）」引擎是 Apple 的，需要 macOS 15 或更高版本。在 macOS 14 上只有这一个引擎用不了，其余引擎照常能用。如果你已经在 macOS 15，它给的是下载按钮，那只是这对语言的语言包还没下到你的 Mac 上，点下载即可。想升级到更新的 macOS，去系统设置 ▸ 通用 ▸ 软件更新更新。
连不上 Ollama 或 LM Studio
这两个引擎连的是跑在你自己 Mac 上的服务器。确认对应的 App 正在运行、它的本地服务器已经启动，并且 TransOne 里的 Base URL 和 Model 和它对外提供的一致。默认值：Ollama 是 http://localhost:11434/v1，LM Studio 是 http://localhost:1234/v1。详见本地与离线模型。
翻译质量与语言
译文不对，或者太生硬
不同引擎擅长的语言对不一样。在设置 ▸ 翻译服务里多开几个引擎，把译文并排对比，再留下你信得过的那个来翻这类文字。详见翻译引擎。
翻成了错误的语言
目标语言是根据你对这段文字的设置来定的。打开翻译窗口，在语言栏里手动指定目标语言，这只对这一次有效；或者去设置 ▸ 翻译设置改默认值。
购买与试用
试用到期了
7 天免费试用结束后，只有翻译窗口会被锁住，并显示一张升级卡片。偏好设置和朗读照常可用。想解锁，去设置 ▸ 升级完成一次买断。如果你已经在另一台用同一 Apple 账户的 Mac 上买过 TransOne，改用恢复购买。
还是没解决
发邮件到 [email protected]。想更快得到答复，请一并附上：
- 你的 macOS 版本；
- 你的 TransOne 版本，在设置 ▸ 关于里；
- 你当时用的引擎；
- 你做了什么，结果又是什么。