跳转至

AgentMeshOS 总体演进路线图

版本：v1.7.2

更新：2026-10-04

状态：阶段一至阶段八、P10 至 P16 已完成并归档；P9 已关闭，不再实施；当前阶段为 P17《代理网络控制面统一入口与真实客户端验收》，进行中，当前工作包为 P17-5。

本路线图描述 AgentMeshOS 作为“AI 应用运行平台 / AI 操作系统”的平台演进和应用演进。它不把任何单一业务应用当作系统本体，也不把架构讨论误报为功能实现。

📌 结论摘要

阶段一至阶段八已经形成从分布式底座、通用 AI Runtime 到应用中心的完整闭环，P10 完成可替换网络边缘，P11 完成网络治理与节点纳管，P12 完成 102 最终验收，P13 完成 OmniRoute latest stable 原生迁移，P14 完成搜索 MCP 双监听、三工具和双通道真实回归，P15 完成多 Edge、DERP region 900 至 903、Peer Relay、DNS 切换和 RR 冷启动修复并归档，P16 完成 102 只读备用控制面、Edge 回退和 RR 整机重启演练并归档。当前阶段为 P17，状态为进行中，当前工作包是 P17-5 发布、验收与回退收口。依据是 docs/plans/state.json、P16 完成归档和 P17 计划。

🧭 总体方向

flowchart LR
    Base["分布式计算底座"] --> Runtime["通用 AI Runtime"]
    Runtime --> Apps["可插拔 AI 应用"]
    Apps --> Feedback["业务结果 / 成本 / 收益 / 复盘"]
    Feedback --> Runtime

底座继续使用 Network、Compute、Scheduler、Storage、Security 和 Observability。应用中心负责把这些平台能力组织成人类可直接使用的应用；第一个样板是本地资料分析与验收，不访问外部业务来源。

🧱 八个阶段

阶段一：分布式计算底座

状态：已完成并归档。

  • Headscale/Tailscale 网络
  • Nomad 调度和 Docker 执行
  • Cloudreve WebDAV 系统云盘与 dd 本地持久化存储
  • 多节点任务提交、调度、执行和结果回收
  • 临时数据清理、真实业务闭环和发布验收

结果：AgentMeshOS 具备稳定的分布式计算底座。

阶段二：架构重新整理

状态：已完成并归档（架构文档已同步；Runtime 尚未实现）。

  • 明确底座、AI Runtime 内部控制边界和应用层
  • 明确 AI Boss Agent、专业 Agent、Provider、MCP 和工作流边界
  • 明确普通任务不使用审批、批准单、准入报告、租约或普通 TTL
  • 仅在数据风险明确时使用必要的技术围栏

阶段三：通用 AI Runtime MVP

状态：已完成并归档。完整证据见阶段三完成归档。旧“整体可行性评估”已取消并保留为历史记录，不作为 Go/No-Go 门禁。

  • AI Boss Agent 和研究 Worker 的最小编排
  • 已授权公开资料研究、去重、初筛和证据登记的通用底座
  • NomadAdapter、StorageAdapter、ToolAdapter、FeedbackAdapter 的最小内部契约
  • Agent Registry、Workflow、Memory、Feedback、Runtime 策略选择和来源目录的最小实现范围
  • P3-6 至 P3-12 已由官方 OmniRoute 和薄 Runtime 完成生产验收；MCP 搜索/抓取已通过标准 Streamable HTTP。Compression 隔离复评在特定工具日志上有高压缩率，但保真门槛未通过，生产保持关闭。详见阶段三完成归档
  • 不新增第二调度器、审批中心或公网任务 API

阶段四：AI BOSS 智能编排、通用成果与验收闭环

