用途:本技能提供使用 gws 命令行界面(CLI)的关键准则,适用于通过 gws CLI 操作 Google Workspace 服务的任何场景,目的是防止常见错误并保护用户数据。
支持的服务:目前仅 Drive(文件与文件夹操作)、Docs(文档读写)、Sheets(表格读写)、Slides(演示文稿读写)四项服务可用且已预配置。Gmail、Calendar、Tasks、Chat 等其他服务不可用,不应尝试使用。
链接交互:不要用浏览器打开 Google Drive、Docs、Sheets 或 Slides 链接(如 https://docs.google.com/...),浏览器环境可能未登录正确的 Google 账号,很可能无法访问文件。应改用 gws 命令,查看内容时使用相应的 get 或 export 命令(例如 gws drive export)。
Slides 文本换行:通过 gws slides presentations batchUpdate 插入文本时,API 对换行字符的解释不同。\n 会被翻译为新的 paragraphMarker,产生独立段落(相当于按 Enter),连续两个 \n 会生成三个段落、中间为空行;\v(垂直制表符 \u000b)被视为单个 textRun 内的特殊字符,不创建新段落,渲染为软换行,相当于 Shift+Enter,适用于同一段落或项目符号内的多行文本。规则是:新段落或新项目符号用 \n,单段落/项目符号内换行用 \v。
禁止永久删除:切勿执行任何永久删除用户数据的 gws 命令,包括永久删除文件、幻灯片、演示文稿、邮件、日历事件等。应改用移入回收站或归档操作。永久删除不可逆,可能造成灾难性数据丢失。即使用户要求删除,也应优先移入回收站并在继续前明确确认,绝不使用永久删除。
发现可用技能:首次使用或更新 CLI 后,运行一次 gws generate-skills 生成本地技能文档,会在 skills/ 下生成技能目录,并在 docs/skills.md 生成索引。读取生成的索引和各技能文件,可了解可用命令、服务、配方与工作流。
更新 CLI:更新到最新版本可使用 pnpm update -g @googleworkspace/cli。
限制:资料仅覆盖上述四类服务与规则,其他服务、具体命令参数、收费与平台信息暂未提供。