Timer Alert Tool Free

后台定时提醒免费版：多格式定时器、完成通知、番茄钟与基础多计时器管理。

定时提醒工具（免费版）

概述

本工具提供后台定时器与到时提醒能力，让 AI Agent 能够设置倒计时并在完成时收到系统通知。定时器在后台运行，不阻塞当前会话，完成后触发系统通知并由 Agent 响应用户。免费版聚焦"能定时"——覆盖 6 种时间格式、自定义文案、番茄钟与多计时器并行；循环定时、模板库与升级提醒等高级能力留给专业版。

核心能力

能力	说明	免费版
基础定时	秒/分/时倒计时	是
时间格式	6 种格式支持	是
自定义文案	到时提醒消息	是
番茄钟	25分钟专注+5分钟休息	是
多计时器	并行运行多个定时器	是
进程管理	列表/轮询/日志/终止	是
完成通知	系统通知+Agent响应	是
循环定时	间隔重复提醒	否（专业版）
模板库	预设提醒模板	否（专业版）
升级提醒	多级提醒策略	否（专业版）
定时任务	指定时间点触发	否（专业版）
监控面板	实时计时器状态	否（专业版）

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：后台定时提醒免费、多格式定时器、番茄钟与基础多计、时器管理、定时提醒工具、面向个人用户与独、立开发者、提供后台定时器与、到时提醒能力、支持多种时间格式、时分秒、自定义提醒文案、番茄钟工作法、多计时器并行与后、台进程管理、定时器在后台运行、完成后触发系统通、Use、when、需要生成营销文案、写作内容、标题优化、内容创作时使用、不适用于纯技术文、档撰写等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：烹饪定时

用户说"帮我设一个 12 分钟的定时器，提醒我意大利面好了"。Agent 在后台启动 12 分钟定时器，到时后通知用户。

bash

bash background:true command:"node {baseDir}/timer.js 12m '意大利面好了！'"

完成后 Agent 响应：

text

⏰ 定时提醒！12 分钟计时已到：意大利面好了！

场景二：番茄钟工作法

用户说"帮我启动番茄钟工作法"。Agent 先后启动 25 分钟专注定时器与 5 分钟休息定时器，交替提醒。

bash

# 专注阶段（25 分钟）
bash background:true command:"node {baseDir}/timer.js 25m '番茄钟专注时间结束！该休息了。'"

# 休息阶段（5 分钟，专注结束后启动）
bash background:true command:"node {baseDir}/timer.js 5m '休息结束！回到工作。'"

场景三：多任务并行计时

用户说"帮我同时设三个定时器：茶 5 分钟、鸡蛋 10 分钟、会议 30 分钟"。Agent 并行启动三个后台定时器。

bash

bash background:true command:"node {baseDir}/timer.js 5m '茶泡好了'"
bash background:true command:"node {baseDir}/timer.js 10m '鸡蛋煮好了'"
bash background:true command:"node {baseDir}/timer.js 30m '会议马上开始'"

快速开始

60 秒上手

1. 确定倒计时时长与提醒文案
2. 使用 bash background:true 启动后台定时器
3. 定时器完成后收到系统通知
4. Agent 以正确格式响应提醒用户

基础定时器

bash

# 5 分钟定时器
bash background:true command:"node {baseDir}/timer.js 5m '时间到了！'"

# 30 秒定时器
bash background:true command:"node {baseDir}/timer.js 30s '快速提醒'"

# 1 小时定时器
bash background:true command:"node {baseDir}/timer.js 1h '一小时已到'"

管理运行中的定时器

bash

# 列出所有运行中的定时器
process action:list

# 查看特定定时器状态
process action:poll sessionId:XXX

# 查看定时器日志
process action:log sessionId:XXX

# 终止定时器
process action:kill sessionId:XXX

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

示例

时间格式速查

格式	描述	示例	等效时长
Ns	N 秒	30s、90s	30 秒、90 秒
Nm	N 分钟	5m、15m	5 分、15 分
Nh	N 小时	1h、2h	1 小时、2 小时
N	N 分钟（默认）	5	5 分钟
MM:SS	分:秒	5:30	5 分 30 秒
HH:MM:SS	时:分:秒	1:30:00	1 小时 30 分

番茄钟配置

bash

# 标准番茄钟：25 分钟专注 + 5 分钟休息
bash background:true command:"node {baseDir}/timer.js 25m '番茄钟：专注完成！休息 5 分钟。'"
# 专注结束后启动休息
bash background:true command:"node {baseDir}/timer.js 5m '番茄钟：休息结束！开始下一轮专注。'"

# 长休息版：50 分钟专注 + 10 分钟休息
bash background:true command:"node {baseDir}/timer.js 50m '深度专注完成！休息 10 分钟。'"
bash background:true command:"node {baseDir}/timer.js 10m '长休息结束！继续工作。'"

多计时器场景配置

