Daily Stock Analysis 是一个基于AI大模型的A股、港股、美股、日股、韩股、台股自选股智能分析系统，支持每日自动生成「决策仪表盘」报告，并推送到企业微信、飞书、Telegram、Discord、Slack、邮箱等渠道。

1. 系统要求与准备

1.1 硬件与软件要求

  • 操作系统：Windows、macOS、Linux。
  • Python：版本 3.8+。
  • 网络：需要互联网连接以获取行情数据和调用AI模型API。
  • AI模型API Key：至少需要配置一个AI模型服务的API Key（推荐 Anspire 或 AIHubMix，提供多种模型）。

1.2 准备事项

  • 自选股列表：准备您要分析的股票代码（如 600519,hk00700,AAPL,7203.T,005930.KS,2330.TW）。
  • 通知渠道：准备至少一个通知渠道的Webhook或Token（如企业微信机器人）。

2. 部署方式

项目提供了多种部署方式，推荐从 GitHub Actions 开始，这是最便捷、零成本的方案。

2.1 方式一：GitHub Actions（推荐，零成本）

适合：希望定时运行、无需维护服务器、快速上手的用户。

  1. Fork 本仓库：点击右上角 Fork 按钮，将仓库复制到您的GitHub账户。
  2. 配置 Secrets（关键步骤）：
    • 进入您的仓库 Settings → Secrets and variables → Actions → New repository secret。
    • 添加以下必需的Secrets：
      • ANSPIRE_API_KEYS：Anspire API Key（推荐，同时提供模型和搜索能力）。
      • WECHAT_WEBHOOK_URL：企业微信机器人Webhook地址（或其他通知渠道的Secret）。
      • STOCK_LIST：您的自选股列表（如 600519,hk00700,AAPL）。
  3. 启用 Actions：点击 Actions 标签，点击 I understand my workflows, go ahead and enable them。
  4. 手动测试：进入 Actions → 每日股票分析 → Run workflow → Run workflow，测试运行是否成功。
  5. 自动运行：默认会在每个**工作日 18:00（北京时间）**自动执行分析并推送。

2.2 方式二：本地运行 / Docker 部署

适合：需要更多控制权、或希望运行Web界面的用户。

  1. 克隆项目：

    1
    2
    git clone https://github.com/ZhuLinsen/daily_stock_analysis.git
    cd daily_stock_analysis

  2. 安装依赖：

    1
    pip install -r requirements.txt

  3. 配置环境变量：

    1
    2
    cp .env.example .env
    # 编辑 .env 文件，填入您的API Key、通知渠道和自选股列表

  4. 运行分析：

    1
    python main.py
    • 常用命令：
      • python main.py --debug：调试模式。
      • python main.py --stocks 600519,hk00700：临时分析指定股票。
      • python main.py --market-review：生成大盘复盘报告。
      • python main.py --webui：启动Web界面（访问 http://127.0.0.1:8000）。

  5. Docker 部署（可选）：

    1
    2
    docker build -t daily-stock-analysis .
    docker run -d --env-file .env daily-stock-analysis

3. 核心功能与配置

3.1 配置详解

以下是在 .env 文件或GitHub Secrets中可配置的核心变量：

类别 变量名 说明 示例
AI模型 ANSPIRE_API_KEYS 推荐，同时提供LLM和搜索，新用户有免费额度 sk-...
OPENAI_API_KEY OpenAI兼容API Key（如DeepSeek、通义千问） sk-...
OPENAI_BASE_URL 自定义API地址 https://api.deepseek.com/v1
通知渠道 WECHAT_WEBHOOK_URL 企业微信机器人地址 https://qyapi.weixin.qq.com/...
FEISHU_WEBHOOK_URL 飞书机器人地址 https://open.feishu.cn/...
TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID Telegram Bot 123456:ABC...
自选股 STOCK_LIST 用逗号分隔的股票代码 600519,hk00700,AAPL,7203.T
新闻搜索 SERPAPI_API_KEYS 用于获取新闻舆情，增强分析质量 ...
行情数据 TUSHARE_TOKEN A股行情增强（可选） ...

3.2 分析报告内容

系统会为每只自选股生成一份包含以下内容的决策仪表盘：

  • 综合评分与决策：买入/观望/卖出建议。
  • 核心结论：AI生成的简明分析。
  • 舆情情绪：基于新闻和社交媒体的情绪判断。
  • 风险警报：资金流向、筹码分布等风险点。
  • 利好催化：业绩预告、政策利好等。
  • 最新动态：最近的重要新闻或公告。

4. 高级功能

4.1 Web 界面 (--webui)

启动Web UI后，您可以：

  • 手动触发分析：选择日期和股票进行分析。
  • 查看历史报告：浏览以往的分析记录。
  • Agent策略问股：在 /chat 页面进行多轮对话式问股，支持均线、缠论、趋势等15+种策略。
  • 持仓与回测管理：记录和跟踪投资组合。
  • 配置管理：在线修改系统配置。

4.2 大盘复盘 (--market-review)

生成包含主要指数涨跌、市场概况、板块表现的每日市场复盘报告。

5. 常见问题排查

问题 可能原因 解决方案
GitHub Actions 运行失败 Secrets配置不全或不正确 检查 Secrets 中是否配置了 ANSPIRE_API_KEYS（或其他LLM Key）、WECHAT_WEBHOOK_URL（或其他通知渠道）和 STOCK_LIST。查看Actions日志获取具体错误信息。
收不到推送消息 Webhook URL错误或网络问题 检查通知渠道的Secret值是否正确。确保企业微信/飞书机器人能够访问外网。
分析报告质量不高 新闻搜索源未配置或AI模型能力有限 建议配置 SERPAPI_API_KEYS 或 ANSPIRE_API_KEYS（自带搜索）以获取更丰富的舆情信息。尝试在 .env 中更换更强大的AI模型。
本地运行时 ModuleNotFoundError Python依赖未完整安装 确保在正确的虚拟环境中运行 pip install -r requirements.txt。
数据获取失败或超时 免费数据源受限或网络波动 这是使用免费数据源的正常现象。可配置 TUSHARE_TOKEN 等付费/稳定数据源提升可靠性。系统会自动重试和降级。

6. 总结

Daily Stock Analysis 是一个功能完整、部署灵活的AI股票分析工具。

核心部署路径：

  1. 快速体验：使用 GitHub Actions 方式，5分钟完成配置，免费定时运行。
  2. 本地控制：克隆项目，安装依赖，配置 .env，通过 python main.py 运行。
  3. 可视化操作：启动 --webui，在浏览器中管理配置、手动分析、查看历史。
  4. 个性化配置：根据需求调整AI模型、数据源、通知渠道和分析参数。

建议：

  • 对于初次使用者，强烈建议从 GitHub Actions 开始，这是最简单、最稳定的方式。
  • 配置时，至少确保 AI模型、一个通知渠道 和 自选股列表 这三个核心要素正确设置。
  • 如果对分析质量有更高要求，可以配置 新闻搜索API 来增强舆情分析。
  • 所有功能细节和高级配置，请参考项目仓库中的 完整配置与部署指南。

项目地址：https://github.com/ZhuLinsen/daily_stock_analysis