timer

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

🥥3总安装量 1评分人数 1
100% 的用户推荐

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

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 代码安全规范,无 eval/exec/system 等危险函数
  • ✅ 零外部依赖,仅使用 Node.js 内置模块
  • ✅ 完善的输入验证与类型检查,无注入风险
  • ⚠️ 来源为个人开发者账号(hisxo),属 T3 来源
  • ⚠️ 使用 spawn 调用 macOS afplay 播放提示音(参数硬编码,无注入风险)

使用说明

核心用法

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
请选择文件