mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-22 01:48:11 +00:00
3e3c6a24d2
- 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
20 lines
848 B
Markdown
20 lines
848 B
Markdown
# HomeAgent 架构设计 v4
|
||
|
||
完整架构文档参见 [docs/ARCHITECTURE.md](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 向量索引，不与记忆耦合
|
||
|
||
## 快速启动
|
||
|
||
```bash
|
||
make build # 编译
|
||
make run # 编译并启动（数据 /tmp/homeagent）
|
||
```
|