docs: reorganize .env.example and add missing variables

- Unified provider block order (PROVIDER → MODEL → KEY → URL)
- Grouped LLM params (temperature, timeout, retries) together
- Added API Server section (API_AUTH_KEY, CORS_ORIGINS, ENABLE_SESSION_RUNTIME)
- Added CCXT_EXCHANGE for crypto fallback config
- Renamed Swarm section to Agent Tuning

Author: warren618

agent/.env.example

@@ -1,89 +1,99 @@
 # ============================================================================
-# LLM Provider — uncomment ONE block below
+# LLM Provider — uncomment ONE provider block below
 # ============================================================================
-LANGCHAIN_TEMPERATURE=0.0
 
-# --- OpenRouter ---
+# --- OpenRouter (recommended, multi-model gateway) ---
 LANGCHAIN_PROVIDER=openrouter
+LANGCHAIN_MODEL_NAME=deepseek/deepseek-v3.2
 OPENROUTER_API_KEY=sk-or-v1-your-key-here
 OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
-LANGCHAIN_MODEL_NAME=deepseek/deepseek-v3.2
-
-# --- DeepSeek ---
-# LANGCHAIN_PROVIDER=deepseek
-# DEEPSEEK_API_KEY=sk-xxx
-# DEEPSEEK_BASE_URL=https://api.deepseek.com/v1
-# LANGCHAIN_MODEL_NAME=deepseek-chat
 
 # --- OpenAI ---
 # LANGCHAIN_PROVIDER=openai
+# LANGCHAIN_MODEL_NAME=gpt-4o
 # OPENAI_API_KEY=sk-xxx
 # OPENAI_BASE_URL=https://api.openai.com/v1
-# LANGCHAIN_MODEL_NAME=gpt-4o
+
+# --- DeepSeek ---
+# LANGCHAIN_PROVIDER=deepseek
+# LANGCHAIN_MODEL_NAME=deepseek-chat
+# DEEPSEEK_API_KEY=sk-xxx
+# DEEPSEEK_BASE_URL=https://api.deepseek.com/v1
 
 # --- Gemini ---
 # LANGCHAIN_PROVIDER=gemini
+# LANGCHAIN_MODEL_NAME=gemini-2.5-flash
 # GEMINI_API_KEY=xxx
 # GEMINI_BASE_URL=https://generativelanguage.googleapis.com/v1beta/openai/
-# LANGCHAIN_MODEL_NAME=gemini-2.5-flash
 
 # --- Groq ---
 # LANGCHAIN_PROVIDER=groq
+# LANGCHAIN_MODEL_NAME=llama-3.3-70b-versatile
 # GROQ_API_KEY=gsk_xxx
 # GROQ_BASE_URL=https://api.groq.com/openai/v1
-# LANGCHAIN_MODEL_NAME=llama-3.3-70b-versatile
 
 # --- DashScope / Qwen ---
 # LANGCHAIN_PROVIDER=dashscope
+# LANGCHAIN_MODEL_NAME=qwen-plus
 # DASHSCOPE_API_KEY=sk-xxx
 # DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
-# LANGCHAIN_MODEL_NAME=qwen-plus
 
 # --- Zhipu ---
 # LANGCHAIN_PROVIDER=zhipu
+# LANGCHAIN_MODEL_NAME=glm-4-plus
 # ZHIPU_API_KEY=xxx
 # ZHIPU_BASE_URL=https://open.bigmodel.cn/api/paas/v4
-# LANGCHAIN_MODEL_NAME=glm-4-plus
 
 # --- Moonshot / Kimi ---
 # LANGCHAIN_PROVIDER=moonshot
+# LANGCHAIN_MODEL_NAME=kimi-k2.5
 # MOONSHOT_API_KEY=sk-xxx
 # MOONSHOT_BASE_URL=https://api.moonshot.ai/v1
-# LANGCHAIN_MODEL_NAME=kimi-k2.5
 
 # --- MiniMax ---
 # LANGCHAIN_PROVIDER=minimax
+# LANGCHAIN_MODEL_NAME=MiniMax-Text-01
 # MINIMAX_API_KEY=xxx
 # MINIMAX_BASE_URL=https://api.minimax.io/v1
-# LANGCHAIN_MODEL_NAME=MiniMax-Text-01
 
 # --- Xiaomi MIMO ---
 # LANGCHAIN_PROVIDER=mimo
+# LANGCHAIN_MODEL_NAME=MiMo-72B-A27B
 # MIMO_API_KEY=xxx
 # MIMO_BASE_URL=https://api.xiaomimimo.com/v1
-# LANGCHAIN_MODEL_NAME=MiMo-72B-A27B
 
-# --- Ollama ---
+# --- Ollama (local) ---
 # LANGCHAIN_PROVIDER=ollama
-# OLLAMA_BASE_URL=http://localhost:11434/v1
 # LANGCHAIN_MODEL_NAME=qwen2.5:32b
+# OLLAMA_BASE_URL=http://localhost:11434/v1
+
+# LLM parameters
+LANGCHAIN_TEMPERATURE=0.0
+TIMEOUT_SECONDS=120
+MAX_RETRIES=2
 
 # ============================================================================
-# Data Providers
+# Data Sources
 # ============================================================================
-# A-shares: Tushare Pro (requires token, https://tushare.pro)
+# A-shares: Tushare Pro token (https://tushare.pro)
 TUSHARE_TOKEN=your-tushare-token
-# HK/US equities: yfinance (free, no key needed)
-# Crypto: OKX public API (free, no key needed)
+# HK/US equities: yfinance (free, no config needed)
+# Crypto: OKX public API (free, no config needed)
+# Crypto fallback exchange (default: binance). Change if OKX is blocked:
+# CCXT_EXCHANGE=binance
 
 # ============================================================================
-# Runtime
+# API Server (optional)
 # ============================================================================
-TIMEOUT_SECONDS=120
-MAX_RETRIES=2
+# Bearer token for API auth (empty = no auth, dev mode)
+# API_AUTH_KEY=
+# CORS allowed origins (comma-separated)
+# CORS_ORIGINS=http://localhost:3000,http://localhost:5173,http://localhost:8000
+# Enable session runtime
+# ENABLE_SESSION_RUNTIME=true
 
 # ============================================================================
-# Swarm / Subagent tuning (optional, defaults are sensible)
+# Agent Tuning (optional, defaults are sensible)
 # ============================================================================
 # SWARM_WORKER_TIMEOUT=300
 # SWARM_WORKER_MAX_ITER=50