.env.example

# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
# Roro Digital Human Orchestrator — 环境变量配置
# 复制此文件为 .env 并填入实际值
# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

# ── LLM 配置 ──
# 任何 OpenAI-compatible API 都支持
LLM_BASE_URL=https://api.openai.com/v1
LLM_API_KEY=sk-your-api-key-here
LLM_MODEL=gpt-4o

# 可选调参
# LLM_MAX_TOKENS=1024
# LLM_TEMPERATURE=0.8
# LLM_TIMEOUT=60

# 主 LLM 是否原生支持多模态（直接接收图片）
#   true  = 主 LLM 直接吃图片（要求 LLM_MODEL 是多模态模型，如 qwen3.5-omni-flash / gpt-4o）
#           图片走 OpenAI content 数组格式：[{"type":"text",...},{"type":"image_url",...}]
#   false = 走视觉旁路（用 MCP_VISION_MODEL 描述图片后注入主链路）
#           旁路对纯文本主 LLM（如 qwen-plus / deepseek-chat）友好，但信息有损
LLM_MULTIMODAL=false

# ── TTS 配置 (Higgs TTS App Server) ──
TTS_SERVER_URL=http://localhost:8081
TTS_API_KEY=
TTS_DEFAULT_VOICE=random
# TTS_TIMEOUT=30

# ── ASR 配置 (FunASR 2-pass Server) ──
# ASR_SERVER_URL=ws://localhost:10095
# ASR_SAMPLE_RATE=16000
# ASR_MODE=2pass

# ── MCP 设备控制配置 ──
MCP_ENABLED=true
MCP_TIMEOUT=10
MCP_CAMERA_TIMEOUT=30

# 视觉旁路配置（LLM_MULTIMODAL=false 时才生效）
MCP_VISION_BYPASS=true
#   true  = LLM_MULTIMODAL=false 时，用 VL 模型描述图片后注入主链路
#   false = 完全禁用图片处理（前端图片被丢弃）
MCP_VISION_MODEL=qwen-vl-max

# 视觉旁路模型的 API 端点与密钥（独立于主 LLM）
# 跨 provider 场景必须配置，例如：
#   主 LLM = DeepSeek，视觉旁路 = qwen-vl-max → 这里填 DashScope 的端点与密钥
# 留空则回退到主 LLM 的 LLM_BASE_URL / LLM_API_KEY（同 provider 场景）
MCP_VISION_BASE_URL=
MCP_VISION_API_KEY=

# ── 服务器配置 ──
# HOST=0.0.0.0
# PORT=8090
# Docker 部署时需配置，设为宿主机 LAN IP，ESP32 通过此地址访问
# SERVER_PUBLIC_HOST=192.168.x.x

# ── 安全配置 (生产环境必读) ──
# CORS_ORIGINS 控制允许哪些网页域名连接 WebSocket 和 REST API。
# 默认 * 允许所有来源，仅适用于本地开发。
#
# 生产环境要求：
#   1. 将 CORS_ORIGINS 限制为你的前端域名，如:
#      CORS_ORIGINS=https://your-domain.com,https://app.your-domain.com
#   2. 在 Roro 前面放一层反向代理 (Nginx/Caddy)，启用 HTTPS/TLS。
#      否则 API Key 会以明文在 HTTP 头中传输。
#   3. 如果只在本机使用，保持 HOST=127.0.0.1 (而非 0.0.0.0) 即可，
#      外部网络无法访问。
# CORS_ORIGINS=*

# ── 管理后台配置 ──
# 记忆管理后台 (/admin) 的访问 Token
# 留空或不配置 = dev mode,无需登录即可访问 (仅限局域网/开发环境)
# 配置后,访问 /admin 需在登录页输入此 Token
# ADMIN_TOKEN=

# ── 常用 LLM 替代方案示例 ──
# DeepSeek:
# LLM_BASE_URL=https://api.deepseek.com/v1
# LLM_API_KEY=sk-xxx
# LLM_MODEL=deepseek-chat
# LLM_MULTIMODAL=false  # DeepSeek 为纯文本模型，走视觉旁路

# Ollama (本地):
# LLM_BASE_URL=http://localhost:11434/v1
# LLM_API_KEY=ollama
# LLM_MODEL=qwen3:8b
# LLM_MULTIMODAL=false

# 通义千问 - 多模态:
# LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
# LLM_API_KEY=sk-xxx
# LLM_MODEL=qwen3.5-omni-flash
# LLM_MULTIMODAL=true   # omni 系列原生支持图片

# 通义千问 - 纯文本:
# LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
# LLM_API_KEY=sk-xxx
# LLM_MODEL=qwen-plus
# LLM_MULTIMODAL=false  # 纯文本，走视觉旁路

# Moonshot (Kimi):
# LLM_BASE_URL=https://api.moonshot.cn/v1
# LLM_API_KEY=sk-xxx
# LLM_MODEL=moonshot-v1-8k
# LLM_MULTIMODAL=false