Metadata-Version: 2.4
Name: hermes-agent-evolution
Version: 9.0.0
Summary: AI助手自我进化系统 V1/V2/V3 融合版 - 单体+微服务混合架构
Home-page: https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3
Author: HermesAgentEvolution Team
Author-email: HermesAgentEvolution Team <contact@example.com>
License: MIT
Project-URL: Homepage, https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3
Project-URL: Bug Reports, https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3/issues
Project-URL: Source, https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3
Project-URL: Documentation, https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3/wiki
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: psutil>=5.8.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: numpy>=1.19.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.1; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Provides-Extra: full
Requires-Dist: requests>=2.25.0; extra == "full"
Requires-Dist: scikit-learn>=0.24.0; extra == "full"
Provides-Extra: v2
Requires-Dist: docker>=6.0; extra == "v2"
Requires-Dist: gitpython>=3.1; extra == "v2"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# HermesAgentEvolution

![Version](https://img.shields.io/badge/version-7.0.13-blue)
![Tests](https://img.shields.io/badge/tests-566%20passed-brightgreen)
![Python](https://img.shields.io/badge/python-3.9%2B-blue)
![License](https://img.shields.io/badge/license-MIT-green)

**HAE — 基于数据消费闭环的 AI 自主进化引擎**

打通了经验写入→关联消费→质量反馈→行为改进的完整闭环。专为 HermesAgent 生态设计，8工具+4Hook。

---

## 迭代时间线

| 版本 | 日期 | 核心成果 |
|------|------|---------|
| v3.0.4 | 2026-05-09 | 健康评分修复 · 插件部署审计 · DB 清理回收 1.3GB |
| v3.0.6 | 2026-05-09 | EvolutionAuditor 自进化审计器 · 10 个子系统 |
| v5.0.0 | 2026-05-11 | V4架构优化 · Hermes原生对齐 · WAL全覆盖 |
| v6.0.0 | 2026-05-11 | OOM根因修复 · discover_all max_entries 防护 |
| **v7.0.10** | **2026-05-13** | **极简独立handler · 删除全局缓存 · 761行精简** |
| v7.0.9 | 2026-05-13 | MemGPT异步知识Agent+对话缓存 |
| v7.0.8 | 2026-05-12 | hermes memory同步+知识点自动提取 |
| v7.0.7 | 2026-05-12 | FTS5索引修复+采纳日志+智能匹配优化 |
| v7.0.6 | 2026-05-12 | 三阶段智能上下文匹配 · 不机械切词 |
| **v7.0.5** | **2026-05-12** | **_init_instance TTL自动恢复 · None缓存30s重试** |
| v7.0.4 | 2026-05-12 | 线程安全+工具追踪隔离+内存监控确认 |
| v7.0.3 | 2026-05-11 | DFX补漏：VmPeak内存监控 + MemoryMax=4GB |
| v7.0.2 | 2026-05-11 | LearningObserver修复 · 3工具恢复 · 性能追踪恢复 |
| v7.0.1 | 2026-05-11 | 数据消费闭环 · 关联质量打分 · 经验注入 · 8工具+4Hook |

---

## 项目状态

| 指标 | 数值 |
|------|:----|
| 测试通过 | **566 / 566** (100%) |
| Hermes 工具 | 8 个 |
| Hermes Hook | 4 个 |
| Python | ≥ 3.9 |

---

## Hermes 集成工具（8 个）

| 工具 | 功能 |
|------|------|
| `evolution_memory_discover` | 结构化字段匹配发现记忆关联（tags+content_type+FTS5关键词共现） |
| `evolution_create_tool` | 从 API 描述自动创建工具 |
| `evolution_run_cycle` | 触发完整进化周期（6 阶段） |
| `evolution_learn` | 记录学习经验与教训 |
| `evolution_self_monitor` | 获取系统健康状态 |
| `evolution_audit` | 查询进化审计历史与趋势 |
| `evolution_analyze_performance` | 分析工具性能指标 |
| `evolution_recall_lessons` | V7新增 — 查询历史经验教训，返回可执行行为改进建议 |

## Hermes Hook（4 个）

| Hook | 功能 |
|------|------|
| `post_tool_call` | 工具执行后自动记录经验 |
| `on_session_start` | V7新增 — 会话启动时注入最近失败教训 |
| `pre_llm_call` | V7新增 — LLM调用前注入关联上下文 |
| `post_llm_call` | V7新增 — LLM回复后对关联质量打分 |

---

## 快速上手

```bash
pip install hermes-agent-evolution && hermes-evolution check
```

---

## 文档索引

| 文档 | 说明 |
|------|------|
| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | 架构详解 |
| [docs/CHANGELOG.md](docs/CHANGELOG.md) | 变更日志 |
| [docs/v7_plan.md](docs/v7_plan.md) | V7 设计方案 |
| [docs/v7_dev_plan.md](docs/v7_dev_plan.md) | V7 开发计划 |
| [docs/INSTALLATION.md](docs/INSTALLATION.md) | 安装指南 |
| [docs/HERMES_INTEGRATION.md](docs/HERMES_INTEGRATION.md) | Hermes Agent 集成手册 |
| [docs/API_REFERENCE.md](docs/API_REFERENCE.md) | API 参考 |
| [docs/TESTING.md](docs/TESTING.md) | 测试指南 |
| [docs/CONTRIBUTING.md](docs/CONTRIBUTING.md) | 贡献指南 |

*让 AI 助手从经验中学习，持续进化。*
