Calendar reminder 是一个基于 ICS（iCalendar）协议的提醒操作工具，通过封装的提醒工作器 API 实现日历事件的创建、查询、删除和轮换等核心功能。该工具专为需要与订阅式日历服务集成的场景设计，能够自动将用户请求转化为标准的 ICS 格式事件，并同步到用户的日历系统中。其底层调用脚本 `scripts/reminder-client.mjs` 完成所有 HTTP 通信，确保接口调用的规范性与安全性。整个系统依赖环境变量配置 API 访问凭证和基础地址，避免硬编码敏感信息或盲目猜测部署位置。在交互过程中，工具会主动识别时间、时区、重复规则等关键信息的缺失或歧义，并通过简明追问引导用户提供完整参数，从而生成准确无误的日程条目。最终输出始终包含规范化后的日程详情，同时严格保护认证令牌等隐私数据不被泄露。
核心功能特点
- 支持创建符合 ICS 标准的提醒事件，包含标题、时间、时区等必填字段及备注、地点、URL 等可选属性
- 提供列出当前所有提醒的功能，便于用户查看和管理已有日程
- 允许按唯一 ID 删除指定提醒，实现精准的事件清理操作
- 具备轮换 ICS 订阅令牌的能力，保障长期同步服务的持续可用性
- 内置时间解析逻辑，可处理自然语言描述的时间表达式并转换为标准格式
- 遵循安全最佳实践，所有 API 调用均通过专用脚本执行，不暴露原始 HTTP 请求细节
适用场景
Calendar reminder 适用于需要将外部系统生成的提醒无缝集成进个人或团队日历生态的场景。例如，当企业应用希望向员工推送会议通知、任务截止提醒或节假日安排时，可通过此工具自动生成 ICS 事件并推送到员工的日历订阅源中。另一个典型用例是自动化运维平台，在系统维护窗口到期前触发告警提醒，确保相关人员及时响应。此外，个人开发者也可利用该技能构建自定义待办事项管理器，将语音输入或聊天指令转化为结构化日程项。无论是周期性任务（如每日签到、每周汇报），还是单次性重要节点（如生日、纪念日），该工具都能灵活适配。由于它完全基于开放标准 ICS，因此兼容绝大多数主流日历客户端，包括 Google Calendar、Outlook、Apple Calendar 以及国产办公套件中的日历模块，极大提升了跨平台协作的便利性。