核心功能
gws-drive-upload 是基于 Google Workspace API 构建的文件上传命令行工具，封装了 Google Drive 的文件上传能力，提供极简的单命令上传体验。该 skill 自动处理本地文件的 MIME 类型检测，支持指定目标文件夹（parent）和重命名（name），无需手动配置 Content-Type 即可正确识别 PDF、CSV、图片等常见格式。
显著优点
1. 零配置上传：自动推断 MIME 类型和文件名，降低使用门槛
2. 灵活的目标控制：可通过 --parent 指定 Drive 文件夹，通过 --name 实现上传即重命名
3. 统一认证体系：继承 gws-shared 的全局认证和 flag 配置，避免重复登录
4. 明确的写操作警示：内置 [!CAUTION] 提示，强制确认机制降低误操作风险
潜在局限
- 写操作不可逆：上传后无法通过同一工具直接撤销，需依赖 Google Drive 原生回收站
- 单文件限制：不支持批量上传或文件夹递归同步
- 依赖外部 CLI：需预装
gws二进制文件，环境配置成本存在 - 网络依赖：Google API 的可用性直接影响工具稳定性
适合人群
- 需要快速将本地报告、数据文件归档到 Google Drive 的办公用户
- 构建自动化工作流、需要将生成文件自动上传的开发者
- 已使用 gws 工具链管理 Google Workspace 的现有用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 误覆盖风险 | 若目标文件夹存在同名文件，可能触发覆盖或创建副本（取决于 Drive 设置）|
| 权限泄露 | `--parent` 指定的共享文件夹可能无意中将文件暴露给协作者 |
| 认证令牌 | 继承 gws 的 OAuth 凭证管理，需确保 `gws-shared` 的令牌存储安全 |
| 数据残留 | 上传过程中本地临时文件或日志可能包含敏感路径信息 |
建议搭配 gws drive 其他只读命令先确认目标文件夹结构，再执行上传操作。