README_STARTUP.md

系统启动说明

启动方式

1. 推荐启动方式

# 使用重构后的模块化架构启动
streamlit run run_main_app_refactored.py --server.port 8501

2. 传统启动方式

# 使用传统的单文件启动
python run_app.py

常见问题及解决方案

1. Tushare API初始化失败

错误信息：

Timeout value connect was functools.partial(...)

解决方案：

• 确保已正确配置Tushare Token
• 检查网络连接是否正常
• 尝试更新tushare库到最新版本：pip install --upgrade tushare

2. 会话文件被占用

错误信息：

[WinError 32] 另一个程序正在使用此文件，进程无法访问

解决方案：

1. 关闭所有正在运行的系统实例
2. 运行清理脚本：

   python scripts/clear_sessions.py

3. 重新启动系统

3. 页面显示空白或功能异常

解决方案：

1. 清除浏览器缓存
2. 清除系统会话状态：
   • 点击侧边栏的"清除持久化状态"按钮
   • 或运行清理脚本

环境配置

必需依赖

• Python 3.8+
• streamlit>=1.28.0
• tushare>=1.2.62
• pandas>=1.5.0
• plotly>=5.15.0

安装依赖

pip install -r requirements.txt

配置说明

Tushare Token配置

在环境变量中设置：

export TUSHARE_TOKEN=your_token_here

或在src/core/config.py中修改默认Token。

系统架构

系统采用模块化设计，包含以下主要模块：

• 多步骤选股流程（传统量化策略）
• 同花顺技术分析（专业级分析）
• 数据服务层（Tushare/同花顺数据接口）
• 缓存管理（SQLite数据库缓存）
• 会话管理（状态持久化）

注意事项

1. 系统默认端口为8501
2. 首次运行可能需要较长时间初始化数据
3. 建议定期清理缓存和会话文件以保持系统性能