核心用法
gws-sheets-append 是 gws CLI 工具集中的 Google Sheets 写入子命令，专用于向指定表格追加数据行。基础用法为 gws sheets +append --spreadsheet <ID>，配合 --values 或 --json-values 参数完成数据写入。
双模式写入：
--values 'Alice,100,true'：单行快速追加，逗号分隔的简单字符串--json-values '[["a","b"],["c","d"]]'：批量多行插入，支持嵌套数组结构
显著优点
1. CLI 原生集成：与 gws 生态无缝衔接，可复用全局认证与配置
2. 双模式灵活：简单场景用 --values，复杂批量场景用 --json-values
3. 自动化友好：适合 shell 脚本、CI/CD 流水线及定时任务嵌入
4. 显式安全提示：文档标注为 write 命令，强制要求执行前用户确认
潜在局限
- 认证依赖：需预先配置 Google OAuth2 凭证（见
gws-shared） - 格式约束：
--values仅支持简单字符串，复杂数据类型需转 JSON - 无事务回滚：追加操作不可逆，无内置 undo 机制
- 单表限制：一次仅能操作一个 spreadsheet，跨表需多次调用
适合人群
- DevOps/平台工程师：构建数据管道与监控报表自动化
- 数据分析师：轻量级 ETL 流程的终点写入
- 开发者：需要程序化更新 Google Sheets 的后台服务
常规风险
- 数据覆盖风险：追加位置由 API 自动决定，若表格结构变动可能导致数据错位
- 权限泄露：
gws-shared的凭证文件需妥善保管，避免 scope 过度授权 - 批量写入失败：
--json-values大数组可能触发 API 配额限制，需分页处理
版本信息
当前版本 v0.21.2，属于 gws 生态的稳定功能模块。