配置参考

Compose 已提供本地默认值。只有需要自定义端口、模型、解析器、稳定性或生产存储时，才复制 .env.example 为 .env。

网络与运行模式

变量	默认值	说明
WEB_PORT	3000	宿主机 Web 端口
API_PORT	8000	宿主机 API 端口
BIND_ADDRESS	127.0.0.1	监听地址；服务器设为 0.0.0.0 前先配置外围保护
SAG_ENVIRONMENT	dev	生产环境使用 prod
SAG_CORS_ORIGINS	http://localhost:3000	允许带凭据访问 API 的前端 Origin
NEXT_PUBLIC_API_BASE	http://localhost:8000	浏览器访问 API 的构建期地址
SAG_SECRET_KEY	本地开发默认值	JWT 签名密钥；生产必须替换
SAG_ALLOW_REGISTRATION	false	是否开放传统邮箱注册接口

LLM

变量	默认值	说明
SAG_LLM_PROVIDER	openai	LiteLLM provider 标识
SAG_LLM_BASE_URL	https://api.302ai.cn/v1	OpenAI 兼容端点；原生 provider 可留空
SAG_LLM_API_KEY	空	模型密钥
SAG_LLM_MODEL	qwen3.6-flash	服务端模型标识
SAG_LLM_MAX_TOKENS	20000	最大生成 tokens
SAG_LLM_TIMEOUT_MS	60000	单次请求超时毫秒数
SAG_LLM_MAX_RETRIES	2	模型请求重试次数

界面与 API 在 Key 为空时仍可启动，但事件抽取、查询理解、精确检索重排和回答生成不可用。

Embedding

变量	默认值	说明
SAG_EMBEDDING_MODEL	bge-large-en-v1.5	Embedding 模型标识
SAG_EMBEDDING_BASE_URL	https://api.302ai.cn/v1	独立 Embedding 端点
SAG_EMBEDDING_API_KEY	空	独立密钥；应用设置中可复用 LLM 配置

Embedding 是文档向量化与快速检索的必要能力。更换模型后，既有向量不能自动获得同一语义空间，应重新处理文档。

解析与分块

变量	默认值	说明
SAG_DOCUMENT_PARSER	auto	自动选择 MinerU 或 MarkItDown
SAG_MINERU_BASE_URL	https://api.302ai.cn	MinerU 服务地址
SAG_MINERU_API_KEY	空	MinerU Key
SAG_MINERU_VERSION	2.5	MinerU 版本
SAG_DOCUMENT_EXTRACT_CONCURRENCY	5	并行抽取数
SAG_DOCUMENT_CHUNK_MAX_TOKENS	1000	单 chunk 目标上限
SAG_DOCUMENT_CHUNK_MODE	standard	分块模式

后台任务与引擎

变量	默认值	说明
SAG_JOB_MAX_ATTEMPTS	3	后台任务最大尝试次数
SAG_ENGINE_CACHE_SIZE	16	引擎实例缓存容量
SAG_ENGINE_WARMUP_COUNT	4	启动预热数量
SAG_MINERU_POLL_TIMEOUT	300	可选的 MinerU 轮询超时

PostgreSQL

变量	默认值	说明
POSTGRES_USER	sag	数据库用户
POSTGRES_PASSWORD	无	生产覆盖必填
POSTGRES_DB	sag	数据库名

生产覆盖还会设置 SAG_SAG_RELATIONAL_PROVIDER=postgres 与 SAG_SAG_VECTOR_PROVIDER=pgvector。不要在默认 Compose 中手工混搭只覆盖一半的存储设置。