用途：在 Claude Code 中通过命令行访问 Google Drive，完成列出文件、搜索、下载、同步文件夹，以及把本地 HTML/文档上传并转换为原生 Google 文档。
主要能力：list 列出文件夹内容（--verbose 显示大小与修改时间，--json 输出便于解析）、search 按 Drive 查询语法检索、info 查看文件信息、download 下载单个文件、sync 同步整个文件夹（-r 含子文件夹）、create-doc 将本地 HTML 或 .docx 转换为原生 Google 文档并可 --update 就地覆盖。Google Docs、Sheets、Slides、Drawing 会分别自动导出为 .docx、.xlsx、.pptx、.png。内置指数退避与抖动重试，应对 403 rateLimitExceeded / userRateLimitExceeded 及 429。
使用方式：先完成强制预检——确认 gdrive 可执行文件存在（缺失则 bun install && bun run build）、检查 GDRIVE_OP_UUID 环境变量、用 op account list 验证 1Password 登录。未设置时进入配置流程：安装 1Password CLI（brew install 1password-cli）、用 op vault list 与 op item list --vault 发现 OAuth 条目、选择凭据、将 export GDRIVE_OP_UUID="<uuid>"（必要时加 GDRIVE_OP_VAULT）写入 ~/.zshrc 并 source 验证，再执行一次 list 测试（首次会打开浏览器授权）。示例命令：$GDRIVE_CLI list <folder_id>、$GDRIVE_CLI download <file_id> -o ./output.pdf、$GDRIVE_CLI sync <folder_id> -o ./output_dir -r。create-doc 需 drive.file 权限，首次写入会再次请求授权。
适用场景：批量拉取共享文件夹、按名称或类型检索文件、把 Markdown 经 pandoc 转 HTML 后导入为可评论的原生文档。
限制：凭据必须来自 1Password；令牌存于 ~/.claude/tools/gdrive-tokens/<uuid>.json，失效报 invalid_grant 时需删除令牌并重新交互授权；--update 仅适用于本应用创建的文档；创建原生文档不推荐用 rclone。若 CLI 不可用，可回退到已配置的 rclone remote，通过 --drive-root-folder-id 访问任意文件夹（含“共享给我”下的文件夹），并可用 --metadata 获取 owner 与创建时间。文件夹 ID 取自 URL /folders/ 之后部分。具体收费与配额信息暂未提供。