场景	计时器 1	计时器 2	计时器 3
烹饪	茶 5m	鸡蛋 10m	汤 30m
会议	议程A 15m	议程B 20m	总结 5m
运动	热身 5m	训练 30m	拉伸 10m
学习	阅读 25m	练习 15m	复习 10m

最佳实践

1. 完成通知格式（关键）

定时器完成后收到 System: 消息。响应必须直接以提醒开头，不能以 HEARTBEAT_OK 开头——以 HEARTBEAT_OK 开头且少于 300 字符的响应会被自动过滤，用户收不到提醒。

text

# 错误（会被过滤，用户收不到）
HEARTBEAT_OK
⏰ 定时器完成了！

# 正确（用户能收到）
⏰ 定时提醒！你的 12 分钟计时已到：意大利面好了！

2. 后台运行

定时器必须使用 background:true 在后台运行，否则会阻塞当前会话。后台定时器有独立 sessionId，完成后退出码为 0。

3. 多计时器管理

并行运行多个定时器时，用 process action:list 查看所有 sessionId。每个定时器独立计时，完成时分别通知。建议为每个定时器设置有区分度的提醒文案。

4. 番茄钟循环

标准番茄钟为 25 分钟专注 + 5 分钟休息。每 4 个番茄钟后安排一次长休息（15-30 分钟）。专注定时器结束后立即启动休息定时器，保持节奏。

5. 提醒文案要具体

提醒文案应包含足够信息让用户立即理解。避免模糊的"时间到了"——写明是什么任务的定时器完成了。

6. 及时清理已完成定时器

已完成的定时器会自动退出（码 0）。手动终止的定时器退出码 130。定期用 process action:list 检查，避免残留进程。

7. 提醒文案包含上下文

好的提醒文案应包含：计时器用途 + 剩余状态 + 后续动作。例如"Pasta 定时完成！请关火滤水，准备酱汁"比"时间到了"更有帮助。

8. 长时间定时器分段

超过 1 小时的定时器建议分段设置中间检查点。例如 3 小时工作拆为 3 个 1 小时定时器，每个检查点评估进度并决定是否调整计划。

常见问题

Q1：定时器完成后用户没收到通知？

A：检查 Agent 响应格式——不能以 HEARTBEAT_OK 开头。响应应直接以提醒内容开头，如 ⏰ 定时提醒！...。HEARTBEAT_OK 开头且少于 300 字符的响应会被自动过滤。

Q2：定时器没有在后台运行？

A：必须使用 bash background:true 启动。如果省略 background:true，定时器会阻塞当前会话直到完成。

Q3：如何取消正在运行的定时器？

A：先用 process action:list 找到 sessionId，再执行 process action:kill sessionId:XXX。被终止的定时器退出码为 130。

Q4：多个定时器同时完成怎么处理？

A：每个定时器完成后分别触发独立的系统通知。Agent 按通知到达顺序依次响应，每个响应独立处理。

Q5：定时器精度如何？

A：短定时器（< 1 分钟）每秒记录进度，长定时器每 10 秒记录。精度在 ±1 秒内。macOS 完成时会播放声音提示（需 afplay 可用）。

Q6：如何查看定时器运行日志？

A：process action:log sessionId:XXX 查看特定定时器的进度日志，包含每秒/每 10 秒的计时记录。

已知限制

A：免费版不支持循环定时（间隔重复提醒）、提醒模板库、多级升级提醒、指定时间点触发与实时监控面板。这些能力在专业版提供。

免费版限制

本免费版限制以下高级功能：

• 循环定时（间隔重复提醒，如每 30 分钟提醒一次喝水）
• 提醒模板库（预设场景快速启动）
• 多级升级提醒（首次→重复→紧急三级策略）
• 指定时间点触发（如每天 14:00 提醒）
• 实时监控面板（所有定时器状态可视化）
• 定时器链（前一个完成后自动启动下一个）
• 跨会话持久化（重启后恢复定时器状态）
• 通知渠道扩展（邮件/Webhook/推送）

解锁全部功能请使用专业版：timer-alert-tool-pro

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 且具备后台进程执行能力的 AI Agent
• 操作系统：Windows / macOS / Linux
• Node.js：16+（运行 timer.js 定时器脚本）

依赖详情

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由 Agent 内置 LLM 提供
Node.js 16+	运行时	必需	运行 timer.js 脚本
afplay	CLI 工具	可选	macOS 自带，完成时播放声音
声卡/扬声器	硬件	可选	播放声音提示

API Key 配置

• 无需额外 API Key：本工具基于本地 Node.js 脚本运行，不调用外部 API
• 禁止：在 SKILL.md 或脚本中硬编码任何凭证
• 安全建议：定时器在本地后台运行，提醒内容不应包含敏感信息

可用性分类

• 分类：MD+EXEC（纯 Markdown 指令，需要 exec 命令行执行能力启动后台定时器）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务
• 模型路由建议：免费版使用低成本模型（如 GPT-4o-mini / Claude Haiku）即可完成定时器管理与通知响应

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案