BEAM

Betting Earnings And Moves with AI
用 AI 押注财报后的股价走势。

中文 · English

BEAM 是一个本地运行的财报后股价反应预测终端。它把未来美股财报日历、三个本机 AI CLI 的方向判断，以及事后结算战绩放在一个高密度终端界面中。

能做什么

• 从 Finnhub 同步未来 90 天美股财报，并缓存在 SQLite。
• 通过本机 Codex CLI、Claude CLI、Gemini CLI 预测财报后股价：看涨、看跌或中性，并附带置信度、双语分析和研究来源。
• 在详情页查看实时报价、价格曲线和每个模型的分析。
• 使用 Yahoo Finance 日线结算已到期预测；横盘区间固定为 -3% 至 +3%，并在“模型战绩”中展示累计准确率。
• 支持搜索、筛选、排序、拖拽列宽、分页及中英文界面。

环境要求

• Node.js 22.13+
• Python 3.12+
• 已在本机登录 Codex CLI、Claude CLI 与 Gemini CLI
• Finnhub API key

安装与配置

在项目根目录执行。Windows PowerShell：

npm install
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r backend\requirements.txt
Copy-Item .env.example .env.local
Copy-Item backend\.env.example backend\.env

macOS / Linux（Bash、Zsh）：

npm install
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r backend/requirements.txt
cp .env.example .env.local
cp backend/.env.example backend/.env

在 backend\.env（macOS/Linux 为 backend/.env）至少填写：

FINNHUB_API_KEY=你的_finnhub_key

可选项：

EARNINGS_DATABASE_PATH=backend/data/earnings.db
AI_CLI_TIMEOUT_SECONDS=480
CODEX_CLI_MODEL=gpt-5.6-sol
CLAUDE_CLI_MODEL=claude-opus-5
GEMINI_CLI_MODEL=gemini-3.1-pro-preview

CLI 的登录、网页搜索、MCP 与其他工具配置由各自的本机 CLI 管理；本项目不保存模型 API key。

启动

Windows PowerShell：

.\.venv\Scripts\Activate.ps1
npm run dev:all

macOS / Linux：

source .venv/bin/activate
npm run dev:all

• 网站：http://localhost:3000
• API：http://127.0.0.1:8000

首次使用需同步财报日历：

python -m backend.app.cli earnings sync

日常操作

后端服务运行时，使用以下三条命令：

# 1. 更新未来 90 天财报日历（Finnhub；不调用 AI）
python -m backend.app.cli earnings sync

# 2. 提交待预测财报（本机 AI CLI）
python -m backend.app.cli predictions run --lookahead-days 7 --limit 5

# 指定日期或单只股票
python -m backend.app.cli predictions run --start-date 2026-08-03 --end-date 2026-08-03 --limit 5
python -m backend.app.cli predictions run --symbol NVDA

# 3. 结算到期预测（Yahoo Finance；不调用 AI）
python -m backend.app.cli evaluations run

预测命令默认跳过已有真实预测；仅在确实需要覆盖时添加 --force。使用 --wait 可在终端持续查看任务状态：

python -m backend.app.cli predictions run --symbol NVDA --wait

数据说明

• 财报日期、公司资料和可获得的一致预期来自 Finnhub。
• 价格曲线和预测结算使用 Yahoo Finance 日线数据。
• 前端只读取 SQLite 缓存；同步日历或提交 AI 任务才会访问外部服务。
• AI 预测是独立观点，不保证准确，也不构成投资、交易或财务建议。

项目结构

app/          React + TypeScript 前端
backend/app/  FastAPI、SQLite、日历同步、AI 任务与结算逻辑
backend/data/ 本地 SQLite 数据库（运行后生成）
tests/        前端测试
backend/tests/ 后端测试

验证

npm run typecheck
npm run build
npm test