# GLS-0018 · 单一真相源与多知识库同步规范 v1.0

## 文档定位

本规范定义代码仓库、Notion、ima、Tolaria 以及其他镜像知识库之间的权威关系、同步方向、冲突处理、迁移规则和验证机制。

核心原则：

> 同一份正式定义只能有一个当前权威正文；其他位置都是镜像、索引、工作副本或运行时缓存。
> 

---

## 1. 推荐角色分工

```
代码仓库
└── Canonical Source · 正式定义与版本事实源

ima
└── Retrieval Mirror · 人类阅读与 AI 检索知识库

Notion
└── Evolution Workspace · 历史、协作、草稿与演化记录

Tolaria
└── Runtime Store · 运行加载、检查点与执行状态
```

在代码仓库完成迁移前，可暂时指定 Notion 或 ima 为权威源，但必须登记迁移状态。

---

## 2. 文档状态

```
DRAFT       草稿
REVIEW      评审中
CANDIDATE   候选正式版
STABLE      当前正式版
MIRROR      镜像
RUNTIME     运行副本
DEPRECATED  已废弃
ARCHIVED    历史归档
```

---

## 3. Source Manifest

```yaml
source_manifest:
  object_id: "GLS-0300"
  version: "1.0.0"
  status: "STABLE"

  canonical:
    source_type: "repository"
    uri: ""
    branch: "main"
    commit: ""

  mirrors:
    - source_type: "notion"
      uri: ""
      sync_mode: "manual | automatic"
    - source_type: "ima"
      uri: ""
      sync_mode: "manual | automatic"

  runtime:
    uri: ""
    loaded_version: ""

  integrity:
    checksum: ""
    updated_at: ""
    verified_at: ""
```

---

## 4. 同步方向

标准同步链：

```
草稿产生于 Notion
→ 人工整理与评审
→ 写入代码仓库
→ 仓库版本发布
→ 同步到 ima
→ Tolaria 拉取已发布版本
```

正式版本发布后，镜像中的直接修改不得自动反向覆盖代码仓库。

---

## 5. 同步事件

```
SOURCE-CREATED
SOURCE-UPDATED
SOURCE-PUBLISHED
MIRROR-SYNCED
MIRROR-STALE
CONFLICT-DETECTED
MIGRATION-STARTED
MIGRATION-COMPLETED
RUNTIME-LOADED
VERIFICATION-FAILED
```

所有正式同步事件应写入 HLDP。

---

## 6. 冲突处理

发生内容冲突时：

```
比较 object_id
→ 比较版本号
→ 比较 canonical 标记
→ 比较 commit/checksum
→ 判断是否为未发布草稿
→ 保留双方内容
→ 建立冲突记录
→ 人工确认合并结果
```

不得静默覆盖，不得仅凭最后修改时间决定权威性。

---

## 7. 内容分层

```
Normative
└── 正式规范，必须进入权威源

Explanatory
└── 说明、教程，可存在多个镜像

Historical
└── 演化记录，由 HLDP 保留

Runtime
└── 检查点与运行状态，不得当作规范正文

Personal/Private
└── 按权限隔离，不进入公共镜像
```

---

## 8. 迁移规则

知识从 Notion/ima 迁入仓库时：

```
建立对象编号
→ 确认当前版本
→ 确认旧页面来源
→ 去重但不删除历史
→ 写入标准路径
→ 生成 checksum
→ 更新 Registry
→ 标记镜像地址
→ 发布迁移完成事件
```

---

## 9. 同步验证

每次同步至少验证：

```
编号一致
标题一致
版本一致
正文 checksum 一致
依赖链接有效
状态一致
权威源唯一
镜像更新时间明确
```

---

## 10. 防止知识库“越同步越乱”

- 不允许多个平台同时作为正式编辑源；
- 不允许复制后失去原始编号；
- 不允许把运行日志混入协议正文；
- 不允许旧版镜像覆盖新版；
- 不允许因为页面更新时间较新就认定内容更新；
- 不允许删除冲突内容来假装同步成功；
- 不允许 AI 自行决定不可逆合并。

---

## 11. 最终定义

> 单一真相源与多知识库同步规范，负责保证光湖语言世界在多平台迁移、检索、协作和运行过程中始终知道：哪一份是当前正式事实，哪一些只是副本，以及发生冲突时该如何安全处理。
>