pokemon-chat/.env.example at develop · skygazer42/pokemon-chat · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180


# -----------------------
# Frontend (Vite)
# -----------------------
# Vite will expose only variables prefixed with VITE_ to the browser.

# 【必填/常用】开发时后端地址（Vite dev proxy 目标；vite preview/前后端分离部署也可直连该地址）
VITE_API_URL=http://127.0.0.1:5050

# 【常用】前端请求 API 的路径前缀（默认 /api；生产通常由 Nginx 反代提供 /api/*）
VITE_API_BASE_PATH=/api

# 【常用】应用显示名称（document.title 与 UI 品牌名）
VITE_APP_TITLE=可萌

# 【可选】前端版本号（不填则默认使用 web/package.json 的 version）
VITE_APP_VERSION=
# 【可选】构建提交 SHA（CI 可注入，用于排查版本）
VITE_BUILD_SHA=
# 【可选】构建时间（CI 可注入；不填会在构建时自动生成）
VITE_BUILD_TIME=

# 【可选】是否开启 sourcemap（true/false；线上默认建议 false）
VITE_SOURCEMAP=false

# ---- Logging ----
# 【常用】后端日志级别：DEBUG/INFO/WARNING/ERROR
LOG_LEVEL=DEBUG

# ---- Feature flags ----
# 【功能开关】是否启用知识库（Milvus 向量检索）；依赖 milvus 服务与 embedding 配置
enable_knowledge_base=false
# 【功能开关】是否启用知识图谱（Neo4j 图谱检索）；依赖 neo4j 服务
enable_knowledge_graph=false
# 【功能开关】是否启用联网搜索（Tavily）；需要 tavily_api_key 或 TAVILY_API_KEY
enable_web_search=false
# 【功能开关】是否启用 MCP（Model Context Protocol）；需要 mcp 服务（docker compose --profile mcp）
enable_mcp=false
# 【功能开关】是否启用 reranker 重排（提升检索结果质量）
enable_reranker=false
# 【功能开关】是否启用 BERT NER（本地实体识别；通常需要额外安装 torch/transformers）
enable_ner_bert=false
# 【功能开关】是否启用语音识别（FunASR）；需要 funasr 服务（docker compose --profile asr）
enable_asr=false

# 【安全开关】是否允许潜在危险的图谱查询（GraphCypherQAChain）；生产环境建议 false
allow_dangerous_graph_requests=false

# ---- LLM ----
# 【必填】大模型 API Key（用于聊天/智能体；示例为 OpenAI 兼容接口）
llm_api_key=
# 【常用】大模型 API Base URL（OpenAI 兼容）
llm_api_base=https://api.siliconflow.cn/v1
# 【常用】默认聊天模型名（随 provider 而变）
llm_model_name=Qwen/Qwen2.5-7B-Instruct
# 【可选】温度（越大越发散；越小越稳定）
llm_temperature=0.7
# 【可选】单次回答最大 token 上限
llm_max_tokens=4096

# Optional provider keys (legacy auto-detection / UI convenience)
# 【可选】SiliconFlow 平台 Key（也可用 llm_api_key；部分逻辑会自动识别）
SILICONFLOW_API_KEY=
# 【可选】OpenAI Key（也可用 llm_api_key）
OPENAI_API_KEY=
# 【可选】DeepSeek Key（也可用 llm_api_key）
DEEPSEEK_API_KEY=
# 【可选】智谱 AI Key（也可用 llm_api_key）
ZHIPUAI_API_KEY=
# 【可选】Tavily Key（也可用 tavily_api_key；用于 enable_web_search=true）
TAVILY_API_KEY=

# ---- CORS ----
# 【常用】允许跨域的来源（生产建议填写具体域名；开发可用 *）
cors_allow_origins=*
# 【常用】是否允许携带凭证（cookie/authorization 等）（true/false）
cors_allow_credentials=false

# ---- Embedding ----
# 【常用】Embedding 提供商（如 siliconflow/openai 等）
embedding_provider=siliconflow
# 【可选】Embedding API Key（如与 llm_api_key 相同也可复用）
embedding_api_key=
# 【常用】Embedding API Base URL
embedding_api_base=https://api.siliconflow.cn/v1/embeddings
# 【常用】Embedding 模型名
embedding_model_name=BAAI/bge-m3
# 【常用】Embedding 向量维度（需与模型一致）
embedding_dimension=1024

