feat: add Super Alpha research, management and MCP workflows
Deploy production / deploy (push) Successful in 56s
Deploy production / deploy (push) Successful in 56s
This commit is contained in:
yuxuanhui
+52
-2
@@ -54,7 +54,7 @@ python -m app.cli mcp-token-revoke TOKEN_ID
|
||||
| search_data_preparations | `{q?,scope_key?,limit?,offset?}`；查询可编辑集合及当前版本 |
|
||||
| get_data_preparation | `{id,version,q?,limit?,offset?}`；按版本分页预览字段与数据集归属，版本冲突重新选择 |
|
||||
| search_catalog | `{filters:{region,universe,delay,...},dataset_id?}`；省略 dataset_id 查数据集，提供则查字段 |
|
||||
| get_research_metadata | `{query:{kind,...}}`；kind 为 scopes/settings/operators/field_availability |
|
||||
| get_research_metadata | `{query:{kind,...}}`；kind 为 scopes/settings/operators/field_availability/superalpha |
|
||||
| refresh_research_data | `{query:{kind,...}}`；kind 为 catalog/operators/settings/field_availability/pnl |
|
||||
| get_submission_check | `{alpha_id}`；读取检查上下文、snapshot 和缓存结果，不发起检查 |
|
||||
| check_submission | `{alpha_id,snapshot,descriptions}`；写回已确认描述并异步检查，绝不正式提交；要求 research:refresh |
|
||||
@@ -65,7 +65,7 @@ python -m app.cli mcp-token-revoke TOKEN_ID
|
||||
| submit_backtests | `{name,candidates,idempotency_key,preparation_refs?,duplicate_policy?,source?}` |
|
||||
| get_backtest | `{run_id,after?,event_limit?}`，after 为事件游标 |
|
||||
| get_backtest_results | `{run_id,item_ids?,limit?,offset?}` |
|
||||
| get_backtest_artifact | `{item_id,kind,limit?,offset?,date_from?,date_to?}`，kind 为 snapshot/pnl |
|
||||
| get_backtest_artifact | `{item_id,kind,limit?,offset?,date_from?,date_to?}`，kind 为 snapshot/pnl/components |
|
||||
| control_backtest | `{run_id,action,expected_version,idempotency_key}` |
|
||||
|
||||
metadata 的 operators 支持 q/category 和分页；settings 支持分页；field_availability 要求 field_id 和 scope。refresh 的 catalog 要求 scope，可选 dataset_id；pnl 要求 alpha_ids；availability 与读取使用相同范围字段。目录和 PnL 刷新返回 job_id，查询不会隐式刷新；另外三种刷新最多等待 30 秒，成功只返回快照引用，完整内容用读取工具获取。失败不发布半成品。
|
||||
@@ -192,3 +192,53 @@ MCP_TEST_DATABASE_URL=postgresql+asyncpg://USER:PASSWORD@127.0.0.1:PORT/wq_mcp_t
|
||||
该脚本执行迁移、并发提交/控制、重启重放、回退及重升级，不用于个人库或生产库。生产启用、真实平台兼容性、真实额度和客户端实际凭据配置仍需另行授权验证。本功能不会恢复任何定时研究。
|
||||
|
||||
使用数据准备集合时，`preparation_refs` 为最多 20 个 `{id,version}`。提交时核对版本、范围和字段，固定独立快照并保存到回测来源；空集合或版本冲突不会创建运行。后续编辑或删除集合不影响回测。无需旧输入草稿接口。
|
||||
|
||||
|
||||
## Super Alpha 研究
|
||||
|
||||
迁移 `0021` 增加回测项类型、Selection/Combo 和独立组件快照表。历史 REGULAR 回测保留原输入及结果；已有 SUPER 记录直接进入 **研究成果 → Super Alpha 管理**。原 Alpha 管理固定为非 SUPER，两个页面的列表、统计、筛选、导出、保存视图和列偏好区分类型，共用同一 Alpha 记录。
|
||||
|
||||
**研究实验 → Super Alpha 研究** 支持方案版本、复制/归档、参数候选、设置候选、等权基线、Selection 预览和固定候选。候选勾选后进入通用回测预览及启动窗口。参数使用 `{name}`；变量不接受普通 Alpha 的 `field` 类型。全量展开默认上限 100，可调至 10000；随机模式使用固定种子。基线另列候选，包含基线后最多 10000 项。保存与构造不调用模型或启动回测。
|
||||
|
||||
| 工具 | 权限与输入 |
|
||||
| --- | --- |
|
||||
| `search_superalpha_plans` | read；q/limit/offset |
|
||||
| `get_superalpha_plan` | read；plan_id/version 或 experiment_id/limit/offset |
|
||||
| `save_superalpha_plan` | write；plan/idempotency_key；更新同时提供 plan_id/version |
|
||||
| `preview_superalpha_selection` | refresh；展开后的 selection、完整 SUPER settings，可选 plan_id/version；立即返回 job_id |
|
||||
| `get_superalpha_selection` | read；snapshot_id 或 job_id，支持 q/limit/offset |
|
||||
| `build_superalpha_candidates` | write；plan_id/version 或内联 plan；mode、limit、seed、selection_snapshot_ids、idempotency_key |
|
||||
| `search_superalphas` | read；filters，服务端固定 SUPER 范围 |
|
||||
| `get_superalpha` | read；alpha_id，读取设置、指标、两个 Description、实际组件及研究来源 |
|
||||
|
||||
权限名称分别为 `research:read`、`research:write`、`research:refresh`。`get_research_metadata({query:{kind:"superalpha"}})` 返回专属设置契约、文档属性和阶段信息；settings 查询可带 alpha_type，operators 可带 stage=SELECTION/COMBO。账户未返回的设置范围保持未知，文档属性不等于实时账户授权。
|
||||
|
||||
外部模型自行构造方案后调用 save/build。构造返回 `candidates` 和 `submit_source`，分别传入 `submit_backtests.candidates` 和 `.source`；超过 100 项按构造记录分页读取，再按批次提交。每批使用独立幂等键，保留同一个 research_id。也可直接提交完整 SUPER 候选，不先保存方案：
|
||||
|
||||
```json
|
||||
{
|
||||
"name": "SUPER 等权对照",
|
||||
"idempotency_key": "super-round-001",
|
||||
"candidates": [{
|
||||
"client_item_id": "equal-weight",
|
||||
"alpha_type": "SUPER",
|
||||
"selection": "turnover < 0.2",
|
||||
"combo": "1",
|
||||
"settings": {
|
||||
"instrumentType": "EQUITY", "region": "USA", "universe": "TOP3000", "delay": 1,
|
||||
"decay": 0, "neutralization": "INDUSTRY", "truncation": 0.08,
|
||||
"pasteurization": "ON", "unitHandling": "VERIFY", "nanHandling": "OFF",
|
||||
"language": "FASTEXPR", "visualization": false, "maxTrade": "OFF", "maxPosition": "OFF",
|
||||
"selectionHandling": "POSITIVE", "selectionLimit": 100, "componentActivation": "IS"
|
||||
}
|
||||
}]
|
||||
}
|
||||
```
|
||||
|
||||
这只是输入形态示例，地区和参数须依据实际元数据选择。回测沿用 `submit_backtests`、`get_backtest`、`get_backtest_results`、`get_backtest_artifact` 和 `control_backtest`。SUPER 每项单独 POST，共用账户并发及恢复机制；REGULAR 继续批量方式。提交回执未知时不会自动重发。`search_backtests` 可按 alpha_type、research_id 筛选；精确匹配覆盖类型、Selection、Combo 和完整设置。
|
||||
|
||||
Selection 预览在通用后台任务中执行，进度用 `get_refresh_job` 查询，组件用 `get_superalpha_selection` 分页读取。预览请求遵循现有平台资料的六个查询字段：selection/instrumentType/region/delay/selectionLimit/selectionHandling。Universe 和 Combo 不会被假装应用到该只读查询；完整设置仍保存在观察记录中。
|
||||
|
||||
预览和实际组件分开存储。`get_backtest_artifact(kind="components")` 仅返回当次实际组件证据；平台未提供完整成员列表时，complete=false、component_hash=null。未核实列表不能作为同池证据，即使预览曾返回完整组件。请求指纹覆盖实际模拟的完整输入，组件指纹覆盖排序后的完整 ID 集合；时间和来源单独记录。指标取当次固定快照，PnL 为单独采集的缓存，以 fetched_at 为准。
|
||||
|
||||
验证入口：`uv run pytest -q tests/test_superalpha.py`、前端 `pnpm exec playwright test tests/superalpha.spec.ts`。专用本地 PostgreSQL 可执行 `SUPER_TEST_DATABASE_URL=.../wq_superalpha_test uv run python -m tests.superalpha_postgres`，验证迁移、历史记录兼容、完整闭环及并发保存幂等。脚本拒绝其他数据库名称或非本机地址。所有自动化验收均使用模拟平台；真实 SUPER 模拟须另行授权。
|
||||
|
||||
Reference in New Issue
Block a user