feat: add versioned research templates and alpha variants

2026-09-08 21:29:21 +08:00
parent b604e6050e
commit f89ae211d2
55 changed files with 5650 additions and 435 deletions
@@ -0,0 +1,39 @@
+# 第一阶段验收：模板与变体闭环
+
+日期：2026-09-08。状态：实现完成，本地验收通过；真实 WorldQuant 协议联调尚未完成，原因见末尾。
+
+## 交付内容
+
+- 数据与素材、研究实验、研究成果分组导航；数据目录、算子库、模板工坊、Alpha 变体、原回测研究和 Alpha 管理可直接进入。保留当前侧栏折叠、最近访问、快捷导航和全局助手。
+- 算子目录及独立本地收藏/备注；合法设置快照；字段详情可查询可用范围。字段级证据无法确认目标范围时不允许直接回测。
+- 模板稳定 ID、不可变版本、编辑/采样/展开、旧格式导入预览和同名冲突保护。随机采样直接访问组合空间，不先穷举。
+- 结构与字段变体、市场与设置变体；保存种子、输入、改动、模板版本及模型生成依据。每个候选保留实际输入引用，回测结果通过实验 ID 与 client_item_id 追溯。
+- 基线与候选比较：表达式、设置、指标快照、共同日期窗口 PnL；缺失指标不当作零。
+- 页面和 AI 共用研究服务；原 Chatbox 绑定使用共用表达式展开及语法/类型校验。所有手工回测继续先生成固定预览，再由用户确认。
+
+## 验收步骤与结果
+
+| 验收 | 步骤 | 结果 |
+|---|---|---|
+| 后端回归 | `backend/.venv/bin/pytest -q --tb=short` | 176 项通过；包含新增研究及原账户、目录、AI、回测、Alpha 测试 |
+| 追加类型边界 | 直接 VECTOR、非聚合算子使用 VECTOR、局部 VECTOR 后显式聚合；重跑研究相关测试 | 44 项研究相关测试通过；修复仅收紧本地类型校验 |
+| 组合空间 | 重复占位符；100^20 组合取 50 个随机候选；相同随机种子重复生成 | 数量受限、结果可复现；全组合超限返回错误 |
+| 版本与导入 | 保存 v1、更新 v2、重新读取 v1；并发旧版本写入；旧占位符转换及同名导入 | 历史不变，冲突返回 409，同名不覆盖 |
+| 生成与来源 | 固定输入→模板候选→原预览→合成模拟→Alpha 来源；父实验及目标市场输入 | 来源保留，可由实验 ID + 候选 ID 找到输入版本与种子 |
+| 字段和范围 | 未知字段、错误字段类型、跨市场独立输入、局部变量、字段级证据与目录矛盾 | 无法核实的候选保持待核实；不进入选定候选回测预览 |
+| 模型接口 | PydanticAI FunctionModel 返回结构化模板 | 单次请求；模型/配置版本/用量/输入上下文保存在模板版本，未调用真实模型 |
+| 比较 | 两条 Alpha 使用不同设置、缺失 Sharpe、部分重叠 PnL 日期 | 保留 null；仅共同日期且窗口起点归零；不同设置明确标识 |
+| 前端构建 | `pnpm --dir frontend build`、TypeScript 检查 | 通过；依赖 lottie-web 的既有 eval 提示不阻塞构建 |
+| 浏览器回归 | 项目 17 项 Playwright 用例，全新临时 SQLite、合成平台、独立 localhost 端口 | 17 项通过，覆盖账户、菜单、配置、AI、目录、回测、Alpha、多尺寸与恢复 |
+| 页面闭环 | 浏览器固定 TEST_FIN 输入，创建“阶段一浏览器验收模板”v1，生成两个候选，确认回测，查看结果后返回原实验 | 2/2 结果已保存，来源返回原实验及关联回测；创建候选时运行数量仍为 0 |
+| 算子备注 | 浏览器收藏 rank、保存备注、同步算子、重新选择 rank | 平台定义刷新后，本地备注和收藏仍在 |
+| PostgreSQL | 专用 PostgreSQL 17 容器中执行 `backend/tests/research_postgres.py`：0005→0006、Alembic schema check、旧研究备注、并发版本写入、重复回测启动 | 通过；旧备注/版本保留，两个并发启动返回同一运行 |
+| 备份恢复 | 专用库 pg_dump，恢复至新库；核对模板版本、实验、回测数量和旧备注 | 通过；未操作个人工作数据库 |
+
+## 交付边界与未完成验证
+
+本阶段没有上线部署、正式提交 Alpha、回写平台属性或调用真实模型。新增生成和模拟限定 REGULAR / FASTEXPR / EQUITY；其他已有 Alpha 展示不受影响。
+
+真实 WorldQuant 联调脚本已准备：仅向官方 API 认证，读取算子、OPTIONS 设置及字段可用性，不保存凭据。沙箱内请求返回 network_error；提权执行被自动审批两次拒绝，理由为审批器未认可任务目标记录中的外部账户授权。已在当前对话发出明确授权确认问题，等待回复。本报告不把合成协议测试视为真实平台联调通过。
+
+可用性协议无法识别时明确标为待核实。完整的目标范围目录及独立固定输入可以提供字段存在证据；若存在额外字段级证据，则要求同时满足。原始时间序列离线特征计算、官方检查/提交、旧运行搬迁均不在本阶段范围。