feat: integrate chatbox research with datasets and backtests

2026-09-08 12:43:00 +08:00
parent 43336ad960
commit aef8e1d310
37 changed files with 1421 additions and 42 deletions
@@ -0,0 +1,18 @@
+# 实现 Chatbox 研究来源与模块集成
+
+Type: task
+Status: ready-for-agent
+Progress: completed
+
+规格：[spec.md](../spec.md)。主代理负责实现与最终验证，子代理仅完成只读定位。
+
+## Comments
+
+- 2026-09-08：当前来源已经存在于回测 JSON 和不可变历史，优先补齐消费者和反向查询，无需新增来源实体或数据库迁移。
+
+- 2026-09-08：完成数据集工具、固定输入与字段绑定预览、服务端 Chatbox 来源赋值、Alpha 来源反查与筛选、原会话/输入/回测跳转。无需数据库迁移。
+- 验证：`ruff check app tests` 通过；后端全量 `pytest -q` 为 129 passed（含新增 13 个研究集成场景）；前端 `pnpm build` 通过；既有浏览器回归 `pnpm test` 为 11 passed。构建仅报告既有 lottie-web eval 警告。
+- 隔离 PostgreSQL 17 完成迁移并通过 Chatbox 全链路及同 Alpha 多来源两个关键场景；未使用正式数据库。
+- Playwright 页面实测：123 字段输入保存 → 用此输入研究 → 候选预览 → 确认 → 保存 1/1 → 追问结果 → 回测 → Alpha 研究来源 → 原输入；另建会话后可从回测恢复原研究会话。390px 窄屏无页面横向溢出，最终控制台无错误。截图位于忽略目录 `output/playwright/chatbox-alpha-source-mobile.png`、`output/playwright/chatbox-research-mobile.png`。
+- 后端与两份 Compose 的每轮模型请求默认上限统一为 12，支持目录检索到回测的多次工具往返；已有显式配置继续优先。
+- 本次仅本地实现和合成上游验收，未调用真实模型或 WorldQuant，未部署或提交。
@@ -0,0 +1,22 @@
+# Chatbox 研究来源与模块集成
+
+Status: ready-for-agent
+
+用户于 2026-09-08 授权实现数据集到 chatbot 候选构建、回测和 Alpha 管理的集成，并明确 chatbox 是一种研究来源。
+
+## 设计与范围
+
+- 研究来源由方式 `kind`、业务引用 `reference`、具体研究 `research_id` 和可选输入快照组成。Chatbox 使用 `kind=chatbox`、会话 ID 为 reference、生成轮次 ID 为 research_id，由服务端注入，不依赖模型自行填 ID。它不是 Alpha 的本地备注 Research。
+- 复用现有 BacktestRun.source 和 BacktestResult → BacktestItem → BacktestRun 关联，反查 Alpha 的全部已保存来源；不增加单值 Alpha.source，不用本地标签代替来源，不新建重复关联表。来源筛选与分页/导出保持同一查询。未产生本地回测记录的同步 Alpha 显示无本地研究来源。
+- 普通聊天生成 inline 候选自动标记 chatbox。引用现有回测草稿、预览裁剪和重跑保留原生产来源，执行聊天信息仍单独记录在 ai_context。重跑添加 parent_run_id。
+- 数据集页面传递范围、对象及保存的输入快照引用，不发送未保存备注。明确排除的字段保留选择语义；用于研究的输入在服务端固定，不把搜索页当成全量。
+- AI 可分页检索本地数据集/字段及固定输入，按显式字段选择准备输入快照。无缓存时说明并引导同步，不自动启动平台同步。
+- 构建接口接受输入快照 ID、研究假设、模板表达式、具名字段绑定与期望字段类型、明确模拟参数。服务端替换占位符，核对绑定归属/类型/非空、研究范围与唯一候选 ID，再调用已有回测预览。仅验证绑定与参数，不宣称完成 FASTEXPR 语义或平台算子权限检查，不隐式插入清洗或 VECTOR 聚合。
+- 回测预览和结果可查看来源与输入快照，Alpha 详情可回到关联回测和原聊天会话；回测和 Alpha 列表支持来源方式筛选。
+- 不增加完成事件自动唤醒，用户后续提问读取真实结果。保留固定集合确认、异步执行、幂等与历史快照。
+
+## 验证
+
+隔离数据库、合成模型和模拟平台 HTTP 验证：目录/输入分页与上下文；字段跨集/类型/范围/占位符校验及失败无部分预览；chatbox 来源由服务端注入；确认前无平台提交、重复确认唯一运行；结果可反查来源、同一 Alpha 多来源不覆盖不重复计数；重跑/裁剪/原草稿保留来源；旧快照不随重同步改变。执行后端检查、前端构建和浏览器集成回归。真实模型/WorldQuant 联调、部署和提交不在本次本地实现范围。
+
+验收结果见 [实现任务](issues/01-implementation.md)。每轮模型请求默认上限调整为 12，与原工具执行上限 12 和活动执行时限共同约束调用预算；显式环境配置不变。