核心用法
Calendar Planner 是一款面向命令行用户的跨平台日历规划技能，专注于解决多日历源（Google Calendar、Outlook、Apple Calendar、CalDAV）之间的日程冲突修复与周度统筹。用户通过 gcalcli、khal/vdirsyncer、osascript 或 Microsoft Graph PowerShell 等轻量适配器，执行读取、合并、审计和写入操作。
核心工作流遵循「Life Grid Protocol」：
1. Intake — 识别真实目标，而非仅处理表面请求
2. Map — 将事项分类为 hard（硬性承诺）、flexible（弹性块）、prep（准备）、travel（通勤）、recovery（恢复）
3. Defend — 优先保护不可协商时段
4. Repair — 若周计划已崩溃，提供具体移动/取消/降级方案
5. Close — 输出单一推荐计划及可直接执行的命令序列
配套三个 Python 脚本实现本地分析：calendar_merge.py（多源归一化）、calendar_guard.py（冲突与缓冲检测）、week_plan.py（周度复盘生成）。
显著优点
- 多源整合：原生支持四大主流日历生态，避免厂商锁定
- CLI 原生：完全基于命令行，便于脚本化、自动化与版本控制
- 安全设计：所有写入操作需显式授权，默认先输出 dry-run；可选本地记忆文件严格最小化，不存储参会人详情或敏感描述
- 结构性规划：Life Grid 方法强制区分硬性承诺与弹性块，防止「假容量」导致的日程崩塌
- 缓冲保护：强制要求为会议配置准备、通勤、恢复时间，识别 overlapped days 与 short gaps
潜在缺点与局限
- 技术门槛高：需自行配置 OAuth、PowerShell 模块或 CalDAV 同步，非技术用户上手成本显著
- 无原生 GUI：依赖终端与 Markdown 文件，视觉规划体验弱于 Notion、Cron 等工具
- 写入风险：虽有多重确认机制，但 CLI 操作一旦确认即直接修改云端日历，无「撤销」缓冲
- 平台依赖：Apple Calendar 自动化仅限 macOS；Windows 用户需额外配置 WSL 或 PowerShell 环境
- 记忆连续性弱：本地记忆文件需用户主动维护，无自动学习用户偏好的 AI 推断能力
适合人群
- 开发者、运维工程师、技术管理者等习惯 CLI 工作流的专业人士
- 多日历源用户（如同时管理个人 Google Calendar 与公司 Outlook）
- 需要周度「日程修复」而非单点约会的深度时间管理实践者
- 隐私敏感型用户，希望规划数据尽量本地化处理
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|---------|---------|---------|
| 误操作写入 | CLI 确认后即刻同步云端，可能误删或误移他人会议 | 强制 dry-run 预览；分离读写权限日历；核心日历设为只读模式 |
| 数据残留 | 本地 `~/calendar-planner/` 目录若未加密，存在规划习惯泄露风险 | 敏感环境禁用本地记忆；定期清理 `inbox.md` 与 `plans.md` |
| 适配器失效 | Google/Microsoft API 变更导致 `gcalcli` 或 Graph 模块失效 | 锁定特定版本；关注 changelog；保留 ical 导出作为 fallback |
| 时间估算偏差 | 过度依赖脚本检测，忽略人类「状态波动」因素 | 保留 manual override 入口；在 `memory.md` 中记录个人疲劳模式 |
| 社交冲突 | 未经充分协商直接移动共享日历事件 | 严格遵循「ask before write」原则；优先生成提案供人工确认 |
安全等级说明
- 数据最小化：仅传输必要的日历元数据，不含邮件、联系人或任务内容
- 显式授权：所有外部写入需用户逐次确认，无自动化静默操作
- 本地优先：分析脚本完全本地运行，规划记忆文件可选且需用户显式同意创建
综合评估：A 级 — 设计良好的隐私优先工具，但 CLI 操作本身带来的误操作风险需用户自行管控。