timer

⏱️ 零依赖后台计时提醒专家

基于 Node.js 的本地后台计时器,支持多格式时间输入与系统通知,零依赖、无网络通信,适合日常提醒与番茄工作法。

收藏
11.7k
安装
3.4k
版本
v1.0.0
CLS 安全性认证2026-05-06
点击查看完整报告 >

使用说明

核心用法

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 系统无音频反馈,依赖视觉通知。

安全解读

概述

timer 是一款轻量级后台计时器工具,专为需要定时提醒的场景设计。用户可通过简单命令设置分钟/小时/秒级计时,计时器在后台独立运行,完成后自动触发系统通知。

核心用法

  • 基础计时timer.js 5m 设置 5 分钟倒计时
  • 带标签提醒timer.js 10m 'Check the oven' 自定义提醒内容
  • 多格式支持:支持 30s/1h/5:30/1:30:00 等多种时间格式
  • 后台管理:通过 process 命令查看、轮询、终止运行中的计时器

显著优点

| 优势 | 说明 |
|------|------|
| **零依赖架构** | 仅使用 Node.js 内置模块,供应链攻击面为零 |
| **后台持久化** | 基于进程隔离,即使主会话中断计时仍继续 |
| **系统级提醒** | macOS 支持原生提示音(afplay),跨平台可扩展 |
| **代码极简** | 仅 213 行可执行代码,审计友好,无隐藏逻辑 |

潜在局限

  • 平台限制:提示音功能当前仅支持 macOS(afplay),Linux/Windows 需手动扩展
  • 无持久化存储:计时器状态仅存于内存,系统重启后丢失
  • 通知依赖外部机制:需正确配置系统通知通道,否则可能出现提醒遗漏

适合人群

  • 需要 专注工作流(Pomodoro、深度工作)的知识工作者
  • 烹饪/实验场景 需要多任务并行的用户
  • 追求 极简工具栈、厌恶臃肿 App 的技术用户

常规风险与注意事项

⚠️ 关键交互规范:计时完成时,系统会发送 System: 通知消息。用户必须直接回复提醒内容(如 "⏰ Pasta is ready!"),禁止HEARTBEAT_OK 开头——此类短响应会被过滤机制拦截,导致提醒静默丢失。

其他风险极低:代码无网络请求、无敏感数据收集、无文件系统越权访问。

timer 内容

手动下载zip · 3.7 kB
SKILL.mdtext/markdown
请选择文件