Dev

CHANGELOG.md

@@ -9,6 +9,50 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 > 此处记录尚未发布版本的变更。未来规划请查看开发路线图文档：`docs/development-roadmap.md`。
 
+## [0.0.8] - 2026-02-02 (Stable)
+
+### Fixed - 代码质量与兼容性修复 🛠️
+- **🔧 Hooks API 适配** - 修复 `installer.py` 中 `verify_installation()` 和 `get_installation_status()` 方法以适配新版 Claude Code Hooks API（PreToolUse、PostToolUse、Stop、Notification 等列表格式）
+- **🛡️ 类型安全增强** - 修复 `claude_hook.py` 中的类型安全问题：
+  - `on_notification()` 方法的 `message` 参数类型检查
+  - `on_pre_tool_use()` 方法的 `tool_input` 类型检查
+  - 新版 API 中 `session_start` 状态的正确初始化
+- **✅ 测试用例更新** - 更新 `tests/test_events.py` 中 14 个测试用例以匹配实际事件实现
+- **🐛 异常处理优化** - 使用具体异常类型替代裸 `except`（`builtin.py`、`custom.py`）
+- **🗑️ 代码清理** - 删除废弃的 `ConfirmationRequiredEvent` 类
+
+### Enhanced - CLI Commands 模块优化 ✨
+- **📦 CLI 模块重构** - 将 CLI 命令按功能拆分到独立模块（`core`、`config`、`hooks`、`debug`）
+- **🔧 代码质量修复**：
+  - `config.py`: 使用深拷贝避免配置缓存污染
+  - `core.py`: 修复权限比较逻辑，使用数值比较替代字符串比较
+  - `core.py`: 使用 `click.clear()` 替代 `os.system` 清屏
+  - `hooks.py`: 添加 `--yes/-y` 选项支持非交互式卸载（CI/CD 友好）
+  - `debug.py`: 使用 `click.pause()` 替代 `input()`
+
+### Added - 新版 Hooks API 支持 🚀
+- **🎯 PreToolUse 钩子** - 工具使用前触发，支持敏感操作检测（Bash、Edit、Write、DeleteFile 等）
+- **📊 PostToolUse 钩子** - 工具使用后触发，支持错误检测和结果记录
+- **✅ Stop 钩子** - Claude 停止工作时触发，用于任务完成通知
+- **🔔 Notification 钩子** - 处理权限请求（permission_prompt）和空闲提示（idle_prompt）
+- **🔄 向后兼容** - 保留旧版 API 支持，通过命令行参数调用
+
+## [0.0.7b1] - 2025-08-23 (Pre-release: Beta)
+
+### PyPI Compatibility Fixes 🔧
+- **解决PyPI包相对导入错误**：修复 `attempted relative import with no known parent package` 问题，确保从PyPI安装的包能正常工作。
+- **导入系统重构**：将 `src/claude_notifier/cli/main.py` 中所有相对导入（如 `from ..core` 等）改为绝对导入（`from claude_notifier.core`）。
+- **包结构优化**：移动 `events/`、`templates/`、`managers/` 目录到 `claude_notifier/` 包内，统一包结构，避免导入冲突。
+
+### Testing & Validation ✅
+- **开发环境测试**：通过 `pip install -e .` 开发模式安装测试。
+- **生产环境测试**：通过虚拟环境 `pip install .` 生产模式安装测试。
+- **CLI功能验证**：确认 `claude-notifier` 和 `cn` 命令正常工作，`cn setup` 不再报错。
+
+### Package Structure 📦
+- **清理孤立文件**：移除 `src/managers/` 等孤立目录，避免包结构混乱。
+- **版本信息更新**：升级版本至 `0.0.7b1`，标记为Beta版本进行测试。
+
 ## [0.0.6] - 2025-08-22 (Stable)
 
 ### Publishing & Release Workflow 🚀

RELEASE_v0.0.6.md

