# Universe Mechanism Layer Map v0.2

> **定位**：跨库机制分层总览，不新增机制，只梳理关系
> **执行**：Universe Blueprint v0.2 §8（变更留痕）；本图是"新增/修改治理机制前的前置审查依据"
> **审定人**：珍珍（zhenzhen）
> **维护人**：小宝（xiaobao）
> **日期**：2026-08-07
> **状态**：active（跨库 canonical）
> **继承**：由 Nebula_System_Mechanism_Layer_Map v0.1.1（2026-08-03）跨库重构升级；治理范围从 Nebula 升格为 Universe

---

## 0. 机制关系边界

| 文件 | 职责 | 替代关系 |
|------|------|----------|
| **本图（Universe Mechanism Layer Map）** | 跨库机制分层总览（正文/索引/触发/对齐四层 + 串联链路 + 红线 + 前置审查门槛） | 不替代任何机制实体 |
| **Nebula/Rules/Governance_Mechanisms_Index.md** | **Nebula 组件专属机制索引**（执行循环/成长箱/任务路由/写入门控/目录治理等 Nebula 内部机制） | 不替代跨库分层图 |
| **Universe Blueprint §8** | 宪法级四层简表 + 前置审查门槛条款 | 本图是它的执行细则 |

**二者不互相替代**：Universe 图管跨库分层，Nebula 索引管 Nebula 专属机制。

---

## 1. 核心原则

**正文归正文，索引归索引，触发归触发，对齐归对齐。**

不允许一个机制同时承担所有职责，也不允许新增机制覆盖已有机制。

---

## 2. 分层表

### 2.1 正文层 — 记录真实变更内容

负责保存详细事实，不负责全局汇总。

| 机制 | 路径 | 主职责 | 不负责什么 |
|------|------|--------|-----------|
| **Universe Changes** | `Universe/99_System/Changes/` | Universe 级系统变更记录（审计报告、口径补丁、封板记录、Fit Review 等） | 不做每日总索引，不替代子库日志 |
| **Agent Change Index（索引子层）** | `Universe/99_System/Changes/Agent_Change_Index/` | 跨 agent / 跨子库变更索引桥（见 2.2 索引层） | 不写正文 |
| **Nebula Component Changes / Logs** | `Nebula/99_System/Changes/`、`Nebula/99_System/Logs/` | **Nebula 组件专属**：Nebula 内部系统变更记录、迁移/操作/执行过程日志 | 不做跨库总览，不替代子库日志 |
| **子库 CHANGELOG** | `BoA/BoA_System/CHANGELOG.md` 等 | 子库本地变更日志 | 不替代 Universe 总控索引 |
| **子库 reports** | `BoA/BoA_System/` 下各报告 | 阶段性报告与封板记录 | 不作为长期路由规则 |

**现状**：
- Universe Changes：Phase 2 迁移记录 + 机制文件（P2-1 ~ P2-7）
- Agent Change Index：试运行中，已有 2026-08-02 起每日样本
- Nebula Changes / Logs：历史变更与操作记录（时间跨度 2026-05 至今）
- 子库 CHANGELOG：目前 BoA 有正式 CHANGELOG

---

### 2.2 索引层 — 让大家知道发生了什么

负责串联正文来源，不重复写正文。

| 机制 | 路径 | 主职责 | 不负责什么 |
|------|------|--------|-----------|
| **Agent Change Index** | `Universe/99_System/Changes/Agent_Change_Index/` | 跨 agent / 跨子库变更索引桥 | 不写正文，不替代 Changes / CHANGELOG |
| **Library Registry** | `Universe/99_System/Registry/Library_Registry.md` | 子库定位、权限、主档范围登记 | 不做日常变更日志 |
| **Components Registry** | `Universe/99_System/Registry/Components_Registry.md` | 一级组件（Nebula/NEXUS/ETERNA/Cluster）边界登记 | 不做日常变更日志 |
| **Agent Capability Registry** | `Universe/99_System/Registry/Agent_Capability_Registry.md` | agent 能力登记层（身份以 AGENT_REPORT 为准） | 不生成 agent_id |
| **Content Routing Rules** | `Universe/99_System/Governance/Universe_Content_Routing_Rules_v0.2.md` | 内容去向与主档归属规则 | 不记录每天谁改了什么 |
| **Access Boundary** | `Universe/99_System/Governance/Universe_Library_Access_Boundary_v0.2.md` | 权限边界、可读可写与审定权 | 不承担内容主档判断全文 |
| **Skill Naming Rules** | `Universe/99_System/Governance/Rules/Universe_Skill_Naming_Rules_v0.2.md` | 跨库 canonical skill 命名规则 | 不替代 skill 实现本体 |