状态：已完成并归档；最终证据见阶段四最终归档，重新开启期间的实施记录见阶段四权威计划。原阶段四完成归档继续保留此前真实验收事实。

  • 保留已经验收的持久交互、SSE、幂等、取消、恢复、Token 预算、上下文、长期记忆、附件、剪贴板、多模态、CLI Gateway 与 API Gateway 可见性。
  • 将关键词判断和固定单任务替换为 AI BOSS 模型结构化规划，使其选择已登记逻辑能力、主节点/Nomad 执行建议、依赖、并行、成果契约与验收标准。
  • Runtime 负责验证能力、安全、预算、资源、风险、状态和幂等；Nomad 只选择具体节点；Worker 只执行已登记任务包。
  • 建立 Plan、Task、Deliverable、Evidence、Verification 与 Acceptance 持久闭环；completed 只表示最终验收完成。
  • 常见成果通过真实确定性检查器与 AI BOSS 结构化审核；不支持、高风险、外部业务、未知风险或证据不足进入 Benson 决定。
  • Console 增加“成果与验收”分区，支持成果、证据、检查、审核、版本、返工、拒绝和重开。
  • 代码、生产与公网出口已通过并已重新归档；阶段五最终出口见其独立完成归档。

阶段五：AI BOSS 受控主动工作循环

状态：已完成并归档；细化记录见阶段五计划，最终事实见阶段五完成归档。

  • Runtime 只按 Benson 已创建并启用的持久策略，在固定触发、预算、数据等级和动作白名单内唤醒 AI BOSS。
  • Console 增加“主动工作”区，提供全部暂停/恢复、策略启停与暂停、计划与预算编辑、当前运行取消、终止后续运行和受控重新运行。
  • 模型不能创建或放宽策略；重新运行创建新运行和预算快照，不重放旧调用，也不直接重启 Runtime 服务。
  • 首版只做无破坏验证，不自动投递、付款、发信、交易、修改凭据、Provider/Combo、网络、Git 或部署。

阶段六：应用中心基础与本地应用样板

阶段状态：已完成并归档，见阶段六完成归档。

计划状态：已完成并归档；权威事实见阶段六完成归档，原计划兼容入口为 phase-6-application-center-foundation.md。

  • 建立内置应用注册表、应用 Manifest、状态和 Console 应用中心。
  • 交付“本地资料分析与验收工作台”样板，只处理 Benson 明确提交的本地资料。
  • 复用 Conversation、Plan、Task、Deliverable、Evidence、Runtime、Nomad 和 Storage，不新增第二状态机或调度器。
  • 完成应用工作区、历史、版本、恢复和桌面/移动端生产验收。

阶段七：本地应用 MVP 与应用运行规范

状态：已完成并归档，见阶段七完成归档；原计划兼容入口为plans/phase-7-application-mvp.md。

把 P6 样板收敛为持续可用的本地应用，补齐稳定数据模型、设置、历史、版本、重新运行、成本、导出、备份恢复和应用运行规范。应用版本独立于平台版本，例如 local-review-app 0.1.0 不等同于 AgentMeshOS Platform 版本。

阶段八：多应用扩展与应用生命周期

阶段状态：已完成并归档。目标“应用平台与首个成果型应用交付”已通过生产和浏览器验收，见阶段八完成归档；完整计划兼容入口为 phase-8-application-expansion.md。

阶段九：隔离 Tailnet 临时远程协助节点

阶段状态：已关闭，不再实施；详细关闭边界见 P9 计划。

  • P9 原目标是在隔离 Support Tailnet 和 SSH 下为授权临时电脑提供技术支持；已实现脚本和接口保留为历史资产，未完成的三平台 ACL、真实接入和撤销清理不再阻塞当前阶段。

阶段十：MM 公网 IP 可替换架构整改方案（2026-09-25）

阶段状态：已完成并归档；已关闭且不再实施：P9。完成归档见 completed-phase-10-mm-public-ip-replaceable-architecture.md，原始权威计划见 phase-10-mm-public-ip-replaceable-architecture.md。

  • 保留原计划的逻辑身份、动态地址、端点快照、配置渲染、恢复链和 CI 防复发基线；后续修订只在同一计划内叠加。
  • 使用稳定边缘身份和业务 CNAME，消除 MM 公网 IPv4/IPv6 在 Nginx、UFW、SSH、DERP、出口服务和恢复脚本中的硬编码。
  • 收口 RR、101、Home 的公网与 Tailnet SSH 双通道，明确 DD、MM 不新增反向管理权限。
  • 直连优先、DERP 为辅；MM 作为 region 900，DD 作为 region 901 候选，并明确 MM 自身失联时 MM DERP 不能兜底。P15 已把 region 900 的稳定域名从会随活动 Edge 切换的 mesh.yohan.fun 解耦为 derp-mm.yohan.fun。
  • 在 Console 首页交付交互式网络拓扑、真实链路分类、状态颜色、数据流动画、移动端和 reduced-motion 支持。
  • 执行顺序固定为部署、更新、GitHub 同步、再次更新并确认；P10-1 DNS 与域名清单冻结完成前，不修改现网网络配置。
  • P10-0 至 P10-8 已完成计划治理、DNS、端点快照、SSH 双通道、路径分类、拓扑告警、控制台态势、隔离切换回退和文档归档。真实第二生产边缘切换、DD region 901 和完整 IPv6 端到端保留为外部前置。

