定时器（Timer）

设置在后台运行的定时任务。当定时器到期时，你将收到一条系统通知，且必须立即以提醒消息形式响应，以便向用户发出通知。

快速开始

# 设置一个 5 分钟定时器
bash background:true command:"node {baseDir}/timer.js 5m"

# 设置带标签的定时器
bash background:true command:"node {baseDir}/timer.js 10m 'Check the oven'"

# 以秒为单位设置定时器
bash background:true command:"node {baseDir}/timer.js 30s"

# 以小时为单位设置定时器
bash background:true command:"node {baseDir}/timer.js 1h"

时间格式

⚠️ 关键要求：定时器完成通知

当定时器完成时，你会收到一条形如以下的 System: 消息：

System: [2026-01-24 21:27:13] Exec completed (swift-me, code 0) :: ⏰ Timer complete! Check the pasta!

❌ 错误响应 — 不要这样回复：

HEARTBEAT_OK

🎉 Your timer is complete! Check the pasta!

该响应将被自动过滤，且不会送达用户！

✅ 正确响应 — 应该这样回复：

⏰ Timer Alert! Your timer is complete: Check the pasta!

请直接以通知消息开头，不要包含 HEARTBEAT_OK。

原因？ 所有以 HEARTBEAT_OK 开头、且总长度不足 300 字符的响应，均会被系统自动屏蔽，永不送达用户。你的定时器提醒将因此丢失！

示例

烹饪定时器

bash background:true command:"node {baseDir}/timer.js 12m 'Pasta is ready!'"

定时器到期后，请回复："⏰ Your 12-minute timer is up! Pasta is ready!"

快速提醒

bash background:true command:"node {baseDir}/timer.js 2m 'Take a break'"

Pomodoro 工作法

# 工作时段
bash background:true command:"node {baseDir}/timer.js 25m 'Pomodoro done - time for a break!'"
# 用户收到通知后...
# 休息时段
bash background:true command:"node {baseDir}/timer.js 5m 'Break over - back to work!'"

多个定时器

bash background:true command:"node {baseDir}/timer.js 5m 'Tea is ready'"
bash background:true command:"node {baseDir}/timer.js 10m 'Eggs are done'"
bash background:true command:"node {baseDir}/timer.js 30m 'Meeting starts soon'"

定时器管理

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

# 查询指定定时器状态
process action:poll sessionId:XXX

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

# 取消某个定时器
process action:kill sessionId:XXX

注意事项

• 定时器作为后台进程运行，并拥有唯一的 sessionId
• 正常完成的定时器退出码为 0
• 被手动取消（通过 kill）的定时器退出码为 130
• 在 macOS 上，若系统支持 afplay，定时器完成时将播放提示音
• 进度日志按如下频率记录：短时定时器每秒一次，长时定时器每 10 秒一次