跳转至

AgentMeshOS 系统总结

版本：v2.0.1

更新：2026-10-04

状态：阶段三通用 AI Runtime MVP、重新开启后的阶段四“AI BOSS 智能编排、通用成果与验收闭环”、阶段五至阶段八、P10 至 P16 均已完成并归档；P9 已关闭且不再实施；当前阶段 P17“代理网络控制面统一入口与真实客户端验收”进行中。

📌 结论摘要

AgentMeshOS 已完成从分布式底座、薄 Runtime 到应用平台、网络治理、102 节点纳管、OmniRoute 原生迁移、搜索 MCP、多 Edge/Tailnet 中继和只读备用控制面的归档。P16 已增加 102 只读 Auth/Console/API、Edge 本地回退和 RR 重启演练，让 RR 后端故障时仍能受控查看网络态势。P17 正在把代理网络 Master、节点面板、Console 架构页和真实客户端验收连成统一控制面。依据是 P16 完成归档、P17 计划与 docs/plans/state.json。

RR→101 系统剥离：101 已成为项目代码、资料、GitHub/CI-CD 和发布协调权威；RR 继续承载生产 Runtime、System Operations Bridge 和生产运行载荷。四类 RR 载荷已完成版本化接收、健康与回滚验收，非敏感恢复材料已交接到 101 独立备份盘；RR 项目控制链路停用，后续发布仍需通过 Actions 监控闸门和公网验收。

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

  • main：控制面、Nomad Server、Headscale、AI Runtime 与受控自动化。
  • 101：AgentMeshOS 项目代码/资料/GitHub/CI-CD 权威和项目级发布协调入口；不再归类为普通 Worker，可按 Nomad 标签执行可替换的无状态计算任务，但不运行生产 Runtime/Bridge。
  • 103：可替换的通用计算 Worker，不承载系统云盘。
  • RR：生产部署与运行节点，继续承载生产 Runtime、Bridge 和服务；只消费版本化发布产物。
  • MM：当前活动公网 HTTPS Edge；与 d02、DD、dog-public 同为可替换候选，Cloudreve 文件请求直接反代到 dd。
  • dd：Cloudreve 与其本地持久化文件数据；当前是系统云盘单点。
  • Tailnet：控制、运维和私有管理；不转发用户文件数据；允许小于 1 MiB 且经 SHA-256/权限校验的脚本、配置、凭据和紧急交换文件临时传输。历史 P9 的 Support Tailnet 标签保留为关闭记录，当前不启用。
  • 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 只选择具体节点。102 当前生产 OmniRoute 为官方 3.8.51 原生 systemd 安装，P13-4 运行基线是 70 条连接、19 个 Combo、4 个 API Key、迁移 193、SQLite quick_check=ok；RR omni 数据、包、service、回退备份和 vhost 已删除。

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、阶段八应用平台与成果交付、P10 可替换网络边缘、P11 网络治理、P12 节点纳管、P13 OmniRoute 原生迁移和 P14 搜索 MCP 也已完成归档。P9 已关闭且不再实施。

P15 已把 Edge、DERP 和 Peer Relay 分离并归档：Edge 负责公网 DNS、TLS、Nginx 与回源；DERP 负责 Tailnet 官方中继；Peer Relay 是普通 Tailnet 节点提供的中继能力。RR 永远排除三者，只保留 Headscale、Runtime 和控制面。P16 进一步区分“Edge 可选”和“后端可登录”：现已增加 102 只读 Auth、Console、API Gateway 投影和受控本地回退；DERP 或 Peer Relay 仍不能替代 Console/Auth/API 写入高可用。

项目仓库负责研发、构建、测试和发布。101 与 GitHub Actions 负责 CI/CD 协调，RR 只部署带摘要的已发布产物；生产系统依靠已发布镜像、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 写入长期目录。

⚠️ 未决项 / 需要决策

事项 当前事实 下一步
P13 归档后观察 P13 已完成并归档，MM 直连 102，102 为唯一生产权威 长期健康观察独立运行；异常按新运维事件处理
P14 归档 搜索 MCP 双监听、三工具和双通道真实回归已完成 保持稳定能力，不重新打开归档
P15 归档 四台候选、四区 DERP、Peer Relay、DNS 切流/回切、AAAA 恢复和 RR 冷启动修复均已完成 不再重开 P15；边缘漂移按新运维事件处理
P16 控制面 102 只读备用、认证会话连续性、Edge 回退和 RR 重启演练已完成并归档 不再重开；后续异常按新运维事件处理
P17 范围 代理控制面统一入口、四个节点面板、Console 架构页和三端客户端验收 生产实施与真实验收完成后才允许归档
生产入口切换 MM 面板源与渲染 conf 均直连 102，RR 只保留本机 Runtime 代理 后续入口变更必须同时修改面板源和渲染配置并另行评审