用途：SwarmVault 用于在智能体已启用 SwarmVault MCP 服务器（stdio 传输，命令 npx -y @swarmvaultai/cli mcp，指向某个 vault 目录）时，管理一个三层知识库：raw/ 存放不可变的原始输入（PDF、转录、代码、邮件、URL、表格），wiki/ 存放由智能体与编译器生成的 markdown 页面（含 page_id、source_ids、node_ids、freshness、source_hashes 等 frontmatter），state/ 存放生成的索引、图谱与审批结果。库的契约在根目录 swarmvault.schema.md，配置在 swarmvault.config.json。
主要能力：MCP 工具分为几类。库检查：workspace_info、list_sources、search_pages、read_page。图谱操作（关系型问题优先于 grep）：graph_report、query_graph、get_node、get_neighbors、get_hyperedges、shortest_path、god_nodes、blast_radius。问答：query_vault 返回带引用的答案，save: true 可写入 wiki/outputs/。摄取与维护：ingest_input、compile_vault、lint_vault。若 MCP 不可用但有 shell，可用 swarmvault <subcommand> 或 npx -y @swarmvaultai/cli <subcommand>，工作目录设为 vault 根。
使用方式：先读 swarmvault.schema.md，再读 wiki/graph/report.md 或 wiki/index.md；关系问题用图谱查询；新来源先 ingest_input 再 compile_vault，然后 lint_vault；高价值答案用 query_vault save: true 保存。
限制：raw/ 不可编辑、重命名或删除；wiki/ 由编译器拥有，编辑须保留 frontmatter 字段；schema 变更未经审查不要直接 compile，应先 lint；候选页面未经用户确认不得提升；未经明确要求不得推送图谱到 Neo4j 或导出到 Obsidian。