Apple Calendar (MacOS) 是一款专为 macOS 用户设计的本地命令行工具，用于高效管理通过系统日历应用同步的多种日历账户。该工具无需依赖第三方 API 密钥或复杂的 OAuth 授权流程，直接操作本地已集成的 Apple、Google、iCloud、Outlook 和 CalDAV 等日历数据。其核心设计理念是“以 Calendar.app 为统一入口”，在终端环境中实现对事件的快速查询、创建、更新与删除，同时确保所有操作具备安全校验与用户确认机制。所有运行上下文、配置偏好及操作日志均存储于用户主目录下的 `~/apple-calendar-macos/` 文件夹中，严格保证数据本地化，不向外部服务传输任何日历信息，充分尊重隐私与安全边界。 该工具适用于已经将各类日历账户配置并同步至 macOS 系统日历的用户场景。它不会处理账户连接或身份验证本身，而是聚焦于对已同步事件的管理。通过调用系统内置命令如 `icalBuddy`、`osascript` 或专用 CLI 工具 `apple-calendar-cli`，它能够解析时间范围、识别重复事件、检测冲突，并在执行写操作前进行预读验证，确保修改准确无误。尤其适合需要批量处理日程、快速插入会议或调试复杂时区问题的开发者与高级用户。 整体架构强调确定性输入与最小化暴露原则：所有时间参数需显式指定时区，避免因模糊表述（如“下周五”）导致误解；仅读取必要字段，不导出完整日历内容；对于删除、跨日历移动或多事件编辑等高风险操作，强制要求二次确认。此外，工具内置了命令路径探测机制，自动选择可用的底层执行方式，提升跨平台兼容性。无论是日常快速添加提醒，还是自动化脚本中的日程调度，Apple Calendar (MacOS) 都能在不离开终端的前提下提供稳定可靠的支持。
核心功能特点
- 无需 OAuth 或 API 密钥，直接操作本地已同步的 Apple、Google、iCloud、Outlook 和 CalDAV 日历
- 支持事件查询、创建、更新与删除，具备预读验证与写后确认机制
- 自动探测可用命令行工具（apple-calendar-cli > icalBuddy > shortcuts > osascript），适配不同 macOS 环境
- 所有配置与操作日志本地存储于 ~/apple-calendar-macos/，保障隐私与数据安全
- 对删除、跨日历移动和多事件编辑等危险操作强制要求用户显式确认
- 严格处理时区、重复事件与全天事件语义，避免夏令时导致的漂移问题
适用场景
Apple Calendar (MacOS) 特别适合那些已经在系统日历中集成了多个账户（如公司 Outlook、个人 Google 日历和家庭 iCloud）的用户。在日常工作中，当需要快速查看未来一周的所有会议安排，或临时插入一个紧急预约时，该工具允许用户直接在终端中输入命令完成操作，无需反复切换图形界面。例如，开发人员可以在编写自动化脚本时调用此工具来动态创建测试用的会议事件，或在部署新系统前批量清理过期日程。 对于经常出差或跨时区协作的专业人士而言，该工具的时区处理能力尤为关键。它能明确区分事件所属时区，并在写入时保留原始时间边界，防止因夏令时调整而导致重复事件错位。此外，在处理包含重复规则（如每周例会）的事件时，系统会主动提示确认递归逻辑与时区行为，避免因默认设置引发意外变更。 另一个典型使用场景是故障排查与恢复。由于每次删除或大规模编辑都会记录到 `safety-log.md` 中，用户可以回溯操作历史，必要时还原误删内容。这种设计使得该工具不仅适用于常规管理，也能作为可靠的日程审计与修复手段，尤其适合 IT 管理员维护团队共享日历或在教学环境中指导学生整理个人计划。