hermes-agent-evolution 3.0.0__tar.gz

hermes_agent_evolution-3.0.0/CHANGELOG.md

@@ -0,0 +1,141 @@
+# 变更日志 (Changelog)
+
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/) 规范。
+
+## [3.0.0] — 2026-05-06
+
+### 新增 (Added)
+
+#### 融合架构 (V1+V2+V3)
+- **`fusion/` 桥接层** — V1单体 ↔ V2微服务双向桥接
+  - `fusion/bridge.py` — `V1V2Bridge` 事件转换、服务映射、数据格式转换
+  - `fusion/compatibility.py` — 兼容层、枚举映射、API网关、服务降级、版本检测
+  - `fusion/unified_entry.py` — `UnifiedAgent` 统一入口，支持 V1_ONLY / V2_ONLY / HYBRID 三种模式
+
+#### CLI 命令行工具
+- **`hermes-evolution` CLI** — 通过 `pyproject.toml [project.scripts]` 注册
+  - `hermes-evolution check` — 环境自检: Python版本、9个核心模块导入、DB读写、插件部署
+  - `hermes-evolution setup` — 一键部署 Hermes 插件到 `~/.hermes/plugins/hermes-evolution/`
+  - `hermes-evolution status` — 系统状态: 版本、代码行数、测试结果、DB文件
+  - `hermes-evolution test` — 运行测试套件
+
+#### DB 路径隔离
+- **`db_utils.py` 统一连接工厂** — 所有 evolution 模块通过 `get_evolution_db()` 获取连接
+  - WAL 模式 + 30s busy_timeout + 8MB cache + foreign_keys
+  - 线程安全连接缓存 (threading.Lock)
+  - 路径解析: `EVOLUTION_DATA_DIR` → `HERMES_HOME/data/evolution/` → `~/.hermes/data/evolution/`
+  - 指数退避重试装饰器 `@retry_on_db_error`
+  - 便捷函数: `db_table_exists()`, `db_get_stats()`, `vacuum_database()`
+
+#### 日志统一
+- **Python `logging` 模块** — 统一使用 `logging.getLogger(__name__)` 替代裸 print
+- 日志级别通过 `LOG_LEVEL` 环境变量控制 (DEBUG/INFO/WARNING/ERROR)
+- DB连接/关闭/重试等关键路径均有日志输出
+
+#### 工程化
+- **Makefile** — 13 个标准化命令: `install`, `install-min`, `test`, `test-v`, `test-cov`, `test-failed`, `lint`, `format`, `fix`, `clean`, `build`, `check`, `check-all`
+- **`make check`** — 集成 lint + test 的 CI 预检命令
+- **`make build`** — PyPI 包构建 (python-build)
+
+#### PyPI 打包
+- **`pyproject.toml`** — 标准化项目配置，`[project.scripts]` CLI入口
+- 可选依赖分组: `dev` (pytest), `full` (numpy/scikit-learn), `v2` (pyyaml/docker)
+
+### 变更 (Changed)
+- **版本号**: 2.0.0 → 3.0.0
+- **架构**: 单体守护进程 → V1/V2/V3 三位一体融合架构
+- **DB路径**: 项目根 `data/` → `~/.hermes/data/evolution/` (标准化隔离)
+- **日志**: 分散的 print/logging → 统一 `logging` 模块
+- **安装**: `pip install -r requirements.txt` → `pip install -e .` (pyproject.toml)
+- **代码检查**: flake8/black → ruff (check + format)
+- **测试入口**: `pytest tests/` → `make test` / `hermes-evolution test`
+
+### 修复 (Fixed)
+- SQLite 并发写入锁问题: 通过 WAL + busy_timeout=30s + 重试装饰器解决
+- 跨线程连接安全: `check_same_thread=False` + 线程安全缓存
+
+---
+
+## [2.0.0] — 2026-04-28
+
+### 新增 (Added)
+- **迭代6: Hermes Agent 插件集成** — thin-layer 插件通过 `register(ctx)` 暴露 6 tools + 1 hook
+- `pyproject.toml` 标准化打包配置
+- 守护进程独立架构 (方案A): `hermes_daemon.py` 546行 + 插件薄层
+- 飞书 OpenAPI 通知器 (支持 webhook/openapi/simulated 三种模式)
+- Cron 定时进展汇报 (每2小时飞书推送)
+- `test_iteration6_integration.py` 集成测试 (27用例, 覆盖5维度)
+
+### 变更 (Changed)
+- 版本号升级至 2.0.0
+- 迭代6架构决策: 守护进程独立, 松耦合共享 SQLite
+
+---
+
+## [1.5.0] — 2026-04-28
+
+### 新增 (Added)
+- **迭代5: 闭环自主进化守护进程** — 完整的自主进化循环
+  - `closed_loop/action_executor.py`
+  - `closed_loop/metrics_collector.py`
+  - `closed_loop/orchestrator.py`
+  - `closed_loop/daemon.py`
+- 飞书通知修复: OpenAPI 模式正常运行
+- Cron 每2小时进展汇报
+
+---
+
+## [1.4.0] — 2026-04-26
+
+### 新增 (Added)
+- **迭代4: 安全增强** — `security/` 模块
+  - `audit_logger.py` — 审计日志记录/查询/轮转
+  - `permission_manager.py` — 权限管理/角色分配
+  - `sandbox_executor.py` — 安全沙箱执行
+  - `threat_detector.py` — 威胁检测
+- **协作引擎** — `collaboration/` 模块
+  - `agent_orchestrator.py` — 多Agent编排
+  - `agent_registry.py` — Agent注册/发现
+  - `message_bus.py` — 消息总线
+  - `task_dispatcher.py` — 任务分发
+- **V1/V2 融合层** — `fusion/` 模块
+  - `bridge.py` — 桥接层
+  - `unified_entry.py` — 统一入口
+  - `compatibility.py` — 兼容层
+
+### 变更 (Changed)
+- 测试覆盖: 253/253 全通过 (19测试文件)
+- 代码覆盖率: 66%
+
+---
+
+## [1.3.0] — 2026-04-26
+
+### 新增 (Added)
+- **迭代3: 工具能力进化**
+  - `tools/enhanced_tool_creator.py` — 增强工具创建器
+  - `tools/tool_auto_generator.py` — 工具自动生成
+  - `tools/tool_integration.py` — 工具进化引擎
+  - `tools/tool_performance_analyzer.py` — 性能分析器
+  - `tools/tool_registry.py` — 工具注册表
+
+---
+
+## [1.2.0] — 2026-04-26
+
+### 新增 (Added)
+- **迭代2: 学习与记忆**
+  - `learning/` 模块 — 经验学习/观测/分析/策略
+  - `memory/` 模块 — 关联发现/检索优化/数据库
+  - `self_monitor.py` — 自我监控
+
+---
+
+## [1.0.0] — 2026-04-26
+
+### 新增 (Added)
+- **初始发布: HermesAgentEvolution V1+V2**
+  - V1 基础Agent框架 (`src/`)
+  - V2 微服务架构 (`v2_project/`)
+  - 基础测试框架 (pytest)
+  - 项目文档框架

