计时器

设置可在后台运行的计时器。计时器完成后，您将收到系统通知，并且必须发送提醒来通知用户。

快速开始

# Set a 5-minute timer
bash background:true command:"node {baseDir}/timer.js 5m"

# Set a timer with a label
bash background:true command:"node {baseDir}/timer.js 10m 'Check the oven'"

# Set a timer in seconds
bash background:true command:"node {baseDir}/timer.js 30s"

# Set a timer in hours
bash background:true command:"node {baseDir}/timer.js 1h"

时间格式

⚠️ 重要：计时器完成通知

当计时器结束时，您会收到一条系统：类似这样的消息：

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!'"

完成后，请回复："⏰ 您的12分钟计时器已到！意面煮好啦！"

快速提醒

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

番茄工作法时段

# Work session
bash background:true command:"node {baseDir}/timer.js 25m 'Pomodoro done - time for a break!'"
# After user is notified...
# 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'"

管理计时器

# List all running timers
process action:list

# Check specific timer status
process action:poll sessionId:XXX

# View timer output
process action:log sessionId:XXX

# Cancel a timer
process action:kill sessionId:XXX

备注

• 计时器作为后台进程运行，具有唯一的 sessionId
• 完成的计时器以代码 0 退出
• 通过 kill 命令取消的计时器以代码 130 退出
• 计时器完成时，在 macOS 上会播放声音通知（如果afplay可用）
• 每秒（短计时器）或每10秒（长计时器）记录一次进度