基于 Google Calendar API 的日历管理工具，通过 OAuth 2.0 安全授权，支持自然语言交互查看、创建和管理日程，Free 层只读、Pro 层解锁完整写入功能。
说明：
## 核心用法
gcal-pro 是一款 Google Calendar 集成工具，用户通过自然语言对话即可完成日历管理。首次使用需在 Google Cloud 创建项目并配置 OAuth 凭据，完成授权后即可使用。
**基础查询（Free 层）**：查看今日/明日/本周日程、搜索特定事件、列出所有日历、查找空闲时段。命令行支持 `today`、`、`tomorrow`、`、`week`、`、`search`、`、`free` 等子命令。
**高级管理（Pro 层，$12 一次性）**：通过自然语言快速创建事件（如 “Lunch with Alex Friday at noon”）、更新/重新安排事件、删除事件、生成每日晨间简报。Pro 功能通过 `quick`、`、`delete`、`、`brief` 等命令实现，支持 Python API 调用。
**晨间简报**：可配置 Cron 定时任务，每日自动推送当日日程概览，包含事件数量、时间地点等关键信息。
## 显著优点
1. **权限分层设计科学**：Free 层仅申请 `calendar.readonly` 只读权限，Pro 层才扩展至 `calendar.events` 写入权限，严格遵循最小权限原则，降低用户授权顾虑。
2. **自然语言交互友好**：支持 “What’s on my calendar tomorrow?”、”Schedule lunch with Alex at noon Friday” 等口语化表达，降低使用门槛。
3. **安全防护措施到位**：敏感文件（token.json、license.json）统一存储于 `~/.config/gcal-pro//` 并设置 0o600 权限；删除等破坏性操作强制要求用户确认，避免误操作。
4. **依赖生态成熟**：基于 Google 官方 API 客户端库（google-auth、google-api-python-client），无第三方黑盒依赖，供应链风险可控。
5. **输出格式美观**：事件列表、确认回执、晨间简报均采用结构化 Emoji 排版，信息层级清晰，适合直接复制到聊天场景。
## 潜在缺点与局限性
1. **配置门槛较高**：首次使用需用户自行创建 Google Cloud 项目、配置 OAuth 凭据，对非技术用户不够友好，存在因配置错误导致的使用障碍。
2. **License 验证机制简单**：当前仅校验密钥格式（GCAL-XXXX-XXXX-XXXX），未接入 Gumroad API 进行在线验证，存在密钥共享或伪造风险。
3. **依赖版本未锁定**：requirements.txt 使用 `>=` 宽松版本约束，缺乏 SHA256 校验和，存在供应链攻击窗口（尽管当前依赖均为官方库）。
4. **时区处理单一**：默认固定为 America/New_York，虽支持用户显式指定时区，但自动检测能力不足，国际用户需手动调整。
5. **功能边界清晰但有限**：专注 Google Calendar 单平台，不支持 Outlook、Apple Calendar 等其他日历系统，跨平台用户需额外工具。
## 适合的目标群体
– **效率型知识工作者**：需要快速查询日程、管理会议安排的职场人士，尤其是已深度使用 Google Workspace 生态的用户。
– **技术爱好者与开发者**：具备基础命令行和 OAuth 配置能力，愿意自行完成首次 setup 的用户。
– **Clawdbot 框架用户**：已使用 Clawdbot 作为个人助手的用户，可通过 Cron + Messaging 实现自动化日程推送。
– **轻量级日历需求者**：不需要复杂项目管理功能，仅需”查看+简单编辑”核心场景的用户，Free 层已能满足大部分只读需求。
## 使用风险
1. **OAuth 授权风险**：用户需自行保管 client_secret.json，若文件泄露可能导致 Google 账号被恶意访问；建议定期在 Google 账号后台检查授权应用。
2. **Token 失效风险**：长期未使用可能导致 refresh token 过期，需重新运行认证流程，影响自动化任务（如晨间简报）的稳定性。
3. **Pro 功能付费转化摩擦**：Free 用户尝试写入操作时会触发升级提示，若用户期望”免费试用”可能产生体验落差。
4. **数据本地化局限**：所有数据存储于本地文件，无云端同步机制，多设备使用需手动迁移配置文件。
5. **Google API 配额限制**：高频调用可能触发 Google Calendar API 速率限制，影响大规模企业场景的使用体验。
会员专属
