适用对象：要把 Gmail、云端硬盘、日历、文档、表格等 Google 办公能力带进本轮的用户。授权由连接器自管，凭证按用户目录存放，不进资料库。
1. 模块定位与亮点
连接器基于 Google 开源的 Workspace CLI（gws），按 Discovery API 动态覆盖 Workspace 全服务。官方仓库声明它不是 Google 正式商用 SLA 产品，但命令面随 Google API 更新。
亮点可以记三条：
- 一张卡覆盖 Gmail / Drive / Calendar / Docs / Sheets / Slides / Tasks / People 等，其余走
google_schema+google_invoke。 - 点「连接」→ 弹出 Google 登录授权，无需自己装命令行、跑终端或粘贴凭证。Gmail 已连接即可直接查信，不必再加号挂到本轮，输入栏也不出现胶囊；与其它邮箱并存时未点名默认都查。
- 凭证按账号隔离在本机连接器目录，不要写进对话或资料库。
2. 能做什么
- Gmail：未读摘要、列表搜索、读信、写信、回复
- 云端硬盘：列文件、按名搜索、看元数据
- 日历：日程摘要、创建事件
- 任务、通讯录搜索
- 其它 Workspace API：先
google_schema再google_invoke（含gmail +send、drive +upload、calendar +agenda等 helper）
3. 从哪进
专家 · 技能 · 连接器 → 连接器 → Google Workspace。配好后即可直接问 Gmail 等。
4. 全流程概览
打开卡片 → 点「连接」→ 在弹出的 Google 窗口登录并同意权限
→ 状态已连接 → 自然语言提问（不必再挂到本轮）
5. 分步操作
- 打开本卡，点 连接。
- 浏览器会弹出 Google 登录页：用要接入的 Google 账号登录，勾选权限后确认。
- 看到「授权成功」后可关闭弹窗；本卡状态变为 已连接。
- 状态变为 已连接 后，即可用自然语言提问；加号里会显示「已可用」，不必再勾选挂载。
若提示「系统尚未配置 Google 登录」，说明部署侧还没配好 OAuth 客户端，请联系管理员（环境变量 YUTAN_GOOGLE_CLIENT_ID / YUTAN_GOOGLE_CLIENT_SECRET，并在 Google Cloud 控制台把当前站点回调地址登记为：https://你的站点/yutan-google/oauth/callback）。
6. 页面结构说明
货架连接器卡（介绍页 → 一键 Google 授权）；已连接后上下文条可出现「已可用」胶囊。
7. 常见问题
提示还没连？
重新点「连接」完成授权；过期后同样再连一次即可。
个人 @gmail.com 授权失败 / 权限过多？
未验证的 GCP 应用有 scope 上限。管理员应在同意屏幕把你的账号加为测试用户；若仍失败，把报错原文发给管理员。
和 QQ / 网易邮箱什么关系？
那是国内个人邮箱 IMAP 卡；本卡是 Google Workspace OAuth，不要混用。