SuperAPI AI 工具集

google-workspace

办公与效率

查看项目

更新于 10-15 21:50

技能介绍

用途:该技能提供一个统一的 Google Workspace 命令行工具 gws,用于读写 Drive、Docs、Sheets、Gmail、Calendar 等服务,并可在运行时读取 Google Discovery Service,使新增 API 端点自动可用。

前置条件:需将 gws 二进制放入 $PATH,安装命令为 pnpm add -g @googleworkspace/cli;随后执行 gws auth login 通过浏览器完成 OAuth 登录,用 gws auth status 查看认证状态。

主要能力:支持 Drive 文件与文件夹操作、Docs 读写与追加文本、Sheets 单元格读取、Gmail 消息搜索、Calendar 操作等。核心语法为 gws <service> <resource> [sub-resource] <method> [flags]。常用标志包括 --params、--json、--fields、--page-all、--upload、--output、--dry-run。可用 gws schema <service>.<resource>.<method> 查询载荷结构。

使用方式:先阅读相关 SKILL.md(如 gws-shared、gws-drive、gws-docs、gws-sheets、gws-gmail、gws-calendar)再执行未用过的命令。对于复杂 API 载荷,建议先写 JSON 文件,用 --dry-run 验证,逐字段修正后再执行实际修改。需要自动分页时可使用 --page-all 输出 NDJSON。

限制与注意事项:写操作和删除操作前应询问用户确认;对 list/get 始终使用 --fields 限制返回字段,避免上下文过大;涉及 Sheets 范围中的感叹号时使用单引号防止 shell 历史展开;大载荷应写入临时文件并用 $(cat /tmp/file.json) 传入。该技能不提供具体收费、价格或效果信息。暂未提供其他平台支持或额外限制说明。