vector-setup

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Vector Setup

Vector 设置

Bootstraps

ruvector@0.2.25

and its optional add-ons so every

/vector

subcommand actually works on first run.

引导

ruvector@0.2.25

及其可选插件完成配置，确保首次运行时所有

/vector

子命令均可正常工作。

Why this exists

为什么需要这个设置

Out of the box, several

/vector

subcommands fail with a confusing dep error:

Error	Missing package
`ONNX WASM files not bundled. The onnx/ directory is missing.`	`ruvector-onnx-embeddings-wasm`
`Brain commands require @ruvector/pi-brain`	`@ruvector/pi-brain`
`SONA not available. Native error: Cannot find module '/.../@ruvector/sona/index.js'`	`@ruvector/ruvllm` (JS fallback)
`LLM commands require @ruvector/ruvllm`	`@ruvector/ruvllm`

This skill installs them in one pass.

默认情况下，多个

/vector

子命令会因依赖缺失报错，且错误信息不够清晰：

错误信息	缺失的包
`ONNX WASM files not bundled. The onnx/ directory is missing.`	`ruvector-onnx-embeddings-wasm`
`Brain commands require @ruvector/pi-brain`	`@ruvector/pi-brain`
`SONA not available. Native error: Cannot find module '/.../@ruvector/sona/index.js'`	`@ruvector/ruvllm` （JS回退版本）
`LLM commands require @ruvector/ruvllm`	`@ruvector/ruvllm`

本设置可一次性安装所有缺失的依赖包。

Steps

步骤

Pin ruvector:
bash
```
npm install ruvector@0.2.25
```

Install the add-ons (idempotent — only what's missing):

bash

npm install ruvector-onnx-embeddings-wasm \
            @ruvector/pi-brain \
            @ruvector/ruvllm

For a leaner install, pass

--full

to also pull

@ruvector/graph-node

and

@ruvector/router

bash

npm install ruvector-onnx-embeddings-wasm \
            @ruvector/pi-brain \
            @ruvector/ruvllm \
            @ruvector/graph-node \
            @ruvector/router

Verify the binary:

bash

npx -y ruvector@0.2.25 doctor
npx -y ruvector@0.2.25 info

Register the MCP server:

bash

claude mcp add ruvector -- npx -y ruvector@0.2.25 mcp start
claude mcp list | grep ruvector

Sanity check the most common subcommands:

bash

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

(Optional) Generate a pi identity for brain + edge:

bash

npx -y ruvector@0.2.25 identity generate
npx -y ruvector@0.2.25 identity show

固定ruvector版本：
bash
```
npm install ruvector@0.2.25
```

安装插件（幂等操作——仅安装缺失的包）：

bash

npm install ruvector-onnx-embeddings-wasm \
            @ruvector/pi-brain \
            @ruvector/ruvllm

若需要完整安装，添加

--full

参数以同时安装

@ruvector/graph-node

和

@ruvector/router

：

bash

npm install ruvector-onnx-embeddings-wasm \
            @ruvector/pi-brain \
            @ruvector/ruvllm \
            @ruvector/graph-node \
            @ruvector/router

验证二进制文件：

bash

npx -y ruvector@0.2.25 doctor
npx -y ruvector@0.2.25 info

注册MCP服务器：

bash

claude mcp add ruvector -- npx -y ruvector@0.2.25 mcp start
claude mcp list | grep ruvector

完整性检查最常用的子命令：

bash

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

（可选）为brain + edge生成pi身份标识：

bash

npx -y ruvector@0.2.25 identity generate
npx -y ruvector@0.2.25 identity show

Smoke test

冒烟测试

For a deterministic verification of the install, run the plugin's bundled smoke script:

bash

bash plugins/ruflo-ruvector/scripts/smoke.sh

It checks: version pin, top-level subcommand visibility,

hooks ast-analyze

hooks route

attention list

rvf examples

, and

info

. Exits non-zero if any drift from the contracted surface is detected.

如需确定性验证安装结果，运行插件附带的冒烟测试脚本：

bash

bash plugins/ruflo-ruvector/scripts/smoke.sh

该脚本会检查：版本固定情况、顶层子命令可见性、

hooks ast-analyze

、

hooks route

、

attention list

、

rvf examples

和

info

命令。若检测到任何与预期不符的情况，将返回非零退出码。

What this does not install

本设置不包含的安装项

Native Rust toolchain (optional; only needed for source builds)
Platform-specific native bindings (auto-detected by
```
@ruvector/core
```
)
```
@ruvector/sona
```
native binding (the JS fallback via
```
@ruvector/ruvllm
```
is sufficient on macOS arm64; Linux x64 has its own native binding)

doctor

still reports a problem after this skill runs, paste its output verbatim and ask.

Rust原生工具链（可选；仅源码编译时需要）
特定平台的原生绑定（由
```
@ruvector/core
```
自动检测）
```
@ruvector/sona
```
原生绑定（在macOS arm64平台上，
```
@ruvector/ruvllm
```
提供的JS回退版本已足够；Linux x64平台有其专属的原生绑定）

若运行

doctor

命令后仍报告问题，请复制完整输出并咨询相关支持。