**现状**：
- 索引层全部机制均已迁入 Universe canonical 路径（P2-1 ~ P2-6 封板）
- Nebula 旧位均为兼容 pointer / 历史入口

---

### 2.3 触发层 — 判断谁需要知道

负责把变更转成通知、学习、复核动作。

| 机制 | 路径 | 主职责 | 不负责什么 |
|------|------|--------|-----------|
| **Daily Universe Update** | `Nebula/99_System/Agents/Onboarding/Agent_Daily_Universe_Update_Template_v0.1.md` | 每日告诉 agent 必须知道的增量 | 不做原始变更正文 |
| **Weekly Re-onboarding Digest** | `Nebula/99_System/Agents/Onboarding/Agent_Weekly_ReOnboarding_Digest_Template_v0.1.md` | 周更汇总与对齐建议 | 不替代 Changes / Index |
| **Re-onboarding Trigger Rules** | `Nebula/99_System/Agents/Onboarding/ReOnboarding_Trigger_Rules_v0.1.md` | 判断是否触发强制再入职 | 不负责写变更正文 |
| **JR Review / 珍珍审定** | 无独立文件，由各机制标记触发 | 对高影响变更做最终判断 | 不做日常流水汇总 |

**现状**：
- Daily Update：模板已有，引用 Agent Change Index（§0 参考索引）
- Weekly Digest：模板已有
- Re-onboarding Trigger Rules：v0.1，已含 8 条触发条件（含 Index 标记触发）
- JR Review：散布在各机制的 `requires_jr_review` 标记中

> 注：触发层/对齐层机制为 **Universe 级**（服务所有 agent），文件当前保留在 Nebula Onboarding 目录，属后续候选审查项。

---

### 2.4 对齐层 — 确认 agent 已学习 / 已签收

负责验收，不负责记录所有变更。

| 机制 | 路径 | 主职责 | 不负责什么 |
|------|------|--------|-----------|
| **Signature Enforcement** | `Nebula/99_System/Agents/Onboarding/Signature_Enforcement_Rule_v0.1.md` | 签名硬门槛 | 不判断内容是否正确 |
| **Receipt Tracker** | `Nebula/99_System/Agents/Onboarding/Agent_Universe_Update_Receipt_Tracker_20260731.md` | 记录谁已签收、谁未签收 | 不替代学习材料正文 |
| **Agent 回执** | `Nebula/99_System/Agents/Onboarding/Agent_Update_Acknowledgement_Template.md` | agent 学习确认 | 不作为系统规则源 |

**现状**：
- Signature Enforcement：v0.1，硬门槛规则
- Receipt Tracker：2026-07-31 版本，追踪 agent 的 Universe Update 签收状态
- Agent 回执：模板已有，含 agent_id / agent_name / signed_at 签名字段

---

## 3. 串联链路

### 3.1 系统级变更链路

```
系统文件修改（Blueprint / Rules / Agent Registry / 治理文件）
  ↓
写入 Universe Changes 或组件专属 Changes（详细变更记录）
  ↓
回挂 Agent Change Index（索引 + change_type + 触发标记）
  ↓
判断 → requires_daily_update: true → 进入 Daily Update
  ↓
判断 → requires_reonboarding: true → 进入 Re-onboarding Trigger
  ↓
判断 → requires_signature: true → 进入 Signature / Receipt
  ↓
判断 → requires_jr_review: true → 提交珍珍审定
```

### 3.2 子库变更链路

```
子库内变更（目录合并/删除/新增、主档修改、治理执行）
  ↓
写入子库 CHANGELOG / reports（本地详细日志）
  ↓
若影响路由/权限/主档归属 → 回挂 Agent Change Index
  ↓
必要时更新 Library Registry / Routing Rules / Access Boundary
  ↓
Daily / Weekly Update 摘要提示
```

### 3.3 Skill 变更链路

```
Skill 新增 / 同步 / deprecated / 删除
  ↓
写入 skill source-of-truth 变更记录
  ↓
回挂 Agent Change Index（change_type: skill）
  ↓
判断是否需要 agent 学习
  ↓
必要时进入 Re-onboarding / Signature
```

### 3.4 内容路由链路

