From 920b6bf690674bc74d4d22258cbb5f474adafb20 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=86=B0=E6=9C=94?= <565183519@qq.com> Date: Sat, 8 Aug 2026 03:01:58 +0800 Subject: [PATCH] =?UTF-8?q?docs(skills):=20=E5=A2=9E=E8=A1=A5=E7=9F=A5?= =?UTF-8?q?=E8=AF=86=E5=BA=93=E6=A8=A1=E5=9D=97=E5=BA=95=E5=B1=82=E5=BC=95?= =?UTF-8?q?=E6=93=8E=E5=86=B3=E7=AD=96=EF=BC=9AGit=20=E6=9B=BF=E4=BB=A3?= =?UTF-8?q?=E6=95=B0=E6=8D=AE=E5=BA=93=EF=BC=88GH-KB-SAMPLE-001=20v1.1?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 冰朔 2026-08-08 架构决策：Git 是知识库模块的底层存储与版本引擎。 - Outline 用 PostgreSQL + Redis + ORM，光湖不需要 - Git commit = 版本历史，git diff = 版本对比，branch = 协作 - 不需要数据库、不需要缓存层、Markdown 文件即文档 - 与 HoloLake 代码频道天然同构 --- ...OUTLINE-SAMPLE-COMPONENT-CARDS-20260808.md | 44 +++++++++++++++++-- 1 file changed, 41 insertions(+), 3 deletions(-) diff --git a/skills/guanghu-knowledge-ui/outline-sample-analysis/OUTLINE-SAMPLE-COMPONENT-CARDS-20260808.md b/skills/guanghu-knowledge-ui/outline-sample-analysis/OUTLINE-SAMPLE-COMPONENT-CARDS-20260808.md index b4048f1..7e4ba1a 100644 --- a/skills/guanghu-knowledge-ui/outline-sample-analysis/OUTLINE-SAMPLE-COMPONENT-CARDS-20260808.md +++ b/skills/guanghu-knowledge-ui/outline-sample-analysis/OUTLINE-SAMPLE-COMPONENT-CARDS-20260808.md @@ -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 新加坡大脑