# ---- Reranker ----
# 【配置开关】是否启用 reranker（与 enable_reranker 一起决定是否生效）
reranker_enabled=true
# 【可选】Reranker API Key
reranker_api_key=
# 【常用】Reranker API Base URL
reranker_api_base=https://api.siliconflow.cn/v1
# 【常用】Reranker 模型名
reranker_model_name=BAAI/bge-reranker-v2-m3
# 【可选】参与重排的 top_k
reranker_top_k=10
# 【可选】重排阈值（低于阈值的结果可被过滤/降权）
reranker_threshold=0.1

# ---- Databases ----
# Local defaults (Docker Compose overrides host/port internally)
# 【常用】Neo4j Bolt 连接地址（Docker 内部会覆盖为 bolt://neo4j:7687）
neo4j_uri=bolt://localhost:7687
# 【常用】Neo4j 用户名
neo4j_username=neo4j
# 【可选】Neo4j 密码（若 NEO4J_AUTH=none 可留空）
neo4j_password=

# 【常用】MySQL 主机（Docker 内部会覆盖为 mysql）
mysql_host=127.0.0.1
# 【常用】MySQL 端口（本机映射默认 3307；Docker 内部会覆盖为 3306）
mysql_port=3307
# 【常用】MySQL 用户名
mysql_user=root
# 【常用】MySQL 密码
mysql_password=123456
# 【常用】MySQL 数据库名
mysql_database=langgraph

# 【常用】Milvus 地址（Docker 内部会覆盖为 http://milvus:19530）
milvus_uri=http://localhost:19530

# ---- Web search ----
# 【可选】Tavily API Key（启用 enable_web_search=true 时必填；也可用 TAVILY_API_KEY）
tavily_api_key=

# ---- MCP (optional) ----
# 【可选】MCP SSE 服务地址（启用 enable_mcp=true 时使用；Docker 内一般是 http://mcp:8000/sse）
mcp_sse_url=http://127.0.0.1:8000/sse
# 【可选】MCP 服务使用的 LLM API Key（若 MCP 服务单独配置模型，可在此设置）
mcp_llm_api_key=
# 【可选】MCP 服务使用的 LLM Base URL
mcp_llm_base_url=
# 【可选】MCP 服务使用的 LLM 模型名
mcp_llm_model=

# ---- ASR (FunASR) ----
# 【可选】FunASR WebSocket 地址（启用 enable_asr=true 时使用；Docker 内一般是 ws://funasr:10095）
funasr_url=ws://localhost:10095

# ---- Agent advanced ----
# Checkpointer type: memory, sqlite
# 【高级】对话状态持久化方式：memory（内存）/ sqlite（落盘）
checkpointer_type=memory
# Conversation max messages (short-term memory window)
# 【高级】会话短期记忆窗口大小（最大保留的消息条数）
conversation_max_messages=50
# Time-travel debug
# 【高级】是否启用 time-travel 调试（true/false）
enable_time_travel=false
# Interrupts / approvals
# 【高级】是否启用中断/审批（true/false；用于需要用户确认的步骤）
enable_interrupts=false

# ---- Tool keys ----
# 【可选】OpenWeather API Key（天气工具用）
tool_openweather_api_key=

# ---- LightRAG (optional) ----
# 【可选】LightRAG 工作目录（存放索引/中间产物）
lightrag_working_dir=./resources/lightrag_data
# 【可选】LightRAG 图存储实现（默认 Neo4JStorage）
lightrag_graph_storage=Neo4JStorage
# 【可选】LightRAG 向量存储实现（默认 MilvusVectorDBStorage）
lightrag_vector_storage=MilvusVectorDBStorage

# ---- App build metadata (backend) ----
# `/readyz` will show these when present (useful for CI/CD)
# 【可选】后端版本号（/readyz 会展示）
APP_VERSION=
# 【可选】后端构建提交 SHA（/readyz 会展示）
BUILD_SHA=
# 【可选】后端构建时间（/readyz 会展示）
BUILD_TIME=