基于 Node.js 的本地后台计时器,支持多格式时间输入与系统通知,零依赖、无网络通信,适合日常提醒与番茄工作法。
说明:
## 核心用法
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 系统无音频反馈,依赖视觉通知。








