Google Calendar 自然语言管理工具，支持日程查看、智能创建、可用时段查询及晨间简报，需用户自建 OAuth 认证，Pro 版 $12 解锁完整功能。
说明：
## 核心功能与用法
gcal-pro 是一款面向 Google Calendar 的 CLI 集成工具，通过自然语言对话实现日历管理。核心能力覆盖**只读查询**与**写入操作**两大层级：
**基础功能（Free）**：查看今日/明日/本周日程、事件搜索、日历列表、空闲时段检测。适合快速确认行程安排，避免在浏览器与终端间切换。
**高级功能（Pro/$12）**：自然语言快速创建（如 “Lunch with Alex Friday at noon”）、事件修改/删除、每日晨间简报（cron 推送）。其中 `quick` 指令的 NLP 解析是核心卖点，显著降低创建成本。
### 技术架构与使用模式
– **OAuth 自托管**：用户需在 Google Cloud Console 创建项目并下载 `client_secret.json`，工具本地存储 `token.json`。该设计将认证责任转移给用户，避免第三方托管敏感令牌，但也提高了入门门槛。
– **Python API + CLI 双模式**：既可直接调用 `gcal_core.py` 函数，也可通过命令行脚本执行，便于嵌入自动化工作流。
– **Cron 集成**：Pro 用户可配置定时任务，通过 Clawdbot 推送每日日程摘要至消息通道。
### 显著优点
1. **自然语言交互**：降低日历操作的认知负荷，无需记忆严格的日期格式。
2. **分层定价合理**：基础查询免费满足多数场景，$12 一次性付费而非订阅，对轻度用户友好。
3. **本地化认证**：OAuth 凭据由用户自持，符合隐私敏感用户的偏好。
4. **确认机制**：删除/修改操作强制要求用户确认，避免误操作。
### 局限性与风险
– **配置门槛高**：首次 setup 需完成 Google Cloud 项目创建、OAuth 配置、本地文件放置，非技术用户可能放弃。
– **依赖 Google API 稳定性**：令牌过期、API 变更或权限回收均会导致服务中断。
– **功能边界模糊**：描述中 “confirmed=True” 与 `-y` 标志的混用可能造成用户困惑。
– **无多账户支持**：文档未提多 Google 账号切换，企业用户场景受限。
### 适合人群
– 重度终端用户 / 开发者
– 追求自动化工作流的技术从业者
– 对订阅制反感、偏好买断制的个人用户
### 常规风险
– **令牌泄露风险**：`token.json` 若被窃取可导致日历数据暴露
– **误删事件**：尽管有确认机制，批量操作或脚本错误仍可能引发数据丢失
– **时区歧义**：默认 America/New_York，跨时区用户需显式指定
会员专属
