必须明确授予Gemini macOS智能体对特定文件夹的读写权限，而非全盘访问：需启用辅助功能权限、重启应用，并通过弹窗选取专用中转文件夹（如~/Documents/AI_Sort_Inbox），同时API调用须限定OAuth作用域为drive.file或spaces='appDataFolder'。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在Mac端让Gemini API智能体安全地自动整理本地文件，必须明确授予其访问特定文件夹的权限，而非开放整个系统—— macOS的沙盒机制会默认阻止任何AI代理读写桌面、文档或下载等敏感位置。
启用辅助功能权限（系统级前提）
打开“系统设置”→“隐私与安全性”→“辅助功能”，点击右下角锁形图标输入密码解锁。
点击左下角“+”号，前往访达 → 应用程序 → 找到并选中 Gemini.app，拖入列表；若未出现，可点击“其他…”→勾选“启用所有应用程序”→再手动定位添加。
【必须重启Gemini应用才能使该权限生效】。不重启会导致后续所有文件操作请求被静默拒绝，界面无提示、日志无报错，仅表现为“任务卡在扫描阶段”。
为智能体指定可信文件夹（最小权限原则）
启动Gemini Mac app，按 Option + Space 唤出聊天窗口，输入指令：“请整理我指定的文件夹”，等待AI返回文件选择弹窗。
此时弹窗仅允许你点击选取单个文件夹——不要点“桌面”或“访达”，而是提前新建一个专用中转文件夹，例如：~/Documents/AI_Sort_Inbox。
使用固定的 Next.js/Tailwind/Prisma 技术栈构建并记录独立 SaaS 项目，仅将 FastAPI 用于 Python 工作负载，并遵循严格的架构规范。
将待整理的PDF、发票、合同等文件全部移入该文件夹，再在此处选中它。Gemini智能体将仅获得对该路径的读写权限，无法触及其他区域。
配置API调用时的OAuth作用域（开发者场景）
方法一：使用gcloud CLI绑定最小权限服务账号
在终端中执行：gcloud auth application-default login --scopes=https://www.googleapis.com/auth/drive.file,https://www.googleapis.com/auth/cloud-platform。
注意：务必包含 drive.file 而非 drive 全局权限，否则OAuth授权页会显示“将获得对您所有Google云端硬盘文件的完全访问权限”，导致用户拒绝授权。
方法二：在代码中显式声明文件级访问
调用 files.list 或 files.get 时，在请求参数中加入 spaces='appDataFolder'，强制限定操作范围为Gemini专属应用数据目录，该目录由系统自动创建且与其他App隔离。
