核心用法
gws drive +upload 是 GWS CLI 工具集中用于将本地文件上传至 Google Drive 的命令行技能。基础用法极为简洁：执行 gws drive +upload <file> 即可完成上传。该命令支持三个关键参数：<file>（必需）指定本地文件路径；--parent（可选）将文件上传至特定文件夹 ID；--name（可选）自定义云端文件名，若省略则默认保留本地原文件名。
显著优点
1. 零配置自动化：MIME 类型自动检测，无需手动指定文件格式，大幅降低使用门槛。
2. 灵活命名策略：通过 --name 参数可实现批量重命名或规范化命名（如日期前缀、项目标识），便于后续检索。
3. 精准的文件夹管理：支持 --parent 指定目标文件夹 ID，适合自动化脚本中将文件归档至特定项目目录。
4. CLI 原生集成：与 GWS 生态深度整合，可配合管道、Cron 定时任务实现无人值守上传。
潜在局限
- 依赖前置认证：必须先完成
gws-shared中的 OAuth 授权流程，首次配置较繁琐。 - 无批量上传：单次仅支持单个文件，大量文件需配合 shell 循环或外部脚本。
- 文件夹 ID 不友好：
--parent要求输入 Drive 文件夹 ID 而非路径名，对用户不够直观。 - 覆盖风险：当前版本未明确提示同名文件处理逻辑，存在意外覆盖可能。
适合人群
- 需要将本地报告、日志、备份文件自动同步至 Google Drive 的开发者与运维人员
- 构建 CI/CD 流水线并需归档构建产物的 DevOps 工程师
- 习惯命令行操作、追求自动化效率的高级用户
常规风险
写入操作不可逆：该命令属于明确的 WRITE 操作，官方文档已标注 [!CAUTION] 警示。建议在执行前通过 --dry-run 或预览模式确认目标路径，并在自动化脚本中实现二次确认机制，防止误传敏感文件或覆盖重要数据。此外，OAuth Token 的存储安全需严格遵循 gws-shared 中的安全规范，避免凭证泄露。