.env.example

# ============================================================
#  StockLens 配置文件
#  复制此文件为 .env 并填入你的配置
#  cp .env.example .env
# ============================================================

# ==================== 必填配置 ====================

# 自选股列表（逗号分隔，支持 A股/港股/美股）
# A股: 600519  港股: hk00700  美股: AAPL
STOCK_LIST=AAPL,NVDA,600519

# LLM 配置（至少配置一种方式，AI 分析必需）
#
# --- 方式一：多通道配置（推荐） ---
# LLM_CHANNELS=deepseek
# LLM_DEEPSEEK_BASE_URL=https://api.deepseek.com
# LLM_DEEPSEEK_API_KEY=sk-xxx
# LLM_DEEPSEEK_MODELS=deepseek-chat
# LLM_DEEPSEEK_PROTOCOL=openai
# LITELLM_MODEL=openai/deepseek-chat
#
# --- 方式二：Gemini ---
# GEMINI_API_KEY=your_gemini_key
#
# --- 方式三：OpenAI ---
# OPENAI_API_KEY=your_openai_key


# ==================== 选填配置 ====================

# --------------------------------------------------
# LLM 通用
# --------------------------------------------------
# LLM_TEMPERATURE=0.7                        # 采样温度 [0.0-2.0]
# LITELLM_MODEL=                             # 主模型，provider/model 格式
# LITELLM_FALLBACK_MODELS=                   # 逗号分隔的备用模型
# LITELLM_CONFIG=                            # litellm_config.yaml 路径（最高优先级）

# --------------------------------------------------
# LLM 多通道详细配置
# 当 LLM_CHANNELS=foo,bar 时，为每个通道配置以下变量
# 将 {NAME} 替换为通道名（大写）
# --------------------------------------------------
# LLM_{NAME}_BASE_URL=                       # API 端点
# LLM_{NAME}_API_KEY=                        # API Key
# LLM_{NAME}_API_KEYS=                       # 多 Key 负载均衡（逗号分隔）
# LLM_{NAME}_MODELS=                         # 模型列表（逗号分隔）
# LLM_{NAME}_PROTOCOL=                       # 协议: openai/anthropic/gemini/vertex_ai/deepseek/ollama
# LLM_{NAME}_ENABLED=true                    # 启用/禁用通道
# LLM_{NAME}_EXTRA_HEADERS=                  # 额外 HTTP 头（JSON 格式）

# --------------------------------------------------
# Gemini
# --------------------------------------------------
# GEMINI_API_KEY=                             # 单 Key
# GEMINI_API_KEYS=                            # 多 Key 负载均衡（逗号分隔，优先于单 Key）
# GEMINI_MODEL=gemini-3-flash-preview         # 模型名称
# GEMINI_MODEL_FALLBACK=gemini-2.5-flash      # 备用模型
# GEMINI_TEMPERATURE=0.7                      # 温度（建议用 LLM_TEMPERATURE 统一管理）
# GEMINI_REQUEST_DELAY=2.0                    # 请求间隔（秒）
# GEMINI_MAX_RETRIES=5                        # 最大重试次数
# GEMINI_RETRY_DELAY=5.0                      # 重试基础延迟（秒）

# --------------------------------------------------
# Anthropic (Claude)
# --------------------------------------------------
# ANTHROPIC_API_KEY=                          # 单 Key
# ANTHROPIC_API_KEYS=                         # 多 Key 负载均衡
# ANTHROPIC_MODEL=claude-3-5-sonnet-20241022  # 模型名称
# ANTHROPIC_TEMPERATURE=0.7                   # 温度 [0.0-1.0]
# ANTHROPIC_MAX_TOKENS=8192                   # 最大输出 Token

# --------------------------------------------------
# OpenAI / OpenAI 兼容
# --------------------------------------------------
# OPENAI_API_KEY=                             # 单 Key
# OPENAI_API_KEYS=                            # 多 Key 负载均衡
# OPENAI_BASE_URL=                            # 自定义端点（兼容 API）
# OPENAI_MODEL=gpt-4o-mini                    # 模型名称
# OPENAI_TEMPERATURE=0.7                      # 温度
# AIHUBMIX_KEY=                               # AIHubmix 一站式 Key（自动设置 base_url）

# --------------------------------------------------
# DeepSeek
# --------------------------------------------------
# DEEPSEEK_API_KEY=                           # 单 Key
# DEEPSEEK_API_KEYS=                          # 多 Key 负载均衡

