Mac Reminders Agent

核心用法

Mac Reminders Agent 是专为 macOS 设计的本地提醒事项管理技能，通过 AppleScript 直接调用系统原生 Reminders 应用。用户可通过自然语言指令执行两类操作：

1. 任务查询（list）

• 支持时间范围筛选：today（今日）、week（本周）、all（全部）
• 自动分类展示：未完成事项按时间排序，已完成事项单独归档
• 调用示例：cli.js list --scope week --locale zh

2. 任务添加（add）

• 自然语言解析：自动识别标题、截止时间、备注
• 时间格式：ISO 8601 标准（含时区偏移）
• 调用示例：cli.js add --title "会议" --due "2026-02-05T09:00:00+08:00" --locale zh

显著优点

• 本地优先架构：所有操作通过 AppleScript 直连系统应用，无需网络传输，任务数据零上云
• 多语言原生支持：内置英/韩/日/中四语模板，自动检测用户语言或显式指定 --locale
• 系统级集成：直接操作 macOS 原生数据库，支持与 Siri、快捷指令、iCloud 提醒事项的完整生态联动
• 轻量化依赖：仅依赖 applescript npm 模块，无重型框架

潜在局限

• 平台锁定：仅限 macOS，Windows/Linux 用户无法使用
• 权限依赖：首次使用需授权「辅助功能」或「自动化」权限，拒绝则完全失效
• 无跨设备同步能力：本身不解决同步问题，依赖用户已配置的 iCloud 账户状态
• 时间解析局限：--due 参数需严格 ISO 8601 格式，自然语言如"明天上午"需前置解析层转换

适合人群

• 重度依赖 macOS 原生提醒事项、追求工作流简洁的本地优先用户
• 对云端任务管理工具（Notion/Todoist）有隐私顾虑的多语言使用者
• 需将 AI 对话与现有 Apple 生态无缝衔接的自动化爱好者

常规风险

| 风险类别 | 说明 | 缓释措施 |

|---------|------|---------|

| 权限被拒 | 系统弹窗拦截 AppleScript 自动化 | 引导用户至「系统设置 > 隐私与安全 > 自动化」手动授权 |

| 时区偏差 | ISO 8601 时区偏移设置错误导致提醒时间错位 | 默认采用系统本地时区，显式校验偏移量格式 |

| 数据竞争 | 与其他 Reminders 客户端同时写入可能产生冲突 | 依赖 macOS 原生事务机制，极端情况建议用户避免高频并发操作 |

核心用法

Mac Reminders Agent 是一款专为 macOS 生态打造的本地化任务管理技能，通过 Node.js CLI 与 AppleScript 双桥接架构，实现与系统原生 Reminders 应用的深度集成。用户可通过自然语言触发两类核心操作：一是查询模式，支持按时间维度（今日/本周/全部）检索待办事项，自动区分完成与未完成状态并以本地化模板呈现；二是创建模式，允许以口语化指令快速添加新提醒，支持指定标题、截止时间（ISO 8601 格式）及备注内容。

技能采用三层调用链路：用户指令 → cli.js 统一入口 → apple-bridge.js 后端执行层。语言支持覆盖英语、韩语、日语、中文四种常用语种，既可通过 --locale 参数显式指定，也可基于用户输入自动检测，默认回退至英语。输出格式遵循各语言习惯，如韩语显示「미완료 미리알림」、中文显示「今天有什么任务」等本地化表达，大幅降低跨语言使用门槛。

显著优点

原生级体验：区别于第三方待办应用的繁琐同步，直接调用 macOS 内置 Reminders 数据库，确保数据实时一致，充分利用系统级通知、Siri 建议等生态能力。

零网络依赖：所有操作均通过本地 AppleScript 完成，无需云端 API 或网络请求，从根本上杜绝数据泄露风险，契合隐私敏感型用户需求。

多语言工程化：locales.json 的模板化设计使扩展新语种仅需补充键值对，无需改动核心逻辑，展现出良好的国际化架构思维。

轻量可信：仅依赖单一官方 npm 模块 applescript，无复杂依赖树，代码总量不足千行却功能完整，审计成本极低。

潜在缺点与局限性

平台锁定：AppleScript 为 macOS 专属技术，该技能无法在 Windows、Linux 或移动设备上运行，跨平台用户需寻找替代方案。

权限门槛：首次使用需在系统设置中授予终端应用访问 Reminders 的权限，对非技术用户可能存在配置障碍；若权限被拒绝，功能将完全不可用。

时间解析局限：当前 --due 参数要求严格的 ISO 8601 格式（如 2026-02-05T09:00:00+09:00），不支持「明天上午九点」等自然语言时间表达，用户需自行转换或依赖外部 NLP 层预处理。

功能边界：仅覆盖查询与创建两类基础 CRUD 操作，暂不支持修改、删除、列表分类筛选（如按智能列表区分工作/个人）、优先级标记等高级特性。

适合的目标群体

• macOS 重度用户：已深度使用 Apple 生态（iPhone、iPad、Mac 多端同步），希望将 AI Agent 能力无缝注入现有工作流的技术从业者与效率爱好者。
• 隐私优先者：拒绝将任务数据托管至 Notion、Todoist 等云端服务，坚持数据本地化的安全意识用户。
• 多语言办公场景：跨国团队或外语学习者，需在中文、日语、韩语等多语环境中快速管理任务。
• 极简主义者：追求「够用就好」，不愿为待办管理安装额外 App，希望直接复用系统原生应用的轻量用户。

使用风险

性能层面：AppleScript 执行涉及进程间通信与 GUI 自动化，单次调用耗时通常在 200-500ms，高频批量操作（如一次导入百条任务）可能出现明显延迟，建议控制单次调用规模。

依赖项风险：applescript npm 模块虽属官方维护，但更新频率较低；若未来 macOS 版本变更 AppleScript 接口语义，存在兼容性断裂可能，需关注维护者社区动态。

权限漂移：macOS 系统升级或安全策略重置可能意外撤销 Reminders 访问授权，导致技能静默失效，表现为「There was a problem accessing the Reminders app」错误，需用户手动重新授权。

子进程稳定性：child_process.execFile 调用自身脚本虽属安全设计，但若 apple-bridge.js 运行时遭遇 Reminders 应用未响应或数据文件损坏，可能抛出未捕获异常，建议生产环境配置重试机制与兜底提示。