GitNexus 如何配置 --embeddings 使用远端 /v1/embeddings 端点替代本地模型【免费下载链接】GitNexusGitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration项目地址: https://gitcode.com/GitHub_Trending/gi/GitNexusGitNexus 的analyze命令默认使用本地 ONNX 模型生成语义向量模型需要下载且 CPU 推理较慢。如果你的机器上已经有一个 OpenAI 兼容的/v1/embeddings服务文档明确支持 Infinity、vLLM、TEI、llama.cpp、Ollama、LM Studio 或 OpenAI可以只改配置让gitnexus analyze --embeddings改为请求远端端点索引其余流程不变。本文给出两条配置路径环境变量、命令行参数以及运行后如何确认远端端点确实生效。适用前提来自 gitnexus/README.md 的 Requirements 一节Node.js 22在 Git 仓库内运行GitNexus 用 git 做 commit 追踪远端服务已提供 OpenAI 兼容的/v1/embeddings接口。用环境变量配置远端端点这是 gitnexus/README.md “Remote Embeddings” 一节给出的主路径。其中GITNEXUS_EMBEDDING_URL和GITNEXUS_EMBEDDING_MODEL必须同时设置两者缺一时 GitNexus 会回落到本地 ONNX embeddingsGITNEXUS_EMBEDDING_DIMS未设置时默认384。下面示例中的 URL、模型名、API key 需要替换为你自己的服务值http://your-server:8080/v1是文档示例写法export GITNEXUS_EMBEDDING_URLhttp://your-server:8080/v1 export GITNEXUS_EMBEDDING_MODELBAAI/bge-large-en-v1.5 export GITNEXUS_EMBEDDING_DIMS1024 # 可选默认 384 export GITNEXUS_EMBEDDING_REQUEST_DIMSomit # 可选omit 表示不发送 dimensions 字段或给整数覆盖它 export GITNEXUS_EMBEDDING_API_KEYyour-key # 可选默认 unused export GITNEXUS_EMBEDDING_MAX_ATTEMPTS3 # 可选总尝试次数1-20 export GITNEXUS_EMBEDDING_RETRY_CAP_MS5000 # 可选最大重试延迟 export GITNEXUS_EMBEDDING_MIN_INTERVAL_MS0 # 可选最小请求间隔 export GITNEXUS_EMBEDDING_HTTP_TIMEOUT_MS180000 # 可选单请求超时最大 300000 gitnexus analyze . --embeddings两个维度变量作用不同README 对它们的分工有明确说明GITNEXUS_EMBEDDING_DIMS用于校验返回向量长度必须与端点实际产出的维度一致GITNEXUS_EMBEDDING_REQUEST_DIMS只控制请求体里发送的dimensions字段取omit或none、off、false、0时完全不发送该字段适合会拒绝该字段的严格后端取正整数时用该值替代GITNEXUS_EMBEDDING_DIMS发送不设置时发送GITNEXUS_EMBEDDING_DIMS此前行为。GITNEXUS_EMBEDDING_MAX_ATTEMPTS、GITNEXUS_EMBEDDING_RETRY_CAP_MS、GITNEXUS_EMBEDDING_MIN_INTERVAL_MS、GITNEXUS_EMBEDDING_HTTP_TIMEOUT_MS都是与具体供应商无关的重试/节奏参数供应商侧的限制应自行通过配置提供。所有GITNEXUS_EMBEDDING_*变量都不设置时本地 embeddings 行为不变。用命令行参数配置等价替代路径不想污染环境变量时gitnexus analyze提供一组--embedding-*参数它们覆盖同名环境变量适用于一次性或脚本化运行参数说明见 gitnexus/src/cli/index.tsgitnexus analyze . --embeddings \ --embedding-base-url http://your-server:8080/v1 \ --embedding-model BAAI/bge-large-en-v1.5 \ --embedding-dims 1024各参数的适用条件--embedding-base-url urlOpenAI 兼容 embeddings 的 base URL必须包含/v1后缀且必须为http://或https://。文档给出的示例是 Ollama 的http://10.219.32.29:11434/v1替换为你的服务地址--embedding-model model模型名文档示例为qwen3-embedding:8b--embedding-auth-token tokenBearer token覆盖GITNEXUS_EMBEDDING_API_KEY对 Ollama 这类无鉴权服务可省略。该值不会出现在日志中--embedding-dims number向量维度必须为正整数例如 Qwen3-Embedding-8B 的 4096且“必须与索引构建时使用的维度一致”非法值会被拒绝并提示--embedding-dims must be a positive integer.。--embedding-base-url与--embedding-model或对应的环境变量必须同时给出否则 CLI 会打印Note: custom HTTP embeddings require BOTH --embedding-base-url and --embedding-model (or the matching env vars). Falling back to local ONNX embeddings.并回落到本地模型——出现这行说明你的远端配置实际没有生效。另外注意--embedding-*参数只在同时传--embeddings时才有意义。如果只传参数而不传--embeddingsGitNexus 会提示Note: --embedding-* flags only apply when --embeddings is also passed; no embeddings will be generated this run.本次运行不生成任何向量。验证远端端点已生效运行gitnexus analyze . --embeddings后有两个文档给出的确认点启动时的确认行。当 embeddings 已启用且 URL、MODEL 齐备时输出中会打印URL 经过脱敏鉴权 token 永不打印Using custom embedding endpoint: masked-url (model: 你的模型名)看到这一行说明本次运行走的是自定义 HTTP 端点而不是本地模型。gitnexus doctor的 Embeddings 段。gitnexus doctor会显示运行时平台能力与 embedding 配置其 Embeddings 段的Backend行在远端配置下显示http未配置远端端点时显示local见 gitnexus/src/cli/doctor.ts。配置变更后用它复核一次即可。常见失败与处理端点请求失败。CLI 会输出The custom embedding endpoint request failed.并附带具体原因文档给出的排查顺序是确认端点 URL 可达且正在运行host、port、/v1路径三要素都要对确认模型名和 embedding 维度与端点实际提供的一致若本次只需要索引而不需要向量去掉--embeddings重跑无向量索引。GITNEXUS_EMBEDDING_DIMS取值非法。环境变量路径下 GitNexus 会给出专门的配置错误信息而不是裸堆栈按提示改为正整数即可命令行路径下非法--embedding-dims同样被前置校验拦截。误以为生效了。如果你的输出里出现的是“回落到本地 ONNX”的 Note 行而不是Using custom embedding endpoint行检查 URL/MODEL 是否只给了一个或 URL 是否漏了/v1后缀。--embeddings本身默认关闭不启用时远端配置不会产生任何请求。索引完成后语义检索会基于该远端模型生成的向量工作其余 BM25/混合检索路径不受影响。【免费下载链接】GitNexusGitNexus: The Zero-Server Code Intelligence Engine - GitNexus is a client-side knowledge graph creator that runs entirely in your browser. Drop in a git repository (Github, Gitlab, Azure, Local) or ZIP file, and get an interactive knowledge graph with a built in Graph RAG Agent. Perfect for code exploration项目地址: https://gitcode.com/GitHub_Trending/gi/GitNexus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考