2.8 KiB
2.8 KiB
数据真相源 · Truth Source Federation · v3.0
定义仓库、Notion、大脑记忆三方数据的权威来源和冲突解决优先级。
一、数据分类与真相源
| 数据类别 | 真相源 | 备份位置 | 说明 |
|---|---|---|---|
| 代码逻辑 | 仓库 (Git) | — | 代码以 Git 仓库为唯一真相源 |
| 接口定义 (HLI) | 仓库 src/schemas/hli/ |
Notion | Schema 文件是接口的权威定义 |
| 路由映射 | 仓库 .github/brain/routing-map.json |
Notion | 路由表由仓库自动生成 |
| 开发者进度 | Notion | 仓库 dev-status.json |
Notion 是进度管理主平台 |
| 项目规划 | Notion | 仓库 docs/ |
Notion 是规划管理主平台 |
| 铸渊身份 | 仓库 .github/brain/memory.json |
persona-brain | 身份定义以仓库为准 |
| 铸渊人格风格 | 仓库 .github/persona-brain/system-prompt.md |
— | 风格定义以文件为准 |
| 团队成员 | 仓库 .github/brain/collaborators.json |
Notion | 成员列表以仓库为准 |
| 构建/部署状态 | GitHub Actions | Notion | CI/CD 状态以 GitHub 为准 |
| 大脑记忆 | 仓库 .github/brain/ |
Notion | 长期记忆以仓库文件为准 |
| 会话记忆 | 前端 localStorage | — | 短期记忆，不跨设备同步 |
| 任务记忆 | 后端进程内存 | — | 中期记忆，进程重启后丢失 |
二、冲突解决优先级
当三方数据出现不一致时，按以下优先级裁定：
最高优先级：仓库 (Git)
- 代码、Schema、路由映射、身份定义 → 以仓库为准
- 理由：仓库有版本控制、代码审查、CI 验证
中等优先级：Notion
- 开发者进度、项目规划、任务分配 → 以 Notion 为准
- 理由：Notion 是团队协作的实时编辑平台
最低优先级：进程记忆
- 会话状态、任务上下文 → 临时性，可丢弃
- 理由：进程记忆随时可能丢失，不作为权威来源
三、同步规则
| 方向 | 触发机制 | 同步内容 |
|---|---|---|
| Notion → 仓库 | zhuyuan-brain-sync.yml 工作流 |
开发者进度 → dev-status.json |
| 仓库 → Notion | esp-signal-processor.yml 工作流 |
CI 结果、部署状态 |
| 仓库 → 仓库 | update-repo-map.yml 工作流 |
文件变更 → repo-map.json |
| 仓库 → persona-studio | 跨仓库同步 | brain/ 核心文件 |
四、禁止事项
- ❌ 禁止在 Notion 中修改代码逻辑定义（必须通过 PR）
- ❌ 禁止在仓库中手动编辑
dev-status.json（由同步工作流维护） - ❌ 禁止三方数据长期不同步（超过 24 小时必须触发同步）
- ❌ 禁止跳过冲突解决直接覆盖（必须确认优先级后再操作）
真相源联邦协议 v3.0 · 2026-03-10 · 冰朔设计 · 铸渊落地