Swarmvault 故障排查

# 故障排除 ## `swarmvault` 命令未找到 ClawHub 技能本身不捆绑 CLI 二进制文件。安装已发布的包并验证它： bash npm install -g @swarmvaultai/cli swarmvault --version 如果仍然找不到二进制文件，请检查 npm 的全局 bin 目录是否在 `PATH` 中。 ## Node 版本过旧 SwarmVault 需要 Node `>=24`。 bash node --version 在排查提供商或编译行为之前升级 Node。 ## 库已编译，但质量较弱 检查库是否仍在使用内置的 `heuristic` 提供商。这是一个有效的本地/离线默认值，但其合成效果有意设计得较轻。当你需要更丰富的合成质量或可选功能（如嵌入、视觉或图像生成）时，请在 `swarmvault.config.json` 中添加模型提供商。 对于本地语义图谱查询，`embeddingProvider` 必须指向支持嵌入的后端，例如 `ollama` 或其他兼容 OpenAI 的嵌入服务。内置的 `heuristic` 提供商不生成嵌入。 ## 音频文件已摄入，但未出现转录 音频摄入需要 `tasks.audioProvider` 指向具有 `audio` 功能的提供商。如果没有，SwarmVault 仍会摄入来源并记录提取警告，而不是导致整个运行失败。 YouTube 转录摄入不需要模型提供商，但如果视频没有可访问的字幕或上游转录获取路径不可用，它仍然可能失败。 ## 来源审查或仪表盘未出现 如果你期望出现来源范围的指南或审查页面，请使用以下流程之一： bash swarmvault ingest --guide swarmvault source add --guide swarmvault source session 然后验证： - `wiki/outputs/source-briefs/` - `wiki/outputs/source-sessions/` - `wiki/outputs/source-guides/` - `wiki/dashboards/index.md` - `wiki/dashboards/timeline.md` - `wiki/dashboards/source-sessions.md` - `wiki/dashboards/source-guides.md` - `state/approvals/` ## `wiki/graph/report.md` 或搜索工件缺失 运行： bash swarmvault compile 然后验证： - `wiki/graph/report.md` - `state/graph.json` - `state/search.sqlite` 如果库位于 git 中，并且你想要快速的图谱级差异，运行 `swarmvault diff`。 ## 智能体安装或钩子似乎已过时 在项目根目录下重新运行相关的安装命令： bash swarmvault install --agent claude --hook swarmvault install --agent gemini --hook swarmvault