cc-notify-hooks — AI Agent 时代的注意力调度器

问题

Agent 在等你，你不知道

这些场景每天都在发生。

⏳

权限确认卡了 20 分钟

Claude 需要你点一下"允许"，你切到浏览器看了篇文章，回来发现它等了你半小时。

😴

任务完成了但你不知道

跑了个大重构，你去喝咖啡。回来一看——10 分钟前就完成了，白等了。

🎮

多个 Agent 同时跑

3 个终端窗口 3 个任务。你根本记不住哪个需要你介入，哪个还在自己跑。

💪

离开电脑就失联

开个会回来，发现 Agent 在第 3 分钟就卡住了，剩下 57 分钟纯浪费。

机制

短通知 + 长通知，两级调度

推送前检查你是否已响应。回来了就停，没回来就升级。

事件触发

Claude Code 需要权限确认 / 等待输入 / 任务完成

3 ~ 15s

短通知 — 即时触达

macOS 系统弹窗、Telegram 消息、Bark / Pushover / ntfy 手机推送。你可能只是切了个窗口，几秒钟就能看到。

✓ 你看到通知回来了？后面的推送自动取消。

5 min

长通知 — 异步兜底

企业微信 / 飞书 / 钉钉 / Slack / Discord 群消息。你可能在开会、在通勤，但最终能从工作沟通工具看到任务状态。

✓ 短通知已经解决了？长通知不会再发。零噪音。

渠道

11 个渠道，按需启用

每个渠道的延迟可独立调整。不用的不开，开了的不烦。

短通知渠道（即时触达）

macOS3s 系统通知

Telegram5s Bot 推送

Bark15s iOS/Mac

Pushover15s 跨平台

ntfy15s 开源

Gotify15s 自建

长通知渠道（异步兜底）

企业微信5min Webhook

飞书5min Webhook

钉钉5min Webhook

Slack5min Webhook

Discord5min Webhook

安装

两行命令，即刻生效

Claude Code 插件一键安装，或独立脚本部署。

在 Claude Code 中执行：

/plugin marketplace add MarioZZJ/cc-notify-hooks
/plugin install cc-notify-hooks@cc-notify-hooks

安装后创建配置文件：

# 下载配置模板
curl -sL https://raw.githubusercontent.com/MarioZZJ/cc-notify-hooks/main/config/notify.example.json \
  -o ~/.claude/hooks/notify.json

# 编辑配置，启用你需要的渠道
# 将 "enabled": false 改为 true，填入凭证
vim ~/.claude/hooks/notify.json

git clone https://github.com/MarioZZJ/cc-notify-hooks.git
cd cc-notify-hooks
bash install.sh

安装脚本会交互式引导你选择渠道、输入凭证。

特性

为 Agent 工作流设计

⚡ 智能取消

用户回来操作，排队中的推送全部作废。不会重复打扰。

🔇 子智能体过滤

子任务不会触发推送，只有主 Agent 的关键事件才会通知你。

🕑 Rate Limiting

同类事件 10 秒内只推一次，高频操作不会变成通知轰炸。

🔧 延迟可调

每个渠道独立设置延迟。Telegram 5 秒、Bark 30 秒、飞书 10 分钟，你说了算。

🌏 macOS 零配置

macOS 用户装完即用，系统原生通知，不需要注册任何服务。

🔌 Claude Code 插件

标准插件结构，/plugin 命令安装，版本更新一键搞定。

人可以闲着
Agent 不可以