# --------------------------------------------------
# Agent 专用 LLM
# --------------------------------------------------
# AGENT_LITELLM_MODEL=                        # Agent 专用模型（空则继承 LITELLM_MODEL）

# --------------------------------------------------
# Vision（图片识别）
# --------------------------------------------------
# VISION_MODEL=                               # LiteLLM 模型字符串
# VISION_PROVIDER_PRIORITY=gemini,anthropic,openai  # 提供商优先级

# --------------------------------------------------
# 搜索引擎（增强新闻情报，任选配置）
# --------------------------------------------------
# TAVILY_API_KEYS=                            # Tavily AI 搜索
# SERPAPI_API_KEYS=                           # SerpAPI (Google)
# BOCHA_API_KEYS=                             # 博查搜索（中文优化）
# MINIMAX_API_KEYS=                           # MiniMax 搜索
# BRAVE_API_KEYS=                             # Brave Search
# SEARXNG_BASE_URLS=                          # 自建 SearXNG 实例（无配额限制）

# --------------------------------------------------
# 数据源 Token
# --------------------------------------------------
# TUSHARE_TOKEN=                              # Tushare Pro（需 2000 积分）
# TWELVEDATA_API_KEY=                         # TwelveData（美股增强）
# TICKFLOW_API_KEY=                           # TickFlow 大盘复盘增强
# --------------------------------------------------
# 数据源优先级（数字越小优先级越高）
# --------------------------------------------------
# YFINANCE_PRIORITY=0
# XUEQIU_PRIORITY=1
# OPENBB_PRIORITY=2
# TWELVEDATA_PRIORITY=3
# EFINANCE_PRIORITY=4
# AKSHARE_PRIORITY=5
# TUSHARE_PRIORITY=6
# PYTDX_PRIORITY=7
# BAOSTOCK_PRIORITY=8
# FINNHUB_PRIORITY=1                          # 默认 1（仅当 FINNHUB_API_KEY 配置时生效；
                                              # 否则自动降到 999 = 禁用）

# --------------------------------------------------
# 数据源高级配置
# --------------------------------------------------
# OPENBB_PROVIDER=yfinance                   # OpenBB 后端
# FMP_API_KEY=                                # Financial Modeling Prep (OpenBB)
# POLYGON_API_KEY=                            # Polygon.io (OpenBB)
# TIINGO_API_KEY=                             # Tiingo (OpenBB)
# PYTDX_HOST=                                # 通达信服务器 IP
# PYTDX_PORT=                                # 通达信服务器端口
# PYTDX_SERVERS=                             # 多服务器（逗号分隔 ip:port）
# EFINANCE_CALL_TIMEOUT=30                   # efinance 单次超时（秒）
# REALTIME_SOURCE_PRIORITY=tencent,akshare_sina,efinance,akshare_em  # 实时行情源优先级
# REALTIME_CACHE_TTL=600                     # 实时行情缓存 TTL（秒）
# CIRCUIT_BREAKER_COOLDOWN=300               # 熔断冷却时间（秒）
# PREFETCH_REALTIME_QUOTES=true              # 预取实时行情

# --------------------------------------------------
# 基本面数据采集
# --------------------------------------------------
# FUNDAMENTAL_STAGE_TIMEOUT_SECONDS=1.5      # 基本面阶段总超时
# FUNDAMENTAL_FETCH_TIMEOUT_SECONDS=0.8      # 单数据源超时
# FUNDAMENTAL_RETRY_MAX=1                    # 失败重试次数
# FUNDAMENTAL_CACHE_TTL_SECONDS=120          # 缓存 TTL
# FUNDAMENTAL_CACHE_MAX_ENTRIES=256          # 缓存最大条目

# --------------------------------------------------
# 通知推送：微信企业号
# --------------------------------------------------
# WECHAT_WEBHOOK_URL=                        # 企业微信机器人 Webhook
# WECHAT_MSG_TYPE=markdown                   # 消息类型: markdown/text
# WECHAT_MAX_BYTES=4000                      # 消息最大字节数

