用途
vector-setup 用于引导安装 ruvector@0.2.25 及其可选附加组件，确保每个 /vector 子命令在首次运行时就能正常工作。
ruvector 开箱即用时，若干 /vector 子命令会因缺少依赖而报出令人困惑的错误，例如：
- ONNX WASM 文件未打包，缺少 onnx/ 目录，需要 ruvector-onnx-embeddings-wasm
- Brain 命令需要 @ruvector/pi-brain
- SONA 不可用，原生错误为 Cannot find module '/.../@ruvector/sona/index.js'，需要 @ruvector/ruvllm（JS 回退）
- LLM 命令需要 @ruvector/ruvllm
本技能会一次性安装这些依赖。
主要能力
- 固定安装 ruvector@0.2.25 版本
- 幂等安装附加组件，只安装缺失的部分
- 通过 --full 参数安装更完整的组件集
- 验证二进制文件并注册 MCP 服务器
- 对常见子命令进行健全性检查
- 可选生成 pi 身份
- 提供确定性的冒烟测试脚本
使用方式
1. 固定 ruvector 版本
npm install ruvector@0.2.25
2. 安装附加组件（幂等，只装缺失的）
npm install ruvector-onnx-embeddings-wasm \
@ruvector/pi-brain \
@ruvector/ruvllm
如需更精简的安装，可传入 --full 以同时拉取 @ruvector/graph-node 和 @ruvector/router：
npm install ruvector-onnx-embeddings-wasm \
@ruvector/pi-brain \
@ruvector/ruvllm \
@ruvector/graph-node \
@ruvector/router
3. 验证二进制文件
npx -y ruvector@0.2.25 doctor
npx -y ruvector@0.2.25 info
4. 注册 MCP 服务器
claude mcp add ruvector -- npx -y ruvector@0.2.25 mcp start
claude mcp list | grep ruvector
5. 对最常见子命令做健全性检查
npx -y ruvector@0.2.25 hooks route "test"
npx -y ruvector@0.2.25 attention list
npx -y ruvector@0.2.25 rvf examples
6. （可选）为 brain + edge 生成 pi 身份
npx -y ruvector@0.2.25 identity generate
npx -y ruvector@0.2.25 identity show
冒烟测试
如需对安装进行确定性验证，可运行插件自带的冒烟脚本：
bash plugins/ruflo-ruvector/scripts/smoke.sh
它会检查：版本固定、顶层子命令可见性、hooks ast-analyze、hooks route、attention list、rvf examples 以及 info。若检测到与约定接口有任何偏差，会以非零状态退出。
适用场景
适用于首次配置 ruvector 向量工具链、需要让 /vector 各子命令正常工作的开发者环境。
限制
本技能不会安装以下内容：
- 原生 Rust 工具链（可选，仅在源码构建时需要）
- 平台特定的原生绑定（由 @ruvector/core 自动检测）
- @ruvector/sona 原生绑定（在 macOS arm64 上通过 @ruvector/ruvllm 的 JS 回退已足够；Linux x64 有其自己的原生绑定）
如果本技能运行后 doctor 仍报告问题，请原样粘贴其输出并询问。