WorldQuant Miner

WorldQuant Miner 是一个以 Experiment 为中心的 Alpha 实验平台，现在以 FastAPI Web 服务运行。

前端不分离，不需要 Vue/React/Vite。FastAPI 直接返回一个内置 HTML 页面，页面用原生 JavaScript 调用后端接口。

启动

uv run uvicorn app.interfaces.web:app --host 127.0.0.1 --port 8000

打开：

http://127.0.0.1:8000

也可以按 .env 中的 WEB_HOST、WEB_PORT 调整监听地址和端口。

配置

系统配置放在 .env：

• WorldQuant 账号和密码
• API base url
• 请求超时、重试、限流
• 数据库路径
• 元数据 cache 路径
• LLM 配置
• Web 监听配置
• 日志级别

实验参数不放 .env。页面表单负责提交实验参数，包括：

• dataset、region、universe、delay、neutralization、decay、truncation
• metadata policy
• generation
• queue
• analysis
• evolution

data/cache

data/cache 仍然是唯一元数据目录，不能移动。

当前后端通过 MetadataCache 读取：

• data/cache/datasets.json
• data/cache/operators.json
• data/cache/fields/{dataset_id}.json

页面中的“检查 cache”按钮会验证这些文件是否可用。

Web 操作流程

1. 打开首页。
2. 点击“检查系统状态”。
3. 点击“检查 cache”。
4. 填写实验配置。
5. 点击“创建实验”。
6. 点击“生成候选”。
7. 点击“查看报告”或“查看候选”。
8. 如果确认要真实提交 WorldQuant simulation，再点击“启动真实队列”。

真实提交保护

只有页面里的“启动真实队列”会触发真实 WorldQuant simulation。

真实提交前必须满足：

• .env 中 WQ_EMAIL 和 WQ_PASSWORD 已配置。
• .env 中 ENABLE_SIMULATION=true。
• 当前实验配置有效。

否则后端会直接拒绝提交。

API

• GET /
• GET /api/system/status
• GET /api/metadata/cache/status?dataset=analyst4
• POST /api/experiments
• POST /api/experiments/{id}/generate-candidates
• POST /api/experiments/{id}/start-queue
• GET /api/experiments/{id}/report
• GET /api/experiments/{id}/candidates
• GET /api/experiments/{id}/jobs