google-drive

用途

Google Drive 技能用于通过 OAuth 认证来管理 Google Drive 中的文件与文件夹，支持上传、下载、搜索、整理和分享云端内容。当用户提及“google drive”“drive”“upload file”“download file”“share file”“create folder”等场景时适用。

预检步骤

使用前必须始终先运行认证检查脚本：

python3 00-system/skills/google/google-master/scripts/google_auth.py --check --service drive

退出码含义：

0：可直接使用，继续处理用户请求
1：需要登录，运行 python3 00-system/skills/google/google-master/scripts/google_auth.py --login
2：缺少凭据或依赖，参见 ../google-master/references/setup-guide.md

主要能力

脚本 drive_operations.py 提供以下操作：

列出文件：list，可加 --folder <folder_id> 指定文件夹
搜索文件：search "report"
获取文件信息：info <file_id>
下载文件：download <file_id> --output ./local_file.pdf
下载 Google Doc 为 PDF：download <doc_id> --format pdf
上传文件：upload ./local_file.pdf --folder <folder_id>
创建文件夹：create-folder "New Folder" --parent <parent_id>
移动文件：move <file_id> <destination_folder_id>
复制文件：copy <file_id> --name "Copy of File"
重命名文件：rename <file_id> "New Name"
删除文件（移入回收站）：delete <file_id>
分享文件：share <file_id> user@example.com --role writer
获取分享信息：sharing <file_id>

对应的函数包括 list_files、search_files、get_file_info、download_file、upload_file、create_folder、move_file、copy_file、rename_file、delete_file、share_file、get_sharing_info。

使用方式

文件或文件夹 ID 可从 URL 中获取：

https://drive.google.com/file/d/[FILE_ID]/view
https://drive.google.com/drive/folders/[FOLDER_ID]

导出格式（针对 Google 文档类文件，下载时使用 --format）：

Google Docs：pdf、docx、txt、html
Google Sheets：pdf、xlsx、csv
Google Slides：pdf、pptx

分享角色：

reader：仅查看
commenter：查看和评论
writer：查看、评论和编辑

配置步骤

首次设置参见 ../google-master/references/setup-guide.md。快速开始：

安装依赖：

pip install google-auth google-auth-oauthlib google-api-python-client

在 Google Cloud Console 创建 OAuth 凭据（启用 Google Drive API，选择“Desktop app”）
在 Nexus 根目录的 .env 文件中添加：

GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=your-client-secret
GOOGLE_PROJECT_ID=your-project-id

运行登录：

python3 00-system/skills/google/google-master/scripts/google_auth.py --login

错误处理

常见错误与解决方案参见 ../google-master/references/error-handling.md。

限制

资料未提供关于收费、价格、使用配额或性能表现的说明。