daily_stock_analysis

环境要求

• Python 环境（需能执行 pip 与 python 命令）
• 项目代码已下载到本地目录
• 至少一个 AI 模型 API Key（如 ANSPIRE_API_KEYS、GEMINI_API_KEY、OPENAI_API_KEY 等）
• 至少一个通知渠道配置（如企业微信/飞书 Webhook、Telegram、邮箱等）
• 必填的自选股列表 STOCK_LIST

安装与启动步骤

1. 1安装依赖

   进入项目根目录后执行，按 requirements.txt 安装 Python 依赖，建议先建虚拟环境避免污染全局。

   pip install -r requirements.txt

   复制

2. 2生成并编辑配置

   复制示例环境变量文件为 .env，再打开编辑，填入模型 Key、推送渠道和自选股。

   cp .env.example .env && vim .env

   复制

3. 3配置 AI 模型 Key

   在 .env 中至少填一个模型服务的 API Key；用 OpenAI 兼容服务时同时填 OPENAI_BASE_URL 与 OPENAI_MODEL。

4. 4配置通知渠道

   至少配置一个推送渠道的 Webhook 或 Token，否则分析结果无法推送到企业微信/飞书/Telegram 等。

5. 5填写自选股

   STOCK_LIST 为必填，代码用英文逗号分隔，支持 A股、港股、美股、日股、韩股、台股。

6. 6运行一次分析

   执行主程序，读取 .env 配置后拉取行情与新闻并生成决策仪表盘、推送结果。

   python main.py

   复制

7. 7调试与空跑

   --debug 输出调试日志，--dry-run 只生成不实际推送，适合首次验证配置是否正确。

   python main.py --debug
   python main.py --dry-run

   复制

8. 8启用定时或常驻服务

   --schedule 本地定时运行；--serve-only 仅启动 FastAPI 服务，不执行分析任务。

   python main.py --schedule
   python main.py --serve-only

   复制

关键配置

如何确认成功

运行 python main.py 后终端输出分析日志与报告，且配置的通知渠道收到「决策仪表盘」推送即成功。

常见问题

注意事项

• 必填项只有 STOCK_LIST，模型 Key 与通知渠道各至少配一个才能完成分析与推送。
• 指数类自选股需使用显式代码（如 sh000016、930606.CSI），且通过一次性 --stocks 或 GitHub Actions 入口支持。
• 新闻源会显著影响舆情、公告与催化因素质量，建议至少配置一个搜索服务。
• 不要将 .env 中的 API Key 提交到公开仓库。