终端直控 Apple 日历，自动化日程管理

macOS 原生 Apple Calendar 命令行工具，支持日程查询、创建/修改/删除事件及空闲时间检测，需 Node.js 环境。

基本信息

• 技能名称?Apple Calendar CLI
• 中文名称?终端直控 Apple 日历，自动化日程管理
• 作者?joargp
• 分类?其他
• 版本?1.0.0
• 标签?calendar, macos, cli, automation, jxa, productivity, ical, scheduling

使用方法

使用说明
核心用法
accli 是基于 JavaScript for Automation (JXA) 的 macOS 专属 CLI 工具，通过 Node.js 包装实现与 Apple Calendar 的深度集成。主要功能模块包括：
日历管理 ：列出所有日历并获取持久化 ID，支持设置默认日历简化后续操作
事件操作 ：查询（支持时间范围过滤、关键词搜索）、创建、更新、删除全流程管理
空闲检测 ：跨多日历分析忙闲状态，自动排除已取消、已拒绝及透明事件
关键特性 ：
纯 JSON 输出模式（ --json ）便于脚本集成
支持 ISO 8601 标准时间格式（ YYYY-MM-DDTHH:mm 与 YYYY-MM-DD ）
日历 ID 优先机制（比名称更稳定）
显著优点

1. 原生集成 ：直接调用 Apple Calendar 数据库，无需 iCloud API 或第三方同步
2. 离线可用 ：完全本地运行，不依赖网络连接
3. 自动化友好 ：JSON 输出配合标准 Unix 时间操作，适合 Shell 脚本与定时任务
4. 权限复用 ：继承 macOS 系统日历权限，无需额外 OAuth 流程
   潜在局限
   平台锁定 ：仅支持 macOS，无法跨平台使用
   权限依赖 ：首次运行需用户授权访问日历，无 GUI 交互时可能阻塞
   功能边界 ：不支持高级功能如会议邀请发送、附件管理、重复规则创建
   npm 分发 ：依赖 Node.js 生态，企业环境可能受软件源策略限制
   适合人群
   macOS 重度用户需自动化日程管理
   开发团队构建内部效率工具（如 Slack/钉钉机器人集成）
   个人用户偏好终端工作流（配合 cron 、 fzf 等工具）
   常规风险
   数据误操作 ： delete 命令永久删除，建议二次确认或先备份
   时区歧义 ：未明确指定时区时依赖系统设置，跨时区场景需谨慎
   并发冲突 ：无事务机制，多进程同时修改可能导致日历状态不一致
   权限持久化 ：系统权限变更后需手动重新授权，自动化场景可能中断