产物参考

# 产物参考 SwarmVault 采用“保存优先”原则。磁盘上的文件即是产品。 ## 规范输入 - `swarmvault.schema.md` - 知识库指令、命名规则、排除项、新鲜度规则 - `raw/sources/` - 不可变的规范源 - `raw/assets/` - 本地化远程或导入的资产 - `state/sources.json` - 用于循环目录、公共代码库和文档中心的受管源注册表 - `state/sources//` - 受管源的工作状态，例如浅克隆和爬取元数据 ## 已编译知识 - `wiki/sources/` - 源页面 - `wiki/concepts/` 和 `wiki/entities/` - 提升后的规范页面 - `wiki/code/` - 基于解析器的模块页面 - `wiki/projects/` - 项目汇总 - `wiki/outputs/` - 保存的查询和探索输出 - `wiki/outputs/source-briefs/` - 针对受管源的源范围入门摘要 - `wiki/outputs/source-reviews/` - 通过审批暂存的源范围评审页面 - `wiki/outputs/source-guides/` - 引导式源集成页面，暂存更广泛的 wiki 更新以供评审 - `wiki/outputs/source-sessions/` - 可恢复的引导式会话锚点及问答状态 - `wiki/dashboards/` - 最近来源、时间线、冲突和开放问题仪表板 - `wiki/candidates/` - 暂存的概念/实体页面 - `wiki/graph/report.md` - 信任和导向报告 ## 状态与评审 - `state/graph.json` - 已编译的图谱产物 - `state/search.sqlite` - 本地全文索引 - `state/code-index.json` - 代码库感知的符号/导入索引 - `state/extracts/` - 提取的 Markdown 和 JSON 附属文件，涵盖 PDF、Word 系列、RTF、OpenDocument、EPUB、CSV/TSV、Excel 系列、PowerPoint 系列、Jupyter 笔记本、BibTeX、Org-mode、AsciiDoc、转录、Slack 导出、电子邮件、日历、音频转录、YouTube 转录捕获、结构化配置/数据预览及图像源 - `state/approvals/` - 来自 `compile --approve` 的评审包 - `state/benchmark.json` - 最新的基准/信任产物 - `state/watch/` - 待处理的语义刷新和监视状态产物 - `state/sessions/` - 保存的编译/查询/探索/lint/监视历史记录 - `state/jobs.ndjson` - 监视运行日志 ## 如何使用这些产物 - 在重复提问之前，请先阅读生成的页面。 - 使用报告和审批产物来解释发生了什么变化。 - 优先考虑修改 schema 或添加新源，而不是直接编辑生成的源文件。