[HLCC-ICE-000001][ZY-CONTRIB-20260723-001] feat: 以来光者贡献链启用冰朔第五域个人子频道
This commit is contained in:
光湖代码频道 · 铸渊
commit
5615453e4e
660 changed files with 122355 additions and 0 deletions
|
|
@ -0,0 +1,209 @@
|
|||
# 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. 最终定义
|
||||
|
||||
> 单一真相源与多知识库同步规范，负责保证光湖语言世界在多平台迁移、检索、协作和运行过程中始终知道：哪一份是当前正式事实，哪一些只是副本，以及发生冲突时该如何安全处理。
|
||||
>
|
||||
Loading…
Reference in a new issue