ai-chat-app/skills/calendar-manager/references/resources.md

日历管理参考资料

gcal CLI

安装

# macOS
brew install gcalcli

# Python
pip install gcalcli

配置

# OAuth 登录
gcalcli --oauth2

# 或使用凭据
gcalcli --client-id ID --client-secret SECRET ...

常用命令

# 列出今天
gcalcli calw

# 列出本周
gcalcli calw -n 2

# 搜索事件
gcalcli search "会议"

# 快速添加
gcalcli quick "Meeting" tomorrow 3pm

# 详细添加
gcalcli add \
  "团队会议" \
  --when "2026-02-25 14:00" \
  --duration 60 \
  --where "会议室A" \
  --description "讨论项目进度"

icalBuddy (macOS)

安装

brew install ical-buddy

常用命令

# 今天事件（含详情）
icalBuddy eventsToday+

# 明天事件
icalBuddy eventsTomorrow

# 指定范围
icalBuddy eventsFrom:2026-02-24 to:2026-02-28

# 未完成的任务
icalBuddy uncompletedTasks

# 带颜色输出
icalBuddy -c eventsToday

Cron 格式

┌───────────── 分钟 (0 - 59)
│ ┌───────────── 小时 (0 - 23)
│ │ ┌───────────── 日期 (1 - 31)
│ │ │ ┌───────────── 月份 (1 - 12)
│ │ │ │ ┌───────────── 星期 (0 - 6) (周日=0)
│ │ │ │ │
* * * * *

示例

# 每小时
0 * * * *

# 每天 8 点
0 8 * * *

# 每周一 9 点
0 9 * * 1

# 每月 1 号 10 点
0 10 1 * *

# 每 30 分钟
*/30 * * * *

Windows 任务计划

# 创建每日任务
$action = New-ScheduledTaskAction -Execute "python.exe" -Argument "script.py"
$trigger = New-ScheduledTaskTrigger -Daily -At "8:00AM"
Register-ScheduledTask -Action $action -Trigger $trigger -TaskName "DailyTask"