Google Workspace CLI

选一个任务，开始使用

在个人终端完成 Google 项目与只读登录，再把 brief.md 和第一条提示词交给助手。下面的内联 JSON 命令按 Bash/zsh 引号写法展示；其他终端需按其规则传递同一 JSON。

1. 安装 gws 与所需 Skills

   复制安装命令

   这里固定安装已核对的 CLI 0.22.5，npm 会全局安装 gws；Skills 从当前仓库选择安装，两者并不保证同一快照。npm 下载原生程序，技能安装另选宿主和位置。随后按下方首次路径配置项目与 OAuth。

   npm install -g @googleworkspace/[email protected]
   npx skills add https://github.com/googleworkspace/cli

   查看作者安装说明

   首次只读路径：项目 → 授权 → 文件夹

   创建 brief.md，写入一个 My Drive 小型文件夹的完整链接、ID 和清单用途。安装后，在 Google Cloud 项目中启用 Drive API，按作者手工 OAuth 指南配置同意屏幕；External/Testing 应用把自己加入 Test users，创建 Desktop app 客户端，把下载的 JSON 保存到默认 ~/.config/gws/client_secret.json（自定义配置目录时以该目录为准）。由本人运行 gws auth login --scopes https://www.googleapis.com/auth/drive.readonly；CLI 另会附加身份识别范围。用 gws auth status 核对当前用户、实际 scopes 和 token 状态；它可能联网刷新与查询身份。确认后执行第一条提示词，产出清单并抽查链接。

   作者的安装与手工 OAuth 步骤

2. 把这段话发给 AI

   复制提示词

   以下提示词与样例由编辑编写，ID、表名和数据均需替换。预期产物不是本站访问 Google 账号后的实测结果。

   使用 gws-drive，按 brief.md 盘点一个指定 Drive 文件夹的直属内容，不移动、分享或删除文件。先用 gws schema drive.files.get 和 gws schema drive.files.list 核对当前方法；用 files get 的 fileId/fields 确认目标的名称及文件夹类型。 将 FOLDER_ID 换成真实 ID，再执行：gws drive files list --params '{"q":"'\''FOLDER_ID'\'' in parents and trashed=false","pageSize":100,"fields":"nextPageToken,files(id,name,mimeType,modifiedTime,webViewLink)"}' --page-all --page-limit 10 --format json。这个查询排除回收站内容，只覆盖该文件夹的直接子项；子文件夹仅列为条目，不递归读取。 把 stdout 保存为 inventory.pages.ndjson，并另存 stderr 与退出码。json 模式下每行是一整页响应，不是一条文件记录；抽取各页 files 后生成 inventory.csv 和范围说明。不要用 -o 保存这类 JSON，-o 是二进制下载路径。 检查末页是否仍有 nextPageToken；--page-all 默认仍受 10 页上限约束。未结束时标明不完整，增加合理页数上限后重新读取，避免把重复页追加到旧清单。核对文件 ID 去重、目录范围，并抽查几条 webViewLink；无法返回的字段留空。

3. 检查你拿到的结果

   • 带 ID、类型、更新时间与链接的清单。
   • 可复核的原始分页响应和读取范围。
   • 末页、重复 ID 与链接抽查结果。
   查看这项任务的作者说明