# Universe Blueprint v0.2

> **状态**：正式生效（active）· 跨库治理 canonical
> **版本**：v0.2
> **创建日期**：2026-08-05
> **生效日期**：2026-08-06
> **维护人**：小宝（xiaobao）
> **审定人**：珍珍（zhenzhen）
> **批准人**：R

---

## 0. 边界声明

Universe Blueprint v0.2 是跨 Nebula、NEXUS、ETERNA、Cluster 的正式治理总纲。

Nebula Blueprint v12.x 继续作为 Nebula 组件专属规则与历史兼容依据有效；凡跨库治理冲突，以 Universe Blueprint 为准，凡 Nebula 专属事项仍按 Nebula v12.x 及后续 Nebula Component 规则执行。

---

## 1. Universe 是什么

**Universe 是 Ray's Digital Ecosystem 的总治理域。**

Universe 不是内容库，不是业务执行层，不是某个 agent 的工作空间。它是跨 Nebula、NEXUS、ETERNA、Cluster 的治理层，负责：

- 定义架构边界（哪个库承接什么内容）
- 统一 Agent 治理（注册、能力、权限、变更留痕）
- 统一 Skill 规范（canonical 命名、来源追踪）
- 统一路由规则（内容往哪放、谁来处理）
- 统一权限边界（谁能看、谁能改、谁能审定）
- 统一变更留痕（谁改了什么、谁需要知道）

---

## 2. 架构全景

```
Universe（总治理层）
│
├── Blueprint/         ← 宪法（本文件）
├── Governance/        ← 跨库治理规则
│   ├── Routing Rules  ← 内容路由规则
│   ├── Access Rules   ← 权限边界规则
│   └── Mechanism Map  ← 机制分层与留痕串联
├── Registry/          ← 注册表
│   ├── Agent Registry ← Agent 注册表
│   ├── Library Registry ← 子库注册表
│   └── Runtime Registry ← 运行时环境注册表
├── Skills/            ← Skill canonical 注册表
└── Changes/           ← Universe 级变更记录 + Agent Change Index（索引层）
│
├──→ Nebula（动态入口 · 知识与业务孕育 · 关系演化 · 真相裁决 · 跨域协调）
│       └── 99_System/ = Nebula 专属治理
│
├──→ NEXUS（汇承业务公域）
│       └── NEXUS_System/ = NEXUS 专属治理
│
├──→ ETERNA（品牌团队业务组件 / 隔离执行域）
│       └── 99_System/ = ETERNA 专属治理
│
└──→ Cluster（子库集合）
        ├── BoA/BoA_System/
        ├── Minutes/
        ├── Private/
        └── ...
```

---

## 3. 核心原则

### 3.1 内容定位与权限边界分离

- **内容定位**：这个库承接什么职能、在 Universe 体系里是什么角色
- **权限边界**：谁能看、谁能改、是否可反向关联

一个库可以权限受限，但仍然属于 Universe 体系组成部分。一个子库可以是专用承接位，但不等于脱离 Universe 总控。

### 3.2 Universe 管什么、不管什么

| Universe 管 | Universe 不管 |
|-------------|--------------|
| 架构边界 | 各库内部目录治理 |
| Agent 注册与治理 | Agent 私有记忆 |
| Skill canonical 命名 | Skill 内部实现 |
| 跨库路由规则 | 各库内部业务逻辑 |
| 权限边界总纲 | 各库内部权限细项 |
| 变更留痕总索引 | 各库内部 CHANGELOG 正文 |

### 3.3 专用子库已承接时，Nebula 收束存放职能

当某类内容已有专用子库承接位时，Nebula 不再并行维护同类主档，只保留路由入口、历史说明、外部资料或跨业务关联。

---

## 4. 组件边界

### 4.1 Nebula

- **定位**：Universe 下的动态入口、知识与业务孕育、关系演化、真相裁决与跨域协调组件
- **自治范围**：目录治理、实体纠偏、写入门控、MOC、Daily Note、GTD
- **Universe 管什么**：宪法、Agent、Skill、路由、权限
- **私域正文规则**：私域正文默认转入 Cluster/Private；Nebula 保留必要路由、关系与裁决，不默认承接私域正文
- **当前 canonical 宪法**：Nebula/99_System/Blueprint/Blueprint.md（v12.17）

### 4.2 NEXUS

