🚨 AgentMeshOS 项目宪法¶

版本：v0.1.0

状态：系统级约束规范（不可随意修改）

1️⃣ 宪法的定义¶

本宪法定义 AgentMeshOS 的不可违反的系统设计原则。

任何架构设计、模块设计、代码实现都必须遵守本宪法。

2️⃣ 核心原则一：控制层与执行层必须分离¶

❌ 禁止：

Worker 节点承担调度职责
子节点直接控制全局资源

✔ 正确结构：

Control Plane（VPS）
    ↓
Scheduler（Nomad）
    ↓
Execution Layer（Nodes）

3️⃣ 核心原则二：节点必须可插拔¶

所有 Worker Node 必须满足：

可以随时加入集群
可以随时退出集群
不会影响系统整体运行

❌ 禁止：

强绑定节点 ID
依赖固定 IP

4️⃣ 核心原则三：存储必须接口化¶

存储层不能绑定具体实现。

必须通过统一接口：

S3 Compatible API

允许实现：

MinIO
SeaweedFS
Ceph

5️⃣ 核心原则四：AI 必须独立于执行层¶

❌ 禁止：

AI 模块直接绑定某个 Node
AI 依赖单点执行环境

✔ 正确：

AI Core 作为独立决策层
通过 Scheduler 分配任务

6️⃣ 核心原则五：调度系统必须独立¶

调度系统（Nomad）必须独立运行，不可嵌入 Node。

Scheduler = 独立大脑
Compute = 执行肌肉

7️⃣ 核心原则六：系统必须支持动态扩展¶

节点数量可从 1 → N 扩展
无需重启系统
无需修改核心代码

8️⃣ 核心原则七：所有系统必须模块化¶

AgentMeshOS 不允许“单体系统设计”。

所有组件必须符合：

Plugin Architecture

9️⃣ 核心原则八：禁止状态耦合¶

❌ 禁止：

节点之间共享本地状态
AI 依赖单节点内存

✔ 必须：

状态统一管理（Storage / DB）

9.5️⃣ 核心原则九：部署服务必须自托管¶

AgentMeshOS 的部署服务、控制面、调度面、网络协调面、存储服务和运行时服务，默认必须部署在项目自有服务器或自有节点上。

❌ 禁止：

将核心部署能力长期依赖第三方托管控制台
把节点注册、调度、网络控制、任务执行、数据存储交给外部 SaaS 作为默认方案
在未说明风险和替代方案前，直接接入第三方远程授权或外部控制面

✔ 必须：

优先选择可自托管方案
使用自有域名、自有服务器和自有配置承载控制面
对确实无法自托管的临时例外，先说明原因、影响、期限、回滚方案，并经项目负责人确认

🔟 架构不可破坏原则¶

任何优化必须遵守以下顺序：

1. 不破坏架构
2. 不破坏解耦
3. 不破坏可插拔性
4. 不破坏控制/执行分离

11️⃣ 宪法修订规则¶

本宪法不能随意修改。

任何修改必须：

记录 ADR（架构决策）
说明原因
评估影响

📌 当前总结¶

AgentMeshOS 已进入“约束系统设计阶段”。

系统结构已固定，后续所有设计必须在该约束下进行。