homelab-agent：构建私有化多智能体AI平台的完整参考架构

homelab-agent是一个完整的多层架构参考实现，旨在家庭实验室环境构建功能完备的私有化AI平台。它通过三层架构实现持久化上下文、多智能体协作工作流和专用智能体，让AI真正理解并管理你的基础设施，数据不出本地，既保护隐私又提供云端服务无法比拟的深度集成能力。

homelab-agent的核心理念是让AI不再每次会话从零开始，而是拥有关于环境的持久记忆，能够主动调用工具管理服务器，并通过专门构建的智能体执行特定任务。这不是简单的"用AI写脚本"，而是一个持续运行、积累知识、与基础设施深度集成的智能系统，且所有数据运行在本地硬件上，保障隐私安全。

第一层：主机与核心工具链

基础层为专用迷你PC（如GMKTec K11），运行Debian 13和Claude Desktop，核心是MCP服务器集成，提供17个服务（监控、存储管理、开发工具等）的实时访问能力。

第二层：自托管服务栈

通过Docker部署LibreChat（多用户前端+专用智能体）、SWAG/Authelia（安全认证）、可观测性栈（Grafana+InfluxDB+Loki）及CloudCLI、SearXNG等专用组件。

第三层：多智能体Claude Code引擎

具备作用域内存、后台作业和自动知识积累能力，通过CLAUDE.md结构化知识组织、NATS JetStream实现智能体协作。

1. 持久化上下文系统：从markdown记录发展为结构化仓库，让AI拥有环境持久记忆，交互从解释设置变为直接指令。
2. 版本控制的基础设施：AI触及的一切均在git版本控制中，变更可审计、回滚，协作有单一事实来源。
3. 模块化设计：各组件可独立使用或组合，文档提供独立价值、集成价值及采用优先级评级。

基础设施运维

通过MCP集成查询Netdata指标、TrueNAS存储状态、Unraid容器健康等。

开发工作流

管理GitHub仓库、语义搜索代码文档、使用CloudCLI浏览器内界面。

专用智能体：求职助手

实现多源职位抓取、简历评分、申请跟踪、邮件提醒等功能。

自主构建管道

包含trigger-proxy、task-dispatcher等组件，支持安全的工作流执行。

1. Ollama队列代理：三级优先级队列、客户端API认证、模型感知路由、Valkey嵌入缓存等。
2. 语义搜索架构：qmd混合搜索（BM25+向量+LLM重排序）、Hister记忆搜索（覆盖500+文件）。
3. 知识图谱：Graphiti+Neo4j构建时序知识图谱，捕获基础设施拓扑，由memory-flush和memory-sync维护。

建议渐进式部署路径：

1. 第一阶段：Layer1基础（专用主机+Claude Desktop+核心MCP服务器）
2. 第二阶段：Layer2核心（LibreChat+SWAG/Authelia+SearXNG）
3. 第三阶段：可观测性（Grafana栈+监控集成）
4. 第四阶段：高级功能（智能体总线、知识图谱、Temporal工作流） 即使仅Layer1，也能实现AI与基础设施的直接交互升级。

homelab-agent代表个人AI基础设施构建的前沿实践，将LLM从"对话工具"转变为"基础设施操作员"。对技术爱好者、家庭实验室玩家及企业用户提供宝贵参考架构，模块化设计支持渐进式采用，丰富文档和活跃更新使其成为可持续学习资源。