阶段十一：AgentMeshOS 网络可替换、告警治理与节点纳管

阶段状态：已完成并归档；计划状态：已完成；已关闭且不再实施：P9。P11 已完成范围冻结，当前工作包为无，详情见 P11 完成归档，原始记录见 phase-11-placeholder.md；P10 已完成并归档，不再重新打开为当前实施入口。

dog-public 已完成从 101 的公网与 Tailnet 双路径 SSH 回读，返回主机名均为 dog；其 Tailnet 地址为 100.64.0.3，9100/metrics 返回 200，现有宝塔、Nginx、Shadowsocks Rust 和 SSH 端口未被改动。ThreeDogs、DERP、Claude 和微信 ClawBot 已按用户确认暂停、收尾、归档、冻结，不再作为 P11 或 P12 的待办。

阶段十二：102 节点纳管一次性最终验收

阶段状态：已完成并归档；计划状态：已完成；当前工作包：无；P12-0 已完成并归档。102 的身份、SSH、Tailscale、Docker、Nomad Client、node_exporter、RR 遥测、RR/101/Home 三管理入口、UFW 和重启持久性共 8 项验收全部通过。OmniRoute 原生迁移不属于 P12 出口，完成归档见 completed-phase-12-pcdell-102-final-acceptance.md，原计划保留为 phase-12-pcdell-102-and-omniroute-migration.md。

阶段十三：OmniRoute latest stable 原生迁移

阶段状态：已完成并归档；计划状态：已完成；当前工作包：无；P13-6 已完成并归档。官方 npm 3.8.51 已一次性直装到 102，最终快照恢复、生产切换、Boss/Worker、Codex Responses、管理 API、SQLite、负向鉴权、真实回退和再次切换均已通过。MM 公网入口已直连 102；RR omni 数据、包、service、回退备份和网关 vhost 已删除，RR 仅保留本机 Runtime 私有代理。完整归档见 completed-phase-13-omniroute-latest-stable-migration.md。

阶段十四：OmniRoute 官方能力接入与搜索试点

阶段状态：已完成并归档；计划状态：已完成；当前工作包：无。102 已同时监听 Tailnet 与局域网，101 默认使用 Tailnet MCP，客户端只暴露三个搜索工具；本地与 Omni 各 5 项独立查询通过，web_fetch 和 tool_search 也已真实验证，x_search 已移除。完整归档见 completed-phase-14-omniroute-search-mcp.md。

阶段十五：AgentMeshOS 多边缘、Tailnet 中继与网络态势韧性整改

阶段状态：已完成并归档；计划状态：已完成；当前工作包：无。P15 以 MM、d02、DD、dog-public 为 Edge、DERP 和 Peer Relay 候选，RR 永远排除；四区 DERP、Peer Relay、精确 Headscale policy、证书链、SNI 回源、真实切流、AAAA 删除、回切、AAAA 恢复、RR 冷启动修复和最终发布验收均已完成。完整归档见 completed-phase-15-multi-edge-tailnet-resilience.md，原计划保留为 phase-15-multi-edge-tailnet-resilience.md。

阶段十六：控制面后端冗余与断网只读控制台

阶段状态：已完成并归档；计划状态：已完成；当前工作包：无；P16-5 已完成并归档。P16 已完成 102 Auth/Console/API 只读备用、Auth SQLite 一致性快照、同一 AUTH_SESSION_SECRET、只读写拒绝、Edge 主备 upstream、101 单观察者安全路径和 RR 整机重启恢复验收。RR 仍是唯一控制面写权威，102 只提供明确标记的只读降级服务。完整事实见 P16 完成归档，原计划保留为 phase-16-control-plane-backend-resilience.md。

