HomeAgent

单二进制 24/7 智能家庭管家。基于 NextAgent 认知解耦架构 + TrulyMEM 自主图记忆。

架构

                    IO 抽象层（唯一输入路径）
  ┌─────────────────────────────────────────────────────┐
  │  Microphone  Camera  GPIO  HTTP  OneBot-QQ  Plugins │
  │  所有外部输入 → InputEvent → inputCh                  │
  └──────────────────────┬──────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────┐
  │              Agent Core（编排器）                      │
  │  三层记忆注入 → Provider.Chat() → 工具执行 → 输出     │
  └──────────────────────┬──────────────────────────────┘
                         │
  ┌──────────────────────▼──────────────────────────────┐
  │             API 抽象层（唯一输出路径）                  │
  │   Provider: OpenAI / Ollama / Lua 适配               │
  │   DeepSeek v4 flash（默认）                          │
  └─────────────────────────────────────────────────────┘

快速开始

make build
./build/homed -data /tmp/homeagent

依赖：Go 1.19+、CGo（go-sqlite3）。

记忆体系（三层）

层	存储	容量	裁剪策略
上下文	内存	30 条	TF-IDF 相关性排序，淘汰→文档
文档	JSON + TF-IDF 向量	无上限	72h 冷访问→图数据库
图	SQLite 三元组	无上限	定期重整+同义合并

插件系统（OpenClaw 兼容）

插件 = 容器，内嵌 IO 通道为组件。plugins/ 目录热插拔，agent 通过 plgreload 工具控制重载。

plugins/
├── qq/                          # OneBot QQ 通道插件
│   ├── SKILL.md                 # 技能描述 + IO 端口声明
│   └── skill.json               # 元数据 + WS 连接配置

示例 QQ 插件 plugins/qq/SKILL.md

# QQ 通知插件
io_type: io
io_input_route: qq
io_output_route: qq
io_output_caps: text,file,image

## qq_send_private_msg
发送 QQ 私聊消息
- user_id: 目标 QQ 号
- message: 消息内容（支持 CQ 码）

核心命令

make build        # 编译主二进制
make run          # 编译并启动（数据 /tmp/homeagent）
make install      # 安装到系统
make test         # 运行测试

配置

/etc/homeagent/config.yaml（默认 config/config.yaml）：

daemon:
  listen_addr: ":8080"
  data_dir: "/var/lib/homeagent"
llm:
  model: "deepseek-v4-flash"
  base_url: "https://api.deepseek.com/v1"

许可证

MIT