MarioZZJ/cc-notify-hooks

README 摘要

cc-notify-hooks Claude Code 、 Codex CLI 、 Reasonix 与 dsh（DeepSeek Harness） 的分级推送通知系统。支持 11 个通知渠道 ，可作为插件或独立脚本使用，各 agent 共享同一份配置。 为什么需要分级通知？ Claude Code、Codex、Reasonix 和 dsh 的任务常常需要几秒到几十分钟不等。你不会一直盯着终端，但又需要在合适的时候回来操作。 cc-notify-hooks 将通知分为两级 ： 短通知（秒级） — 你可能只是切到了浏览器或聊天窗口。系统通知、手机推送这类 即时触达 的渠道会在几秒内提醒你"Claude 需要你"。如果你看到通知并回来操作了，后续推送自动取消——不会再打扰你。 长通知（分钟级） — 你可能离开了电脑、在开会、甚至不在手机旁。企业微信群、飞书群、Slack 频道这类 团队/异步渠道 会在几分钟后兜底通知。即使你错过了短通知，最终也能从工作沟通工具里看到任务状态。 核心机制 ：每次推送前检查用户是否已响应（pending 文件是否还在）。用户一旦回来操作，当前 Session 排队中的推送自动作废，其他并行 Session 不受影响。短通知解决了问题，长通知就不会再发。 支持的渠道 短通知渠道（即时触达） 适合切屏、短暂离开的场景。 渠道 默认延迟 说明 macOS 3s 零配置，系统原生通知 Telegram 5s Bot 消息，手机即时推送 Bark 15s iOS / macOS / Android 推送 Pushover 15s 跨平台推送服务 ntfy 15s 开源推送，支持自建 Gotify 15s 自建推送服务 长通知渠道（异步兜底） 适合离开电脑、开会、或需要团队可见的场景。 渠道 默认延迟 说明 企业微信 5min 群机器人 Webhook 飞书 5min 群机器人 Webhook 钉钉 5min 群机器人 Webhook Slack 5min Incoming Webhook Discord 5min Channel Webhook 每个渠道的延迟可独立调整。只启用你需要的渠道，其余自动跳过。 工作原理 安装 依赖 - jq — 解析 JSON（ brew install jq / apt install jq ） - curl — 发送推送（通常已预装） 方式一：Claude Code Marketplace（推荐 Claude 用户） 在 Claude Code 中执行： 安装后运行 /reload-plugins 刷新，然后执行 /cc-notify-hooks:config 启动交互式配置向导（见下方配置章节）。 方式二：Codex CLI Marketplace（推荐 Codex 用户） 仓库根目录的 .agents/p…

分类