AgentMeshOS 项目宪法

版本：v1.3.1

更新：2026-08-13

核心原则

控制面与执行面分离：主节点负责 Nomad、Headscale 与受控服务；Worker 只提供计算资源。
节点可插拔：业务任务不得强绑定单个 Worker 的本地状态。
存储必须边界清晰：当前系统云盘由 Cloudreve 应用与其 WebDAV/API 承担；应用不得直连其本地持久化目录。
节点只做控制与执行，不承担业务数据面传输：Tailnet、SSH、Nomad 节点间链路及主节点/Worker 中转不得传输用户文件、镜像、安装包、构建产物、测试夹具、附件、成果和归档。允许临时传输小于 1 MiB 的受控脚本、配置、凭据和紧急交换文件，但必须校验来源、目标、SHA-256 和权限并清理临时对象；业务文件仍必须经 cloud.yohan.fun 公网 HTTPS 数据面在 Cloudreve 与实际使用方之间直达。
AI Runtime 独立于 Worker：Runtime 只通过受控 Adapter 调度 Nomad；模型、普通 Agent 与 MCP 不得取得主机或基础设施凭据。
凭据最小化：密码、Token、Key 仅在 root-only 配置中保存，不进入 Git、日志、浏览器或模型上下文。
真实状态优先：文档、页面和报告必须区分已设计、仓库已修改、已部署、已验证，不得以历史记录代替实时证据。
执行完成不等于验收完成：Worker 返回或 Nomad Allocation 结束只表示执行阶段结束；只有必需检查、AI BOSS 审核以及适用的 Benson 决定完成后，任务才可进入最终 completed。
智能与硬边界分层：AI BOSS 负责目标理解、语义规划、逻辑能力选择、派工、审核和汇总；Runtime 负责契约、安全、能力、预算、状态和幂等验证；Nomad 只选择具体节点；Worker 只执行已登记任务包。
成果必须可证：任何任务成果都必须可登记、展示、版本化并关联真实可访问的证据；不支持自动检查的成果进入 Benson 决定，不得由模型自述或空字段伪造通过。

系统云盘约束

当前系统云盘数据面固定为：客户端到 MM BaoTa Nginx，再到 dd Cloudreve 与 dd 本地持久化存储。Cloudreve 的既有个人文件不属于 AgentMeshOS 自动化范围。

受控小文件交换例外为小于 1 MiB 的脚本、配置、凭据和紧急交换文件，必须经过来源/目标核验、SHA-256 校验、最小权限设置和临时文件清理。该例外不包括业务文件内容。Worker 为执行需要取得业务文件时，必须从 Cloudreve 的公网 HTTPS 入口下载至任务临时目录，完成后删除临时副本；不得通过 SSH、Tailnet、Nomad 分发、主节点代理或节点间复制取得业务文件。

Runtime 与任务自动化只操作受限 WebDAV 空间中的长期目录与临时目录。长期目录不得被自动删除；临时目录只能在任务结束后按明确范围清理。

AgentMeshOS 系统自动化 WebDAV 账户不是 Cloudreve root/admin 账户。root-only 只表示凭据文件由 root:root 0600 保护。该凭据仅访问 AgentMeshOS-临时 与 AgentMeshOS-长期 等自动化目录；Project 使用独立的 101 专用凭据，不能混用，也不得为成果预览或下载创建权限更高的 Cloudreve 管理凭据。

Cloudreve 既有 Project 是独立项目库，不属于 Runtime Artifact 空间。RR 永久不挂载、同步或持有 Project 专用凭据。101 只允许经正式验收的唯一受限单向控制器向 Cloudreve Project 写入；禁止双向同步、WebDAV 挂载、bisync、远端递归全量扫描和任何 Cloudreve 反向写入 101。Project 专用凭据只能由该 root-only 控制器读取，AgentMeshOS 项目代码权威仍为 101 的 /root/project/AgentMeshOS 和 GitHub，RR 只运行版本化发布载荷。

101 的 /srv/codex-hub-backup（必须现场确认是 /dev/sda1）是所有需要备份内容的统一独立备份边界。Project 同步在覆盖或删除前自动保存旧对象与变更记录；系统配置、服务定义、Git bundle、同步状态和其他明确需要恢复的内容由全局自动备份任务写入该盘。备份用于恢复，不阻止同步删除，也不得静默退回 /backup。

已退役的 KodBox、Nomad CSI、JuiceFS、MariaDB Galera、MinIO 与 MM TCP 中转不得重新作为系统云盘实现或恢复方案。