核心用法
Timer Skill 是一款轻量级后台计时工具,通过 Node.js 脚本实现多场景定时提醒。用户可通过 bash background:true 命令启动计时器,支持秒(s)、分钟(m)、小时(h)及 MM:SS、HH:MM:SS 等多种时间格式,并可附加自定义标签(如"Check the oven")。计时器以独立后台进程运行,完成后通过系统消息通知用户,Agent 需直接回复提醒内容(禁止以 HEARTBEAT_OK 开头)以确保用户收到通知。
显著优点
1. 零外部依赖:仅使用 Node.js 内置模块(child_process、path),无 package.json 依赖,杜绝供应链攻击风险。
2. 输入严格验证:parseDuration 函数采用正则表达式校验时间格式,限制最大 24 小时,防止无效或恶意输入。
3. 后台进程管理:支持多计时器并行运行,可通过 process action:list/poll/kill 查看、监控和终止任务。
4. 原生系统集成:macOS 环境下自动调用 afplay 播放系统提示音,增强提醒效果。
5. 权限最小化:仅申请 node 运行权限,与功能完全匹配,无过度授权。
潜在缺点与局限性
- 平台限制:提示音功能依赖 macOS 的 afplay 命令,其他系统无声音提醒。
- 精度边界:计时检查间隔为 100ms,不适合毫秒级精密计时场景。
- 时长上限:硬编码 24 小时最大限制,无法满足超长周期提醒需求。
- T3 来源风险:虽代码审计通过,但源自个人开发者账号(hisxo),长期维护稳定性存疑。
适合的目标群体
- 需要烹饪计时、会议提醒的日常用户
- 践行 Pomodoro 番茄工作法的效率工作者
- 多任务并行管理需求的办公场景
- 对数据隐私敏感、拒绝云端服务的本地优先用户
使用风险
- 通知丢失风险:若 Agent 错误地以 HEARTBEAT_OK 开头回复,短内容将被系统过滤,导致用户收不到提醒(文档已重点警示)。
- 进程残留风险:异常退出可能导致后台进程未清理,需手动通过 process action:list 检查。
- 跨平台兼容性:非 macOS 系统无音频反馈,依赖视觉通知。