3.8 KiB

Raw Permalink Blame History

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

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. 最终定义

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

3.8 KiB Raw Permalink Blame History