hermes_agent_evolution-3.0.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include requirements.txt
+include README.md
+include CHANGELOG.md
+include LICENSE
+recursive-include hermes-plugin *

hermes_agent_evolution-3.0.0/PKG-INFO

@@ -0,0 +1,236 @@
+Metadata-Version: 2.4
+Name: hermes-agent-evolution
+Version: 3.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
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Provides-Extra: full
+Requires-Dist: requests>=2.25.0; extra == "full"
+Requires-Dist: numpy>=1.19.0; extra == "full"
+Requires-Dist: scikit-learn>=0.24.0; extra == "full"
+Provides-Extra: v2
+Requires-Dist: pyyaml>=6.0; 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
+
+![Python Version](https://img.shields.io/badge/python-3.9%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Version](https://img.shields.io/badge/version-3.0.0-blue)
+![Tests](https://img.shields.io/badge/tests-422%20passed-brightgreen)
+![CI](https://img.shields.io/badge/CI-passing-brightgreen)
+
+**AI 自我进化框架 — V1 / V2 / V3 融合架构**
+
+使 AI 助手能够从经验中学习、自动优化策略、持续改进自身能力。专为 HermesAgent 生态设计，也可作为独立库移植到任何 Python 项目中。
+
+---
+
+## ⚡ 5 秒安装
+
+```bash
+pip install hermes-agent-evolution && hermes-evolution setup
+```
+
+---
+
+## 🧭 快速了解
+
+| | | | |
+|:---:|:---:|:---:|:---:|
+| 🧠 **学习进化** | 🛠️ **工具进化** | 🧩 **记忆进化** | 🔒 **安全进化** |
+| 记录交互经验 | 分析工具效果 | 关联记忆发现 | 审计日志追踪 |
+| 模式识别分析 | 动态优化选择 | 检索性能优化 | 沙箱隔离执行 |
+| 自动策略生成 | 自动创建工具 | 智能关联发现 | 威胁检测防护 |
+
+---
+
+## 🏗️ V3 融合架构
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                     Hermes Agent / 上层应用                     │
+├──────────────────────────────────────────────────────────────┤
+│                                                              │
+│   ┌────────────────  V1 单体进化引擎 ────────────────┐        │
+│   │                                                  │        │
+│   │  🧠 learning/    🧩 memory/    🛠️ tools/        │        │
+│   │  🔒 security/    🤝 collaboration/               │        │
+│   │  🔄 closed_loop/   📊 self_monitor               │        │
+│   │                                                  │        │
+│   └──────────────────────┬───────────────────────────┘        │
+│                          │                                    │
+│              ┌───────────┴───────────┐                        │
+│              │   🔗 融合桥 (Fusion)   │                        │
+│              │  bridge · compat · uni │                        │
+│              └───────────┬───────────┘                        │
+│                          │                                    │
+│   ┌──────────────────────┴───────────────────────────┐        │
+│   │              V2 微服务层 (services/)               │        │
+│   │                                                  │        │
+│   │  core/events/    core/services/    core/config/  │        │
+│   │  learning/meta/  learning/refl/    learning/rl/  │        │
+│   │  tools/discov/   tools/compos/                   │        │
+│   │  system/deploy/  system/monitor/  system/test/   │        │
+│   └──────────────────────────────────────────────────┘        │
+│                                                              │
+├──────────────────────────────────────────────────────────────┤
+│  基础设施: SQLite (WAL) · JSON · Python 3.9+ · Docker       │
+└──────────────────────────────────────────────────────────────┘
+```
+
+> V1 单体引擎承载核心进化逻辑；V2 微服务提供事件驱动、可水平扩展的服务层；融合桥实现 V1 ↔ V2 双向互通，统一入口零感知切换。
+
+---
+
+## 📊 项目状态
+
+| 模块 | 文件数 | 代码行数 | 测试文件 | 状态 |
+|------|:------:|:--------:|:--------:|:----:|
+| V1 进化引擎 (`src/evolution/`) | 30 | ~17,500 | 22 | ✅ |
+| V2 微服务 (`src/services/`) | 11 | ~7,100 | — | ✅ |
+| 融合桥 (`src/evolution/fusion/`) | 3 | ~2,200 | — | ✅ |
+| **合计** | **44** | **~26,800** | **22** | **422 passed** |
+
+---
+
+## 🚀 快速上手
+
+### 三步开始
+
+```bash
+# 1. 安装
+pip install hermes-agent-evolution
+
+# 2. 部署插件到 Hermes
+cp -r hermes-plugin ~/.hermes/plugins/hermes-evolution/
+
+# 3. 自检
+make check
+```
+
+### 基础用法
+
+```python
+from evolution.learning.observer import LearningObserver
+from evolution.learning.analyzer import ExperienceAnalyzer
+
+observer = LearningObserver()
+analyzer = ExperienceAnalyzer(observer)
+
+# 记录经验
+observer.record_experience(experience)
+
+# 分析学习
+analysis = analyzer.analyze_recent_experiences(days=7)
+print(f"成功率: {analysis.success_rate:.1%}")
+```
+
+### Hermes 集成工具
+
+| 工具 | 功能 |
+|------|------|
+| `evolution_run_cycle` | 触发完整进化周期 |
+| `evolution_create_tool` | 从 API 描述自动创建工具 |
+| `evolution_analyze_performance` | 分析工具性能指标 |
+| `evolution_learn` | 记录学习经验/教训 |
+| `evolution_self_monitor` | 获取系统健康状态 |
+| `evolution_memory_discover` | 发现记忆之间的关联 |
+
+> 📖 完整集成指南见 **[docs/HERMES_INTEGRATION.md](docs/HERMES_INTEGRATION.md)**
+
+---
+
+## 🔧 Makefile 命令速查
+
+| 命令 | 说明 |
+|------|------|
+| `make help` | 显示所有可用命令 |
+| `make install` | 安装开发依赖（可编辑模式） |
+| `make install-min` | 最小安装（仅核心依赖） |
+| `make test` | 运行全量测试（快速模式） |
+| `make test-v` | 运行全量测试（详细模式） |
+| `make test-cov` | 运行测试 + 覆盖率报告 |
+| `make test-failed` | 仅重跑上次失败的测试 |
+| `make lint` | 代码检查（ruff） |
+| `make format` | 代码格式化 |
+| `make fix` | 自动修复 lint 问题 |
+| `make clean` | 清理构建产物 |
+| `make build` | 构建 PyPI 包 |
+| `make check` | 环境自检 |
+| `make check-all` | 全量检查（lint + test） |
+| `make docker-build` | 构建 Docker 镜像 |
+
+---
+
+## 📚 文档索引
+
+| 文档 | 说明 |
+|------|------|
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | V3 融合架构详解 |
+| [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/PORTING.md](docs/PORTING.md) | 移植到其他项目 |
+| [docs/iteration5_engineering_plan.md](docs/iteration5_engineering_plan.md) | 迭代 5 工程计划 |
+| [docs/evolution_plan.md](docs/evolution_plan.md) | 进化路线图 |
+| [docs/v2_architecture.md](docs/v2_architecture.md) | V2 微服务架构 |
+| [docs/v2_status_report.md](docs/v2_status_report.md) | V2 状态报告 |
+
+---
+
+## 🤝 贡献
+
+欢迎贡献！
+
+1. Fork 项目
+2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 打开 Pull Request
+
+---
+
+## 📄 许可证
+
+MIT — 详见 [LICENSE](LICENSE)
+
+---
+
+## 📞 联系
+
+- **问题报告**: [GitHub Issues](https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3/issues)
+- **讨论区**: [GitHub Discussions](https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3/discussions)
+
+---
+
+*让 AI 助手不断进化，变得更智能、更高效！*

hermes_agent_evolution-3.0.0/README.md

@@ -0,0 +1,194 @@
+# HermesAgentEvolution
+
+![Python Version](https://img.shields.io/badge/python-3.9%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Version](https://img.shields.io/badge/version-3.0.0-blue)
+![Tests](https://img.shields.io/badge/tests-422%20passed-brightgreen)
+![CI](https://img.shields.io/badge/CI-passing-brightgreen)
+
+**AI 自我进化框架 — V1 / V2 / V3 融合架构**
+
+使 AI 助手能够从经验中学习、自动优化策略、持续改进自身能力。专为 HermesAgent 生态设计，也可作为独立库移植到任何 Python 项目中。
+
+---
+
+## ⚡ 5 秒安装
+
+```bash
+pip install hermes-agent-evolution && hermes-evolution setup
+```
+
+---
+
+## 🧭 快速了解
+
+| | | | |
+|:---:|:---:|:---:|:---:|
+| 🧠 **学习进化** | 🛠️ **工具进化** | 🧩 **记忆进化** | 🔒 **安全进化** |
+| 记录交互经验 | 分析工具效果 | 关联记忆发现 | 审计日志追踪 |
+| 模式识别分析 | 动态优化选择 | 检索性能优化 | 沙箱隔离执行 |
+| 自动策略生成 | 自动创建工具 | 智能关联发现 | 威胁检测防护 |
+
+---
+
+## 🏗️ V3 融合架构
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                     Hermes Agent / 上层应用                     │
+├──────────────────────────────────────────────────────────────┤
+│                                                              │
+│   ┌────────────────  V1 单体进化引擎 ────────────────┐        │
+│   │                                                  │        │
+│   │  🧠 learning/    🧩 memory/    🛠️ tools/        │        │
+│   │  🔒 security/    🤝 collaboration/               │        │
+│   │  🔄 closed_loop/   📊 self_monitor               │        │
+│   │                                                  │        │
+│   └──────────────────────┬───────────────────────────┘        │
+│                          │                                    │
+│              ┌───────────┴───────────┐                        │
+│              │   🔗 融合桥 (Fusion)   │                        │
+│              │  bridge · compat · uni │                        │
+│              └───────────┬───────────┘                        │
+│                          │                                    │
+│   ┌──────────────────────┴───────────────────────────┐        │
+│   │              V2 微服务层 (services/)               │        │
+│   │                                                  │        │
+│   │  core/events/    core/services/    core/config/  │        │
+│   │  learning/meta/  learning/refl/    learning/rl/  │        │
+│   │  tools/discov/   tools/compos/                   │        │
+│   │  system/deploy/  system/monitor/  system/test/   │        │
+│   └──────────────────────────────────────────────────┘        │
+│                                                              │
+├──────────────────────────────────────────────────────────────┤
+│  基础设施: SQLite (WAL) · JSON · Python 3.9+ · Docker       │
+└──────────────────────────────────────────────────────────────┘
+```
+
+> V1 单体引擎承载核心进化逻辑；V2 微服务提供事件驱动、可水平扩展的服务层；融合桥实现 V1 ↔ V2 双向互通，统一入口零感知切换。
+
+---
+
+## 📊 项目状态
+
+| 模块 | 文件数 | 代码行数 | 测试文件 | 状态 |
+|------|:------:|:--------:|:--------:|:----:|
+| V1 进化引擎 (`src/evolution/`) | 30 | ~17,500 | 22 | ✅ |
+| V2 微服务 (`src/services/`) | 11 | ~7,100 | — | ✅ |
+| 融合桥 (`src/evolution/fusion/`) | 3 | ~2,200 | — | ✅ |
+| **合计** | **44** | **~26,800** | **22** | **422 passed** |
+
+---
+
+## 🚀 快速上手
+
+### 三步开始
+
+```bash
+# 1. 安装
+pip install hermes-agent-evolution
+
+# 2. 部署插件到 Hermes
+cp -r hermes-plugin ~/.hermes/plugins/hermes-evolution/
+
+# 3. 自检
+make check
+```
+
+### 基础用法
+
+```python
+from evolution.learning.observer import LearningObserver
+from evolution.learning.analyzer import ExperienceAnalyzer
+
+observer = LearningObserver()
+analyzer = ExperienceAnalyzer(observer)
+
+# 记录经验
+observer.record_experience(experience)
+
+# 分析学习
+analysis = analyzer.analyze_recent_experiences(days=7)
+print(f"成功率: {analysis.success_rate:.1%}")
+```
+
+### Hermes 集成工具
+
+| 工具 | 功能 |
+|------|------|
+| `evolution_run_cycle` | 触发完整进化周期 |
+| `evolution_create_tool` | 从 API 描述自动创建工具 |
+| `evolution_analyze_performance` | 分析工具性能指标 |
+| `evolution_learn` | 记录学习经验/教训 |
+| `evolution_self_monitor` | 获取系统健康状态 |
+| `evolution_memory_discover` | 发现记忆之间的关联 |
+
+> 📖 完整集成指南见 **[docs/HERMES_INTEGRATION.md](docs/HERMES_INTEGRATION.md)**
+
+---
+
+## 🔧 Makefile 命令速查
+
+| 命令 | 说明 |
+|------|------|
+| `make help` | 显示所有可用命令 |
+| `make install` | 安装开发依赖（可编辑模式） |
+| `make install-min` | 最小安装（仅核心依赖） |
+| `make test` | 运行全量测试（快速模式） |
+| `make test-v` | 运行全量测试（详细模式） |
+| `make test-cov` | 运行测试 + 覆盖率报告 |
+| `make test-failed` | 仅重跑上次失败的测试 |
+| `make lint` | 代码检查（ruff） |
+| `make format` | 代码格式化 |
+| `make fix` | 自动修复 lint 问题 |
+| `make clean` | 清理构建产物 |
+| `make build` | 构建 PyPI 包 |
+| `make check` | 环境自检 |
+| `make check-all` | 全量检查（lint + test） |
+| `make docker-build` | 构建 Docker 镜像 |
+
+---
+
+## 📚 文档索引
+
+| 文档 | 说明 |
+|------|------|
+| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) | V3 融合架构详解 |
+| [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/PORTING.md](docs/PORTING.md) | 移植到其他项目 |
+| [docs/iteration5_engineering_plan.md](docs/iteration5_engineering_plan.md) | 迭代 5 工程计划 |
+| [docs/evolution_plan.md](docs/evolution_plan.md) | 进化路线图 |
+| [docs/v2_architecture.md](docs/v2_architecture.md) | V2 微服务架构 |
+| [docs/v2_status_report.md](docs/v2_status_report.md) | V2 状态报告 |
+
+---
+
+## 🤝 贡献
+
+欢迎贡献！
+
+1. Fork 项目
+2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
+3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
+4. 推送到分支 (`git push origin feature/AmazingFeature`)
+5. 打开 Pull Request
+
+---
+
+## 📄 许可证
+
+MIT — 详见 [LICENSE](LICENSE)
+
+---
+
+## 📞 联系
+
+- **问题报告**: [GitHub Issues](https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3/issues)
+- **讨论区**: [GitHub Discussions](https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3/discussions)
+
+---
+
+*让 AI 助手不断进化，变得更智能、更高效！*