核心用法
gworkspace-cli（gw）是一款面向命令行和 AI Agent 的 Google Workspace 集成工具，将 Drive 文件管理、Docs 文档读写、Sheets 数据操作封装为可脚本化的 CLI 命令。
Drive 管理：支持浏览 My Drive 和 Shared Drive、按路径/类型/ID 检索、创建文件夹、上传下载、全局搜索。--drive 标志可无缝切换个人与团队空间。
Docs 操作：读取为纯文本或 Markdown、创建空白文档、按 ID/URL 追加内容，适合报告生成和模板填充。
Sheets 处理：全表或指定范围读取（JSON 输出）、单格/批量写入、追加数据、列出工作表标签。支持从 CSV 文件直接导入。
输出模式：默认 JSON（管道友好）、--pretty 表格（人工查看）、--quiet ID 列表（命令链）。
显著优点
- 终端原生体验：无需浏览器交互即可完成多数操作，契合自动化脚本和 CI/CD 场景。
- 双轨认证：内置默认凭证降低配置门槛，同时支持自定义 OAuth 客户端（
GOOGLE_CLIENT_ID等）。 - Shared Drive 完整支持：区别于多数个人向工具，
--drive标志实现对团队共享空间的完整 CRUD。 - 灵活的 I/O 契约：标准输出/错误分离、退出码规范，便于与
jq、xargs、make等工具组合。 - URL/ID 双兼容：粘贴完整 Google URL 或仅文件 ID 均可识别，减少手动提取的摩擦。
潜在缺点与局限性
- 生态依赖：基于 Node.js/npm，需维护 npm 全局安装环境，容器化场景需额外处理。
- 权限粒度：依赖 Google OAuth 范围，无法突破 Workspace 管理员设置的共享/下载限制。
- 离线限制：纯云端操作，无本地缓存或离线编辑能力，网络中断即不可用。
- 企业合规：内置默认凭证的客户端 ID 归属 11x.agency，敏感行业需审计第三方 OAuth 应用信任度。
- 功能边界：不支持 Sheets 公式计算、Docs 格式保留（仅导出文本/Markdown）、Drive 权限管理（ACL 变更）。
适合人群
- 开发者和 DevOps 工程师构建文档自动化流水线
- 数据分析师定期抽取 Sheets 数据至本地处理
- AI Agent/LLM 需要结构化访问 Google Workspace 的场景
- 远程团队需要脚本化批量操作 Shared Drive 内容
常规风险
- 凭证泄露：
~/.11x/gworkspace/token.json存储 OAuth token，文件权限需严格限制（建议600）。 - 意外覆盖：
sheet write直接覆盖目标范围，无版本历史提示，批量操作前建议导出备份。 - 作用域混淆：
--folder与--drive同时使用时的路径解析需仔细核对，避免文件创建到错误位置。 - Token 过期：长期无人值守脚本需处理
Session expired错误并触发重新认证流程。