@@ -0,0 +1,89 @@
+# 🎉 Claude Code Notifier v0.0.6 发布
+
+这是一个专注于**CI/CD发布流程稳定性**和**跨平台兼容性**的增强版本。
+
+## ✨ 主要亮点
+
+### 🧰 CI/CD 工作流全面增强
+- **🔍 智能版本检查**: TestPyPI 发布前自动检测版本是否存在，避免重复上传导致的 400 错误
+- **⚙️ 工作流优化**: 彻底移除 heredoc，统一使用 `python -c`，显著提升跨平台稳定性
+- **🔄 重试机制**: 安装测试增加智能重试逻辑，提高CI流程可靠性
+- **🎯 灵活发布**: 支持手动触发 PyPI 发布，增强发布流程灵活性
+
+### 📦 跨平台兼容性优化
+- **🐍 Python 3.8 支持**: 固定 pip/setuptools 版本，避免新版本兼容性问题
+- **🌍 系统兼容**: macOS/Windows/Ubuntu 三平台一致性改进
+- **📝 YAML 语法**: 修复 GitHub Actions 输出引用语法，提升解析准确性
+
+### 📚 文档与用户体验
+- **📖 文档同步**: README/README_en 更新到 v0.0.6，提供最新安装指南
+- **📋 变更记录**: 完善 CHANGELOG.md，详细记录所有改进内容
+- **🎯 版本示例**: 更新所有安装示例到当前稳定版本
+
+## 🔧 技术改进详情
+
+### CI/CD 流程优化
+- 替换所有 heredoc 语法为单行 `python -c` 命令，避免跨平台转义问题
+- TestPyPI 发布增加版本存在性检查，智能跳过已存在版本
+- 安装测试引入重试机制（最多8次，智能延迟策略）
+- Python 3.8 环境中限制 pip<25 和 setuptools<70 版本
+
+### 发布流程增强
+```yaml
+# 新增功能
+- 版本检查 API 调用
+- 智能跳过逻辑
+- 手动触发支持
+- 重试机制优化
+```
+
+### 跨平台兼容性
+- **macOS**: 修复 multiprocessing 导致的 FileNotFoundError
+- **Windows**: 优化命令行参数转义和路径处理  
+- **Ubuntu**: 统一 shell 脚本语法，避免平台差异
+
+## 📊 改进统计
+
+- **文件变更**: 7个文件优化
+- **代码行数**: +177/-109 (净增68行)
+- **工作流步骤**: 新增3个关键检查点
+- **测试覆盖**: 增强跨平台测试场景
+
+## 🎯 适用场景
+
+此版本特别适合：
+- **CI/CD 集成**: 需要稳定自动化发布流程的项目
+- **跨平台部署**: macOS/Windows/Linux 混合环境
+- **企业环境**: 对发布流程稳定性有高要求的团队
+- **开源项目**: 需要可靠 PyPI 发布流程的开源项目
+
+## 📥 安装升级
+
+### 全新安装
+```bash
+pip install claude-code-notifier==0.0.6
+claude-notifier setup --auto
+```
+
+### 现有用户升级
+```bash
+pip install --upgrade claude-code-notifier
+claude-notifier --version
+```
+
+## 🔗 相关链接
+
+- **PyPI**: https://pypi.org/project/claude-code-notifier/0.0.6/
+- **文档**: [README.md](README.md) | [README_en.md](README_en.md)
+- **变更日志**: [CHANGELOG.md](CHANGELOG.md)
+- **问题反馈**: [GitHub Issues](https://github.com/kdush/Claude-Code-Notifier/issues)
+
+## 🙏 致谢
+
+感谢所有使用和反馈的用户，你们的建议让 Claude Code Notifier 变得更好！
+
+---
+
+**📱 快速体验**: `claude-notifier setup --auto`
+
+**🤖 Generated with [Claude Code](https://claude.ai/code)**

src/claude_notifier/__version__.py

@@ -5,11 +5,13 @@
 Version information for Claude Code Notifier
 """
 
-__version__ = "0.0.6"
-__version_info__ = (0, 0, 6)
+__version__ = "0.0.8"
+__version_info__ = (0, 0, 8, 'stable', 0)
 
 # 版本历史
 VERSION_HISTORY = {
+    "0.0.8": "稳定版：代码质量与兼容性修复、Hooks API 适配新版本、类型安全增强、CLI 模块重构与优化、测试用例更新",
+    "0.0.7b1": "PyPI兼容性修复（Beta版）：解决相对导入错误（attempted relative import with no known parent package）；将所有相对导入改为绝对导入；重新组织包结构确保PyPI安装正常工作",
     "0.0.6": "发布流程稳定性：TestPyPI 版本存在检查并在已存在时跳过上传以规避 400 错误；发布作业步骤顺序与 YAML 修复（移除 heredoc，改用 python -c，统一校验步骤命令）；安装测试加入重试与 Python 3.8 下 pip 限制；文档同步到 0.0.6",
     "0.0.5": "稳定版：跨平台 CI 修复（移除 heredoc 与多进程导入测试，改为同步导入并打印版本）、包内容清理（prune src/hooks）、文档同步，发布首个稳定版本",
     "0.0.4b2": "预发行：修复 GA test-install 多进程错误，清理打包内容并修复换行问题，提升发布稳定性",

src/claude_notifier/cli/commands/__init__.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""
+CLI 命令模块
+
+拆分自 main.py，按功能组织命令：
+- core: 核心命令 (setup, send, test, status, monitor)
+- config: 配置管理命令组
+- hooks: Claude Code 钩子命令组
+- debug: 调试工具命令组
+"""
+
+from .core import register_core_commands
+from .config import config
+from .hooks import hooks
+from .debug import debug
+
+__all__ = [
+    'register_core_commands',
+    'config',
+    'hooks', 
+    'debug',
+]