[ PROMPT_NODE_25508 ]
Swarmvault 说明文档
[ SKILL_DOCUMENTATION ]
# SwarmVault 技能
当你需要一个本地优先的知识库时,使用 SwarmVault 技能。它可以将书籍、文章、笔记、转录、聊天记录、电子邮件、日历、数据集、电子表格、幻灯片、截图、URL、代码和研究资料汇编成持久化的 Markdown 页面、可搜索的图谱、仪表盘以及磁盘上的可审查输出。
SwarmVault 基于 [LLM Wiki](https://gist.github.com/karpathy/442a6bf555914893e9891c11519de94f) 模式构建:在原始来源和用户之间通过三层架构(原始来源、Wiki、模式)保持一个持久化的 Wiki。LLM 负责记录工作——交叉引用、一致性、更新——而你负责整理来源并思考其含义。SwarmVault 将该模式转化为一个带有图谱导航、搜索、审查流程、自动化和可选提供商支持合成的本地工具链。
## 安装
从 ClawHub 安装此技能:
bash
clawhub install swarmvault
安装其依赖的 CLI:
bash
npm install -g @swarmvaultai/cli
swarmvault --version
swarmvault demo --no-serve
swarmvault source add https://github.com/karpathy/micrograd
swarmvault ingest ./meeting.srt --guide
swarmvault ingest ./customer-call.mp3
swarmvault ingest https://www.youtube.com/watch?v=dQw4w9WgXcQ
swarmvault source session transcript-or-session-id
要求:
- Node `>=24`
- `PATH` 中有一个可用的 `swarmvault` 或 `vault` 二进制文件
更新路径:
bash
clawhub update swarmvault
npm install -g @swarmvaultai/cli@latest
## 何时使用此技能
- 你希望知识工作保留在磁盘上,而不是消失在聊天记录中。
- 仓库中已经包含 `swarmvault.config.json` 或 `swarmvault.schema.md`。
- 你希望在同一个工作区中获得 Markdown Wiki 页面、图谱工件、本地搜索、审批、候选内容和 MCP 暴露。
- 你需要一个针对来源集合、代码库或研究资料的“先保存、后编译/查询/审查”的循环。
- 你希望为混合的非代码材料(如 EPUB、CSV/TSV 文件、XLSX 工作簿、PPTX 幻灯片、转录、Slack 导出、邮箱文件和日历导出)提供统一的工作流。
## 快速开始
bash
swarmvault init --obsidian --profile personal-research
swarmvault init --obsidian --profile reader,timeline
swarmvault demo --no-serve
swarmvault source add ./exports/customer-call.srt --guide
swarmvault source session file-customer-call-srt-12345678
swarmvault source add https://github.com/karpathy/micrograd
swarmvault ingest ./src --repo-root .
swarmvault ingest ./customer-