{ "schemaVersion": "0.11.0", "canonical": "https://www.pystone.net/notes/knowledge-network-build-rules/", "atlas": "https://www.pystone.net/?node=knowledge-network-build-rules#knowledge-atlas", "markdown": "https://www.pystone.net/notes/knowledge-network-build-rules.md", "context": "https://www.pystone.net/notes/knowledge-network-build-rules.context.json", "knowledgeVersion": "224c990773de.5fa8af6e39fa", "build": { "siteCommit": "224c990773de166d23a886306577dd90379529ce", "notesCommit": "5fa8af6e39fa3891d1b9b4832bfa6c4e0ecaaf0a", "builtAt": "1970-01-01T00:00:00.000Z", "version": "224c990773de.5fa8af6e39fa" }, "id": "note:knowledge-network-build-rules", "slug": "knowledge-network-build-rules", "title": "知识网络构建规则", "type": "note", "visibility": "public", "idStability": "rename-stable", "author": { "name": "Perrin Yong", "profile": "https://www.pystone.net/profile/" }, "publisher": { "name": "Perrin Yong", "profile": "https://www.pystone.net/profile/" }, "aliases": [], "summary": "知识网络构建规则", "contentRole": "guide", "sourceType": "guide", "isMoc": false, "mocRecognition": "none", "mocScope": "vault", "generated": false, "attribution": "unspecified", "domain": "00-总览与索引", "tags": [], "mocs": [], "contentHash": "d719194fb574ff23075ec892356f9422f12e4f03a8175636c6e0c4e42c91a158", "assets": [], "headings": [ { "depth": 1, "text": "知识网络构建规则", "anchor": "知识网络构建规则", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E7%9F%A5%E8%AF%86%E7%BD%91%E7%BB%9C%E6%9E%84%E5%BB%BA%E8%A7%84%E5%88%99" }, { "depth": 2, "text": "两套结构各司其职", "anchor": "两套结构各司其职", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E4%B8%A4%E5%A5%97%E7%BB%93%E6%9E%84%E5%90%84%E5%8F%B8%E5%85%B6%E8%81%8C" }, { "depth": 2, "text": "知识演化层", "anchor": "知识演化层", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E7%9F%A5%E8%AF%86%E6%BC%94%E5%8C%96%E5%B1%82" }, { "depth": 3, "text": "第二层识别约定", "anchor": "第二层识别约定", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E7%AC%AC%E4%BA%8C%E5%B1%82%E8%AF%86%E5%88%AB%E7%BA%A6%E5%AE%9A" }, { "depth": 2, "text": "链接必须带有关系", "anchor": "链接必须带有关系", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E9%93%BE%E6%8E%A5%E5%BF%85%E9%A1%BB%E5%B8%A6%E6%9C%89%E5%85%B3%E7%B3%BB" }, { "depth": 2, "text": "笔记粒度", "anchor": "笔记粒度", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E7%AC%94%E8%AE%B0%E7%B2%92%E5%BA%A6" }, { "depth": 2, "text": "MOC 的维护方式", "anchor": "moc-的维护方式", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#moc-%E7%9A%84%E7%BB%B4%E6%8A%A4%E6%96%B9%E5%BC%8F" }, { "depth": 2, "text": "Obsidian 使用建议", "anchor": "obsidian-使用建议", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#obsidian-%E4%BD%BF%E7%94%A8%E5%BB%BA%E8%AE%AE" }, { "depth": 2, "text": "自动一致性校验", "anchor": "自动一致性校验", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E8%87%AA%E5%8A%A8%E4%B8%80%E8%87%B4%E6%80%A7%E6%A0%A1%E9%AA%8C" } ], "claims": [], "outgoing": [ { "id": "note:knowledge-network-navigation", "title": "知识网络导航", "url": "https://www.pystone.net/notes/knowledge-network-navigation/", "atlas": "https://www.pystone.net/?node=knowledge-network-navigation#knowledge-atlas", "label": "库级枢纽", "origin": "explicit", "humanReviewed": true, "context": "本库采用四级导航结构：库级枢纽 → 领域 MOC → 跨领域主题 MOC → 知识笔记。集合 MOC 保证可达性，主题 MOC 表达真正的知识关系。这里的导航级别不同于“知识底座—知识演化层”的两层知识架构。", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E4%B8%A4%E5%A5%97%E7%BB%93%E6%9E%84%E5%90%84%E5%8F%B8%E5%85%B6%E8%81%8C" }, { "id": "note:software-delivery-automation-quality", "title": "软件交付、自动化与工程质量", "url": "https://www.pystone.net/notes/software-delivery-automation-quality/", "atlas": "https://www.pystone.net/?node=software-delivery-automation-quality#knowledge-atlas", "label": "持续交付系统", "origin": "explicit", "humanReviewed": true, "context": "例如，“自动化测试是 持续交付系统 的反馈环节”，比单独放置一个裸链接更有信息量。", "citation": "https://www.pystone.net/notes/knowledge-network-build-rules/#%E9%93%BE%E6%8E%A5%E5%BF%85%E9%A1%BB%E5%B8%A6%E6%9C%89%E5%85%B3%E7%B3%BB" } ], "incoming": [ { "id": "note:software-quality-as-feedback-system", "title": "软件质量为什么是反馈系统而不是测试阶段", "url": "https://www.pystone.net/notes/software-quality-as-feedback-system/", "atlas": "https://www.pystone.net/?node=software-quality-as-feedback-system#knowledge-atlas", "label": "软件质量为什么是反馈系统而不是测试阶段", "origin": "explicit", "humanReviewed": true, "context": "公开库对照显示，裸属性扫描返回 6 个节点，其中 1 个是模板；使用 后保留工作台和 4 篇真实综合共 5 个节点，只排除模板。Obsidian 官方资料确认 Search 支持属性、路径和否定条件，Graph 过滤与分组复用 Search 语法。提交 [](https://github.com/PerrinYong/my-notes/commit/2ef0", "citation": "https://www.pystone.net/notes/software-quality-as-feedback-system/#%E5%BD%A2%E6%88%90%E5%90%8E%E8%AF%AD%E4%B9%89%E8%A7%92%E8%89%B2%E6%A0%A1%E5%87%86%E6%A8%A1%E6%9D%BF%E5%B1%9E%E6%80%A7%E4%B8%8D%E7%AD%89%E4%BA%8E%E7%9F%A5%E8%AF%86%E5%AE%9E%E4%BE%8B" }, { "id": "note:knowledge-acquisition-organization-reuse", "title": "知识获取、整理与复用", "url": "https://www.pystone.net/notes/knowledge-acquisition-organization-reuse/", "atlas": "https://www.pystone.net/?node=knowledge-acquisition-organization-reuse#knowledge-atlas", "label": "知识获取、整理与复用", "origin": "explicit", "humanReviewed": true, "context": "知识网络构建规则把语义链接、证据边界与写回动作落实为可维护的知识网络规范。", "citation": "https://www.pystone.net/notes/knowledge-acquisition-organization-reuse/#%E6%A0%B8%E5%BF%83%E6%A6%82%E5%BF%B5" }, { "id": "note:knowledge-acquisition-organization-reuse", "title": "知识获取、整理与复用", "url": "https://www.pystone.net/notes/knowledge-acquisition-organization-reuse/", "atlas": "https://www.pystone.net/?node=knowledge-acquisition-organization-reuse#knowledge-atlas", "label": "知识获取、整理与复用", "origin": "explicit", "humanReviewed": true, "context": "一条内容是否已经成为知识，可以用三个问题检查：能否用自己的话解释；能否连接到已有概念；能否在新的问题中再次调用。相关操作规范见 知识网络构建规则。", "citation": "https://www.pystone.net/notes/knowledge-acquisition-organization-reuse/#%E5%A4%8D%E7%94%A8%E5%88%A4%E6%96%AD" }, { "id": "note:knowledge-network-navigation", "title": "知识网络导航", "url": "https://www.pystone.net/notes/knowledge-network-navigation/", "atlas": "https://www.pystone.net/?node=knowledge-network-navigation#knowledge-atlas", "label": "知识网络导航", "origin": "explicit", "humanReviewed": true, "context": "建网与链接规范：04-知识网络构建规则", "citation": "https://www.pystone.net/notes/knowledge-network-navigation/#%E7%9F%A5%E8%AF%86%E7%BD%91%E7%BB%9C%E5%AF%BC%E8%88%AA" }, { "id": "note:obsidian-search-properties-graph-groups-reference", "title": "Obsidian Search、属性查询与 Graph 分组官方资料摘录", "url": "https://www.pystone.net/notes/obsidian-search-properties-graph-groups-reference/", "atlas": "https://www.pystone.net/?node=obsidian-search-properties-graph-groups-reference#knowledge-atlas", "label": "Obsidian Search、属性查询与 Graph 分组官方资料摘录", "origin": "explicit", "humanReviewed": true, "context": "这一结论已写入知识网络构建规则，并在软件质量为什么是反馈系统而不是测试阶段中作为“相同表面语法、不同语义角色”的校准案例。若将来模板位置或识别方式改变，路径条件也必须同步复核；不能把当前路径约定误写成 Obsidian 的普遍语义规则。", "citation": "https://www.pystone.net/notes/obsidian-search-properties-graph-groups-reference/#%E5%AF%B9%E5%BD%93%E5%89%8D%E7%9F%A5%E8%AF%86%E5%BA%93%E7%9A%84%E9%80%82%E7%94%A8%E7%BB%93%E8%AE%BA" } ], "contentMarkdown": "# 知识网络构建规则\n\n## 两套结构各司其职\n\n- 文件树回答“笔记的主要角色和归档位置是什么”。一篇笔记只需要一个稳定位置。\n- 双向链接回答“这条知识与哪些概念、问题和实践相关”。一篇笔记可以同时属于多个关系网络。\n- MOC（Map of Content）是人工维护的认知地图，不是标签列表，也不是全文目录。\n- frontmatter `note_id` 回答“这篇笔记的对外稳定身份是什么”。它是标题语义翻译成的小写英文单词加连字符（全库唯一），作为博客 URL 后缀与图节点身份；笔记移动、改名都不更换它。它不参与库内 Obsidian 双链——库内链接仍按路径与标题解析。\n\n本库采用四级导航结构：[[03-知识网络导航|库级枢纽]] → 领域 MOC → 跨领域主题 MOC → 知识笔记。集合 MOC 保证可达性，主题 MOC 表达真正的知识关系。这里的导航级别不同于“知识底座—知识演化层”的两层知识架构。\n\n## 知识演化层\n\n- 知识底座中的既有笔记默认忠实原文，优先只做格式、资源引用、来源和语义链接维护；新的纠错、冲突、比较与综合优先通过知识演化层表达。\n- “知识演化层”是第二层的正式名称，维护持续更新的综合判断、证据边界、矛盾、开放问题和跨领域关系。\n- “知识编译”是定位、关联、对照、验证、综合、写回和校验这些内容的工程机制。\n- “知识发酵”描述知识长期相互作用并可能形成新认识的自然过程，不作为目录名或效果承诺。\n- 综合笔记分布在最合适的现有领域；库级入口只负责导航，不建立与现有知识域竞争的复制目录树。\n- 除库级 `05-知识演化.md` 系统入口外，主题 MOC 和具体综合笔记必须用真实主题或问题命名；`知识演化`、`知识编译` 和 `知识发酵` 不能替代具体主题名称成为通用 Graph 枢纽。\n\n### 第二层识别约定\n\n- 不为知识演化层建立独立领域目录，也不使用“综合-”“演化-”等前缀污染主题名称。\n- 综合笔记必须在属性中写明 `type: synthesis`、`layer: evolution`、`status: evolving`；库级工作台写明 `type: workspace` 与 `layer: evolution`。\n- 第一层不批量补 `layer: foundation`；未标记 `layer: evolution` 的既有笔记默认属于知识底座。\n- 综合笔记在标题后放置“知识演化层”说明块，让阅读者一眼知道本文维护的是基于多份底座材料形成的当前认识，而不是来源原文。\n- 在 Obsidian 搜索中输入 `[layer:evolution] -path:\"00-总览与索引/模板\"` 可以列出真实第二层笔记；在 Graph 的 Groups 中使用同一查询并指定颜色，可以在整体网络中辨认第二层节点。路径排除避免携带待复制 frontmatter 的综合模板成为假知识节点；查询仍只使用 Obsidian 原生属性与路径检索，不需要标签节点或额外插件。\n\n## 链接必须带有关系\n\n优先使用下面六类关系来写链接：\n\n- 上位：这篇笔记属于哪个更大的问题或主题。\n- 前提：理解当前结论前必须掌握什么。\n- 解释：哪个机制能够解释当前现象。\n- 对照：哪个观点、方案或案例与它形成差异。\n- 应用：这条知识在哪个工程、产品或决策中被使用。\n- 证据：哪个来源、实验或案例支撑这个判断。\n\n例如，“自动化测试是 [[知识网络/02-软件交付、自动化与工程质量|持续交付系统]] 的反馈环节”，比单独放置一个裸链接更有信息量。\n\n## 笔记粒度\n\n- 原始材料可以保持完整，但要连接“来源”和“待提炼主题”。\n- 稳定知识笔记尽量围绕一个可复述的核心判断，而不是机械追求篇幅短小。\n- 同一结论出现于多个材料时，建立一篇综合笔记作为枢纽，让材料作为证据回链。\n- 不为制造链接而拆碎上下文；项目档案、课程原文和长篇论证仍可保持整体。\n\n## MOC 的维护方式\n\n- MOC 文件名表示主题身份，也是 Graph 视图显示的节点名；使用 `软件工程与质量保障` 这类主题名，不使用 `00-索引`、`README` 等只有页面角色、没有主题信息的名称。\n- MOC 的页面角色写入 `type: moc` 属性，集合层级写入 `scope`，不要把这些元数据塞进文件名。\n- 集合 MOC 带有 `generated: true` 属性，由仓库内 `python tools/kb_moc.py --build` 刷新，使用 `--check` 只读核验；工具拒绝覆盖人工页面。\n- 主题 MOC 由人工维护，只收录能解释主题结构、矛盾、路径和应用的关键节点。\n- 当一个主题 MOC 超过约 30 个同层链接时，按问题或机制拆出子 MOC，而不是继续堆长列表。\n- 每次完成一篇重要笔记，回到它的上位 MOC，补充一句关系说明。\n\n## Obsidian 使用建议\n\n- 在主题 MOC 上使用局部关系图，深度 2 通常足以看到相邻知识。\n- 在知识笔记上同时查看反向链接和出链，前者显示“哪些主题需要它”，后者显示“它依赖什么”。\n- 可在关系图中搜索 `[type:moc]` 聚焦枢纽页；按 `path:` 过滤某个知识域。\n- 属性用于稳定元数据，正文链接用于表达可阅读、可推理的关系。\n\n## 自动一致性校验\n\n- 本地图片、文档、音视频和压缩包引用必须解析到仓库内真实文件；HTTP(S)、`data:`、`file:`、`obsidian:` 等外部 URI 不作为本地附件检查。\n- 占位图必须是实际存在的文件，并在替代文本或正文中明确标为占位；不能仅写“占位”来绕过缺失附件。\n- 确认无法恢复但必须保留的历史引用，逐条登记到 `.knowledge-base/attachment-exceptions.txt`，写明来源、目标和原因；禁止全库通配豁免，引用恢复后必须删除例外。\n- 提交前运行 `python tools/validate_knowledge_base.py --check`，检查摘要、MOC、库级规则、附件、公开/私有边界和原文保真确认门禁。\n- validator 同时检查综合笔记是否带有 `layer: evolution`，防止第二层再次变成无法辨认的普通文件。\n- validator 检查 `note_id` 全量覆盖（生成页、模板与根级治理文件除外）、格式与全库唯一性；生成页的 `note_id` 由 `.knowledge-base/generated-note-ids.tsv` 注册表登记并由生成器写回。新笔记的 ID 由 Agent 依标题语义翻译生成，冲突时已持有 ID 的一方保留、新笔记用领域限定词具体化。\n- 新增、删除或移动 Markdown 笔记后运行 `python tools/validate_knowledge_base.py --fix`，在本仓库内刷新 MOC 与派生文档并继续校验。\n- 仓库通过 `.githooks/pre-commit` 执行只读校验；新环境需运行 `git config core.hooksPath .githooks` 启用仓库内 Hook。\n- 自动校验只判断可机械验证的结构事实，不替代人工判断链接是否真正表达知识关系。\n" }