阶段十七：代理网络控制面统一入口与真实客户端验收

阶段状态：当前 P17，进行中；计划状态：修订中；当前工作包：P17-5 发布、验收与回退收口。P17 已完成范围冻结、四个 panel-*.yohan.fun 节点面板、Console #proxyNetwork 生产回读和 Windows 真机切换/回切验收；Android/iOS 真机与最终回退证据仍未完成。依据是 phase-17-placeholder.md 和 docs/plans/state.json；剩余真机与最终回退未闭环前不得归档。

阶段十八：中国网络可达性探针与临时 IP 自测

阶段状态：已完成（用户已授权在 P17 归档前提前执行并结案）；计划状态：已完成；当前工作包：无。P18 已使用 Globalping 官方 API 在 Console 网络态势中增加网络可达性状态卡，默认使用深圳、广州和东莞组成的华南探针范围；管理员还可临时自测现有 IP、替换 IP 或公网域名，同时运行 ICMP Ping 和 TCP 443，异常时触发 MTR，并提供 ping.pe 人工佐证。完整计划见 phase-18-placeholder.md。

📦 平台版本与应用版本

平台版本表示 AgentMeshOS 平台成熟度：

Platform v0.5：分布式计算底座完成
Platform v1.0：通用 AI Runtime 初版
Platform v1.5：应用中心、本地应用 MVP 和多应用生命周期
Platform v2.0：基于真实需求扩展的 AI 应用平台

应用版本独立编号：

local-review-app 0.1.0
local-review-app 0.5.0
local-review-app 1.0.0

✅ 完成口径

  • “设计完成”只表示架构或规范文档完成。
  • “实现完成”必须有代码、测试、运行态或公网验收证据。
  • AI 协作规范设计已完成，不代表系统内多 Agent Runtime 已实现。
  • P3-6-1 是已退役的候选发现历史，不能恢复为 Provider 核心；P3-6-2 至 P3-12 已完成官方 OmniRoute 原生接入和薄 Runtime 验收。Compression 保持关闭，不得误报为已启用能力。
  • v0.5 底座、阶段三 Runtime MVP、重新开启后的阶段四至阶段八、P10 至 P16 均已完成并归档；P9 已关闭且不再实施，当前 P17 处于进行中状态。P16 的 102 只读备用、认证连续性、Edge 回退和 RR 整机重启演练已经完成；P17 正在执行代理控制面、节点面板、Console 架构页和三端客户端验收。平台版本与阶段编号不是同一套编号。
  • 旧整体可行性评估已取消；应用结果、成本和反馈在 Runtime 与应用运行中持续记录，而不是作为实现前的总阀门。

⚠️ 未决项 / 需要决策

未决项 当前事实 下一步
P12 关闭决策 8 项验收全部通过，102 纳管已关闭并归档 无；后续漂移按新运维事件处理，不重新打开 P12
P13 归档后观察 P13 已完成并归档，102 生产健康，MM 直连 102，RR omni 物料已退役 长期健康观察独立运行；异常按新运维事件处理
P14 归档 搜索 MCP 双监听、三工具和双通道真实回归已完成 保持稳定能力，不重新打开归档
P15 完成归档 多 Edge、DERP、Peer Relay、DNS 切流/回切、RR 冷启动和最终发布回读均已完成 不再重开 P15；边缘漂移按新运维事件处理
P16 控制面 P16 已完成并归档，102 只读备用、Edge 回退和 RR 重启演练均有生产证据 不再重开；异常按新运维事件处理
P17 范围 代理控制面统一入口、四个节点面板、Console 架构页和三端客户端验收 生产实施与真实验收完成后才允许归档
AliDNS 写凭据 101 已配置 root-only 0600 凭据并通过 show/check/ensure-records 回读；控制器 AAAA 路径已通过单测和真实切流/回切 控制器已纳入 30 秒 systemd timer；保持双栈状态与回退回归
外部网络变化 DNS、运营商、边缘主机、路由器固件和证书均属于漂移来源 任一触发条件变化后重新执行端点、SSH、DERP、业务与回退验收