深色模式
知识库设计与使用手册
本区文档不参与站内搜索。内容是知识库自身的设计依据与操作说明, 与知识库条目分属两个层面。
操作说明
设计依据
分类体系
8 大类 / 27 主题域 / 311 技法簇的划分依据、边界约定与查询路径。 记录为什么这样分类,以及 v1 体系的哪些问题促成了当前设计。
设计文档原子单元约定
原子知识单元的判定标准、已实现的 frontmatter 字段、引用 ID 格式, 以及被否决的方案及其理由。
设计文档两类文档的分工
| 操作说明 | 设计依据 | |
|---|---|---|
| 回答的问题 | 怎么写、字段填什么 | 为什么这样设计 |
| 读者 | 正在写文章的自己 | 半年后想改结构的自己 |
| 变更频率 | 跟随实现变化 | 只在设计决策变更时改 |
| 与实现的关系 | 必须与代码一致 | 可以记录未实现的方案,需标注 |
设计文档里标注为「未实现」的章节是刻意保留的:它们记录了考虑过但否决的方案, 避免日后重复讨论同一个问题。