# --------------------------------------------------
# 通知推送：飞书
# --------------------------------------------------
# FEISHU_WEBHOOK_URL=                        # 飞书机器人 Webhook
# FEISHU_APP_ID=                             # 飞书应用 App ID
# FEISHU_APP_SECRET=                         # 飞书应用 App Secret
# FEISHU_FOLDER_TOKEN=                       # 云文档目标文件夹 Token
# FEISHU_MAX_BYTES=20000                     # 消息最大字节数
# FEISHU_STREAM_ENABLED=false                # 启用 Stream 长连接
# FEISHU_VERIFICATION_TOKEN=                 # 事件订阅验证 Token
# FEISHU_ENCRYPT_KEY=                        # 消息加密 Key

# --------------------------------------------------
# 通知推送：Telegram
# --------------------------------------------------
# TELEGRAM_BOT_TOKEN=                        # Bot Token（从 @BotFather 获取）
# TELEGRAM_CHAT_ID=                          # 目标 Chat/Group ID
# TELEGRAM_MESSAGE_THREAD_ID=                # Topic/Thread ID
# TELEGRAM_WEBHOOK_SECRET=                   # Webhook Secret

# --------------------------------------------------
# 通知推送：Email
# --------------------------------------------------
# EMAIL_SENDER=                              # 发件人邮箱（SMTP 自动检测）
# EMAIL_SENDER_NAME=StockLens股票分析助手     # 发件人显示名
# EMAIL_PASSWORD=                            # 邮箱密码/授权码
# EMAIL_RECEIVERS=                           # 收件人（逗号分隔，空则发给自己）
# MERGE_EMAIL_NOTIFICATION=false             # 合并股票+大盘复盘为单封邮件

# --------------------------------------------------
# 通知推送：Discord
# --------------------------------------------------
# DISCORD_BOT_TOKEN=                         # Discord Bot Token
# DISCORD_MAIN_CHANNEL_ID=                   # 主频道 ID
# DISCORD_WEBHOOK_URL=                       # Webhook URL
# DISCORD_MAX_WORDS=2000                     # 消息字符上限
# DISCORD_BOT_STATUS=A股智能分析 | /help      # Bot 状态文本

# --------------------------------------------------
# 通知推送：钉钉
# --------------------------------------------------
# DINGTALK_APP_KEY=                           # 钉钉应用 Key
# DINGTALK_APP_SECRET=                        # 钉钉应用 Secret
# DINGTALK_STREAM_ENABLED=false               # 启用 Stream 模式

# --------------------------------------------------
# 通知推送：企业微信回调
# --------------------------------------------------
# WECOM_CORPID=                              # 企业 ID
# WECOM_TOKEN=                               # 回调 Token
# WECOM_ENCODING_AES_KEY=                    # 消息加密 Key
# WECOM_AGENT_ID=                            # 应用 AgentId

# --------------------------------------------------
# 通知推送：Pushover
# --------------------------------------------------
# PUSHOVER_USER_KEY=                         # 用户 Key
# PUSHOVER_API_TOKEN=                        # 应用 API Token

# --------------------------------------------------
# 通知推送：PushPlus
# --------------------------------------------------
# PUSHPLUS_TOKEN=                            # 推送 Token
# PUSHPLUS_TOPIC=                            # 群组 Topic 编码

# --------------------------------------------------
# 通知推送：ServerChan3
# --------------------------------------------------
# SERVERCHAN3_SENDKEY=                       # SendKey

# --------------------------------------------------
# 通知推送：AstrBot
# --------------------------------------------------
# ASTRBOT_URL=                               # AstrBot 通知 URL
# ASTRBOT_TOKEN=                             # AstrBot Token

# --------------------------------------------------
# 通知推送：自定义 Webhook
# --------------------------------------------------
# CUSTOM_WEBHOOK_URLS=                       # Webhook URL（逗号分隔）
# CUSTOM_WEBHOOK_BEARER_TOKEN=               # Bearer Token
# WEBHOOK_VERIFY_SSL=true                    # HTTPS 证书验证

