参考
Web 界面与 API
vibe-trading serve 启动 FastAPI 服务，Web 界面、IM 渠道和定时任务都通过它运行。
Web 界面页面
- Agent——对话，实时显示工具步骤和团队面板；每条消息最多附五个文件。
- 报告与运行详情——历史运行、指标、图表和代码；对比页并排比较多次运行。
- 持仓——汇总各券商连接的只读持仓。
- Alpha Zoo——浏览、评测和对比因子。
- 期权实验室与相关性状态。
- 定时——周期性研究任务。
- 设置——模型、数据源、IM 渠道和 API key。
访问与安全
在本机上无需任何配置即可使用。其他客户端访问时，请设置 API_AUTH_KEY，并在请求里带上 Authorization: Bearer <key>。交互式 API 文档 /docs 只在未设 key 的本机模式下开放；设了 key 后，带上请求头去取 /openapi.json。
IM 渠道
WebSocket、Telegram、Slack、Discord、Matrix、WhatsApp、Signal、QQ/NapCat、微信/企业微信、飞书/Lark、钉钉、Microsoft Teams、邮件和 Mochat 共用同一套会话。在设置 → IM 渠道里配置和启动，或使用 vibe-trading channels status | start | stop。不在渠道 allow_from 名单里的发送者会在私聊里收到一个配对码，在你用 vibe-trading channels pairing approve 批准之前，其消息都会被忽略。
定时研究
按固定间隔或 cron 表达式定时运行一条指令或一次回测。执行器默认关闭，启动服务时设置 VIBE_TRADING_ENABLE_SCHEDULER=1 才会开启。自带五个可直接定时的模板：盘前简报、财报季跟踪、组合体检、A 股资金流向和机构持仓变动。
vibe-trading playbook list
vibe-trading playbook show premarket-brief
vibe-trading playbook create premarket-brief主要接口
| 接口 | 作用 |
|---|---|
POST /sessions、POST /sessions/{id}/messages | 创建会话、发送消息 |
GET /sessions/{id}/events | SSE 事件流 |
POST /sessions/{id}/cancel | 停止正在进行的运行 |
GET /runs、GET /runs/{run_id} | 运行记录 |
POST /upload | 上传文档、数据文件或图片 |
POST /swarm/runs | 启动团队运行 |
POST /alpha/bench | 启动 Alpha Zoo 评测 |
/scheduled-runs | 定时任务与模板 |
POST /live/halt、POST /live/resume | 紧急停止 |