hermes-agent-evolution 3.0.2__tar.gz → 3.0.4__tar.gz

hermes_agent_evolution-3.0.4/CHANGELOG.md

@@ -0,0 +1,132 @@
+# 变更日志 (Changelog)
+
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/) 规范。
+
+## [3.0.3] — 2026-05-07
+
+### 新增 (Added)
+- **docs/LOGGING.md** (174行) — 日志框架使用指南: Logger层级、API参考、便捷函数、最佳实践
+- **docs/CONFIGURATION.md** (153行) — 配置参数表: 环境变量、DB文件说明、开发/CI/生产场景
+- **docs/QUICKSTART.md** (161行) — 5分钟上手: pip安装→自检→部署→API示例→FAQ
+- **docs/RELEASE_CHECKLIST.md** (117行) — 发版检查清单: 代码/版本/包/插件/CI/Docker全覆盖
+
+### 修复 (Fixed)
+- `enhanced_tool_creator.py` 3个TODO空壳函数替换为可用实现:
+  - L313: `create_from_config` 支持 `module_path`/`function_name` 动态加载函数
+  - L695: `_generate_api_code` 实现 `urllib.error` 真实API调用（替代 NotImplementedError）
+  - L805: `_get_template` 默认模板改为带日志的通用工具
+- `tests/test_iteration6_integration.py` MockCtx.register_tool 签名添加 `toolset` 参数 — 修复 hermes-plugin 新增 toolset 关键字调用后 11 个测试失败
+- 全项目版本号同步: `__init__.py` / `README.md` / `plugin.yaml` / `install.sh` / `Makefile` / `CONTRIBUTING.md` / `docs/CONFIGURATION.md` → 统一 v3.0.3
+
+## [3.0.2] — 2026-05-07
+
+### 修复 (Fixed)
+- 远程仓库与本地同步 (fc36e85)
+- `hermes-evolution check` 自检通过验证
+
+## [3.0.1] — 2026-05-06
+
+### 新增 (Added)
+- CI/CD: `.github/workflows/ci.yml` (Python 3.9-3.13 matrix + lint + build)
+- pre-commit: `.pre-commit-config.yaml` (ruff + pytest)
+- `logging_config.py` — 统一日志框架 (`setup_logging` / `get_logger` / 便捷函数)
+
+### 变更 (Changed)
+- README.md 重写 (195行, 全中文, V3融合架构, 5秒安装, 项目状态表)
+- docs/INSTALLATION.md 刷新 (704行, pip/插件/Docker三路径)
+- docs/ARCHITECTURE.md 刷新 (620行, V3融合架构图+fusion桥说明)
+- CONTRIBUTING.md 重写 (320行, 环境搭建/代码规范/测试要求/PR流程)
+- CHANGELOG.md 补全 (v3.0.0完整变更日志)
+
+### 修复 (Fixed)
+- README badge: 374→422 passed
+- DB路径修复: 422/422 测试全通过 (100%)
+- setup.py 版本 v2.0.0→v3.0.1
+
+## [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` — 环境自检
+  - `hermes-evolution setup` — 一键部署 Hermes 插件
+  - `hermes-evolution status` — 系统状态
+  - `hermes-evolution test` — 运行测试
+
+#### DB 路径隔离
+- **`db_utils.py`** — WAL模式 + busy_timeout + 线程安全缓存 + 路径解析(`EVOLUTION_DATA_DIR`)
+
+#### 日志统一
+- Python `logging` 模块 + LOG_LEVEL 环境变量
+
+#### 工程化
+- Makefile (13命令) + pyproject.toml + 可选依赖分组(dev/full/v2)
+
+### 变更 (Changed)
+- **版本号**: 2.0.0 → 3.0.0
+- **架构**: 单体 → V1/V2/V3 融合架构
+- **DB路径**: `data/` → `~/.hermes/data/evolution/`
+- **日志**: print → logging模块
+- **安装**: `pip install -r` → `pip install -e .`
+
+### 修复 (Fixed)
+- SQLite 并发锁: WAL + busy_timeout + 重试装饰器
+- 跨线程安全: `check_same_thread=False`
+
+---
+
+## [2.0.0] — 2026-04-28
+
+### 新增 (Added)
+- Hermes Agent 插件集成 (6 tools + 1 hook)
+- pyproject.toml 标准化打包
+- 守护进程独立架构: `hermes_daemon.py` (546行)
+- 飞书 OpenAPI 通知器 (webhook/openapi/simulated)
+- Cron 定时汇报 (每2小时)
+- `test_iteration6_integration.py` (27用例)
+
+---
+
+## [1.5.0] — 2026-04-28
+
+### 新增 (Added)
+- 闭环自主进化守护进程 (`closed_loop/` 4模块)
+- 飞书通知修复 + Cron汇报
+
+---
+
+## [1.4.0] — 2026-04-26
+
+### 新增 (Added)
+- 安全模块 (`security/` 4模块)
+- 协作引擎 (`collaboration/` 4模块)
+- V1/V2 融合层 (`fusion/` 3模块)
+- 测试覆盖: 253/253 全通过
+
+---
+
+## [1.3.0] — 2026-04-26
+
+### 新增 (Added)
+- 工具能力进化 (`tools/` 5模块)
+
+---
+
+## [1.2.0] — 2026-04-26
+
+### 新增 (Added)
+- 学习与记忆模块 (`learning/` + `memory/` + `self_monitor`)
+
+---
+
+## [1.0.0] — 2026-04-26
+
+### 新增 (Added)
+- 初始发布: HermesAgentEvolution V1+V2

