Nerdbot 用于构建、查询和维护 Obsidian 原生、git 友好、由智能体管理的知识库，其核心设计是将原始证据与综合整理的 wiki 知识分层分离。它面向具备来源溯源、索引、schema/配置、共享 vault 约定以及仅追加活动日志的分层知识库。
用途与适用场景 Nerdbot 适用于在仓库中启动新的主题知识库、创建新的 Obsidian vault 或将现有 markdown 仓库转换为 vault、向分层知识库添加来源与摘录、在保留溯源的前提下改进综合 wiki 页面、审计结构/来源覆盖/过期索引/活动日志漂移、从已维护知识库中回答问题而无需重新发现原始证据、将混乱仓库修复为更安全的分层知识库、在深入综合前规范化笔记元数据与 [[wikilinks]]、嵌入、别名及共享 .obsidian/ 表面，以及从已维护知识库生成派生输出。
它明确不适用于：自由形式的个人笔记、日志或临时草稿；文档站点生成、框架同步或文档 UX 工作；数据库设计、向量存储 schema 设计或数据库型系统的迁移规划；不维护 git 友好知识库的独立研究报告；以及应保持用户本地的易变工作区或编辑器状态调优。
主要能力与工作流 Nerdbot 提供多种工作流：Create（创建）、Ingest（摄取）、Enrich（丰富）、Audit（审计）、Query（查询）、Derive（派生）、Existing repo（现有仓库改进）和 Migration（迁移）。
Create 用于为用户想要的主题或范围创建新知识库，加载 kb-architecture 与 obsidian-vaults 参考，创建默认分层结构（.obsidian/、raw/、wiki/、schema/、config/、indexes/、activity/），并初始化根索引、来源映射、覆盖索引、共享 vault 配置和活动日志。
Ingest 用于已有来源且知识库需要可信证据捕获时，将原始文件保留在 raw/ 中，在旁边添加规范化摘录，更新索引以显示来源状态、预期 wiki 覆盖和未解决缺口，并在综合工作前或期间添加溯源存根。
Enrich 用于 wiki/ 需要新增或改进综合页面时，仅从 raw/ 或明确标识的规范材料进行综合，在同一批次中添加或刷新溯源链接、来源列表和相关索引条目，并通过补充、注释或扩展来保留用户撰写的语气。
Audit 用于只读诊断、lint 和置信度检查，报告缺失层、过期索引、溯源缺口、孤立 wiki 页面、schema/配置漂移、活动日志缺口、损坏的 [[wikilinks]]、损坏的嵌入、别名冲突和 .obsidian/ 共享表面漂移，并将发现分类为严重、警告或建议。
Query 用于从已维护知识库获取答案而不修改它，优先读取 wiki/ 和 indexes/，仅在验证引用或确认缺口时检查 raw/，回答时附带笔记路径、[[wikilinks]]、来源映射溯源和明确的置信度，并将结果分类为已回答、部分回答或缺口。
Derive 用于从已维护知识库生成工件，确认规范输入和目标输出路径，从 raw/、wiki/、schema/ 和 config/ 构建输出而不替换它们，保持派生可重现，并在 activity/ 中记录输入、配方、时间戳和输出目标。
Existing Imperfect Repo 用于仓库已包含笔记、文档或部分知识库且安全路径不明显时，先运行只读清单，将仓库分类为 obsidian_native_vault、mixed_vault 或 legacy_markdown_repo，默认先进行 Obsidian 原生改造，再拆分工作为小批次。
Migration 用于任何重命名、移动、替换、重新根化或切换，需要迁移访谈、反转、回滚计划和明确批准。
使用方式与核心管线 Nerdbot 使用门控（Gate）管理每个多步骤流程，在第一个受阻门控处停止：Gate 0 分类、Gate 1 清单、Gate 2 计划、Gate 3 确认、Gate 4 执行、Gate 5 验证、Gate 6 交接。执行时一次更改一层：raw -> wiki -> indexes -> activity。对于 Query，在 Gate 2 后停止，除非用户明确要求将知识库缺口转化为 enrich、ingest 或 derive 工作。
默认知识库模式为分层结构：<kb-root>/ 下包含 .obsidian/（templates、snippets）、raw/（assets、sources、captures、extracts）、wiki/（index.md、topics/）、schema/、config/（obsidian-vault.md）、indexes/（coverage.md、source-map.md）、activity/（log.md）。
状态管理方面，持久状态位于项目可见表面：indexes/source-map.md、indexes/coverage.md 和 indexes/evidence-ledger.md 解释来源和声明支持；indexes/review-queue.md 保存不确定的保存回、过期、矛盾、可疑、解析器警告和图清理项；activity/log.md 和 activity/operations.jsonl 是仅追加的活动和重放记录；activity/research/ 默认仅日志；indexes/generated/ 存储可重建的 FTS、图、图表、摘要和未来社区摘要工件。
限制与注意事项 Nerdbot 不适用于自由笔记、文档站点、数据库型知识系统或一次性研究。query 和 audit 默认只读，除非用户明确要求后续修改。create、ingest、enrich、derive 和 improve 默认加法优先，风险不明确时先进行干运行/规划。migrate 默认高影响，需要迁移访谈、反转、回滚计划和明确批准。对于 SOTA LLM-wiki、GraphRAG、DeepWiki、CodeWiki 或 STORM 风格行为，需加载 references/advanced-wiki-logics.md 并在实现前映射到 Nerdbot 层。