🧠 AgentMeshOS 项目交接说明¶

项目名称：AgentMeshOS

版本：v0.1.0

状态：架构设计阶段（Architecture Design Phase）

类型：分布式计算 + AI 操作系统

1️⃣ 项目定位¶

AgentMeshOS 是一个

分布式计算与 AI 自动化操作系统

。

它将多台异构机器（VPS、家用电脑、服务器）通过统一调度与网络层连接，形成一个可编程的计算资源网络（Compute Mesh）。

2️⃣ 系统目标¶

将多台机器统一为一个“虚拟超级计算机”
支持动态节点加入 / 移除
支持容器化任务调度
支持 AI Agent 自动化执行任务
支持未来扩展为 AI 云操作系统

3️⃣ 当前架构（已确认）¶

                    🌐 Internet
                         │
                         ▼
              ┌────────────────────┐
              │   VPS（主节点）    │
              │ Nomad Server       │
              │ Headscale Network  │
              │ Control Plane      │
              └─────────┬──────────┘
                        │
        ┌───────────────┼───────────────┐
        ▼               ▼               ▼
   Node A          Node B          Node C
 (Worker)        (Worker)        (Worker)
   │               │               │
 Docker          Docker          Docker
 Nomad Client    Nomad Client    Nomad Client

4️⃣ 已确定技术栈（不可随意更改）¶

网络层：Tailscale Client + Headscale 自托管控制面
调度层：Nomad
执行层：Docker
操作系统：Ubuntu / Debian Linux
通信方式：自托管 Headscale 管理的 Tailscale Mesh Network

所有部署服务和控制面默认必须部署在项目自有服务器或自有节点上；不得把第三方托管控制台作为核心能力默认依赖。

5️⃣ 系统分层定义¶

AI Core（未来）
│
Scheduler（Nomad）
│
Compute Layer（Docker）
│
Storage Layer（S3 / MinIO）
│
Network Layer（Tailscale Client + Headscale）

6️⃣ 当前开发阶段¶

阶段：v0.1 规划阶段

状态：未部署任何生产系统

目标：完成第一个 VPS + Node 集群

7️⃣ 下一阶段任务¶

初始化 VPS（主节点）
部署 Headscale 自托管控制面并安装 Tailscale 客户端
部署 Nomad Server
接入第一个 Worker Node
验证 Docker 任务调度

8️⃣ 项目核心原则（必须遵守）¶

所有节点必须可插拔（Plug & Play）
控制层（VPS）必须稳定独立
计算层（Node）可以随时加入/退出
存储必须接口化（S3标准）
AI 层不得依赖单一节点

9️⃣ AI 协作规则¶

ChatGPT：负责架构设计
Codex：负责代码实现
Claude：负责方案审查
Gemini：负责信息研究

🔟 文档使用规则¶

本项目所有设计以 docs/architecture 为唯一事实来源（SSOT）。

禁止使用聊天记录作为系统设计依据。

🚨 重要说明¶

任何修改架构设计前，必须更新本项目文档，而不是直接修改代码逻辑。

📌 当前状态总结¶

架构设计：完成
系统部署：未开始
节点数量：0
生产状态：未上线