timer

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

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

收藏
11.7k
安装
3.4k
版本
v1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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 内容

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