用途：用于处理 Google Workspace 相关任务，包括 Gmail、Drive、Calendar、Docs、Sheets 等服务。通过本地辅助脚本直接调用 Google Workspace API，不依赖 MCP。
主要文件：scripts/auth.js 负责 OAuth 登录、状态查询、清除及账号枚举；scripts/workspace.js 是基于 JavaScript 执行的 API 运行器。
账号模型：按邮箱区分配置，没有默认账号。每次 API 调用都必须指定 --email account@example.com。令牌按邮箱存储在 ~/.pi/google-workspace/tokens/ 下。运行前先枚举已登录账号：node scripts/auth.js accounts。
使用方式：始终使用 exec 并提供 --email。在 exec 脚本内可使用 auth（已授权的 OAuth 客户端）、google（googleapis 根对象）、workspace.accountEmail、workspace.call(service, methodPath, params, {version})、workspace.service(service, {version})、workspace.whoAmI()。可选标志包括 --timeout <ms>（默认 30000，最大 300000）、--scopes s1,s2、--script 'return 42'。
建议：每个用户请求尽量用一个 exec 脚本；保持载荷精简（fields、maxResults、最小属性）；独立请求使用 Promise.all；绝不打印令牌内容。用户未指定账号时，先运行 node scripts/auth.js accounts 并确认明确邮箱。授权失败时先查看已知配置，必要时用 workspace.whoAmI() 确认账号不匹配。遇到 401/403/未授权错误时，可切换账号或对该配置重新登录：node scripts/auth.js login --email correct-user@example.com。
设置与诊断：node scripts/auth.js login --email user@example.com；依赖首次运行自动安装；默认认证模式为 cloud，无需本地 credentials.json；可选本地模式需设置 GOOGLE_WORKSPACE_AUTH_MODE=local 并在 ~/.pi/google-workspace/credentials.json 提供凭据。诊断命令：node scripts/auth.js accounts、node scripts/auth.js status --email user@example.com、node scripts/auth.js clear --email user@example.com。