docs: 添加AI功能配置指南 - 说明如何启用Claude API（可选）

AI_SETUP.md

@@ -0,0 +1,127 @@
+# AI 功能配置指南
+
+## 问题说明
+
+如果您看到"获取推荐失败: Failed to fetch AI market overview"错误，这是因为 **Claude AI 功能未配置**。
+
+**好消息**：系统已经实现了自动降级机制，即使不配置 Claude API，系统仍然可以正常使用！
+
+## 当前状态（无AI配置）
+
+✅ **可用功能**：
+- 实时行情数据（新浪、腾讯、东方财富）
+- 历史K线数据
+- ML推荐（XGBoost + LightGBM）
+- 技术指标分析
+- 基本面数据（PE/PB）
+- 实时刷新
+
+❌ **不可用功能**：
+- Claude AI 自然语言解释
+- AI增强的市场分析
+- 智能问答（AI Dock）
+
+## 启用 AI 功能（可选）
+
+如果您希望使用 Claude AI 增强功能，需要配置 OpenRouter API Key。
+
+### 步骤 1：获取 OpenRouter API Key
+
+1. 访问 https://openrouter.ai/
+2. 注册账号并登录
+3. 前往 Keys 页面生成 API Key
+4. 复制您的 API Key（格式：`sk-or-v1-...`）
+
+### 步骤 2：配置环境变量
+
+编辑 `backend/.env` 文件：
+
+```bash
+# 将 your-key 替换为实际的 API Key
+OPENROUTER_API_KEY=sk-or-v1-your-actual-key-here
+```
+
+### 步骤 3：重启后端服务
+
+```bash
+# 如果使用 PM2
+pm2 restart ljwx-stock-backend
+
+# 如果使用 start_app.sh
+./stop_app.sh
+./start_app.sh
+```
+
+### 步骤 4：验证配置
+
+访问前端页面，刷新数据，应该不再看到错误提示。
+
+## API 费用说明
+
+OpenRouter 采用按量计费：
+
+- **Claude 4.5 Sonnet**：
+  - 输入：$3.00 / 1M tokens
+  - 输出：$15.00 / 1M tokens
+
+- **预估成本**（基于缓存优化）：
+  - 日活100用户：~$2-5/天
+  - 日活1000用户：~$15-30/天
+
+**节省建议**：
+- 系统已配置 3600秒 LLM 缓存（1小时）
+- 重复查询会命中缓存，不产生费用
+- 可在 `backend/.env` 中调整 `CACHE_TTL_LLM`
+
+## 替代方案：本地 LLM
+
+如果不想使用付费 API，可以配置本地 Ollama：
+
+```bash
+# 安装 Ollama
+brew install ollama
+
+# 下载模型
+ollama pull qwen3-coder:30b
+
+# 启动 Ollama 服务
+ollama serve
+
+# 配置 backend/.env
+OLLAMA_BASE_URL=http://localhost:11434
+DEEPSEEK_MODEL=qwen3-coder:30b-a3b-q8_0
+```
+
+注意：本地 LLM 效果不如 Claude，但完全免费。
+
+## 常见问题
+
+### Q: 不配置 AI 能用吗？
+
+A: **可以**！系统会自动降级到普通推荐模式，核心功能不受影响。
+
+### Q: 配置后仍然报错？
+
+A: 检查：
+1. API Key 格式是否正确（`sk-or-v1-...`）
+2. 是否重启了后端服务
+3. 查看后端日志：`pm2 logs ljwx-stock-backend`
+
+### Q: 如何控制 API 费用？
+
+A: 调整 `backend/.env`：
+```bash
+# 增加缓存时间（秒）
+CACHE_TTL_LLM=7200  # 2小时
+
+# 或禁用自动刷新
+# 修改 frontend/src/views/DashboardV2.vue
+# 将 60000 改为更大的值或注释掉自动刷新代码
+```
+
+## 技术支持
+
+如有问题，请查看：
+- 后端日志：`pm2 logs ljwx-stock-backend`
+- 前端控制台：浏览器 F12 -> Console
+- 提交 Issue：https://github.com/your-repo/issues