mirror of
https://gitcode.com/JianFeeeee/HomeAgent.git
synced 2026-09-22 18:08:04 +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
84 lines
2.7 KiB
Markdown
84 lines
2.7 KiB
Markdown
# HomeAgent
|
||
|
||
单二进制 24/7 智能管家。**核心零 IO**，所有输入输出通过插件，插件通过三通道与核心交互：工具、阶段钩子、事件订阅。
|
||
|
||
## 架构
|
||
|
||
```
|
||
外部（QQ / HTTP / 硬件...）
|
||
│ 通过插件注册
|
||
▼
|
||
IOManager.InjectInput()
|
||
│
|
||
▼
|
||
┌─────────────────────────────────────────────────┐
|
||
│ Agent Core │
|
||
│ │
|
||
│ on_input → Context → Memory Recall │
|
||
│ → pre_action → [LLM ↔ 工具循环] → before_output │
|
||
│ → output_send → after_output │
|
||
│ │
|
||
│ 内置：三层记忆 + 知识库 + Child Agent │
|
||
└─────────────────────────────────────────────────┘
|
||
│
|
||
├── Stage Pipeline（7 阶段，插件可拦截/改写）
|
||
├── Tool System（插件注册工具给 LLM）
|
||
└── Event Bus（插件订阅系统事件）
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
make build
|
||
./build/homed -data /tmp/homeagent
|
||
```
|
||
|
||
依赖：Go 1.19+、CGo（go-sqlite3）。
|
||
|
||
## 阶段管道
|
||
|
||
```
|
||
on_input → pre_action → post_action ↔ before_toolcall/after_toolcall → before_output → after_output
|
||
↑_______________|
|
||
循环
|
||
```
|
||
|
||
| 阶段 | 插件可做 |
|
||
|---|---|
|
||
| `on_input` | 鉴权、拉黑、改写、短路 |
|
||
| `pre_action` | 注入 context 消息 |
|
||
| `post_action` | 审查/改写 LLM 输出、增删工具 |
|
||
| `before_toolcall` | 拒绝、改参、审计 |
|
||
| `after_toolcall` | 脱敏、改写结果 |
|
||
| `before_output` | 改写最终文本、加格式 |
|
||
| `after_output` | 记录/统计 |
|
||
|
||
## 三层记忆
|
||
|
||
| 层 | 存储 | 容量 | 裁剪 |
|
||
|---|---|---|---|
|
||
| Context | 内存 TF-IDF | 30 条 | 余弦相似度排序→文档 |
|
||
| Document | JSON + 向量索引 | ∞ | 72h 冷→图 |
|
||
| Graph | SQLite 三元组 | ∞ | 定期重整+同义合并 |
|
||
|
||
## 插件三通道
|
||
|
||
| 通道 | 方向 | 用途 |
|
||
|---|---|---|
|
||
| `RegisterTool` | 插件→LLM | Agent 调用插件功能 |
|
||
| `RegisterStage` | 核心→插件 | 干预消息处理流 |
|
||
| `Subscribe/Publish` | 双向 | 审计/日志/通知 |
|
||
|
||
## 核心命令
|
||
|
||
```bash
|
||
make build # 编译
|
||
make run # 编译+启动
|
||
make test # 测试
|
||
make install # 系统安装
|
||
```
|
||
|
||
## 完整文档
|
||
|
||
详见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。
|