用途:统一集成 Google Workspace,跨三个账号管理邮件、日历、文件与沟通。账号别名:psd(工作邮箱)、kh(个人 Gmail)、hrg(商业/咨询与房地产)。可显式指定(如“check my psd email”),也可由 Geoffrey 根据上下文推断(工作→psd,个人→kh,商业→hrg)。
主要能力:Gmail 支持列出收件箱/未读/按标签、读取完整邮件、撰写发送、带附件发送、用 Gmail 运算符搜索、获取未读摘要;日历支持列出即将到来的事件、创建、修改、按条件搜索;Drive 支持浏览/搜索文件、读取内容、创建文档/表格、上传本地文件;Tasks 支持列出任务列表、新建、标记完成;Chat 支持列出空间、向空间发消息、读取聊天历史。部分操作可跨账号,如转发到个人邮箱、复制文件到工作 Drive、同时加入两个日历。
使用方式:所有脚本通过 token_manager 认证,示例:const { getAuthClient } = require('./auth/token_manager'); 脚本以账号作为参数(默认 psd)。输出统一为 JSON,含 success、account、data、metadata(timestamp、count)。错误返回 error、account、action,例如令牌过期时提示运行 node token_manager.js refresh psd。Gmail 搜索支持 from:、to:、subject:、has:attachment、after:/before:、is:unread、label: 等运算符。
限制与准备:使用前需完成 Google Cloud Console 设置(见 auth/GOOGLE_CLOUD_SETUP.md),将凭据加入 ~/Library/Mobile Documents/com~apple~CloudDocs/Geoffrey/secrets/.env,认证全部三个账号;PSD 账号需在 Google Admin 中将 OAuth 应用加入允许列表。访问令牌 1 小时后过期(自动刷新),刷新令牌除非撤销否则不过期;所有 API 调用受 Google 速率限制;Keep API 可用性有限,可能未启用。