```
新增内容产生
  ↓
判断 → 是否有专用子库承接？
  ↓
  是 → 写入子库主档，Nebula 不并行维护
  否 → 写入 Nebula 对应目录
  ↓
若需降级旧文件 → 按 Content_Routing_Rules §6 执行
  ↓
回挂 Agent Change Index（change_type: content / routing）
```

---

## 4. 红线

1. **Agent Change Index 只做索引，不承载正文。**
2. **Daily Update 只做每日增量摘要，不替代 Changes。**
3. **子库 CHANGELOG 只记录子库本地详细变化，不替代 Universe 总控。**
4. **Changes/ 记录系统级详细变更，不做跨 agent 总览。**
5. **新增机制前必须先做机制适配审查，不允许直接另起炉灶。**
6. **权限边界和内容定位必须分开登记。**
7. **专用子库已承接主档时，Nebula 不再并行维护同类主档，只保留路由入口、历史说明、外部资料或跨业务关联。**

---

## 5. 重叠/命名误导检查

| 机制 | 重叠点 | 建议修正 | 是否立即改 |
|------|--------|----------|-----------|
| Nebula 专属 Logs 与 Universe Changes | Logs 是 Nebula 组件专属过程日志，Changes 是系统级结论记录 | 明确：过程日志→组件 Logs，结论/封板→Changes | 否（边界已在本图 2.1 写清） |
| Governance_Mechanisms_Index 与本图 | 都是"机制索引"类 | 明确：Nebula 专属机制索引 vs 跨库分层总览，互不替代 | ✅ 已在本图 §0 写清 |
| 子库 reports 与 CHANGELOG | 部分子库把阶段性报告写入 CHANGELOG，部分单独存放 | 明确：日常变更→CHANGELOG，阶段性报告→reports/ | 否（当前仅 BoA 有正式 CHANGELOG，样本不足） |
| Agent Change Index 与 Changes | Index 条目含 summary，可能被误当成变更正文 | Rules 已明确硬边界，观察是否有人越界 | 否（试运行观察） |
| Daily Update 与 Weekly Digest | 两个触发机制的时间粒度不同，但内容可能重叠 | 明确：Daily=当日增量，Weekly=周度汇总+对齐建议 | 否（模板已有区分） |

---

## 6. 待观察项

| 观察项 | 观察周期 | 判断标准 |
|--------|----------|----------|
| Agent Change Index 是否被误用 | 3-7 天 | 是否有人把正文写入 Index / 把非实质动作记入 |
| change_type 是否足够 | 3-7 天 | 是否出现无法归类的变更类型 |
| 子库 CHANGELOG 回挂是否顺畅 | 1-2 周 | BoA CHANGELOG 是否有遗漏回挂的变更 |
| Daily Update 准确度 | 1-2 周 | agent 反馈是否有遗漏或噪音 |
| 触发层/对齐层机制归属 | 观察期 | Onboarding 机制文件是否需随后续候选迁入 Universe |

---

## 7. 使用规则（新机制前置审查门槛 · canonical）

**本图是新增/修改治理机制前的前置检查依据。** 任何新机制提案，必须先说明：

1. **所属层级**：它属于正文层 / 索引层 / 触发层 / 对齐层？
2. **与既有机制的关系**：是否已有机制承接相同职能？
3. **是否替代或重复**：会不会覆盖 Changes / CHANGELOG / Index / Daily Update / Signature？
4. **退出/合并路径**：如果后续发现冗余，如何合并或废弃？

**未通过分层图审查的新机制提案，不予批准。**

> 定位依据：Universe Blueprint v0.2 §8.2（宪法条款）引用本图 §7（执行细则）。双向可定位。

---

## 8. 版本说明

| 版本 | 日期 | 变更 |
|------|------|------|
| v0.1 | 2026-08-03 | 初始版本（Nebula System 机制分层图，基于现有机制盘点） |
| v0.1.1 | 2026-08-03 | 补 §7 使用规则：新增机制前的前置检查依据（R 审定） |
| v0.2 | 2026-08-07 | **跨库重构升级**（P2-7）：治理范围从 Nebula 升格为 Universe；正文层拆 Universe Changes + Nebula Component 专属层；索引层全部指向已迁 Universe canonical；新增 §0 与 Nebula Governance_Mechanisms_Index 边界说明；Nebula 原图冻结为历史指针（备份：`Nebula/99_System/Changes/.backup/`） |

---

*Universe Mechanism Layer Map v0.2 · 2026-08-07 · active（跨库 canonical）*
*执行 Universe Blueprint v0.2 §8；Nebula 组件专属机制索引见 Governance_Mechanisms_Index.md。*