简述
节点是这个站的基本单位。笔记是节点,术语也是节点——它们在数据模型里是同一种东西,只靠 node_type 区分。
详解
每个节点有一个永不改变的 uid 当身份,一个 slug 当 URL。正文是 markdown,写在 content/ 下,交给 Git 管历史。节点之间有三类边:作者手写的 双链、正文里自动命中的术语提及、术语之间的 is_a 层级。这些边合起来就是知识图谱。
深化
“节点”是从 btree 借来的:数据库索引用树的节点把查找具象化,这里用图的节点把知识具象化。一个刻意的决定是让笔记和术语共用一张 nodes 表——知识本来就没有”文章”和”词条”的硬边界,一段话既可能是笔记主体,也可能是某个术语的详解。同一张表、同一套版本和批注,省掉了两套并行代码。节点是投影:nodes 表随时能用 ingest —rebuild 从 md 重建,md+Git唯一源 才是根。