10 分钟，把它跑起来

第 1 步 · Fork 仓库

打开 ZhuLinsen/daily_stock_analysis，点右上角 Fork。你会得到一份完全属于自己的副本，后续改配置不会影响原作者。

第 2 步 · 配置 Secrets

进入你 Fork 后仓库的 Settings → Secrets and variables → Actions → New repository secret。最少只需要三类：

STOCK_LIST 可以直接复制下面这行做测试：

600519,hk00700,AAPL,7203.T,005930.KS,2330.TW

这行包含 A 股、港股、美股、日股、韩股、台股各一只。更稳妥的做法是先只放 2–3 只熟悉的股票，确认链路通了再扩容。

第 3 步 · 启用 Actions 并手动跑一次

点击仓库顶部 Actions 标签 → 同意启用 workflows → 左侧选择「每日股票分析」→ 右侧 Run workflow。模式选 full（个股 + 大盘），需要跳过交易日检查时再勾 force_run。

大约几十秒后刷新页面，你会看到一个正在运行的 job。展开日志，关键节点包括：安装依赖、检查环境、分析个股、大盘复盘、发送通知。结束后 Artifacts 里会有 reports 和 logs，保留 30 天。

第 4 步 · 等它每天自己上班

默认 cron 是 0 10 * * 1-5（UTC），也就是北京时间周一至周五 18:00。非交易日会自动跳过；如果当天是节假日但你仍想跑，用 force_run。

Actions 环境默认把 MAX_WORKERS 设为 1、报告类型设为 simple，并用随机延迟 0–60 秒错峰启动。这些默认值是为云端环境稳定性做的取舍，不是功能缺失。

第 1 步 · 装依赖

需要 Python 3.10+，推荐 3.11（与官方 CI/Actions 一致）。项目依赖较多，建议用虚拟环境：

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

python3.11 -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate

pip install --upgrade pip
pip install -r requirements.txt

如果某些数据源依赖在你的平台装不上，可以先跳过它们——系统会按能力矩阵降级，不是所有源都必须可用。

第 2 步 · 写 .env

cp .env.example .env
# 用编辑器打开 .env，至少填写：
# STOCK_LIST=600519,300750
# MODELFLARE_KEY=你的key          （或 AIHUBMIX_KEY / GEMINI_API_KEY）
# WECHAT_WEBHOOK_URL=你的webhook  （或飞书/Telegram/Discord/邮件）

.env.example 有上千行，但绝大多数可以留空。不要被它吓到：配置是「按需增强」，不是「全部必填」。

第 3 步 · 先干跑，再真跑

# 只抓数据、不算 LLM、不推送：验证数据源与代码格式
python main.py --dry-run

# 真正分析一只股票，打开调试日志
python main.py --stocks 600519 --debug

# 只分析、不推送
python main.py --no-notify

# 启动 Web 工作台（浏览器访问 http://127.0.0.1:8000）
python main.py --webui

第 4 步 · 本地定时

python main.py --schedule          # 常驻，按配置时间执行
python main.py --serve-only        # 只启动 Web/API，不跑分析
python main.py --market-review     # 只做大盘复盘

注意：本地定时和 Actions 定时是两套独立入口。同时开启、又共用同一个 SQLite，系统会尽量通过「原子认领」避免重复；但多机部署且数据库不共享时，仍可能重复推送。

一条命令起服务

cp .env.example .env
# 编辑 .env：STOCK_LIST、模型 Key、通知、API_PORT

# 只跑定时分析
docker compose -f ./docker/docker-compose.yml up -d analyzer

# 只跑 Web/API
docker compose -f ./docker/docker-compose.yml up -d server

# 两个都跑（注意：只保留一个调度入口）
docker compose -f ./docker/docker-compose.yml up -d

镜像默认以非 root 用户运行，暴露 /api/health 健康检查，并挂载 data/、logs/、reports/、strategies/。完整分析建议 1G 以上内存；512M 仅适合轻量 Web 或单股低并发。