跳转至

AgentMeshOS 系统总结

版本：v1.7.0

更新：2026-08-18

状态：阶段三通用 AI Runtime MVP、重新开启后的阶段四“AI BOSS 智能编排、通用成果与验收闭环”、阶段五至阶段八均已完成并归档；当前阶段 P9 隔离 Tailnet 临时远程协助节点（实施中）。

AgentMeshOS 是以 Headscale/Tailnet、Nomad、Docker、Cloudreve 和 AI Runtime 组成的自托管 AI 应用运行平台 / AI 操作系统。

  • main：控制面、Nomad Server、Headscale、AI Runtime 与受控自动化。
  • 101 / 103：可替换的通用计算 Worker，不承载系统云盘。
  • MM：唯一公网 HTTPS 入口；Cloudreve 文件请求直接反代到 dd。
  • dd：Cloudreve 与其本地持久化文件数据；当前是系统云盘单点。
  • Tailnet：控制、运维和私有管理；不转发用户文件数据；P9 使用独立标签承载临时 Support 节点，禁止进入生产节点池。
  • OmniRoute：官方 npm 原生模型核心，是唯一 Provider/模型/协议/路由权威；AgentMeshOS 不修改其源码。
  • CLI Agent Gateway：AI Boss/Worker 的隔离单模型通道执行与加密 Key 存储，只接受 Runtime 脱敏后的统一上下文和已登记 Codex/Claude CLI 通道；不进入 OmniRoute Provider 列表，不自动回退。
  • API Gateway：Console、Status 和运维使用的状态、节点、Nomad、服务与告警聚合层；不提交 AI 任务、不调用模型、不重启服务、不管理 Cloudreve 文件。
  • 主节点认证回源代理：把认证后的 Console 固定路径分别转发到 Runtime、API Gateway 等受控服务；不保存任务和业务状态。

Runtime 采用薄边界：负责计划契约验证、能力与预算快照、任务图、Nomad Adapter、成果/证据/检查/验收持久化、恢复、业务成本、告警和 OmniRouteAdapter 桥接，不再维护第二套 Provider 凭据、模型目录、健康/冷却、通用回退或 Direct Provider 默认路径。AI BOSS 负责业务语义规划、逻辑能力选择、依赖与并行、成果契约、审核和汇总；Runtime 不代替其派工，Nomad 只选择具体节点。当前生产 OmniRoute 为官方 3.8.49 原生 systemd 安装，运行基线是 52 条连接、51 个已配置 Provider、2 个 Combo 和 2 个 API Key；SQLite quick_check=ok。

Boss 使用 agentmeshos-free-quality-first 按质量顺序优先使用 GPT/Codex、Claude 和 O3，失败或额度不可用后逐级回退；Worker 使用 agentmeshos-free-capacity-pool 按每个模型和账号的累计调用次数均衡 195 个候选、24 家 Provider 的免费容量。同等使用量时仍从高质量顺序开始。

P3-6 至 P3-12 已完成。官方 MCP 搜索/抓取已通过标准 Streamable HTTP 真实验收；Compression 隔离复评在特定工具日志上有高压缩率，但错误、JSON 和结构化结果保真门槛未通过，生产保持关闭。

2026-08-05 AI Boss 模型通道选择、Runtime 固定后端目录和隔离 CLI Agent Gateway 已完成生产部署。Console 可以显式选择 AgentRouter / Codex / gpt-5.6-sol、Claude Code claude-opus-4-8 或 claude-opus-5；三个 CLI 后端均已分别通过生产 Gateway 和正式 Boss API 调用并返回精确 OK，Gateway 最小审计和 AI Boss 执行过程均已持久化。模型不保存 AI BOSS 记忆：同一会话的消息、摘要和确认记忆由 Runtime 统一保存。Console 不再暴露“公开/私有”选择；Runtime 保留原始记录并在外发前按固定规则生成脱敏上下文，因此切换模型不会丢失记忆。Codex 不可用时对话失败/暂停并说明真实原因。

2026-08-06 起，AI BOSS 核心能力改造正式定义为阶段四。此前归档中的对话、预算、上下文、记忆、附件、多模态、SSE、CLI Gateway 和 API Gateway 验收继续有效；2026-08-11 后续审计发现的关键词规划、固定单任务、字段式自动审核和 Console 成果缺口，已由重新开启后的阶段四完成 Plan -> Task -> Deliverable -> Evidence -> Verification -> AI BOSS Review -> Auto/Benson Acceptance 闭环并归档，且 completed 只表示最终验收完成。

阶段五已完成 AI BOSS 受控主动工作循环及 Console 定时、暂停、终止、预算和受控重新运行操作并归档；阶段六应用中心基础、阶段七本地应用 MVP 和阶段八应用平台与成果交付也已完成归档。当前 P9 正在实施隔离 Tailnet 临时远程协助节点；首个样板为“本地资料分析与验收工作台”，演示文稿生成应用已作为 P8 成果交付。

项目仓库负责研发、构建、测试和发布。生产系统依靠已发布镜像、Runtime SQLite、Cloudreve 数据及既有服务运行，不依赖 Git 工作树常驻。

已退役：KodBox、Nomad CSI、JuiceFS、MariaDB Galera、MinIO、MM 39062 中转、disk.yohan.fun 云盘路由。Worker 的最大 1 MiB JSON 回调证据进入 Runtime SQLite；较大/长期 Artifact 只由主节点 Runtime 使用 root-only Cloudreve WebDAV Adapter 写入长期目录。