用途：让 AI 智能体自主管理 Google Drive 文件，适用于“备份到云端”“在 Drive 中查找文件”“从 Drive 下载”“更新云文件”“从 Drive 删除”等场景，以及需要 file_id 进行下载、更新或删除时。不适用于直接下载原生 Google Docs/Sheets，需先导出。
主要能力：支持上传、搜索、下载、更新、删除和列出文件夹。所有命令输出结构化 JSON：成功为 {"status": "success", "message": "...", "data": {...}}，失败为 {"status": "error", "message": "..."}。
使用方式：先安装依赖 pip install -r requirements.txt。将 credentials.json（Google Cloud 服务账号密钥）放在工作目录，或设置 GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json。用 python scripts/auth.py validate 验证凭据，python scripts/auth.py status 检查认证状态。常用命令：python scripts/drive.py upload ./report.pdf --name "Q4 Report.pdf" --folder FOLDER_ID；python scripts/drive.py search "quarterly report" --limit 5；python scripts/drive.py download FILE_ID ./downloads/report.pdf；python scripts/drive.py update FILE_ID ./report_v2.pdf；python scripts/drive.py delete FILE_ID；python scripts/drive.py delete FILE_ID --permanent；python scripts/drive.py list FOLDER_ID --limit 20。链式操作模式：先 python scripts/drive.py search "report.txt" 获取 file_id，再 python scripts/drive.py update <file_id> ./report.txt。
智能体规则：下载、更新、删除前必须先搜索获取准确 file_id，绝不猜测 ID；上传或更新前确认 local_path 存在；遇到 "status": "error" 时读取 message 并调整参数重试；删除默认移入回收站，只有用户明确说“永久删除”时才使用 --permanent。常见错误包括猜测 file_id、上传不存在的文件、默认永久删除、直接下载 Google Docs，应分别通过先搜索、检查路径、保持 --permanent 关闭、先导出为 PDF/CSV 来修正。
限制：需要 Google Cloud 服务账号凭据；原生 Google Docs/Sheets 无法直接下载；其他平台支持与收费情况暂未提供。