Web 与 Cloudflare

indexbind 有两个面向 web 的入口：

• indexbind/web
• indexbind/cloudflare

它们都查询规范化 bundle，但 Cloudflare Workers 需要独立入口，让 wasm 通过静态 Worker 模块导入加载。

浏览器或标准 Worker

import { openWebIndex } from 'indexbind/web';

const index = await openWebIndex('/search/index.bundle');
const hits = await index.search('cloudflare wasm');

如果你的站点始终只用词法检索，可以用词法 profile 打开 bundle，让该运行时实例不加载向量与模型文件：

const index = await openWebIndex('/search/index.bundle', {
  modeProfile: 'lexical',
});
const hits = await index.search('cloudflare wasm');

Cloudflare Worker

import { openWebIndex } from 'indexbind/cloudflare';

export default {
  async fetch(request: Request): Promise<Response> {
    const index = await openWebIndex('https://assets.example.com/index.bundle');
    const hits = await index.search(new URL(request.url).searchParams.get('q') ?? '');
    return Response.json(hits);
  },
};

如果你的宿主把 bundle 文件虚拟化、而不是暴露公开 bundle URL，传入自定义 fetch 实现：

const index = await openWebIndex(new URL('https://mdorigin-search.invalid/index.bundle/'), {
  fetch: (input, init) => env.ASSETS.fetch(new Request(input, init)),
});

如果你的宿主应用通过 Workers Assets 与虚拟基础 URL 提供 bundle 文件，参见手工测试用例：

• fixtures/manual/cloudflare-worker-issue-18

它复现了与 mdorigin 相同的形态：一个假的 bundle 源，加上把请求临时重定向进 ASSETS.fetch(...) 的 fetch 实现。

嵌入后端

规范化 bundle 当前可以用以下后端构建：

• hashing
• model2vec

当你想要更高质量的检索路径时，把 model2vec 作为默认推荐后端。当你想要更轻、偏兼容取向的后端或更小的构建依赖面时，使用 hashing。

对 model2vec，构建步骤会把以下文件复制进 bundle：

• model/tokenizer.json
• model/config.json
• model/model.safetensors

这让 wasm 运行时无需宿主文件系统访问就能嵌入查询。

包边界

npm 包包含运行时代码与 wasm 文件。

bundle 工件包含你的实际索引数据、向量、postings 与可选的 model2vec 模型文件。