Deepseek-V4
Minimax-M2.7
Kimi-k2.6Google Workspace 技能
为 Hermes 提供 Gmail、日历（Calendar）、云端硬盘（Drive）、联系人（Contacts）、表格（Sheets）和文档（Docs）的集成。使用 OAuth2 并支持自动刷新令牌。当可用时，优先使用 Google Workspace CLI (gws) 以获得更广泛的覆盖范围，否则回退到 Google 的 Python 客户端库。
技能路径： skills/productivity/google-workspace/
设置
设置过程完全由代理驱动——请求 Hermes 设置 Google Workspace，它将引导你完成每一步。流程如下：
- 创建 Google Cloud 项目并启用所需的 API（Gmail、日历、云端硬盘、表格、文档、People）
- 创建 OAuth 2.0 凭据（桌面应用类型）并下载客户端密钥 JSON 文件
- 授权——Hermes 生成一个授权 URL，你在浏览器中批准，然后粘贴回重定向 URL
- 完成——此后令牌将自动刷新
如果你只需要电子邮件功能（不需要日历/云端硬盘/表格），请改用 himalaya 技能——它配合 Gmail 应用专用密码使用，只需 2 分钟即可完成设置。无需创建 Google Cloud 项目。
Gmail
搜索
$GAPI gmail search "is:unread" --max 10
$GAPI gmail search "from:boss@company.com newer_than:1d"
$GAPI gmail search "has:attachment filename:pdf newer_than:7d"
返回包含每条消息的 id、from、subject、date、snippet 和 labels 的 JSON。
阅读
$GAPI gmail get MESSAGE_ID
以文本形式返回完整的消息正文（优先使用纯文本，回退到 HTML）。
发送
# Basic send
$GAPI gmail send --to user@example.com --subject "Hello" --body "Message text"
# HTML email
$GAPI gmail send --to user@example.com --subject "Report" \
--body "<h1>Q4 Results</h1><p>Details here</p>" --html
# Custom From header (display name + email)
$GAPI gmail send --to user@example.com --subject "Hello" \
--from '"Research Agent" <user@example.com>' --body "Message text"
# With CC
$GAPI gmail send --to user@example.com --cc "team@example.com" \
--subject "Update" --body "FYI"
自定义 From 标头
--from 标志允许你自定义外发邮件的发件人显示名称。当多个代理共享同一个 Gmail 帐户但你希望收件人看到不同的名称时，这非常有用：
# Agent 1
$GAPI gmail send --to client@co.com --subject "Research Summary" \
--from '"Research Agent" <shared@company.com>' --body "..."
# Agent 2
$GAPI gmail send --to client@co.com --subject "Code Review" \
--from '"Code Assistant" <shared@company.com>' --body "..."
工作原理： --from 值被设置为 MIME 消息中的 RFC 5322 From 标头。Gmail 允许在你自己的已认证电子邮件地址上自定义显示名称，无需任何额外配置。收件人看到的是自定义显示名称（例如“Research Agent”），而电子邮件地址保持不变。
重要提示： 如果你在 --from 中使用不同的电子邮件地址（而非已认证的帐户），Gmail 要求该地址必须在 Gmail 设置 → 账号 → 发送邮件作为中配置为 “发送邮件作为”别名。
--from 标志适用于 send 和 reply 命令：
$GAPI gmail reply MESSAGE_ID \
--from '"Support Bot" <shared@company.com>' --body "We're on it"
回复
$GAPI gmail reply MESSAGE_ID --body "Thanks, that works for me."
自动将回复加入线程（设置 In-Reply-To 和 References 标头）并使用原始消息的线程 ID。
标签
# List all labels
$GAPI gmail labels
# Add/remove labels
$GAPI gmail modify MESSAGE_ID --add-labels LABEL_ID
$GAPI gmail modify MESSAGE_ID --remove-labels UNREAD
日历
# List events (defaults to next 7 days)
$GAPI calendar list
$GAPI calendar list --start 2026-03-01T00:00:00Z --end 2026-03-07T23:59:59Z
# Create event (timezone required)
$GAPI calendar create --summary "Team Standup" \
--start 2026-03-01T10:00:00-07:00 --end 2026-03-01T10:30:00-07:00
# With location and attendees
$GAPI calendar create --summary "Lunch" \
--start 2026-03-01T12:00:00Z --end 2026-03-01T13:00:00Z \
--location "Cafe" --attendees "alice@co.com,bob@co.com"
# Delete event
$GAPI calendar delete EVENT_ID
日历时间必须包含时区偏移量（例如 -07:00）或使用 UTC（Z）。像 2026-03-01T10:00:00 这样不带时区的日期时间是不明确的，将被视为 UTC。
云端硬盘
$GAPI drive search "quarterly report" --max 10
$GAPI drive search "mimeType='application/pdf'" --raw-query --max 5
表格
# Read a range
$GAPI sheets get SHEET_ID "Sheet1!A1:D10"
# Write to a range
$GAPI sheets update SHEET_ID "Sheet1!A1:B2" --values '[["Name","Score"],["Alice","95"]]'
# Append rows
$GAPI sheets append SHEET_ID "Sheet1!A:C" --values '[["new","row","data"]]'
文档
$GAPI docs get DOC_ID
返回文档标题和全文内容。
联系人
$GAPI contacts list --max 20
输出格式
所有命令均返回 JSON。各服务的关键字段如下：
| 命令 | 字段 |
|---|---|
gmail search | id, threadId, from, to, subject, date, snippet, labels |
gmail get | id, threadId, from, to, subject, date, labels, body |
gmail send/reply | status, id, threadId |
calendar list | id, summary, start, end, location, description, htmlLink |
calendar create | status, id, summary, htmlLink |
drive search | id, name, mimeType, modifiedTime, webViewLink |
contacts list | name, emails, phones |
sheets get | 单元格值的二维数组 |
故障排除
| 问题 | 解决方法 |
|---|---|
NOT_AUTHENTICATED | 运行设置（请求 Hermes 设置 Google Workspace） |
REFRESH_FAILED | 令牌已被撤销——重新运行授权步骤 |
HttpError 403: Insufficient Permission | 缺少权限范围——撤销授权并使用正确的服务重新授权 |
HttpError 403: Access Not Configured | 未在 Google Cloud Console 中启用 API |
ModuleNotFoundError | 使用 --install-deps 运行设置脚本 |