核心用法
gws-sheets-append 是 gws 工具链中专用于向 Google 表格追加数据的命令行技能。它通过 OAuth 认证连接 Google Sheets API，支持两种数据写入模式：
1. 简单模式（--values）：逗号分隔的字符串，适合单行快速追加
2. 批量模式（--json-values）：JSON 数组格式，支持多行一次性插入，效率更高
典型工作流
- 从
gws-shared获取全局认证配置 - 指定目标表格 ID（
--spreadsheet） - 选择数据格式并提交，系统自动追加到首空行
显著优点
- 效率突出：批量模式减少 API 调用次数，适合数据流水线集成
- 格式灵活：同时支持简单字符串和结构化 JSON，覆盖从手动调试到自动化脚本的全场景
- 生态整合：作为
gws工具链一环，与读取、格式化等技能共享认证体系
潜在局限
- 无数据校验：不检查列类型或格式，错误数据直接写入
- 无冲突处理：若表格结构变更（如列数增减），可能导致数据错位
- 追加位置固定：始终写入首个空行，无法指定精确单元格
- 依赖外部认证：需预配置 OAuth，首次设置门槛较高
适合人群
| 场景 | 推荐度 |
|------|--------|
| 开发者构建数据收集流水线 | ⭐⭐⭐⭐⭐ |
| 运维人员快速记录日志到云端表格 | ⭐⭐⭐⭐ |
| 非技术用户直接操作 | ⭐⭐（需 CLI 基础） |
| 需要复杂表格格式控制 | ⭐⭐（功能较基础） |
常规风险
1. 误写风险：write 操作不可逆，工具强制要求用户显式确认
2. 权限泄露：OAuth token 若存储不当，可能导致表格数据被非法访问
3. API 限流：高频批量操作可能触发 Google 配额限制
4. 数据隐私：敏感信息写入云端需评估合规要求
> 安全提示：生产环境建议配合 --dry-run 或备份机制使用。