swarmvault

# SwarmVault 当用户需要一个基于 [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) 模式的本地优先知识库时使用此技能——三层架构（原始来源、Wiki、模式），其中 LLM 在你和原始来源之间维护一个持久化的 Wiki。当项目已经包含 `swarmvault.config.json` 或 `swarmvault.schema.md` 时也请使用它。 关于入门、示例、命令参考或故障排除，请在即兴提供工作流建议之前阅读随附的 `README.md`、`examples/`、`references/` 和 `TROUBLESHOOTING.md`。 ## 快速检查 - 在库根目录下工作。 - 如果库尚不存在，运行 `swarmvault init`。 - 当用户想要在将 SwarmVault 指向自己的来源之前进行最快的零配置演练时，使用 `swarmvault demo --no-serve`。 - 当用户想要在不手动执行 init + ingest + compile 的情况下对本地仓库或文档树进行最快的初步扫描时，使用 `swarmvault scan --no-serve`。 - 在进行编译或查询工作之前阅读 `swarmvault.schema.md`。它是库的操作契约。 - 如果存在 `wiki/graph/report.md`，在进行广泛的仓库搜索之前先使用它。 ## 核心循环 1. 需要时使用 `swarmvault init` 初始化一个库。 2. 在进行重大编译前更新 `swarmvault.schema.md`。使用它来定义命名规则、类别、基础知识、新鲜度预期和排除项。 3. 当输入是需要保持注册的循环本地文件、本地目录、公共 GitHub 仓库根目录或文档中心时，使用 `swarmvault source add `。 4. 使用 `swarmvault ingest ` 摄入一次性输入，或使用 `swarmvault ingest ` 摄入整个仓库树。音频文件在配置后使用 `tasks.audioProvider`，支持的 YouTube URL 通过直接转录捕获，而不是通用的 URL 摄入。 5. 当人类应该在规范页面更改之前一次集成一个来源时，使用 `swarmvault ingest --guide`、`swarmvault source add --guide`、`swarmvault source reload --guide`、`swarmvault source guide ` 或 `swarmvault source session `。在 `swarmvault.config.json` 中设置 `profile.guidedIngestDefault: true` 可使引导模式成为默认；使用 `--no-guide` 进行覆盖。使用 `guidedSessionMode: "canonical_review"` 的配置文件会暂存待审批的规范编辑；`insights_only` 配置文件将探索性合成保留在 `wiki/insights/` 中。仅对较轻的纯审查路径使用 `--review`。 6. 使用 `swarmvault inbox import` 进行捕获式导入