重构: 插件自注册 + .so 动态加载 + 中断打断机制

- 所有内置插件 init() 自注册 (plugin.RegisterFactory), 移除 main.go 硬编码
- 新增 .so 动态加载器 (internal/plugin/dynamic.go), 插件可编译为 plugin.so
- 新增 plugin.json 元数据 (internal/plugin/manifest.go)
- 新增 interceptLoop 独立 goroutine:
  (a) cancelLLM() 取消进行中的 HTTP 请求
  (b) interceptCh → drainInterrupt() 注入 [打断消息] 到 LLM 上下文
  (c) InjectInput 空闲时触发新处理循环
- 新增 internal/plugins/all.go 空白导入触发所有内置插件 init()
- internal/sdk/ 作为 PluginSDK 正式 Go API
- internal/api/ → internal/plugins/webui/ 迁移
- 删除旧 cmd/cli/, 使用 cmd/waiter/ 替代
- 更新 PLAN.md / ARCHITECTURE.md / README.md 文档
This commit is contained in:
root
2026-07-03 16:53:34 +08:00
parent 988de228eb
commit 7165e31677
37 changed files with 3376 additions and 1576 deletions

View File

@ -1,19 +1,13 @@
# HomeAgent 架构设计 v4
# HomeAgent 架构设计
完整架构文档参见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)。
实施计划参见 [PLAN.md](PLAN.md)。
## 核心原则
- **核心零 IO** — 无任何硬编码 IO 能力,所有 IO 来自插件
- **输出是工具调用** — Agent 必须显式 `output_send` 才能通信
- **核心零 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`
- **阶段管道** — 7 个 hook 点让插件干预消息处理流
- **三层记忆** — Context (内存) → Document (JSON+向量) → Graph (SQLite)
- **知识独立** — 独立 TF-IDF 向量索引,不与记忆耦合
## 快速启动
```bash
make build # 编译
make run # 编译并启动(数据 /tmp/homeagent)
```