名称： gcal-pro
描述： Google Calendar 集成，用于查看、创建和管理日历事件。当用户询问日程安排、希望添加/编辑/删除事件、检查空闲时间或需要晨间简报时使用。支持自然语言查询，如“我明天的日历上有什么？”或“安排周五中午和 Alex 吃午餐”。免费版提供读取权限；专业版（12 美元）增加创建/编辑/删除功能和晨间简报。

gcal-pro

通过自然对话管理 Google Calendar。

快速参考

设置

首次使用需完成设置：

1. 用户必须创建 Google Cloud 项目并配置 OAuth 凭据
2. 将 client_secret.json 保存到 ~/.config/gcal-pro/ 目录
3. 运行身份验证：
   bash python scripts/gcal_auth.py auth
4. 浏览器将打开 → 用户授予日历访问权限 → 完成

检查认证状态：

python scripts/gcal_auth.py status

版本

免费版

• 查看事件（今日、明日、本周、本月）
• 搜索事件
• 列出日历
• 查找空闲时间段

专业版（一次性支付 12 美元）

• 包含免费版所有功能，并增加：
• 创建事件
• 快速添加（自然语言）
• 更新/重新安排事件
• 删除事件
• 通过 cron 定时发送晨间简报

使用模式

查看日程

当用户询问“我的日历上有什么？”或“我今天有什么安排？”时：

cd /path/to/gcal-pro
python scripts/gcal_core.py today

针对特定时间范围：
- “明天” → python scripts/gcal_core.py tomorrow
- “本周” → python scripts/gcal_core.py week
- “与 Alex 的会议” → python scripts/gcal_core.py search -q "Alex"

创建事件（专业版）

当用户说“将 X 添加到我的日历”或“安排 Y”时：

选项 1：快速添加（自然语言）

python scripts/gcal_core.py quick -q "周五中午与 Alex 共进午餐"

选项 2：结构化创建（通过 Python）

from scripts.gcal_core import create_event, parse_datetime

create_event(
    summary="与 Alex 共进午餐",
    start=parse_datetime("周五中午"),
    location="罗马咖啡馆",
    confirmed=True  # 设置为 False 将显示确认提示
)

修改事件（专业版）

⚠️ 执行破坏性操作前必须确认！

在删除或大幅修改事件之前，务必与用户确认：

1. 显示事件详情
2. 询问“是否要删除/重新安排此事件？”
3. 只有在用户确认后，才使用 confirmed=True 或 -y 标志继续操作

删除：

# 首先，查找事件
python scripts/gcal_core.py search -q "牙医"
# 显示事件 ID

# 然后删除（需用户确认）
python scripts/gcal_core.py delete --id abc123xyz -y

查找空闲时间

当用户询问“我什么时候有空？”或“找一个 1 小时的会议时间”时：

python scripts/gcal_core.py free

晨间简报（专业版 + Cron）

通过 Clawdbot cron 设置每日发送日程摘要：

from scripts.gcal_core import generate_morning_brief
print(generate_morning_brief())

Cron 设置示例：
- 计划：每天上午 8:00
- 操作：运行 python scripts/gcal_core.py brief
- 交付：将输出发送到用户的消息通道

错误处理

时区处理

• 所有时间均按用户本地时区解释（默认：America/New_York）
• 当用户指定时区（例如“下午 2 点 EST”）时，遵循该时区
• 以用户本地时区显示时间
• 以带时区的 ISO 8601 格式存储

响应格式

事件列表使用以下格式：

📅 **1月27日，星期一**
  • 上午 9:00 — 团队站会
  • 中午 12:00 — 与 Alex 共进午餐 📍 罗马咖啡馆
  • 下午 3:00 — 客户电话

📅 **1月28日，星期二**
  • 上午 10:00 — 牙医预约 📍 主街 123 号

确认信息：

✓ 事件已创建：“与 Alex 共进午餐”
  📅 1月31日，星期五，中午 12:00
  📍 罗马咖啡馆

晨间简报：

☀️ 早上好！这是您今天的安排：
📆 2026年1月27日，星期一

您今天有 3 个事件：
  • 上午 9:00 — 团队站会
  • 中午 12:00 — 与 Alex 共进午餐
  • 下午 3:00 — 客户电话

👀 明天：2 个事件

文件位置

~/.config/gcal-pro/
├── client_secret.json   # OAuth 应用凭据（用户提供）
├── token.json           # 用户访问令牌（自动生成）
└── license.json         # 专业版许可证（如果已购买）

与 Clawdbot 集成

此技能可与以下功能配合使用：
- Cron：安排晨间简报
- Memory：存储日历偏好设置
- Messaging：通过 Telegram/WhatsApp 等渠道发送简报

升级提示

当免费用户尝试专业版操作时，回复：

⚠️ 创建事件需要 gcal-pro 专业版（一次性支付 12 美元）。

专业版包含：创建、编辑、删除事件 + 晨间简报。

👉 升级链接：[gumroad-link]

目前，我可以为您显示日程安排（免费）—— 想看看今天的事件吗？