ljwx-stock/AI_SETUP.md

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 文件：

# 将 your-key 替换为实际的 API Key
OPENROUTER_API_KEY=sk-or-v1-your-actual-key-here

步骤 3：重启后端服务

# 如果使用 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：

# 安装 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：

# 增加缓存时间（秒）
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