用途
gws-drive 是 gws-claude-plugin 提供的技能之一，用于通过命令行管理 Google Drive 中的文件、文件夹和共享云端硬盘。它封装了 Google Drive API v3，以 gws drive <resource> <method> [flags] 的形式调用各类资源与方法。
前置条件
使用前需先阅读 ../gws-shared/SKILL.md，其中包含认证方式、全局标志和安全规则。如果该文件缺失，运行 gws generate-skills 生成。
主要能力
该技能覆盖以下 API 资源与方法：
- about：get，获取用户、用户 Drive 及系统能力信息（必须设置 fields 参数）。
- accessproposals：get、list、resolve，用于管理待处理的访问提案（仅审批者可列出）。
- approvals：get、list，获取或列出文件上的审批。
- apps：get、list，获取特定应用或列出用户已安装的应用。
- changes：getStartPageToken、list、watch，用于检索变更及订阅变更通知。
- channels：stop，停止通过该通道监听资源。
- comments：create、delete、get、list、update，管理文件评论（多数方法需设置 fields 参数）。
- drives：create、get、hide、list、unhide、update，管理共享云端硬盘。
- files：copy、create、download、export、generateIds、get、list、listLabels、modifyLabels、update、watch。其中 create 与 update 支持 /upload URI，最大文件 5,120 GB，接受任意有效 MIME 类型；download 操作自创建起 24 小时内有效；export 导出内容限制为 10 MB；list 默认返回所有文件（含已回收站文件），可用 trashed=false 过滤。
- operations：get，获取长时间运行操作的最新状态。
- permissions：create、delete、get、list、update，管理文件或共享云端硬盘的权限（同一文件的并发权限操作不受支持，仅最后一次更新生效）。
- replies：create、delete、get、list、update，管理评论回复。
- revisions：delete、get、list、update，管理文件版本（仅可删除二进制内容文件的版本，Google Docs/Sheets 等及最后一个版本不可删除；版本历史较多时列表可能不完整）。
- teamdrives：create、get、list、update，均已弃用，建议改用 drives 对应方法。
此外提供辅助命令 +upload，用于带自动元数据上传文件。
使用方式
基本调用形式：
gws drive <resource> <method> [flags]
在调用任何 API 方法前，建议先检查：
# 浏览资源与方法
gws drive --help
# 查看某方法的必填参数、类型和默认值
gws schema drive.<resource>.<method>
使用 gws schema 的输出构建 --params 和 --json 标志。
适用场景
适用于需要通过命令行或自动化方式操作 Google Drive 的场景，例如上传与下载文件、搜索和列出文件、管理共享云端硬盘、设置与查询权限、处理评论与回复、查看文件版本、订阅变更通知等。
限制
- 使用前必须完成认证配置，并遵循 gws-shared 中的安全规则。
- 部分方法必须设置 fields 参数。
- download 操作自创建起 24 小时内有效；export 导出内容限制为 10 MB。
- 同一文件的并发权限操作不受支持，仅最后一次更新生效。
- 仅可删除二进制内容文件的版本，Google Docs/Sheets 等及最后一个版本不可删除。
- 版本历史较多时，revisions.list 返回的列表可能不完整。
- teamdrives 资源已弃用。
- 关于收费、价格、平台支持等具体信息，资料中暂未提供。