- **定位**：汇承团队业务公域 / 团队协作执行组件（承接客户、项目、团队协作、产品/交付与公司侧业务资料；内部团队系统、权限试点和客户协作投影仍渐进完善）
- **自治范围**：业务规则、客户管理、项目治理、团队协作
- **Universe 管什么**：宪法、Agent、Skill、路由、权限
- **专属系统**：NEXUS/99_NEXUS_System/
- **canonical 目录**：采用六层 + 六层外独立个人文件夹（完整二级目录见 NEXUS 小宪法）
- **代码项目**：治理/登记域 = Cluster/Visio/（Code_Project_Registry.md 唯一登记表）；运行域 = Registry 登记的 runtime_path；NEXUS 不保留可运行源码正文

### 4.3 ETERNA · provisional

- **定位**：品牌团队业务组件 / 隔离执行域
- **自治范围**：业务规则、供应商管理
- **Universe 管什么**：宪法、Agent、Skill、路由、权限
- **专属系统**：ETERNA/99_System/
- **状态**：provisional — 待实际边界/使用者/权限域进入 Registry 后补丁细化

### 4.4 Cluster

- **定位**：子库集合（专用承接位）
- **子库**：BoA、Hui、Jinyu、Risesun、家大业大、Serein、Minutes、Private、Readwise、IMA
- **Universe 管什么**：宪法、Agent、Skill、路由、权限
- **各库自治**：内部运营、内容管理

---

## 5. Agent 治理

### 5.1 Agent 注册表

- **主注册表**：Nebula/99_System/agents/AGENT_REPORT.json（唯一身份/roster/active-status 真相源，不迁）
- **能力登记**：Universe/99_System/Registry/Agent_Capability_Registry.md（基于 roster 的能力/平台/运行环境/数据域/工作负载登记；不能新建 agent_id，不取代 Agent Card）+ Platform_Capability_Matrix.md（derived view，禁止双写）
- **变更索引**：Universe/99_System/Changes/Agent_Change_Index/（索引层，2026-08-07 P2-6 迁入；旧位 Nebula/99_System/agents/ 已删除，仅留 LEGACY 说明）

### 5.2 Agent 治理原则

- Agent 要自登记，不靠人工记录
- 珍珍作为审定者，只审核登记质量与分工建议
- 底座能力 + 权限边界 + 数据域 + 长期表现共同决定任务

### 5.3 Agent 环境归属

| 环境 | Agent |
|------|-------|
| Neb（公司） | 妮妮、大宝、珍珍（跨环境） |
| Zion（私域） | 娜娜、小宝、然然、珍珍（跨环境） |
| Falcon（Windows） | 菲菲、文文、盈盈 |
| Cloud（扩展） | 小Max马、Max小龙、小扣子 |
| Ark（深圳） | Runtime Pending（待 NEXUS runtime 实测和 Runtime Registry 字段补齐后定；不构成组件边界未完成） |

---

## 6. Skill 治理

### 6.1 Skill Canonical 命名

| canonical skill | legacy alias | 定位 |
|----------------|-------------|------|
| `universe-compile` | `inbox-compile`, `meeting-minutes`, `minutes-orchestrator` | 原始材料编译 |
| `universe-filing` | `nebula-filing`, `filing` | 正式落库 |
| `universe-lint` | `nebula-lint` | 治理质量检查 |
| `universe-audit` | `audit-review` | 后续复审 |
| `universe-output` | `meeting-to-deck-bridge`, `html-slides-generator` | 输出层 |

### 6.2 Skill 来源追踪

- **canonical 源**：Nebula/99_System/Skills/（当前）
- **未来 canonical 源**：Universe/99_System/Skills/（Phase 2 迁移候选）

---

## 7. 路由规则

### 7.1 内容路由

| 内容类型 | 目标库 | 说明 |
|----------|--------|------|
| 人物/机构/可复用实体资料 | Nebula | 30_Resources/ |
| 已发生的业务事实 / Event | Nebula | 10_Projects/Events/（可关联多个对象，不强行挂单一 Project） |
| 知识概念 | Nebula | 20_Areas/ |
| 项目 | Nebula | 10_Projects/ |
| 汇承业务 | NEXUS | NEXUS 对应目录 |
| 亿达业务 | ETERNA | ETERNA 对应目录 |
| 投资研究 | BoA | Cluster/BoA/ |
| 会议纪要 | Minutes | Cluster/Minutes/ |
| 私人正文 | Private | Cluster/Private/ |

