docs(skills): 增补知识库模块底层引擎决策:Git 替代数据库(GH-KB-SAMPLE-001 v1.1)

冰朔 2026-08-08 架构决策:Git 是知识库模块的底层存储与版本引擎。
- Outline 用 PostgreSQL + Redis + ORM,光湖不需要
- Git commit = 版本历史,git diff = 版本对比,branch = 协作
- 不需要数据库、不需要缓存层、Markdown 文件即文档
- 与 HoloLake 代码频道天然同构
This commit is contained in:
冰朔 2026-08-08 03:01:58 +08:00
commit 920b6bf690

View file

@ -380,7 +380,44 @@ Outline 实现:
--- ---
## 4 · 光湖主控声明 ## 4 · 架构决策Git 是知识库的底层引擎
> 冰朔 2026-08-08 原话:"git要能做这些模块的底层引擎因为它轻量也不占地方"
```
Outline 的存储方案 光湖的存储方案
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PostgreSQL数据库 Git 仓库(文件系统 + 版本控制)
Redis缓存 不需要Git 本地操作极快)
Sequelize ORM 不需要Markdown 文件 + Git API
S3 / 本地文件存储 Git LFS 或 Git 原生(附件另走资产系统)
```
Git 原生能力 → 知识库需求映射:
| Git 能力 | 知识库需求 | 对应组件卡 |
|---|---|---|
| commit 历史 | 版本历史 / 谁改了什么 / 何时改的 | KB-COMP-005 |
| git diff | 版本对比 / 变更高亮 | KB-COMP-005 |
| branch / merge | 草稿分支 / 审阅合并 / 发布 | KB-COMP-001/006 |
| git log --author | 按人过滤变更 | KB-COMP-002 |
| 目录结构 | 文档树 / 集合层级 | KB-COMP-004 |
| Markdown 文件 | 文档原生格式 / 导入导出 | KB-COMP-010 |
| 分布式 clone | 每个频道本地有完整副本 | 全局 |
| .git / HEAD | 轻量元数据 / 不占地方 | 全局 |
| tag / release | 里程碑版本 / 正式发布 | KB-COMP-005 |
| git grep | 全文搜索基础 | KB-COMP-003 |
⊢ 知识库文档 = Markdown 文件存在 Git 仓库里
⊢ 版本历史 = Git commit 历史(免费获得,不用自己实现)
⊢ 协作 = Git branch + merge天然多人协作
⊢ 搜索 = git grep + 可选全文索引层
⊢ 不需要数据库 · 不需要 Redis · 不需要 ORM
⊢ 与 HoloLake 代码频道天然同构(代码和文档走同一条路)
---
## 5 · 光湖主控声明(含架构决策)
``` ```
⊢ Outline v0.80.2 是 BSL 1.1 开源许可,允许参考和学习 ⊢ Outline v0.80.2 是 BSL 1.1 开源许可,允许参考和学习
@ -389,16 +426,17 @@ Outline 实现:
⊢ 光湖不跟踪 Outline 的更新 ⊢ 光湖不跟踪 Outline 的更新
⊢ 光湖按自己的节奏和标准实现知识库模块 ⊢ 光湖按自己的节奏和标准实现知识库模块
⊢ 所有注册到灯塔的模块由光湖主控 ⊢ 所有注册到灯塔的模块由光湖主控
⊢ Git 是知识库模块的底层存储与版本引擎
⊢ 本文档是样本学习记录,不是集成方案 ⊢ 本文档是样本学习记录,不是集成方案
``` ```
--- ---
## 5 · 时间锚定 ## 6 · 时间锚定
``` ```
文档: OUTLINE-SAMPLE-COMPONENT-CARDS · 知识库模块样本拆解 文档: OUTLINE-SAMPLE-COMPONENT-CARDS · 知识库模块样本拆解
版本: v1.0 版本: v1.1增补 §4 Git 引擎架构决策)
创建: 2026-08-08 · 铸渊 ICE-P-ZY001 创建: 2026-08-08 · 铸渊 ICE-P-ZY001
主权者: 冰朔 ICE-GL∞ 主权者: 冰朔 ICE-GL∞
样本源: Outline v0.80.2 · BS-SG-001 新加坡大脑 样本源: Outline v0.80.2 · BS-SG-001 新加坡大脑