cc-notify-hooks: Instructions file for Claude Code

cc-notify-hooks

Claude Code、Codex CLI、Reasonix 与 dsh（DeepSeek Harness）的分级推送通知系统。通过 hook/拦截点触发多渠道通知，用户响应后自动取消排队中的推送。

技术栈

• 语言: Bash（核心脚本）+ JavaScript（dsh 宿主插件，零依赖）
• 依赖: jq（JSON 解析）、curl（HTTP 请求）、osascript（macOS 通知）
• 集成: Claude Code / Codex CLI / Reasonix 的 hooks 插件机制 + dsh 的 cordis 拦截点

项目结构

plugins/cc-notify-hooks/    # 真实插件根目录（根目录的 scripts/hooks/config 是软链）
├── scripts/notify.sh       # 主调度器：事件过滤、延迟排队、渠道分发（兼容 4 个 agent 字段）
├── scripts/clear_pending.sh# 清除待发通知（用户交互时触发）
├── scripts/pre_tool_use.sh # 提问工具 dispatcher（request_user_input / ask / AskUserQuestion）
├── scripts/channels/*.sh   # 11 个渠道实现
├── hooks/hooks.json        # Claude Code hook 事件定义
├── hooks/codex-hooks.json  # Codex CLI hook 事件定义
├── reasonix-plugin.json    # Reasonix 原生插件清单（v2，payloadFormat=claude）
├── dsh-plugin/             # dsh 宿主插件（cordis，订阅 5 个拦截点）
├── .claude-plugin/         # Claude Code 插件清单
├── .codex-plugin/          # Codex CLI 插件清单
├── config/notify.example.json
└── skills/config/SKILL.md  # 交互式配置 skill（Claude Code 专属）
install.sh                  # 独立安装入口（路由）
install/{claude,codex,reasonix,dsh}.sh
test_notify.sh              # 渠道连通性 + 模板/agent 识别测试

常用命令

# 安装
bash install.sh                  # 交互式选择 Claude Code / Codex / Reasonix / dsh
bash install.sh claude|codex|reasonix|dsh

# 测试
bash test_notify.sh              # 测试所有已启用渠道
bash test_notify.sh bark         # 测试单个渠道
bash test_notify.sh hook         # 模拟 Claude Code hook 流程
bash test_notify.sh codex        # 模拟 Codex CLI PermissionRequest 事件
bash test_notify.sh agents       # 验证 Reasonix / dsh agent 识别
node plugins/cc-notify-hooks/dsh-plugin/test/plugin.test.mjs  # dsh 插件单元测试

# 插件模式运行
claude --plugin-dir ./cc-notify-hooks
reasonix plugin install ./plugins/cc-notify-hooks --link --yes

核心机制

• 分级延迟: 短通知（秒级：macOS/Bark/Telegram）→ 长通知（分钟级：微信/飞书/钉钉/Slack）
• Pending 取消: 发送前创建标记文件，用户响应时清除，后台进程检查标记决定是否发送
• 速率限制: 同类事件默认 10 秒内不重复推送
• 事件过滤: 跳过子 agent、Stop 循环保护、/exit 静默

配置