Files

T

brunoandQwen-Coder 439ad8a854 feat: Upgrade to real-world dynamic stock recommendation system with Claude + Qwen3 AI collaboration

- Implement dynamic stock universe with 3-stage filtering (liquidity, fundamentals, technicals)
- Create Claude + Qwen3 AI collaboration service for intelligent stock analysis
- Update recommendation routes to use live market data instead of hard-coded lists
- Add new documentation and deployment scripts
- Update Docker configuration for AI model integration

BREAKING CHANGE: Replaces hard-coded stock recommendations with dynamic market-based filtering

Co-authored-by: Qwen-Coder <[email protected]>

2025-11-16 12:43:03 +08:00

3.7 KiB

Raw Permalink Blame History

✅ 安装问题已解决！

问题回顾

遇到的错误

❌ pandas 安装失败 - Python 3.14 太新
❌ LightGBM 编译失败 - 缺少 cmake/libomp
❌ ModuleNotFoundError: No module named 'pydantic_settings' - pip 缓存损坏

根本原因

pip 缓存损坏导致 pydantic-settings 虽然显示安装成功，但实际上没有被正确安装到虚拟环境中。

解决方案

已经通过以下方式修复：

pip cache purge  # 清除损坏的缓存
pip install --no-cache-dir --force-reinstall pydantic==2.5.0 pydantic-settings==2.1.0

✅ 验证结果：

✓ pydantic: 2.5.0
✓ pydantic_settings: 2.1.0
✓ BaseSettings import: OK

🚀 现在可以启动了！

方法 1：直接启动（推荐）

./start_app.sh

启动脚本会：

✅ 自动检测并使用 Python 3.12
✅ 检查所有依赖是否正确安装
✅ 清除 pip 缓存避免问题
✅ 验证关键模块可以导入
✅ 启动所有服务

方法 2：如果仍有问题（完全重建）

# 完全清理
rm -rf backend/.venv
pip cache purge

# 重新启动
./start_app.sh

更新的脚本

1. `start_app.sh` - 主启动脚本

✅ Python 版本检测（优先使用 3.12）
✅ 端口冲突自动处理
✅ 依赖安装验证
✅ 一键启动所有服务

2. `install_deps.sh` - 依赖安装脚本

✅ 自动清除 pip 缓存（避免缓存损坏问题）
✅ 使用 --no-cache-dir 强制下载
✅ 分步安装核心包
✅ 每个包安装后立即验证导入
✅ 详细的错误提示

3. `quick_fix.sh` - 快速修复脚本

✅ 修复 pydantic_settings 问题
✅ 验证导入是否正常

4. `fix_install.sh` - 一键重装

✅ 清理旧环境
✅ 检查编译工具
✅ 重新运行安装

服务访问地址

启动后可访问：

服务	地址	说明
前端	http://localhost:5173	Vue 3 开发服务器
后端	http://localhost:8000	FastAPI 服务器
API 文档	http://localhost:8000/docs	Swagger UI
PostgreSQL	localhost:5432	数据库（user: stockai, pass: stockai2025）
Redis	localhost:6379	缓存服务器

常用命令

# 启动开发环境
./start_app.sh

# 只启动后端
./start_app.sh --no-frontend

# 停止服务
./stop_app.sh

# 停止包括数据库
./stop_app.sh --all

# 查看前端日志
tail -f logs/frontend.log

# 重新安装依赖
./install_deps.sh

# 快速修复 pydantic 问题
./quick_fix.sh

下一步

启动应用
```
./start_app.sh
```

配置 API Keys

编辑 backend/.env 并填入你的真实 API keys：

OPENROUTER_API_KEY=sk-or-v1-your-real-key
TUSHARE_TOKEN=your-tushare-token
ALPHA_VANTAGE_API_KEY=your-alphavantage-key

访问应用
- 前端：http://localhost:5173
- API 文档：http://localhost:8000/docs
开始开发 🎉

故障排查

如果还有问题，查看：

TROUBLESHOOTING_PYTHON.md - Python 环境问题完整指南
DEV_SETUP.md - 开发环境设置详细文档
CLAUDE.md - 项目架构和开发指南

技术细节

为什么会发生这个问题？

pip 缓存在以下情况下可能损坏：

网络中断导致下载不完整
磁盘空间不足
pip 版本升级
系统异常关闭

如何避免？

更新的脚本通过以下方式避免：

# 1. 每次安装前清除缓存
pip cache purge

# 2. 使用 --no-cache-dir 跳过缓存
pip install --no-cache-dir package

# 3. 安装后立即验证
python -c "import package"

问题解决时间: 2025-11-16
解决方法: 清除 pip 缓存 + 强制重装
状态: ✅ 已解决

3.7 KiB Raw Permalink Blame History Unescape Escape