用途：让 AI 智能体对 Google Drive 执行完整的 CRUD 管理，包括列出、搜索、上传、下载、导出、整理与分享文件。
主要能力：列出任意文件夹（默认根目录，文件夹优先、后按修改时间排序）；按名称或全文内容搜索，可加 MIME 类型过滤；按 ID 获取文件元数据；上传本地文件（可续传、自动识别 MIME 类型）；下载到本地；导出 Google Workspace 文档（Docs→DOCX/PDF/TXT，Sheets→XLSX/CSV，Slides→PPTX/PDF）；创建文件夹；移动、复制（可改目标文件夹与名称）、重命名；移入/移出回收站（可逆）；永久删除（不可逆）；分享给用户、群组、域或公开，支持 reader/commenter/writer/owner 角色；移除权限、列出全部权限。输出为 JSON。
必要用法：需启用 Google Drive API 的 Google Cloud 项目与 OAuth 2.0 凭据（gcloud ADC 或 credentials.json）。快速配置可运行 uv run ~/.agents/skills/gmail/scripts/setup_workspace.py 一次性配置 Gmail、日历、联系人和 Drive。手动方式：gcloud auth application-default login --scopes https://www.googleapis.com/auth/drive,https://www.googleapis.com/auth/cloud-platform，再用 uv run skills/google-drive/scripts/google_drive.py verify 验证；也可将 credentials.json 放入 ~/.drive_credentials/ 后运行 uv run skills/google-drive/scripts/google_drive.py setup。命令示例：uv run skills/google-drive/scripts/google_drive.py list --folder "FOLDER_ID" --limit 20；search、get、upload、download、export、mkdir、move、copy、rename、trash、untrash、delete、share、permissions、unshare 等子命令参数见资料。
适用场景：为智能体自动化处理云端文件整理、检索、格式转换与协作分享。
限制：永久删除不可恢复；分享范围与角色设置会影响访问权限，需谨慎；价格、配额、并发等限制暂未提供。