### 7.2 路由总控

- 路由规则由 Universe 定义（Universe/99_System/Governance/）
- 各库可有库内路由细则，但不得与 Universe 路由冲突
- 新增路由规则必须先做机制适配审查

---

## 8. 变更留痕

### 8.1 四层分层

| 层 | 职责 | 机制 |
|----|------|------|
| 正文层 | 记录真实变更内容 | Changes / Logs / 子库 CHANGELOG / 子库 reports |
| 索引层 | 串联正文来源 | Agent Change Index / Library Registry / Routing Rules / Access Boundary |
| 触发层 | 判断谁需要知道 | Daily Update / Weekly Digest / Re-onboarding Trigger / JR Review |
| 对齐层 | 确认已学习/已签收 | Signature Enforcement / Receipt Tracker / Agent 回执 |

### 8.2 新机制前置审查门槛

本图是新增/修改治理机制前的前置检查依据。任何新机制提案，必须先说明所属层级、与既有机制的关系、是否替代或重复、退出/合并路径。未通过分层图审查的新机制提案，不予批准。

> **执行细则**：分层图详见 `Universe/99_System/Governance/Universe_Mechanism_Layer_Map_v0.2.md`（跨库机制分层总览，§7 使用规则为审查门槛 canonical）。

---

## 9. 红线

1. **Universe 不侵入各库内部治理**
2. **各库不重复 Universe 已有机制**
3. **内容定位与权限边界必须分开登记**
4. **专用子库已承接主档时，Nebula 不再并行维护同类主档**
5. **新增机制前必须先做机制适配审查**
6. **Agent Change Index 只做索引，不承载正文**
7. **权限边界不等于脱离 Universe**

---

## 10. 与 Nebula Blueprint v12.x 的兼容关系

| 项目 | Nebula Blueprint v12.x | Universe Blueprint v0.2 |
|------|----------------------|------------------------|
| **状态** | active（Nebula 专属 canonical） | active（跨库治理 canonical） |
| **定位** | Nebula 组件专属规则 + 历史兼容依据 | 跨库治理总纲 |
| **管辖范围** | Nebula 内部专属事项 | 跨 Nebula/NEXUS/ETERNA/Cluster |
| **当前关系** | Nebula 专属事项以此为准 | 跨库治理冲突以此为准 |
| **未来关系** | 持续作为 Nebula 专属规则 | 等 ETERNA/Ark/迁移/学习稳定后考虑 v1.0 |

**兼容规则**：
1. Universe Blueprint v0.2 为跨库治理 canonical，凡跨库治理冲突以此为准
2. Nebula Blueprint v12.x 继续作为 Nebula 专属 canonical + 历史兼容依据
3. 凡 Nebula 专属事项仍按 Nebula v12.x 及后续 Nebula Component 规则执行
4. v12.x 中 79% 章节可直接继承到 Universe Blueprint（详见继承矩阵）
5. v12.x 中 6 个章节需要改写（详见继承矩阵）
6. 不急于将 Universe 推到 v1.0；等 ETERNA、Ark、首批跨库治理件迁移和定向 agent 学习稳定后再考虑

---

## 11. 版本说明

| 版本 | 日期 | 变更 |
|------|------|------|
| v0.1 | 2026-08-05 | 初始草案，Phase 1 产出 |
| v0.1.1 | 2026-08-05 | 修正 Event 路由、Nebula 定位、ETERNA 措辞、Ark 措辞；Phase 1 审定修订 |
| v0.2 | 2026-08-06 | 正式生效为跨库治理 canonical；§0 重写为过渡口径；§4.3 ETERNA 标 provisional；§5.3 Ark 标 Runtime Pending；§10 兼容关系更新 |
| v0.3 | 2026-08-08 | 最小补丁（R 批准，珍珍审定）：§4.2 NEXUS 定位更新为汇承团队业务公域 / 协作执行组件；新增 canonical 六层 + 代码治理/运行域分离表述；NEXUS_System/ → 99_NEXUS_System/ |

---

*Universe Blueprint v0.2 · 2026-08-06 · 正式生效 · 跨库治理 canonical*
*Nebula Blueprint v12.x 继续作为 Nebula 专属 canonical + 历史兼容依据。*