用途:通过 goog CLI 构建生产级原生 Google Sheets 工作簿,覆盖跟踪表、预算、日程、报表、模型和数据清理等场景。
主要能力:创建或检查工作簿;在有限表格中写入源数据;添加公式与格式;读取元数据和网格数据以核对公式、格式与表结构;支持数值格式、冻结表头、条件格式、数据验证列表或复选框等。
使用方式:开发时使用 goog-cli 仓库中的 target/debug/goog,或 cargo run --。建议流程:先明确受众、决策、输入输出与更新频率,规划标签页、表格边界、公式、格式与验证规则;执行 target/debug/goog auth list 记录活动账号;首次修改前运行 target/debug/goog sheets --help 及相关嵌套 --help;优先使用 goog sheets values 和 goog sheets sheet 等高层命令而非 batch-update;每次写入后重新读取重要区域。需要显式指定账号时,为每条实时命令传 --account EMAIL。若因缺少所需 scope 失败,运行 goog auth login 后重试。公式、日期、百分比或货币需由 Sheets 解析时使用 --value-input-option user-entered。
限制与注意:不得从浏览器顺序、记忆身份或无关工作簿推断账号;派生值应使用公式而非粘贴常量;已知稳定表格边界时优先使用有限范围而非整列公式;不要用静态值替换可用公式,除非用户要求。若没有匹配的已认证浏览器会话,应报告视觉 QA 受阻,而非声称通过完成门槛。完成前需确认所有标签页、字段、公式与输出存在,公式无错误,表头正确冻结对齐,数字格式正确,长文本可读,验证与保护范围符合编辑流程,并在 100% 缩放下目视检查实时工作簿,最后返回实时 Google Sheets URL 并总结工作簿。创建或大幅重构前应阅读 references/quality.md,命令模式与索引规则见 references/commands.md。