jianf/HomeAgent
1
0
Fork 0
mirror of https://gitcode.com/JianFeeeee/HomeAgent.git synced 2026-09-21 09:28:14 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
b1b90ae09fe24e48753d2dd9918f0ba155db9fb1
HomeAgent/DESIGN.md
root 3e3c6a24d2 v4 architecture: pipeline stages, SDK, event bus, LLM-driven memory consolidation 
- SDK PluginAPI (internal/plugin/sdk/): RegisterTool/RegisterStage/Subscribe/Publish
- EventBus (internal/events/): system-level pub/sub with wildcard support
- StageHost (internal/agent/core/stages.go): 7-stage message pipeline
- Agent core: on_input/pre_action/post_action/before_toolcall/after_toolcall/before_output/after_output
- Plugin Registry: SDK plugin registration and tool routing
- GraphDB.MergeEntities: entity consolidation with relation redirection
- memory_merge tool: allows LLM to merge similar entities
- Consolidation task: heartbeat detects conflicts, enqueues via IO for LLM decision
- _consolidation_ internal channel for system-level memory maintenance
- Comprehensive documentation: ARCHITECTURE.md, PLAN.md, DESIGN.md, README.md
- 54 tests across all packages, all passing
2026-07-03 08:04:39 +08:00

848 B
Raw Blame History

HomeAgent 架构设计 v4

完整架构文档参见 docs/ARCHITECTURE.md。

核心原则

  • 核心零 IO — 无任何硬编码 IO 能力，所有 IO 来自插件
  • 输出是工具调用 — Agent 必须显式 output_send 才能通信
  • 三通道插件 — 工具 (RegisterTool)、阶段 (RegisterStage)、事件 (Subscribe/Publish)
  • 阶段管道 — 7 个 hook 点让插件干预消息处理流：on_input → pre_action → post_action ↔ before_toolcall/after_toolcall → before_output → after_output
  • 三层记忆 — Context (内存) → Document (JSON+向量) → Graph (SQLite)
  • 知识独立 — 独立 TF-IDF 向量索引，不与记忆耦合

快速启动

make build        # 编译
make run          # 编译并启动（数据 /tmp/homeagent）