google-drive-automation

配套材料可用性

本目录副本包含以下内联指南，但不包含下列配套路径。它们是外部前置条件，并非随附文件：

• <support-root>/scripts/auth.py
• <support-root>/scripts/drive.py

使用依赖这些路径的步骤前，请索取原始配套材料或现有安装；本目录未提供经过验证的下载来源。请相对于该安装解析各路径，检查其内容，并核实适用的许可证及执行前置条件。所需文件不存在时，不要运行命令，也不要声称已执行引用的流程。不要伪造缺失的脚本，也不要将名称相同但无关的文件视为等效文件。此处完整说明的独立步骤可在用户授权范围内继续；请将任何依赖步骤报告为不可用。

Google Drive

轻量级 Google Drive 集成，支持独立 OAuth 身份验证。无需 MCP 服务。提供完整的读取和写入权限。

账户支持和 OAuth 范围取决于缺失的上游脚本；登录前请核实实际的 OAuth 应用。本条目并未规定对个人 Google 账户的一般性限制。

适用场景

• 你需要搜索、列出、上传、下载、移动或整理 Google Drive 文件和文件夹。
• 任务需要通过本地脚本，在 Workspace 账户中直接自动执行 Drive 读写操作。
• 你希望执行文件级 Drive 操作，而不引入 MCP 服务依赖。

首次设置

使用 Google 进行身份验证（打开浏览器）：

python scripts/auth.py login

检查身份验证状态：

python scripts/auth.py status

需要时注销：

python scripts/auth.py logout

读取命令

所有操作均通过 scripts/drive.py 执行。若尚未登录，首次使用时会自动进行身份验证。

# Search for files (full-text search)
python scripts/drive.py search "quarterly report"

# Search by title only
python scripts/drive.py search "title:budget"

# Search using Google Drive URL (extracts ID automatically)
python scripts/drive.py search "https://drive.google.com/drive/folders/1ABC123..."

# Search files shared with you
python scripts/drive.py search --shared-with-me

# Search with pagination
python scripts/drive.py search "report" --limit 5 --page-token "..."

# Find a folder by exact name
python scripts/drive.py find-folder "Project Documents"

# List files in root Drive
python scripts/drive.py list

# List files in a specific folder
python scripts/drive.py list 1ABC123xyz --limit 20

# Download a file
python scripts/drive.py download 1ABC123xyz ./downloads/report.pdf

请相对于经过审核的 <support-root> 解析脚本，而不要使用无关仓库中的 scripts/ 文件夹。写入前，请确认准确的文件／文件夹 ID、目标位置和权限；移动或移入垃圾箱的内容可能会影响协作者。读取请求并不授权更改内容、共享或扩大 OAuth 范围。

写入命令

# Upload a file to Drive root
python scripts/drive.py upload ~/Documents/report.pdf

# Upload to a specific folder
python scripts/drive.py upload ~/Documents/report.pdf --folder 1ABC123xyz

# Upload with a custom name
python scripts/drive.py upload ~/Documents/report.pdf --name "Q4 Report.pdf"

# Create a new folder
python scripts/drive.py create-folder "Project Documents"

# Create a folder inside another folder
python scripts/drive.py create-folder "Attachments" --parent 1ABC123xyz

# Move a file to a different folder
python scripts/drive.py move FILE_ID DESTINATION_FOLDER_ID

# Copy a file
python scripts/drive.py copy FILE_ID
python scripts/drive.py copy FILE_ID --name "Report Copy" --folder 1ABC123xyz

# Rename a file or folder
python scripts/drive.py rename FILE_ID "New Name.pdf"

# Move a file to trash
python scripts/drive.py trash FILE_ID

搜索查询格式

搜索命令支持多种查询格式：

格式	示例	说明
全文	"quarterly report"	搜索文件内容和名称
标题	"title:budget"	仅搜索文件名
URL	https://drive.google.com/...	提取并使用文件／文件夹 ID
文件夹 ID	1ABC123...	列出文件夹内容（ID 长度为 25 个或更多字符）
原生查询	mimeType='application/pdf'	直接传递 Drive 查询语法

文件 ID 格式

Google Drive 使用类似 1ABC123xyz_-abc123 的长 ID。可从以下位置获取 ID：

• search 结果
• find-folder 结果
• list 结果
• Google Drive URL

下载限制

• 普通文件（PDF、图片等）可直接下载
• 此工具无法下载 Google Docs／Sheets／Slides
• 对于 Google Workspace 文件，请使用导出功能或专用工具

令牌管理

上游说明使用系统密钥环存储令牌；依赖此功能前，请核实实际实现及回退行为：

• macOS：Keychain
• Windows：Windows Credential Locker
• Linux：Secret Service API（GNOME Keyring、KDE Wallet 等）

服务名称：google-drive-skill-oauth

上游集成说明了云函数令牌刷新流程。传输令牌前，请根据实际脚本核实其操作方、目标位置、范围和令牌处理方式；不要仅因端点托管在 Google 的基础设施上，就假定该端点由 Google 运营。

限制

• 仅在任务明确符合上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必需的输入、权限、安全边界或成功标准，请停止并请求澄清。