# --------------------------------------------------
# 报告配置
# --------------------------------------------------
# SINGLE_STOCK_NOTIFY=false                  # 单股分析完立即推送
# REPORT_TYPE=simple                         # 报告格式: simple/full/brief
# REPORT_SUMMARY_ONLY=false                  # 仅推送摘要
# REPORT_TEMPLATES_DIR=templates             # Jinja2 模板目录
# REPORT_RENDERER_ENABLED=false              # 启用 Jinja2 渲染
# REPORT_INTEGRITY_ENABLED=true              # 报告完整性校验
# REPORT_INTEGRITY_RETRY=1                   # 校验失败重试次数 [0-3]
# REPORT_HISTORY_COMPARE_N=0                 # 历史信号对比条数 [0-10]
# REPORT_DIR=                                # 报告输出目录（空则使用默认）
# MARKDOWN_TO_IMAGE_CHANNELS=                # 渲染为图片的通道: telegram,wechat,custom,email
# MARKDOWN_TO_IMAGE_MAX_CHARS=15000          # 超过此长度跳过图片转换
# MD2IMG_ENGINE=wkhtmltoimage                # 图片引擎: wkhtmltoimage/markdown-to-file

# --------------------------------------------------
# Agent 模式
# --------------------------------------------------
# AGENT_MODE=false                           # 启用 ReAct Agent
# AGENT_MAX_STEPS=10                         # 最大步数 [1-50]
# AGENT_SKILLS=                              # 激活的策略（逗号分隔）
# AGENT_STRATEGY_DIR=                        # 自定义策略 YAML 目录
# AGENT_NL_ROUTING=false                     # 自然语言路由
# AGENT_ARCH=single                          # 架构: single(ReAct)/multi(编排器)
# AGENT_ORCHESTRATOR_MODE=standard           # 流水线: quick/standard/full/strategy
# AGENT_ORCHESTRATOR_TIMEOUT_S=600           # 超时预算（秒）[0-3600]
# AGENT_RISK_OVERRIDE=true                   # 风控 Agent 可否一票否决
# AGENT_DEEP_RESEARCH_BUDGET=30000           # 深度研究 Token 预算 [5000-100000]
# AGENT_DEEP_RESEARCH_TIMEOUT=180            # 深度研究超时（秒）[30-600]
# AGENT_MEMORY_ENABLED=false                 # 启用记忆与校准系统
# AGENT_STRATEGY_AUTOWEIGHT=true             # 回测自动加权策略
# AGENT_STRATEGY_ROUTING=auto                # 策略路由: auto(行情驱动)/manual
# AGENT_EVENT_MONITOR_ENABLED=false          # 事件驱动告警
# AGENT_EVENT_MONITOR_INTERVAL_MINUTES=5     # 轮询间隔（分钟）[1-1440]
# AGENT_EVENT_ALERT_RULES_JSON=              # 告警规则 JSON

# --------------------------------------------------
# 社交情绪
# --------------------------------------------------
# SOCIAL_SENTIMENT_API_KEY=                  # 社交情绪 API Key
# SOCIAL_SENTIMENT_API_URL=https://api.adanos.org  # API 地址

# --------------------------------------------------
# 新闻与分析
# --------------------------------------------------
# NEWS_MAX_AGE_DAYS=3                        # 新闻最大时效（天）[1-30]
# NEWS_STRATEGY_PROFILE=short                # 时效策略: ultra_short(1d)/short(3d)/medium(7d)/long(30d)
# BIAS_THRESHOLD=5.0                         # 乖离率追高预警阈值(%) [1.0-50.0]

# --------------------------------------------------
# 股票分组（邮件分组推送）
# --------------------------------------------------
# STOCK_GROUP_1=600519,000858
# EMAIL_GROUP_1=user1@example.com
# STOCK_GROUP_2=AAPL,NVDA
# EMAIL_GROUP_2=user2@example.com

# --------------------------------------------------
# 市场复盘
# --------------------------------------------------
# MARKET_REVIEW_REGION=cn                    # 复盘区域: cn/us/both

# --------------------------------------------------
# Web 认证
# --------------------------------------------------
# ADMIN_AUTH_ENABLED=false                   # 启用 Web 认证
# ADMIN_PASSWORD=                            # 管理员密码

# --------------------------------------------------
# CORS（API 跨域配置；G4.1 安全加固）
# --------------------------------------------------
# 默认仅允许本地开发端口（5173/3000）。生产部署如果前端不在同源，
# 必须显式列出允许的 origin。
# CORS_ORIGINS=https://example.com,https://app.example.com
#
# CORS_ALLOW_ALL：紧急 / demo 时用，会启动时打 WARNING 日志。
# 注意：开启它会**强制**关闭 allow_credentials（CORS RFC 不允许
# wildcard origin 与 credentials 共存），因此 admin session cookie
# 类的认证 API 会失效。生产环境永远不要开。
# CORS_ALLOW_ALL=false