打包与分发
发布的 npm 版本拆分为:
indexbind,包含 TypeScript API、wasm 运行时文件与原生加载器- 平台包,例如
@indexbind/native-darwin-x64,包含预构建的 NAPI 二进制
正常使用时只需安装 indexbind。存在受支持的预构建目标时,npm 会自动解析匹配的原生包。
当前原生支持
已发布的原生预构建目前覆盖:
- macOS arm64
- macOS x64
- Linux x64(glibc)
未发布 Windows 原生预构建。在 Windows 上,请使用 WSL 完成:
npm install indexbind- 本地构建命令
- 通过原生插件打开 SQLite 工件的本地 Node 查询
如果你的环境没有可用的预构建包,请在 Rust 工具链环境中安装并构建,而不是假设 npm 能解析到匹配的原生二进制。
npm 包里有什么
根包包含:
- 运行时入口,例如
indexbind、indexbind/build、indexbind/web与indexbind/cloudflare dist/wasm与dist/wasm-bundler中的 wasm 运行时文件- 在预构建平台包存在时解析它们的原生加载器
即使你的宿主开发机是 Windows,浏览器与 worker 入口仍来自根包。当前指引只是把安装与构建放在 WSL 里完成。
规范化 Bundle 里有什么
规范化 bundle 包含你的检索数据:
- manifest
- 文档
- 分块
- 向量
- postings
- 可选的模型资产
当你用 model2vec 构建时,以下文件会被复制进 bundle:
model/tokenizer.jsonmodel/config.jsonmodel/model.safetensors
这些模型文件不随根 npm 包分发。