Claude Code Notifier

English Version

🔔 Claude Code Notifier

智能化的 Claude Code 通知系统 - 提供实时、多渠道的操作通知和智能限制功能

✨ 特性

🎯 核心功能
- 智能检测 - 自动检测权限操作和任务完成
- 全局生效 - 一次配置，所有项目自动启用
- 多渠道支持 - 支持 6+ 种主流通知渠道
- 美化通知 - 精美的卡片格式和分层设计
- 易于配置 - 简单的配置文件和安装脚本
- 安全可靠 - 支持签名验证和加密传输

🧠 智能功能
- 智能限流 - 防止通知轰炸，支持冷却时间和频率控制
- 消息分组 - 自动合并相似通知，避免重复打扰
- 操作门控 - 智能识别敏感操作，需要用户确认
- 自适应调节 - 根据使用模式自动优化通知策略

⚙️ 高级配置
- 事件开关 - 灵活的事件启用/禁用配置
- 自定义事件 - 支持用户自定义触发条件和通知内容
- 模板系统 - 统一的模板引擎，支持自定义样式
- 多渠道路由 - 不同事件可配置不同的通知渠道组合
- 统计监控 - 事件统计和通知效果分析
- 配置备份 - 支持配置备份和恢复功能

🆕 最新改进 (v0.0.8 - Stable)

🛠️ 代码质量与兼容性修复
- 🔧 Hooks API 适配 - 修复 installer.py 和 claude_hook.py 以适配新版 Claude Code Hooks API（PreToolUse、PostToolUse、Stop、Notification 等列表格式）
- 🛡️ 类型安全增强 - 修复类型检查问题，提升代码健壮性
- ✅ 测试用例更新 - 更新 14 个测试用例以匹配实际事件实现
- 🐛 异常处理优化 - 使用具体异常类型替代裸 except
- 🗑️ 代码清理 - 删除废弃的 ConfirmationRequiredEvent 类

✨ CLI Commands 模块优化
- 📦 CLI 模块重构 - 将 CLI 命令按功能拆分到独立模块（core、config、hooks、debug）
- 🔧 代码质量修复 - 配置缓存、权限比较、清屏方法等多项优化
- 🚀 CI/CD 友好 - 添加 --yes/-y 选项支持非交互式卸载

� 新版 Hooks API 支持
- 🎯 PreToolUse 钩子 - 工具使用前触发，支持敏感操作检测（Bash、Edit、Write、DeleteFile 等）
- 📊 PostToolUse 钩子 - 工具使用后触发，支持错误检测和结果记录
- ✅ Stop 钩子 - Claude 停止工作时触发，用于任务完成通知
- 🔔 Notification 钩子 - 处理权限请求（permission_prompt）和空闲提示（idle_prompt）
- � 向后兼容 - 保留旧版 API 支持，通过命令行参数调用

🚀 PyPI版本Claude Code钩子自动配置（重大更新）

🎉 突破性功能：PyPI用户现在享受与Git用户相同的无缝体验！

- ✅ ⚡ 一键智能配置 - claude-notifier setup --auto 自动检测和配置所有功能
- ✅ 🔧 完整钩子管理 - 新增 hooks 命令组，提供安装/卸载/状态/验证功能
- ✅ 💡 智能环境检测 - 自动发现Claude Code安装，支持多种安装位置
- ✅ 📊 增强状态显示 - --status 现在包含完整的钩子系统状态
- ✅ 🛡️ 错误恢复机制 - 即使依赖缺失也能基本工作，提供优雅降级
- ✅ 🔄 双模式兼容 - 钩子系统支持PyPI和Git两种模式，智能切换

🔧 版本管理改进

- ✅ PEP 440 版本规范 - 采用 a/b/rc 预发行规范与稳定版并行策略
- ✅ CLI 版本提示 - 稳定版不显示预发行提示；预发行显示"版本类型: Alpha/Beta/RC"
- ✅ README 徽章 - 更新为 Stable 徽章
- ✅ CI/CD 工作流 - 使用 GitHub Actions 构建并发布稳定版到 PyPI；预发行通过仓库 Tag/Release 管理

📱 支持的通知渠道

🚀…