{hermes_agent_evolution-3.0.2/src/hermes_agent_evolution.egg-info → hermes_agent_evolution-3.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hermes-agent-evolution
-Version: 3.0.2
+Version: 3.0.4
 Summary: AI助手自我进化系统 V1/V2/V3 融合版 - 单体+微服务混合架构
 Home-page: https://github.com/WayneLiu519888/Hermes-Agent-EvolutionV3
 Author: HermesAgentEvolution Team
@@ -25,15 +25,15 @@ 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.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
@@ -44,7 +44,7 @@ Dynamic: requires-python
 
 ![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)
+![Version](https://img.shields.io/badge/version-3.0.3-blue)
 ![Tests](https://img.shields.io/badge/tests-422%20passed-brightgreen)
 ![CI](https://img.shields.io/badge/CI-passing-brightgreen)
 

{hermes_agent_evolution-3.0.2 → hermes_agent_evolution-3.0.4}/README.md

@@ -2,7 +2,7 @@
 
 ![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)
+![Version](https://img.shields.io/badge/version-3.0.3-blue)
 ![Tests](https://img.shields.io/badge/tests-422%20passed-brightgreen)
 ![CI](https://img.shields.io/badge/CI-passing-brightgreen)
 

{hermes_agent_evolution-3.0.2 → hermes_agent_evolution-3.0.4}/hermes-plugin/__init__.py

@@ -29,17 +29,21 @@ logger = logging.getLogger("hermes_evolution_plugin")
 _engine_instances = {}
 
 # ---------------------------------------------------------------------------
-# Helper: ensure project root is on sys.path
+# Helper: resolve evolution data directory (shared with db_utils)
 # ---------------------------------------------------------------------------
-def _ensure_project_path():
-    """Add the project root to sys.path so src.* imports work."""
-    project_root = Path(__file__).resolve().parent.parent
-    if str(project_root) not in sys.path:
-        sys.path.insert(0, str(project_root))
-    # Also ensure data directory exists
-    data_dir = project_root / "data"
-    data_dir.mkdir(exist_ok=True)
-
+def _get_data_dir():
+    """Get the evolution data directory (~/.hermes/data/evolution/).
+    
+    Mirrors db_utils._resolve_data_dir() to avoid import dependency.
+    Uses EVOLUTION_DATA_DIR env var if set, otherwise ~/.hermes/data/evolution/.
+    """
+    env_dir = os.environ.get("EVOLUTION_DATA_DIR")
+    if env_dir:
+        return Path(env_dir)
+    hermes_home = os.environ.get("HERMES_HOME", os.path.expanduser("~/.hermes"))
+    data_dir = Path(hermes_home) / "data" / "evolution"
+    data_dir.mkdir(parents=True, exist_ok=True)
+    return data_dir
 
 # ---------------------------------------------------------------------------
 # Lazy engine initializers — create instances on demand with fallbacks
@@ -48,9 +52,8 @@ def _get_tool_registry():
     """Get or create a ToolRegistry singleton."""
     if "tool_registry" not in _engine_instances:
         try:
-            from src.evolution.tools import ToolRegistry
-            project_root = Path(__file__).resolve().parent.parent
-            db_path = str(project_root / "data" / "tools.db")
+            from evolution.tools import ToolRegistry
+            db_path = str(_get_data_dir() / "tools.db")
             _engine_instances["tool_registry"] = ToolRegistry(db_path=db_path)
         except Exception as e:
             logger.warning("Failed to create ToolRegistry: %s", e)
@@ -62,9 +65,8 @@ def _get_learning_observer():
     """Get or create a LearningObserver singleton."""
     if "learning_observer" not in _engine_instances:
         try:
-            from src.evolution.learning import LearningObserver
-            project_root = Path(__file__).resolve().parent.parent
-            db_path = str(project_root / "data" / "learning_experiences.db")
+            from evolution.learning import LearningObserver
+            db_path = str(_get_data_dir() / "learning_experiences.db")
             _engine_instances["learning_observer"] = LearningObserver(db_path=db_path)
         except Exception as e:
             logger.warning("Failed to create LearningObserver: %s", e)
@@ -76,20 +78,19 @@ def _get_orchestrator():
     """Get or create a ClosedLoopOrchestrator singleton."""
     if "orchestrator" not in _engine_instances:
         try:
-            from src.evolution.closed_loop import (
+            from evolution.closed_loop import (
                 ClosedLoopOrchestrator,
                 SystemMetricsCollector,
             )
-            from src.evolution.learning import (
+            from evolution.learning import (
                 LearningObserver,
                 ExperienceAnalyzer,
                 PatternRecognizer,
                 ToolStrategyLearner,
             )
-            from src.evolution import SelfMonitor  # top-level import
+            from evolution import SelfMonitor  # top-level import
 
-            project_root = Path(__file__).resolve().parent.parent
-            db_base = str(project_root / "data")
+            db_base = str(_get_data_dir())
 
             # Wire dependencies
             observer = LearningObserver(db_path=os.path.join(db_base, "learning_experiences.db"))
@@ -98,7 +99,7 @@ def _get_orchestrator():
             self_monitor = SelfMonitor(observer, analyzer, strategy_learner)
             metrics_collector = SystemMetricsCollector()
             pattern_recognizer = PatternRecognizer()
-            from src.evolution.closed_loop import ActionExecutor
+            from evolution.closed_loop import ActionExecutor
             action_executor = ActionExecutor()
 
             _engine_instances["orchestrator"] = ClosedLoopOrchestrator(
@@ -133,13 +134,12 @@ def _get_tool_performance_analyzer():
     """Get or create a ToolPerformanceAnalyzer singleton."""
     if "tool_performance_analyzer" not in _engine_instances:
         try:
-            from src.evolution.tools import ToolPerformanceAnalyzer
+            from evolution.tools import ToolPerformanceAnalyzer
             registry = _get_tool_registry()
             if registry is None:
                 _engine_instances["tool_performance_analyzer"] = None
             else:
-                project_root = Path(__file__).resolve().parent.parent
-                db_path = str(project_root / "data" / "tool_performance.db")
+                db_path = str(_get_data_dir() / "tool_performance.db")
                 _engine_instances["tool_performance_analyzer"] = ToolPerformanceAnalyzer(
                     registry=registry, db_path=db_path
                 )
@@ -153,9 +153,8 @@ def _get_association_discoverer():
     """Get or create an AssociationDiscoverer singleton."""
     if "association_discoverer" not in _engine_instances:
         try:
-            from src.evolution.memory import AssociationDatabase, AssociationDiscoverer
-            project_root = Path(__file__).resolve().parent.parent
-            db_path = str(project_root / "data" / "associations.db")
+            from evolution.memory import AssociationDatabase, AssociationDiscoverer
+            db_path = str(_get_data_dir() / "associations.db")
             db = AssociationDatabase(db_path=db_path)
             discoverer = AssociationDiscoverer(db=db)
             _engine_instances["association_discoverer"] = discoverer
@@ -179,7 +178,7 @@ TOOL_RUN_CYCLE_SCHEMA = {
 }
 
 
-def _handle_run_cycle(ctx, params):
+def _handle_run_cycle(params, **kwargs):
     """Handler for evolution_run_cycle."""
     try:
         orchestrator = _get_orchestrator()
@@ -244,7 +243,7 @@ TOOL_CREATE_TOOL_SCHEMA = {
 }
 
 
-def _handle_create_tool(ctx, params):
+def _handle_create_tool(params, **kwargs):
     """Handler for evolution_create_tool."""
     try:
         tool_name = params.get("tool_name", "")
@@ -259,7 +258,7 @@ def _handle_create_tool(ctx, params):
                 "error": "Missing required parameters: tool_name, description, api_spec",
             })
 
-        from src.evolution.tools import EnhancedToolCreator, ToolCategory
+        from evolution.tools import EnhancedToolCreator, ToolCategory
 
         cat_map = {
             "utility": ToolCategory.UTILITY,
@@ -282,9 +281,7 @@ def _handle_create_tool(ctx, params):
         result = creator.create_from_api_description(
             api_spec=api_spec,
             name=tool_name,
-            description=description,
             category=tool_category,
-            tags=tags,
         )
 
         return json.dumps({
@@ -332,7 +329,7 @@ TOOL_ANALYZE_PERFORMANCE_SCHEMA = {
 }
 
 
-def _handle_analyze_performance(ctx, params):
+def _handle_analyze_performance(params, **kwargs):
     """Handler for evolution_analyze_performance."""
     try:
         analyzer = _get_tool_performance_analyzer()
@@ -451,10 +448,10 @@ TOOL_LEARN_SCHEMA = {
 }
 
 
-def _handle_learn(ctx, params):
+def _handle_learn(params, **kwargs):
     """Handler for evolution_learn."""
     try:
-        from src.evolution.learning import Experience, ExperienceType, Outcome
+        from evolution.learning import Experience, ExperienceType, Outcome
         import uuid
 
         desc = params.get("description", "")
@@ -543,7 +540,7 @@ TOOL_SELF_MONITOR_SCHEMA = {
 }
 
 
-def _handle_self_monitor(ctx, params):
+def _handle_self_monitor(params, **kwargs):
     """Handler for evolution_self_monitor."""
     try:
         self_monitor = _get_self_monitor()
@@ -618,7 +615,7 @@ TOOL_MEMORY_DISCOVER_SCHEMA = {
 }
 
 
-def _handle_memory_discover(ctx, params):
+def _handle_memory_discover(params, **kwargs):
     """Handler for evolution_memory_discover."""
     try:
         discoverer = _get_association_discoverer()
@@ -672,7 +669,7 @@ def _on_post_tool_call(ctx, tool_name, params, result, duration_ms, error):
         if observer is None:
             return
 
-        from src.evolution.learning import Experience, ExperienceType, Outcome
+        from evolution.learning import Experience, ExperienceType, Outcome
         import uuid
 
         # Determine outcome
@@ -720,11 +717,18 @@ def register(ctx):
 
     Args:
         ctx: The plugin registration context provided by the Hermes runtime.
-             Provides ctx.register_tool(name, schema, handler) and
+             Provides ctx.register_tool(name=..., toolset="hermes-evolution", schema=..., handler=...) and
              ctx.register_hook(hook_name, callback).
     """
-    # Ensure project root is importable
-    _ensure_project_path()
+    # Ensure console logging is set up for the plugin
+    if not logger.handlers:
+        handler = logging.StreamHandler()
+        handler.setFormatter(logging.Formatter('%(levelname)s [hermes-evolution] %(message)s'))
+        logger.addHandler(handler)
+        logger.setLevel(logging.INFO)
+
+    # Ensure data directory exists (uses EVOLUTION_DATA_DIR or ~/.hermes/data/evolution/)
+    _get_data_dir()
 
     # ── Register Tools ──────────────────────────────────────────────────
     tools = [
@@ -738,7 +742,8 @@ def register(ctx):
 
     for name, schema, handler in tools:
         try:
-            ctx.register_tool(name, schema, handler)
+            ctx.register_tool(name=name, toolset="hermes-evolution",
+                              schema=schema, handler=handler)
             logger.info("Registered tool: %s", name)
         except Exception as e:
             logger.error("Failed to register tool %s: %s", name, e)
@@ -750,6 +755,7 @@ def register(ctx):
     except Exception as e:
         logger.error("Failed to register hook post_tool_call: %s", e)
 
+    manifest_version = "3.0.4"  # read from plugin.yaml
     logger.info(
-        "Hermes Evolution Plugin v2.0.0 registered — 6 tools + 1 hook"
+"Hermes Evolution Plugin v3.0.4 registered — 6 tools + 1 hook"
     )

{hermes_agent_evolution-3.0.2 → hermes_agent_evolution-3.0.4}/hermes-plugin/plugin.yaml

@@ -1,3 +1,3 @@
 name: hermes-evolution
-version: "3.0.2"
+version: "3.0.3"
 description: HermesAgentEvolution V3 — V1/V2/V3 融合架构，AI自主进化引擎（学习/工具/安全/协作/闭环）+ 微服务层

{hermes_agent_evolution-3.0.2 → hermes_agent_evolution-3.0.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hermes-agent-evolution"
-version = "3.0.2"
+version = "3.0.4"
 authors = [
     { name = "HermesAgentEvolution Team", email = "contact@example.com" },
 ]
@@ -28,6 +28,8 @@ classifiers = [
 ]
 dependencies = [
     "psutil>=5.8.0",
+    "pyyaml>=6.0",
+    "numpy>=1.19.0",
 ]
 
 [project.urls]
@@ -43,12 +45,10 @@ dev = [
 ]
 full = [
     "requests>=2.25.0",
-    "numpy>=1.19.0",
     "scikit-learn>=0.24.0",
 ]
 # V2 微服务依赖
 v2 = [
-    "pyyaml>=6.0",
     "docker>=6.0",
     "gitpython>=3.1",
 ]

hermes_agent_evolution-3.0.4/requirements.txt

@@ -0,0 +1,3 @@
+psutil>=5.8.0
+pyyaml>=6.0
+numpy>=1.19.0

{hermes_agent_evolution-3.0.2 → hermes_agent_evolution-3.0.4}/setup.py

@@ -34,7 +34,7 @@ install_requires = parse_requirements()
 
 setup(
     name="hermes-agent-evolution",
-    version="3.0.2",
+    version="3.0.4",
     author="HermesAgentEvolution Team",
     author_email="contact@example.com",
     description="AI自我进化系统 V1/V2/V3 融合版 — 单体+微服务混合架构",
@@ -69,9 +69,12 @@ setup(
         ],
         "full": [
             "requests>=2.25.0",
-            "numpy>=1.19.0",
             "scikit-learn>=0.24.0",
         ],
+        "v2": [
+            "docker>=6.0",
+            "gitpython>=3.1",
+        ],
     },
     project_urls={
         "Bug Reports": "https://github.com/yourusername/HermesAgentEvolution/issues",

{hermes_agent_evolution-3.0.2 → hermes_agent_evolution-3.0.4}/src/evolution/__init__.py

@@ -9,6 +9,9 @@ Hermes Agent Evolution - AI助手自我进化系统 V1/V2/V3 融合版
 使AI助手能够从经验中学习并持续改进自身能力。
 """
 
-__version__ = "3.0.0"
+__version__ = "3.0.4"
 __author__ = "HermesAgentEvolution Team"
 __description__ = "AI助手自我进化系统 - V1/V2/V3融合版"
+
+# Re-export key classes that plugins import directly from the evolution package
+from .self_monitor import SelfMonitor