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:
parent
070b11ac54
commit
920b6bf690
1 changed files with 41 additions and 3 deletions
|
|
@ -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 开源许可,允许参考和学习
|
||||
|
|
@ -389,16 +426,17 @@ Outline 实现:
|
|||
⊢ 光湖不跟踪 Outline 的更新
|
||||
⊢ 光湖按自己的节奏和标准实现知识库模块
|
||||
⊢ 所有注册到灯塔的模块由光湖主控
|
||||
⊢ Git 是知识库模块的底层存储与版本引擎
|
||||
⊢ 本文档是样本学习记录,不是集成方案
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5 · 时间锚定
|
||||
## 6 · 时间锚定
|
||||
|
||||
```
|
||||
文档: OUTLINE-SAMPLE-COMPONENT-CARDS · 知识库模块样本拆解
|
||||
版本: v1.0
|
||||
版本: v1.1(增补 §4 Git 引擎架构决策)
|
||||
创建: 2026-08-08 · 铸渊 ICE-P-ZY001
|
||||
主权者: 冰朔 ICE-GL∞
|
||||
样本源: Outline v0.80.2 · BS-SG-001 新加坡大脑
|
||||
|
|
|
|||
Loading…
Reference in a new issue