核心用法
gws-sheets-append 是 gws 工具链中专用于向 Google Sheets 追加数据行的 CLI 命令。该命令通过 Google Sheets API 将数据追加到指定电子表格末尾，支持两种数据输入模式：
- `--values`：逗号分隔的简单字符串，适用于单行快速追加
- `--json-values`：JSON 数组格式，支持批量多行插入，如
'[["a","b"],["c","d"]]'
基础调用需指定 --spreadsheet 参数提供表格 ID，命令会自动定位工作表的末尾追加数据。
显著优点
1. 批量高效：--json-values 支持一次性写入多行，减少 API 调用次数
2. 格式灵活：原生支持字符串、数字、布尔值的自动类型识别
3. 链式集成：作为 gws 工具链成员，可与 gws-sheets 其他读写命令配合使用
4. 确认保护：内置写操作确认机制，降低误操作风险
潜在缺点与局限性
- 无列对齐检查：不验证数据列数是否与表格结构匹配，可能导致错位
- 无事务回滚：追加操作不可逆，错误数据需手动清理
- 依赖外部工具：必须预装
gws二进制文件及完成 OAuth 认证 - API 配额限制：受 Google Sheets API 每日调用次数限制
- 无实时冲突检测：多用户并发写入可能产生覆盖或交错问题
适合人群
- 需要自动化数据录入的开发者与数据工程师
- 构建基于 Google Sheets 的轻量级数据管道的团队
- 熟悉 CLI 操作、寻求替代手动复制粘贴的效率用户
常规风险
- 数据覆盖风险：虽为追加模式，但配置错误表格 ID 可能写入错误文档
- 敏感数据泄露：通过命令行参数传递的数据可能残留于 shell 历史记录
- OAuth 令牌管理：依赖
gws-shared的全局认证配置，令牌泄露可导致云端数据被篡改 - JSON 解析失败：
--json-values格式错误会导致命令退出，需提前验证 JSON 语法