.env.example

# 基础设置 BEGIN

## LLM 模型设置 BEGIN # 配置 LLM 和API相关的密钥和地址

LLM_PROVIDER="webllm" # （选填）对话模型，可选的值包括webllm, gemini, ollama, lmstudio。webllm代表通用需要联网的AI模型（如deepseek），ollama和lmstudio代表本地部署模型，gemini代表Gemini
CHAT_API_KEY="sk-114514"                 # （必填）DeepSeek 或其他聊天模型的 API Key
CHAT_BASE_URL="https://api.deepseek.com" # （选填）API 访问地址
MODEL_TYPE="deepseek-v4-flash"               # （选填）使用的模型类型
TEMPERATURE="1.0"         # （选填）温度，可控制模型输出的随机性，越高随机性越高，0-2.0之间
TOP_P="0.9"               # （选填）核采样，可控制模型的选词，越高可选词越多，0-1.0之间
ENABLE_THINKING="false"    # （选填）控制模型思考，如果用的是kimi，glm等改成false可以取消思考。可以填写none，false，true，不需要调整时请填写none

OLLAMA_BASE_URL="http://localhost:11434" # （选填）Ollama配置 - 地址
OLLAMA_MODEL="llama3"                    # （必填）Ollama配置 - 模型

LMSTUDIO_MODEL_TYPE="unknown"                # （必填）LM STUDIO 配置 - 模型
LMSTUDIO_BASE_URL="http://localhost:1234/" # （选填）LM STUDIO 配置 - 地址
LMSTUDIO_API_KEY="lm-studio"                 # （选填）LM STUDIO 配置 - API Key （似乎不需要）

GEMINI_API_KEY="sk-114514"           # （必填）Gemini 配置 - API Key
GEMINI_MODEL_TYPE="gemini-2.5-flash" # （选填）Gemini 配置 - 模型
GEMINI_PROXY_URL=""                  # （选填）Gemini 配置 - 代理地址
## LLM 模型设置 END

## 视觉模型设置 BEGIN # 配置 视觉模型相关的密钥和地址
VD_API_KEY="sk-114514"                      # 图像识别模型的 API Key
VD_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1" # 视觉模型的 API 访问地址
VD_MODEL="qwen3.5-flash"  # 视觉模型的模型类型
## 视觉模型设置 END

## 翻译设置 BEGIN # 配置 翻译相关的密钥和地址
ENABLE_TRANSLATE=true  # 是否启用日语翻译功能，如果没有日语输出将用LLM兜底 [type:bool]
LLM_OUTPUT_SEC_LANG=false # 是否启用多语言输出，关闭翻译后这个要改成true！不然sbv2的语音不能用 [type:bool]
TRANSLATE_LLM_PROVIDER="none" # 翻译模型提供者，可选值包括webllm, gemini, ollama, lmstudio, qwen-translate。webllm代表通用需要联网的AI模型（如deepseek），ollama和lmstudio代表本地部署模型，gemini代表Gemini，qwen-translate代表千问的模型，设置为"none"或留空则使用与LLM_PROVIDER相同的配置
TRANSLATE_API_KEY=""            # 翻译模型的 API Key
TRANSLATE_BASE_URL="https://api.deepseek.com" # 翻译模型的 API 访问地址
TRANSLATE_MODEL="deepseek-v4-flash" # 翻译模型
## 翻译设置 END

## API 与 模型 设置 END

## 对话功能设定 BEGIN # 配置高级对话功能
USE_RAG=false       # 是否启用RAG系统，目前暂时弃用
USE_TIME_SENSE=true # 是否启用时间感知
USE_PERSISTENT_MEMORY=false # 是否启用“永久记忆/记忆压缩”（需用户显式开启） [type: bool]
MEMORY_UPDATE_INTERVAL=250  # 多少条“可见台词”触发一次压缩（约等于旧50轮对话） [type: number]
MEMORY_RECENT_WINDOW=30     # 压缩后保留多少条全局台词窗口用于衔接 [type: number]
## 对话功能设定 END

# 基础设置 END


# 开发者设置 BEGIN

## RAG系统设定 BEGIN # 此设置目前已弃用
RAG_RETRIEVAL_COUNT=3 # 每次回答时检索的相关历史对话数量
RAG_WINDOW_COUNT=5    # 取当前的最新N条消息作为短期记忆，之后则是RAG消息，然后是过去的记忆。
RAG_HISTORY_PATH="ling_chat/data/rag_chat_history" # RAG历史记录存储路径
CHROMA_DB_PATH="ling_chat/data/chroma_db_store"    # ChromaDB向量数据库的存储路径
RAG_CANDIDATE_MULTIPLIER=3 # RAG候选乘数，用于计算实际检索的文档数量
RAG_CONTEXT_M_BEFORE=2     # RAG检索时考虑当前消息之前的上下文数量
RAG_CONTEXT_N_AFTER=2      # RAG检索时考虑当前消息之后的上下文数量
RAG_PROMPT_PREFIX="--- 以下是根据你的历史记忆检索到的相关对话片段，请参考它们来回答当前问题。这些是历史信息，不是当前对话的一部分： ---" # RAG前缀提示，支持多行
RAG_PROMPT_SUFFIX="--- 以上是历史记忆检索到的内容。请注意，这些内容用于提供背景信息，你不需要直接回应它们，而是基于它们和下面的当前对话来生成回复。 ---" # RAG后缀提示，支持多行
## RAG系统设定 END

