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