timer

核心用法

Timer 是一个后台定时器工具，基于 Node.js 运行，支持秒、分、小时及 MM:SS、HH:MM:SS 等多种时间格式。通过 bash background:true 命令启动后，定时器在后台独立运行，完成后向系统推送通知。

显著优点

• 后台运行：不阻塞主会话，可同时设置多个定时器（如同时煮茶、煮蛋）
• 灵活格式：支持 30s、5m、1h、5:30、1:30:00 等直观写法
• 系统通知：完成后通过 System 消息推送，配合正确的响应格式可确保用户收到提醒
• 进程管理：支持 list、poll、kill 等操作管理运行中的定时器
• 原生音效：macOS 环境下自动播放提示音（需 afplay）

潜在缺点与局限性

• 响应格式严格：必须避免 HEARTBEAT_OK 开头且短于 300 字符的响应，否则通知被系统过滤丢失
• 平台依赖：依赖 Node.js 环境；音效功能仅限 macOS
• 无持久化：重启或断线后台进程可能丢失
• 精度限制：秒级/10秒级日志更新，非毫秒级精确

适合人群

• 需要多任务计时提醒的烹饪用户
• 使用番茄工作法（Pomodoro）的效率工作者
• 会议、休息等场景的快速提醒需求

常规风险

• 通知丢失风险：开发者或 AI 若误用 HEARTBEAT_OK 响应格式，用户将收不到提醒
• 后台进程堆积：未清理的定时器进程可能占用资源，需主动 kill
• 时间解析歧义：纯数字如 5 默认为分钟，可能与用户直觉（秒）不符

核心用法

Timer Skill 是一款极简设计的本地后台计时工具，专为需要专注工作流的用户打造。用户通过 bash background:true 命令启动计时器，支持 30s、5m、1h、MM:SS、HH:MM:SS 等多种时间格式，并可附加自定义提醒标签。计时器在后台独立运行，完成后通过系统消息推送通知，用户需直接回复提醒内容（切勿添加 `HEARTBEAT_OK`）以确保消息送达。

显著优点

1. 零依赖纯本地架构：仅使用 Node.js 内置模块（child_process、path），无需任何 npm 第三方包，彻底杜绝供应链攻击风险
2. 后台静默运行：基于进程级后台任务，不阻塞对话流，支持多计时器并行（烹饪、会议、番茄钟等场景）
3. 完善的进程管理：提供 process action:list/poll/kill 全生命周期管理，可随时查看、取消运行中的计时器
4. 安全输入验证：对时间格式、边界值进行严格解析校验，防止畸形输入导致异常
5. 隐私零侵入：不收集、不传输任何用户数据，完全离线运行

潜在缺点与局限性

• 平台音效限制：当前仅支持 macOS afplay 播放提示音，Linux/Windows 用户无音效反馈
• 无持久化存储：进程重启或系统中断后，计时器状态丢失，不支持跨会话恢复
• 无可视化界面：纯命令行交互，对非技术用户存在一定学习成本
• 通知格式敏感：必须严格遵循「直接回复提醒消息」的协议，误加 HEARTBEAT_OK 将导致通知被过滤

适合人群

开发者、远程工作者、需要多任务时间管理的效率用户，以及注重隐私安全的极简主义者。特别适合番茄工作法实践者、烹饪定时、会议提醒等场景。

常规风险

风险极低。经 CLS-Certify 六维安全扫描（静态分析、动态行为、依赖审计、网络流量、隐私合规、威胁情报）全部满分通过，未发现任何恶意代码或可疑行为。唯一的外部调用 afplay 为 macOS 系统标准音效播放命令，功能单一且已做错误边界处理。建议未来版本补充开源许可证声明及跨平台音效适配。