## 存储与日志 BEGIN # 配置日志和其他文件的存储位置
BACKEND_LOG_DIR="ling_chat/data/logs"        # 后端服务日志目录
APP_LOG_DIR="ling_chat/data/log"             # 应用行为日志目录
TEMP_VOICE_DIR="ling_chat/data/temp_voice"   # 临时生成的语音文件存放目录
ENABLE_FILE_LOGGING=true                     # 是否将日志记录到文件
LOG_FILE_DIRECTORY="ling_chat/data/run_logs" # 日志文件的存储目录
CLEAN_TEMP_FILES=true                        # 是否在关闭后清理临时文件（包括语音等）
EMOTION_MODEL_PATH="ling_chat/third_party/emotion_model" # 情感分析模型路径
## 存储与日志 END

## Debug信息 BEGIN # 用于开发和调试的设置
LOG_LEVEL=INFO                # 日志级别，默认为INFO，设置为DEBUG则可以输出更详尽的日志，可选的值包括DEBUG, INFO, WARNING, ERROR, CRITICAL
PRINT_CONTEXT=false           # 是否把本次发送给llm的全部上下文信息截取后打印到终端
ENABLE_FRONTEND_LOG_FORWARDING=true # 是否启用前端日志转发功能
## Debug信息 END

## 服务端口配置 BEGIN # 配置各个服务的网络监听地址和端口
BACKEND_BIND_ADDR="localhost"         # 后端监听地址
BACKEND_PORT=8765                     # 后端监听端口
FRONTEND_BIND_ADDR="localhost"        # 前端监听地址,应该和后端地址同步修改
FRONTEND_PORT=8765                    # 前端监听端口,应该和后端端口同步修改
EMOTION_BIND_ADDR="localhost"         # 情感分析服务监听地址，现在几乎用不到
EMOTION_PORT=8000                     # 情感分析服务监听端口，现在几乎用不到
UPDATE_URL="lupd.uwaspace.work"    # 更新服务地址
COMMUNITY_URL="http://localhost:5200" # 创意工坊地址
ALLOWED_ORIGINS=""                    # CORS配置：允许的源，多个用逗号分隔，例如："http://localhost:5173,http://localhost:3000"

## 服务端口配置 END

## 语音合成 BEGIN # 配置语音合成API KEY和本地地址等
SIMPLE_VITS_API_URL="http://localhost:23456" # SIMPLE_VITS_API(sva-vits和sva-bv2)的语音合成API地址
STYLE_BERT_VITS2_URL="http://127.0.0.1:5000" # Style-bert-vits2(sbv2)的语音合成API地址
SBV2API_API_URL="http://localhost:3000"      # Sbv2-Api(sbv2api)的语音合成API地址
GPT_SOVITS_API_URL="http://127.0.0.1:9880"   # GPT-SOVITS(gsv)的语音合成API地址
GPT_SOVITS_REF_AUDIO=""    # GPT-SOVITS的参考音频路径
GPT_SOVITS_PROMPT_TEXT=""  # GPT-SOVITS的参考音频文字版
GPT_SOVITS_GPT_MODEL=""    # GPT-SOVITS的GPT模型完整路径
GPT_SOVITS_SOVITS_MODEL="" # GPT-SOVITS的sovits模型完整路径
AIVIS_API_KRY=""           # AIVIS的API密钥
VOICE_FORMAT="wav"         # 合成语音的格式，如无必要不建议修改
AUTO_START_TTS_SOFTWARE=false # 是否在启动程序时自动启动语音合成软件
TTS_SOFTWARE_PATH="third_party/tts/launcher.bat" # 语音合成软件路径（支持相对路径和绝对路径，仅支持 .exe 或 .bat 文件）。相对路径基于项目根目录。示例: third_party/tts/launcher.bat 或 D:\path\to\tts.exe [type:path]
## 语音合成 END

## 实验性功能 BEGIN # 配置实验性功能
COMSUMERS=3                    # 设置消费者数量，默认为 3
ENABLE_EMOTION_CLASSIFIER=true # 是否启用情绪分类器（警告：表情显示可能不正常）
ENABLE_DIRECT_EMOTION_CLASSIFIER=true # 是否在原有情绪可用时直接使用原标签
TRANSLATE_STREAM=false         # 是否启用翻译流式处理
OPEN_FRONTEND_APP=true         # 是否在启动后端时自动打开前端应用
USE_STREAM=true                # 是否使用LLM流式生成
VOICE_CHECK=false              # 是否启用语音合成检查
NO_LIMIT_EMOTION_PROMPT=false  # 不限制LLM输出的情感标签，用于更加丰富的情感变化
## 实验性功能 END

## 日程功能 BEGIN # 配置日程提醒功能（测试版）
ENABLE_PROACTIVE_SYSTEM=false       # 全局开关 - 是否启用主动对话系统功能
MAX_PROACTIVE_TIMES=1               # 最多在你回复之前，AI 主动对话几次
ENABLE_VISUAL_PRECEPTION=true       # 是否启用视觉感知功能（包括窥屏功能）
ENABLE_TOPIC_CREATER=true           # 是否启用主动继续对话创造功能
ENABLE_TODO_PRECEPTION=false        # 是否启用待办事项感知功能
ENABLE_SCHEDULE_REMINDER=true       # 是否启用日程提醒功能
ENABLE_IMPORTANT_DAY_REMINDER=true  # 是否启用重要日期提醒功能
TODO_WEIGHT=-1               # 待办事项权重（会提醒你的待办事项的概率）
TOPIC_WEIGHT=-1              # 话题权重（会主动继续话题的概率）
SCREEN_WEIGHT=-1             # 窥屏权重（会窥屏的概率，全选项-1会自动监测概率）
## 日程功能 END
# 开发者设置 END