用途:这是一个轻量的 Google Sheets 命令行集成技能,支持读写表格,使用独立 OAuth 认证,无需 MCP 服务器。需 Google Workspace 账号,个人 Gmail 账号不支持。
首次设置:运行 python scripts/auth.py login 进行浏览器认证;用 python scripts/auth.py status 查看状态;用 python scripts/auth.py logout 退出登录。
读取操作(均通过 scripts/sheets.py,首次未登录会自动认证):get-text 获取表格内容,默认纯文本,可用 --format csv 或 --format json;get-range 按 A1 记法读取指定范围,如 Sheet1!A1:D10 或 A1:C5;find 按查询词搜索表格,可用 --limit 限制数量;get-metadata 获取工作表、维度等元数据。
写入操作:update-range 以 JSON 二维数组更新单元格范围,加 --raw 时按字面文本处理、不解析公式;append-rows 在最后一行数据后追加行;clear-range 清除范围值但保留格式;batch-update 用于格式化、合并等高级批量操作。
表格 ID:可直接传 ID,也可传完整 URL,脚本会自动从 URL 提取 ID。
输出格式:文本默认以竖线分隔、便于阅读;CSV 便于后续处理;JSON 为按工作表分组的二维数组结构。
值输入选项:USER_ENTERED 为默认,按用户输入方式解析数字、日期和公式;RAW(--raw)按原样存储,不解析公式或数字格式。
令牌管理:令牌通过系统钥匙串安全保存(macOS Keychain、Windows Credential Locker、Linux Secret Service API),服务名为 google-sheets-skill-oauth,过期时自动刷新。
限制:需要 Google Workspace 账号;具体配额、权限范围及错误处理细节暂未提供。