OneMacTools 无法正常工作？按症状查找解决方法
如果 OneMacTools 无法正常工作，它显示的信息通常会指明解决办法。本指南按症状分类：App 无法打开或要求输入密钥、权限被拒绝、快速操作不见了、FFmpeg 或 Apple Intelligence 不可用、任务失败、文件仅在 iCloud 中，或 AI 助手无法连接。每一条都引用了 App 的信息以及解决步骤。
本页内容
从这里开始：阅读信息并查看“历史记录”
OneMacTools 会尽量用浅显的语言说明出了什么问题以及下一步该怎么做。任务失败时，信息会显示在工具中、通知中（对于来自访达、菜单栏、快捷指令或监视文件夹的任务，标题为“*工具名称* 失败”），以及历史记录中，失败的任务会连同其信息一起保留。打开“历史记录”，找到该条目并阅读完整信息；历史记录文档解释了这个列表。
- 确保你的 Mac 运行的是 macOS 26 或更高版本；OneMacTools 无法在更早的版本上运行。
- 更新到最新版本：OneMacTools › 检查更新…。
- 在“系统设置”中更改任何权限后，请退出并重新打开 OneMacTools；macOS 的某些权限只在重新启动 App 后才生效。
OneMacTools 无法打开，或要求输入许可证密钥
macOS 提示无法打开该 App
OneMacTools 经过 Apple 签名和公证，因此 Gatekeeper 通常会直接打开它而不显示警告。如果 macOS 阻止了它，请从下载页面重新下载一份（下载不完整或被修改的副本无法通过 Apple 的检查），将它拖到“应用程序”文件夹中，然后从那里打开。接着确认你的 Mac 运行的是 macOS 26 或更高版本。
打开后显示“激活 OneMacTools”
在这台 Mac 上激活密钥之前，这是正常现象。粘贴购买邮件中的密钥并点按激活。如果 OneMacTools 之前已激活，现在又要求输入密钥，说明每周的许可证检查发现该密钥已退款、已停用，或已为这台 Mac 释放（例如在“管理许可证”页面中）。请重新激活，或参阅许可证密钥帮助了解所有激活错误。
| 许可证信息 | 修复 |
|---|---|
| “找不到该密钥……” | 从收据邮件中重新拷贝完整的密钥。 |
| “……已在其方案允许的最大数量的 Mac 上使用……” | 在“设置 › 许可证”中，或在 /licence 释放一台 Mac。 |
| “无法连接 Dodo Payments……” | 检查互联网连接；暂停 VPN 或网络过滤器。 |
| “该密钥已被停用（已退款或已禁用）。” | 如果出乎你的意料，请联系我们。 |
窗口已关闭，但 App 仍在运行
这是有意为之：关闭窗口后，OneMacTools 会留在菜单栏中，让快速操作和监视文件夹继续工作。点按菜单栏图标即可重新打开它，或在那里选取退出 OneMacTools。如果你关闭了程序坞图标，菜单栏图标会始终显示。
权限被拒绝：录屏、麦克风、文件、自动化
App 要录制屏幕、使用麦克风、读取受保护的文件夹或控制其他 App 之前，macOS 都会先询问。如果你点按了“不允许”，OneMacTools 会告诉你，并说明在哪里更改。
| 信息或症状 | 在哪里解决 |
|---|---|
| “OneMacTools 需要‘屏幕录制’权限……” | 点按打开屏幕录制设置，打开 OneMacTools（如果未列出，请点按 + 并从“应用程序”中选择它），然后退出并重新打开 OneMacTools。屏幕录制、从屏幕抓取文字和截屏会用到此权限。 |
| “OneMacTools 无法使用麦克风……” | 系统设置 › 隐私与安全性 › 麦克风。 |
| “无法录制通话声音……” | 请在“系统设置 › 隐私与安全性 › 录屏与系统录音”中允许录制其他 App 的音频。 |
| “……无法转换……：如果 macOS 请求权限，请允许 OneMacTools 控制……” | 系统设置 › 隐私与安全性 › 自动化（Keynote 讲演、Numbers 表格或 Pages 文稿转换 Office 文件时使用）。 |
| 存储空间界面提示需要完全磁盘访问权限 | 在“系统设置 › 隐私与安全性 › 完全磁盘访问权限”中打开 OneMacTools，然后退出并重新打开它。只会读取文件大小。 |
完整的权限列表、各自的用途以及如何撤销，请参阅隐私与权限。
访达快速操作不见了
OneMacTools 会将其操作添加到访达右键菜单的快速操作和服务下，名称为“OMT: …”。如果你没有看到它们：
- 从“应用程序”安装 OneMacTools 后打开一次，以便 macOS 注册它的服务。
- 在 OneMacTools 中，前往设置 › 你的 Mac 上的任意位置，然后点按打开服务设置…。
- 在 键盘快捷键 › 服务 › 文件和文件夹 下，勾选你需要的 OneMacTools 操作。
- 再次在访达中右键点按文件。快速操作只会针对它们能处理的文件类型显示，因此 PDF 操作不会对照片显示。
如果操作运行了但似乎没有反应，请确认通知已打开（后台任务完成时通知我），并查看“历史记录”。详见访达快速操作。
FFmpeg、Apple Intelligence 和语言错误
“此工具需要 FFmpeg”或“FFmpeg 未安装”
视频和音频工具需要 FFmpeg。点按橙色横幅上的 安装（使用 Homebrew 安装），或在“设置 › 辅助程序”中设置自定路径。如果看到“未安装 Homebrew”，请先从 brew.sh 安装 Homebrew。完整指南：Mac 上的 FFmpeg。yt-dlp（下载视频）、WebP 工具（转换为 WebP）和 Ghostscript（PDF 转 PDF/A）同样如此。
“这台 Mac 目前无法使用 Apple Intelligence”
摘要、改写、会议纪要、询问文档及其他写作功能使用 Apple Intelligence。请在支持它的 Mac 上，于“系统设置 › Apple 智能与 Siri”中打开它，并等待模型下载完成。转写、文字识别和翻译使用其他设备端框架。请参阅设备端 AI。
翻译和转写语言
- “请在‘系统设置 › 通用 › 语言与地区 › 翻译语言’中下载……语言。”“翻译”需要先下载一次这些语言。
- “此语言不支持语音识别。”或“设备端转写尚不支持……”请在工具中选择其他语言。
- “无法判断……使用的语言。”“翻译”会根据文字检测源语言，因此请换一个文字更多的文件，或粘贴一段更长的文字。
任务失败：文件和格式问题
| 信息 | 原因与解决方法 |
|---|---|
| “……仅存在于 iCloud 中；请先下载。” | 该文件是占位文件。请在访达中右键点按它并选择“立即下载”，等云朵图标消失后再运行一次工具。 |
| “……受密码保护。请先移除密码。” | 使用移除密码并输入密码，然后重试。 |
| “……中没有可读取的文字。请先尝试‘提取文字’。” | 这是扫描件。请运行使 PDF 可搜索或“提取文本”，然后重试。 |
| “……中没有 macOS 可读取的视频轨道。请先将其转换为 MP4。” | 运行转换视频转为 MP4，然后再使用原来的工具。 |
| “这台 Mac 无法转换该视频。” | macOS 不支持该格式；请先用 FFmpeg 工具进行转换。 |
| “……太长，无法压缩到……MB。请选择更大的尺寸或先进行剪辑。” | “压缩到指定大小”无法在保证可观看画质的前提下达到该目标；请提高限制，或先剪辑。 |
| “结束时间必须晚于开始时间。” | 检查“开始”和“结束”栏，例如 0:12 和 1:30。 |
| “未生成任何内容。” | 该工具没有找到可对这些文件执行的操作。请检查选项和输入文件。 |
| “网站拒绝了下载（HTTP 403）……” | 通常几分钟内就会恢复；否则请在终端中运行 brew upgrade yt-dlp。 |
其他大多数信息是要求补充缺少的输入（“请先粘贴一些文字。”“添加要签署的 PDF。”）或检查器中的某个值。填写后再次运行即可。除非整批都成功，否则不会有任何内容移入你的输出文件夹，因此失败的任务绝不会留下半套结果，也不会动你的原件。
AI 助手无法通过 MCP 连接
- “OneMacTools isn’t letting AI assistants in.”请在“设置 › AI 助手”中开启 允许 AI 助手使用 OneMacTools。
- “OneMacTools isn’t activated yet.”请先激活 App。
- 助手的列表中没有 OneMacTools。请使用 添加到 Claude Desktop…、添加到 Claude Code…、添加到 Cursor… 或 添加到 Codex…，然后按确认信息操作：退出并重新打开 Claude，或新开一个 Claude Code 或 Codex 会话（Cursor 会立即载入）。按钮呈灰色表示未找到该 App，请改用 拷贝设置代码片段。
- “The user didn’t answer, so nothing was done.”操作会等待你在 OneMacTools 中点按“允许”；五分钟内没有回应即视为拒绝。
- “OneMacTools didn’t open, so the request couldn’t be shown to the user.”请从“应用程序”中打开 OneMacTools，然后再问一次。
- “OneMacTools Files is off.”请在“文件”中开启“为我的文件建立索引”，以便助手搜索文件。
完整的设置步骤请参阅 MCP 服务器设置。
如何重置 OneMacTools 并联系支持
重置
没有一键重置按钮，你也很少需要它。可以参照设置参考中的默认值逐项恢复设置；输出文件夹有自己的 重置 按钮。“历史记录”界面中的 清除历史记录 会清空任务列表（结果文件保留在原处），设置中的 删除历史记录… 会删除 Mac 健康历史记录。重新安装 App 不会移除你的设置或许可证，因此如果要把 Mac 送人，请先使用 释放这台 Mac…。
联系支持
如果这里的内容都没有帮助，请联系我们并选择报告问题。请附上：
- 你的 macOS 版本（苹果菜单 › 关于本机）和 OneMacTools 版本（OneMacTools › 关于 OneMacTools）。
- 工具，以及你启动它的方式：窗口、访达、菜单栏、快捷指令、监视文件夹或助手。
- 从历史记录中拷贝的确切信息，以及文件的类型和大致大小（例如“一个来自 iPhone 的 1.4 GB MOV”）。
- 是否每次都会发生，其他文件是否也会。
有关许可证和退款的问题，请选择 Refund or licence key（退款或许可证密钥），并附上收据邮件中的订单号。我们会通过电子邮件回复。
本页提到的工具
问题
为什么 OneMacTools 再次要求输入许可证密钥？
它大约每周在线重新验证一次密钥。如果密钥已退款、被停用，或这台 Mac 已在“管理许可证”页面中被释放，App 会锁定，直到再次激活密钥。离线绝不会导致锁定。
为什么访达中不显示 OneMacTools 快速操作？
需要先在“系统设置 › 键盘 › 键盘快捷键 › 服务 › 文件和文件夹”中开启一次。OneMacTools 的设置中有一个“打开服务设置…”按钮，可直接前往该处。
OneMacTools 提示 Apple Intelligence 不可用，该怎么办？
在支持的 Mac 上，于“系统设置”中开启 Apple Intelligence，并等待模型下载完成。只有写作类功能需要它；其他所有工具无需它也能使用。
在哪里可以查看 OneMacTools 任务失败的原因？
在边栏或顶部栏中打开“历史记录”。失败的任务会连同完整信息、工具以及启动位置（例如访达或快捷指令）一起列出。
任务失败会损坏我的原始文件吗？
不会。工具会先将结果写入临时文件夹，只有整批都成功后才会移入你的输出文件夹。原件不会被改动。
如何彻底删除 OneMacTools？
先在“设置 › 许可证”中使用“释放这台 Mac…”，让激活名额可以用在其他地方。然后退出 OneMacTools，并把它从“应用程序”移到废纸篓。删除 App 之前，请先在“设置”中移除管理员助手。
为什么 OneMacTools 提示需要屏幕录制权限？
“屏幕录制”“从屏幕抓取文字”和截屏需要此权限，而它已关闭或尚未生效。请在“系统设置 › 隐私与安全性 › 录屏与系统录音”中打开 OneMacTools，然后退出并重新打开 OneMacTools。
