gcal-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 速率限制，影响大规模企业场景的使用体验。