# macOS 权限说明

macOS 的隐私门控较多。章鱼速贴的部分能力（自动粘贴、全局输入、后台监听）需要系统级权限。本页说明**每项权限启用什么能力、在哪授予、如何验证**。只开启你需要的能力即可。

## 适合谁看

- 首次在 macOS 上配置自动粘贴或后台监听的用户
- 升级系统后相关功能失效、需要重新授权的用户

> [!NOTE] 以系统弹窗为准
> 实际需要哪些权限、弹窗文案与开关名称，随 macOS 版本和应用版本不同而变化。请以章鱼速贴运行时的系统弹窗与「系统设置 → 隐私与安全性」中的实际项为准。

## 各项权限对应的能力

| 权限（系统设置 → 隐私与安全性） | 启用什么能力 |
|---|---|
| 辅助功能 | 自动粘贴、模拟粘贴/插入到目标应用、全局输入相关行为 |
| 输入监控 | 全局快捷键、监听触发输入相关能力 |
| 屏幕录制 | 仅在涉及截图/取词等能力时可能需要 `[待确认：当前版本是否需要]` |
| 文件与文件夹访问 | 涉及文件类剪贴或导入导出时按需授予 |

> [!WARNING] 自动粘贴依赖辅助功能
> 没有授予「辅助功能」时，自动粘贴/直接插入到目标应用通常无法工作，常表现为"历史里有内容但粘不出来"。

## 授权步骤

:::steps
:::step{title="打开隐私设置"}

打开「系统设置 → 隐私与安全性」。

:::
:::step{title="按能力逐项开启"}

在「辅助功能」「输入监控」等分类中找到章鱼速贴并打开开关。只开启你要用的能力。

:::
:::step{title="必要时重启应用"}

部分权限在开启后需要重新启动章鱼速贴才生效。

:::
:::step{title="确认应用常驻"}

确认章鱼速贴在菜单栏运行；先确认**本机**能正常记录剪贴，再测试跨设备同步。
:::
:::

## 修复后如何验证

- 复制一段纯文本，确认进入本机剪贴历史。
- 在普通文本输入框触发一次自动粘贴，确认能插入。
- 若用到全局快捷键，确认它能正常唤起对应能力。

## 仍未解决

请反馈以下信息：

- macOS 版本
- 应用版本与安装来源
- 受影响的能力（自动粘贴 / 全局快捷键 / 后台监听）
- 已开启与被拒绝的权限项
- 是否最近升级过系统
- 复现步骤（最短路径）

按系统级权限异常逐项排查见 [权限问题](/advanced/troubleshooting/permission-issues)。

## 下一步

:::cards{cols=2}
:::card{title="macOS 平台说明" icon="lucide.layout-grid" href="/advanced/macos/"}
回到 macOS 平台总览，了解整体注意事项。

:::
:::card{title="macOS 常见限制" icon="lucide.triangle-alert" href="/advanced/macos/limitations"}
了解沙箱与系统策略带来的边界。

:::
:::card{title="无法粘贴" icon="lucide.clipboard-x" href="/advanced/troubleshooting/cannot-paste"}
历史里有内容却粘不出来时的排查。

:::
:::card{title="权限问题" icon="lucide.shield-alert" href="/advanced/troubleshooting/permission-issues"}
跨平台系统级权限异常的统一排查入口。
:::
:::