# 变更日志

所有 Hermes 系统的显著变更都将记录在此文件中。

格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
并遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

## [1.0.0] - 2026-04-23

### 新增
- **记忆系统**: 完整的跨会话记忆持久化系统
  - `MemoryManager` 类: 对话同步、记忆预取、持久化存储
  - 语义搜索: 基于词重叠算法的记忆召回
  - 嵌入模型集成: 支持 OpenAI 兼容 API 和优雅降级
  - 记忆文件管理: 自动管理 `memory/YYYY-MM-DD.md` 和 `MEMORY.md`
  
- **Skill 生成系统**: 任务轨迹分析 → Skill 候选生成
  - `TrajectoryRecorder`: 记录任务执行步骤和工具调用
  - `Debriefer`: 分析轨迹提取可复用模式（基于规则）
  - `SkillTemplateGenerator`: 生成符合 OpenClaw 格式的 SKILL.md
  - `SkillApproval`: 用户确认流程，支持批准、修改、拒绝
  - `SkillGenerator`: 主整合类，协调完整生成流程
  
- **兼容性层**: 与 OpenClaw 现有体系无缝集成
  - `HermesCompatibilityLayer`: 全局单例，选择性启用功能
  - 配置管理: YAML 配置文件，环境感知配置
  - 渐进式集成: 不破坏现有功能，可独立启用/禁用
  - 状态监控: 实时系统状态和性能指标
  
- **数据导出器**: 与 claude_optimization 项目集成
  - `MemoryDataExporter`: 扫描记忆文件，提取代码案例
  - 特征提取: 集成 claude_optimization 的 35 个特征提取器
  - ML 数据集生成: 转换为机器学习数据集格式
  - 增强记录器: 代码生成检测和自动评估
  
- **性能基准**: 完整的性能测试和监控系统
  - `PerformanceBenchmark`: 记忆系统、Skill 生成、数据导出性能测试
  - 健康度评分: 综合性能指标和优化建议
  - 实时监控: 响应时间、内存使用、错误率监控
  
- **文档系统**: 完整的用户文档和指南
  - 安装指南: 详细的环境设置和安装步骤
  - 配置说明: 所有配置项详细说明
  - 测试指南: 完整的测试流程和故障排除
  - 部署指南: 生产环境部署和监控
  - 版本管理: 版本策略和发布流程

### 变更
- **架构优化**: 模块化设计，12 个独立 Python 模块
- **性能优化**: 延迟加载、缓存策略、异步处理
- **错误处理**: 完善的异常处理和日志记录
- **用户界面**: 彩色输出、命令补全、交互式提示

### 修复
- **中文分词**: 修复记忆预取中的中文分词问题
- **配置热更新**: 修复配置热更新不生效的问题
- **导入错误**: 修复模块导入路径问题
- **类型检查**: 修复 TypeScript/类型注解问题

### 已知问题
- **嵌入模型限制**: DeepSeek 和 Kimi API 不支持嵌入模型，当前使用词重叠算法
- **安全限制**: OpenClaw 安全策略阻止复杂 Python 解释器调用，端到端测试需手动运行
- **性能优化**: 大规模记忆文件加载可能较慢，需要进一步优化

### 技术栈
- **编程语言**: Python 3.9+, TypeScript
- **核心依赖**: PyYAML 6.0+
- **集成平台**: OpenClaw 2026.4.15+
- **开发工具**: VS Code, Git, pytest

### 系统要求
- **内存**: 4+ GB
- **存储**: 1+ GB 可用空间
- **操作系统**: macOS / Linux / Windows (WSL)

### 兼容性
- **OpenClaw**: 2026.4.15+ (完全兼容)
- **Python**: 3.9+ (推荐 3.9.6)
- **操作系统**: macOS, Linux, Windows (WSL)

### 致谢
感谢所有参与 Hermes 系统开发的贡献者，特别感谢 OpenClaw 社区的支持和反馈。

---

## [0.9.0] - 2026-04-22

### 新增
- **初始版本**: Hermes Agent v0.10.0 源码分析
- **架构设计**: 4 阶段开发计划
- **基础框架**: 项目目录结构和文档框架

### 技术分析
- **Skill 系统分析**: 完整的 Skill 系统架构理解
- **记忆系统分析**: MemoryProvider + MemoryManager 编排模式
- **集成方案**: 与 OpenClaw 集成的详细计划

### 文档
- `docs/01-skill-system.md`: Skill 系统完整分析
- `docs/02-memory-system.md`: 记忆系统完整分析  
- `docs/03-integration-plan.md`: 集成方案详细计划

---

## 版本说明

### 版本号规范
采用语义化版本 2.0.0:
- `主版本号.次版本号.修订号`
- 示例: `1.0.0`, `1.1.0`, `1.0.1`

### 预发布版本
- `主版本号.次版本号.修订号-预发布标识.构建号`
- 示例: `1.0.0-alpha.1`, `1.0.0-beta.2`, `1.0.0-rc.1`

### 构建元数据
- `主版本号.次版本号.修订号+构建元数据`
- 示例: `1.0.0+20240423.093000`

### 版本支持策略
- **1.x.x 系列**: 当前支持版本，接收功能更新和安全更新
- **1.0.x 系列**: 稳定版本，仅接收安全更新和关键修复
- **0.x.x 系列**: 实验版本，不提供官方支持

### 升级指南
从 0.9.0 升级到 1.0.0:
1. 备份现有数据和配置
2. 下载 1.0.0 发布包
3. 运行迁移脚本（如果提供）
4. 更新配置文件
5. 验证升级结果

### 迁移说明
1.0.0 版本包含重大架构变更，建议:
1. 在新环境中测试
2. 逐步迁移功能
3. 监控系统稳定性
4. 准备回滚计划

### 已知限制
1. 需要 Python 3.9+ 环境
2. 某些功能需要额外的 API 密钥
3. 生产部署建议在受控环境中测试

### 未来规划
- **1.1.0**: LLM 驱动的复盘分析
- **1.2.0**: 高级嵌入模型集成
- **2.0.0**: 多智能体协调系统

---

**变更日志维护指南**:
1. 所有显著变更必须记录
2. 按类型分组变更（新增、变更、修复、移除）
3. 包含版本发布日期
4. 遵循语义化版本规范
5. 保持简洁明了

**文档版本**: 1.0  
**最后更新**: 2026-04-23 09:58