配置参考

mindvaults 通过环境变量控制全部行为。所有变量在 docker-compose.yml 的 environment 段设置。

LLM / Embedding Provider 组合

方案	LLM_PROVIDER	LLM_BASE_URL	EMBEDDING_PROVIDER
纯本地	ollama	http://ollama:11434	ollama
DeepSeek	openai	https://api.deepseek.com/v1	ollama
OpenAI	openai	https://api.openai.com/v1	openai
混合（推荐）	openai	https://api.deepseek.com/v1	ollama

混合方案：LLM 走 DeepSeek（便宜），Embedding 走本地 Ollama（数据不出网）。

核心环境变量

变量名	默认值	说明
LLM_PROVIDER	ollama	LLM 推理服务提供商：ollama / openai
LLM_MODEL	qwen3:latest	LLM 模型名称（Ollama tag 或 API model id）
LLM_BASE_URL	http://ollama:11434	LLM API 地址
LLM_API_KEY	(空)	云端 API Key（Ollama 模式留空）
LLM_TEMPERATURE	0.3	生成随机性，0-1.5
EMBEDDING_PROVIDER	ollama	向量化服务提供商
EMBEDDING_MODEL	bge-large-zh-v1.5	Embedding 模型名
CHUNK_SIZE	500	文档切片大小（字符数）
CHUNK_OVERLAP	50	相邻切片重叠字符数
TOP_K	5	检索返回的 Top-K 片段数
SIMILARITY_THRESHOLD	0.7	向量检索最低相似度阈值
API_KEY	(必填)	API 鉴权密钥
REDIS_CACHE_ENABLED	true	是否启用 Redis 检索缓存
DATABASE_URL	postgresql+asyncpg://...	PostgreSQL 连接串
REDIS_URL	redis://redis:6379/0	Redis 连接串

Ollama 模型配置

使用全栈模式时，需预先拉取所需模型：

# 进入 Ollama 容器
docker exec -it mindvaults-ollama-1 bash
# 拉取 LLM 模型
ollama pull qwen3:latest
ollama pull deepseek-r1:8b
# 拉取 Embedding 模型
ollama pull bge-large-zh-v1.5
# 验证
ollama list

Embedding 向量维度适配

模型	维度	推荐场景
bge-large-zh-v1.5	1024	中文文档（推荐）
bge-m3	1024	多语言混合场景
nomic-embed-text	768	英文文档
text-embedding-ada-002	1536	OpenAI 云端

⚠️ 切换 Embedding 模型后需重建索引（所有文档重向量化）。