gcal-pro

通过自然对话管理Google日历。

快速参考

设置

首次使用需进行设置：

1. 用户必须创建 Google Cloud 项目并配置 OAuth 凭据
2. 将client_secret.json文件保存到~/.config/gcal-pro/
3. 目录下

   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 "Lunch with Alex Friday at noon"

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

from scripts.gcal_core import create_event, parse_datetime

create_event(
    summary="Lunch with Alex",
    start=parse_datetime("Friday noon"),
    location="Cafe Roma",
    confirmed=True  # Set False to show confirmation prompt
)

修改事件（专业版）

⚠️ 执行破坏性操作前需要确认！

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

1. 显示事件详情
2. 询问"是否删除/重新安排此活动？"
3. 仅在以下情况后继续执行confirmed=True或-y用户确认后的标志

删除：

# First, find the event
python scripts/gcal_core.py search -q "dentist"
# Shows event ID

# Then delete (with user confirmation)
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
• 发送：将输出发送至用户的消息渠道

错误处理

时区处理

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

响应格式

对于事件列表，请使用以下格式：

📅 **Monday, January 27**
  • 9:00 AM — Team standup
  • 12:00 PM — Lunch with Alex 📍 Cafe Roma
  • 3:00 PM — Client call

📅 **Tuesday, January 28**
  • 10:00 AM — Dentist appointment 📍 123 Main St

用于确认：

✓ Event created: "Lunch with Alex"
  📅 Friday, Jan 31 at 12:00 PM
  📍 Cafe Roma

用于晨间简报：

☀️ Good morning! Here's your day:
📆 Monday, January 27, 2026

You have 3 events today:
  • 9:00 AM — Team standup
  • 12:00 PM — Lunch with Alex
  • 3:00 PM — Client call

👀 Tomorrow: 2 events

文件位置

~/.config/gcal-pro/
├── client_secret.json   # OAuth app credentials (user provides)
├── token.json           # User's access token (auto-generated)
└── license.json         # Pro license (if purchased)

与Clawdbot集成

此功能配合以下使用：

• 定时任务：安排晨间简报
• 记忆功能：存储日历偏好设置
• 消息传递：通过Telegram/WhatsApp等发送简报

升级提示

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

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

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

👉 升级请访问：[gumroad链接]

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