simon/qlib
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
88 Commits 1 Branch 0 Tags
a395db892da12b8e1792b877ae9543ef3542de74
Commit Graph
21 Commits
Author SHA1 Message Date
Simon a395db892d 修复实验页右侧内容溢出：宽表固定两端 + 提示；对比表首列固定；月度表收紧内边距 
- 实验列表 11 列在 1366px 及更窄窗口放不下，「操作」列被推到卡片外；macOS 覆盖式
  滚动条不滚动不显示，看起来就是「右侧内容溢出/被切掉」。现在左右两端固定
  （选择列、ID、操作列），列宽按实测单行内容宽度定，只有真溢出时才提示可横向滚动。
- 对比视图（指标对比 / 参数差异）列数随实验个数增长，首列改为固定，同样按需提示。
- 详情图层里的月度收益表 13 列超出 38px：收紧内边距并固定「年份」列。
- 可排序表头命中区 19.2px → 34px（与同排复选框等高），修掉 UI 规范门禁的 7 项失败。
- 顺手把对比区两处会原样显示的字面 ** 改成「」。

门禁：ruff 通过；pytest 524 passed；tsc 0 error；npm run build OK；test:charts 7 passed；
verify_ui_alignment.py 160 项通过 / 0 失败。
 2026-10-01 19:33:33 +08:00
Simon e58367af27 feat(web): 因子研究/因子组合/股票筛选接入统一作业反馈；阶段圆点按作业类型区分 
接着 /backtest 的那次改造，把其余会跑异步 Job 的页面也切到同一套
`useJobRunner` + `JobProgress`（用户原话：包括因子测试等所有测试都帮我完善用户反馈）：

- **/factors**（一个因子一个 Job 的批量场景）：删掉 `running/processed/current/jobId` 与
  按「已处理数 ÷ 总数」自算的 `Progress` **假百分比**；每轮把 `第 i/共 n 个` 交给反馈条，
  阶段/作业号/已用秒数全部来自后端。取消 = 用户明确意图 → 保留已出的报告、不再跑后续因子，
  不报错；单个因子失败仍继续跑其余因子，并把后端原文累积成**批级清单**（多因子时反馈条
  只能显示最后一个作业，前几个失败不能丢）。
- **/factors/compose**：删掉 `value={30}` 的假进度条；`archiveId` / 复用 `BacktestResultView` /
  「新页面放大」全部保留；failed/cancelled 交给反馈条，页面 error 只留参数与目录错误
  （同一失败不在两处各说一遍）。
- **/selection**：异步选股切反馈条；**同步**的「执行选股」保留原 loading（`POST /selections`
  没有 job_id，套上会去 `GET /jobs/{signal}` 撞 404）。
- **/signals**：`POST /api/signals` 是同步接口，**不套**作业反馈（不编作业号、不编阶段），
  改为点击即现的 `role="status"` 提示，如实写明「同步请求、请求期间不能关页、无阶段无取消、
  出错显示后端原文」。
- **阶段圆点按作业类型区分**（修掉一个真实缺陷）：原来全站共用一张含 `queued/done` 的
  `STAGE_ORDER`，因子测试页实测出现过**裸英文** `factor_calculation` 且 4 个圆点全灰
  （`indexOf` = -1），还画出了因子测试根本不存在的「逐择股日选股 / 撮合与净值结算」。
  现在 `STAGE_PIPELINES = { factor_test: [加载→计算因子值→汇总], backtest: [加载→撮合→汇总],
  selection: [逐择股日选股] }`（阶段序列**不含 queued/done**，那是作业状态不是阶段），
  未知阶段显示「执行中（stage）」并保留已推进的圆点，不整排灰、不露裸枚举。

验证（真实浏览器 CDP，读数原文已记录）：
- /factors：点击后 0.2s 内 `submitting`→`queued` + 作业号；+30s Pill「计算因子值」、
  圆点 `✓ 加载行情与因子数据 / ● 计算因子值 / ○ 汇总指标与曲线`（无「选股/撮合」、无英文枚举）；
  成功态给「去对比 / 打开归档」。
- /selection：圆点只有 `逐择股日选股` 一段；取消 → 「已取消，没有归档」；
  另实测撞并发上限时如实显示后端原文「系统繁忙：并发研究任务已达上限」。
- /factors/compose：`submitting→queued→撮合与净值结算→success(EXP-…)`，业务结果与 5 处放大入口照旧。
- /backtest 回归：圆点由 4 个变 3 个（去掉后端**从不上报**的 selection 阶段），取消仍「已取消 + 没归档」。
- 自检产生的 12 个实验归档已全部删除（bulk-delete count:12，复查无残留）。
 2026-10-01 18:37:25 +08:00
Simon c974415691 feat(web): 实验对比页支持批量删除 / 发起时间列 / 详情图层，打开归档改新页面 
用户要求的三件事（原话）：①批量删除；②增加「测试发起时间」；③点击详情用图层展示、
打开归档用新页面展示。

- **批量删除**（`POST /experiments/bulk-delete`，已在上一个提交实现接口）：
  表头全选（只作用本页，工具条写明范围）+ 每行删除复选框，工具条显示「已选 N 个（待删除）
  | 删除所选 | 取消选择」；确认框写清**不可恢复**、结果只存归档这一份、关联作业记录会保留但
  读不回结果、想留底先导出 JSON。单次接口上限 200 个 id，超过前端分批；**分批中途失败时
  如实报「已删除 X 个，之后失败 —— 原文」**（前面几批是真删了，不能报成一个都没删）；
  接口返回的 `missing` 单独用警示色报「M 个不存在（未计入删除数）」，不把「不存在」当删成功；
  只清掉确实删掉/本来不存在的选中项（没删成的留在选中里可直接重试），并同步清掉已删归档
  的详情图层 / 对比选择 / 勾选状态。
- **发起时间列**：`created_at` 用 `new Date()` 转**本地时间** `YYYY-MM-DD HH:mm:ss`
  （不直接截 UTC 字符串），空值显示「—」；表头可排序（空值恒排末尾、同秒用 id 兜底）。
- **详情图层**：新增通用 `components/Modal.tsx`（portal / `role="dialog" aria-modal` /
  `aria-labelledby` / 锁 body 滚动 / ESC 关闭 / 遮罩 mousedown 关闭而点内容区不关 /
  打开聚焦、关闭把焦点还给触发按钮 / Tab 焦点陷阱；样式走 CSS Module，不动 globals.css）。
  图层内复用 `ArchiveResultView`（按 kind 分发，回测的净值曲线、成交明细、买卖说明、
  因子曲线与「新页面放大」链接都在图层里可用），元信息区列出 id/类型/发起时间/版本/作业/区间/体积；
  标题栏含「在新页面打开完整归档」。
- **打开归档**：列表入口改 `target="_blank" rel="noreferrer"`（URL 不变）。

验证（真实浏览器 CDP，读数原文已记录）：
- 表头 `发起时间 ↓`，首行 `EXP-8EA2819B / 2026-10-01 17:45:05`；点一次变升序（首行
  2026-09-06 17:17:37），再点回降序。
- 图层：`{aria-modal:true, 标题「EXP-8EA2819B 归档详情 · 回测」, canvas:35, tables:10,
  body.overflow:hidden}`；点内容区不关、遮罩关闭后焦点回到「详情」、ESC 关闭且恢复滚动。
- 批量删除：造 2 条一次性归档 → 勾选 → 确认「将永久删除 2 个归档」→ 横幅「已删除 2 个归档。」，
  行数 59→56；用 `/api/experiments` 逐条集合核对 `before-after=[]`、`after-before=[]`
  （只删勾选的）；`missing` 分支实测「已删除 0 个归档，1 个不存在（未计入删除数）。」；
  进行中态实测「删除中… + disabled」。造出的 4 条自检归档已全部清理（404，关键词命中 0）。
- 打开归档用真实鼠标事件点击：页面目标 `/experiments` → `/experiments/EXP-10581FED`
  （合成 `a.click()` 会被 Chrome 弹窗策略拦掉，故用真实鼠标事件验证）。
- 另外把图层关闭按钮调大调亮（34×34、`--text-1`、图标 16px）：2 倍放大截图逐字核对，
  原先「×」细到几乎看不见，现在与「在新页面打开完整归档」同高同线、清晰可见。
 2026-10-01 18:31:04 +08:00
Simon e8fa67ad40 feat(web): 回测页统一作业反馈条（点了立刻有字 / 真实阶段 / 可取消） 
用户反馈：「点击回测没有任何反馈，不清楚是不是已经开始回测」。

- 新增全站统一的 `useJobRunner`（`lib/jobs.ts`）与 `JobProgress` 组件：
  提交瞬间即显示「排队中 + 作业号 + 发起时间」，已用时间**每秒自增**（不依赖后端
  是否报新阶段），阶段来自后端真实 `stage`，排队/运行中可**取消任务**、失败直接显示
  后端原文、成功给「打开归档 / 去对比」。反馈条出现时自动滚入视野（按钮在长表单底部，
  不滚过去就等于没显示）；`role="status" aria-live="polite"`。
- `/backtest` 改用它：删掉原先手写的阶段条与 stage/elapsed/jobId 三个 state，
  取消走 `POST /jobs/{id}/cancel`，取消后如实提示「已取消，没有归档」而不是报错。
- 顺带修掉「未命名组合点运行 → 撞 422」：运行是**临时组合不落库**，未填名字时按
  「未命名组合（仅本次运行）」提交并明确提示，不再把后端 422 原文甩给用户。
- 修掉反馈条里 `**加粗**` 字面残留（hint 不走 Markdown）。

验证（真实浏览器 CDP，实测数字）：
- 勾选策略 → 点「运行回测组合」→ **+0.11s** 反馈条已显示 `排队中` + `JOB-8508F84D`
  + 发起于 18:05:28 + 已用 0s + 四个真实阶段 + 「取消任务」按钮；+4.5s 进入
  `加载行情与因子数据`；点取消 → 「正在取消…」→「已取消」并提示没有归档。
- 反馈条截图逐字核对（阶段、作业号、时间、按钮），并据此修掉 markdown 残留。
 2026-10-01 18:08:58 +08:00
Simon 48a97c2a12 feat(backtest): 买卖点理由（用数据说话）+ 因子曲线 + 曲线新页面放大 
用户要求：「所有买卖点详细说明买卖理由，用数据说话」「回测图上增加因子相关曲线
（买卖依据是股息率，就加股息率曲线）」「所有曲线能弹出新页面放大」。

一、买卖理由（后端产出结构化数据，前端只展示）
- 新增 `quant/trade_reasons.py`：封闭词表 + 文案构造器，组合引擎与单策略引擎共用，
  避免两个引擎对同一件事写出两种说法。理由里带**引擎当时的真实数字**：
  综合分名次/候选数/综合分/各因子原始值/持有交易日/预算与最低佣金/涨停比值等。
- 买入：按名次建仓、顺延成交、涨停未买、停牌未买、现金不足、不足最低佣金；
  卖出：跌出 TopN（含第几名掉出）、被股票池过滤（与「跌出 TopN」分开写）、
  超 Tmax 强制了结、Tmin 保护暂留、停牌/跌停顺延。
- `ActionRecord.reason` 覆盖**成交与未成交**全部买卖点（原 `reject_reason` 保留不动，
  老归档仍可读）；`Trade.entry_reason / exit_reason` 跟着成交记录走。
- 名次来自调仓日完整排名（新增 `_ranked_by_day`），拿不到名次时如实写「未给出名次」，
  绝不编造一个名次填进去。
- 未成交明细不再只写执行层原因：把「为什么选中它、当时各因子多少」一并给出。

二、因子曲线
- `FactorCurve`：每个策略因子一条曲线，值为**当日持仓按市值加权平均的原始值**
  （不做 z-score、不按方向取反，空仓日不落点、不插值、不用 0 填充），并带
  label/direction/unit 供界面说明口径；`FactorDef/FactorTemplate` 新增 `unit`
  （股息率 %、量比/接近新高 倍数、动量等 小数），11 个内置因子实例已逐一核对。
- 归档体积预算照旧按整包计量，无需改迁移。

三、界面
- 结果页新增「买卖说明」区块：全部买卖点 + 理由 + 数字标签，支持方向/成交状态/关键字
  筛选与日期排序；成交明细表加「为什么买 / 为什么卖」两列；新增「因子曲线」区块，
  每条曲线标出组合成交日，直接对照「买卖发生在什么水平」。
- 「新页面放大」：每条曲线（净值/回撤/因子/个股/月度）都能开 `/charts/{归档id}?s=...`
  整页看大图；放大页是 Server Component，数据从归档直出，URL 可分享且与归档一致。
  未归档的结果如实说明「未归档，无法放大」，不给坏链接。
- 数字格式与后端 `f"{v:.4f}"` 同规则（四舍六入五成双）：修掉 0.03125 在理由原文里
  显示 0.0312、旁边标签显示 0.0313 的不一致（17 组边界值与 Python 逐一比对一致）。
- `/factors/compose` 结果区改用同一个 `BacktestResultView`，两处口径不会再漂移。

验证：
- 新增 `tests/test_trade_reasons.py` 8 条（买入数字、跌出 TopN 名次、不在候选池、
  Tmax、Tmin 暂留、涨停未成交、因子曲线加权值、空仓不落点）；后端 510 条全过，ruff clean。
- 真实数据端到端：`/api/combos/run` 6 个月高股息组合（EXP-8EA2819B）13 个买卖点
  100% 带理由与数字，因子曲线 dividend_yield 117 点、单位 %；
  `scripts/verify_backtest_page_contract.py`（4 年、301 个买卖点、140 笔成交）扩展断言
  理由词表/名次/因子值/曲线单调性后通过。
- 浏览器实测：归档详情页与放大页 `/charts/...?s=factor:dividend_yield` 等 5 种曲线
  全部 200 渲染，截图确认表格与曲线数值正确。
 2026-10-01 17:57:00 +08:00
Simon f13b34c59e feat(web): 字段库页 + 界面单位换算 + 因子目录参数化 + 选股策略条件表单 
字段库与单位：
- `/fields`：字段库管理页（中文名/说明可改、可停用；kind 是引擎事实不可改）；
  单位只在字段自己的阶梯里选（总市值 = 万元/亿元），越界 422 原样展示。
- `lib/units.ts`：界面单位 ⇄ 基准单位换算集中一处，条件输入按界面单位回显、
  提交前换回基准单位（引擎只认基准单位，库里存的也永远是基准单位）。
- `SelectionStrategyForm` 取代 `StrategyParamsForm`：一个策略只定义「怎么选」
  （股票池 + 因子 + 过滤条件），条件字段来自字段库接口而不是前端硬编码枚举。

因子参数化（名字即身份，界面不许藏）：
- `/factors` 新增「参数」列与展开行：精确引擎键、每个参数的允许范围、来源、依赖列
  （依赖列标明「引擎事实，不可改」）；说明文案从「不可修改」改为
  「改参数 = 新建参数化因子 = 新身份，旧因子/既有策略不变义」。
- 「新建参数化因子」卡片：模板下拉 + 受控窗口（min/max）+ 方向枚举下拉，
  实时预览规范键/中文名/渲染公式；后端 422 的原文原样展示，不静默截断。
- 因子下拉显示中文名（含参数）与短键，**value 一律是完整引擎键**；
  停用的因子从各页候选里消失（/strategies、/selection、/signals、/factors/compose），
  既有策略/归档仍按名字解析；`/factors/compose` 顺手修了勾选框点击目标过小。
- `/fields` 加提示：字段库只列内置因子名，参数化因子在 /factors 管理，
  选股策略条件下拉里会一并出现。

tsc --noEmit 0 error；verify_ui_alignment 8 页 160 项全过（另跑 3 个选因子页 51/54）。
 2026-10-01 16:38:29 +08:00
Simon 50a1030afa fix(web): 参数表单收束 + 一句话说明改多行（按截图实测修两处失调） 
用户给了真实截图，指出两处肉眼可见的不协调，逐项定位后修复：

1. 「一句话说明」是单行 input 被塞进 ~360px 的格子，placeholder
   「例：全市场股息率最高的 2」直接截断 —— 内容太多、框太小。
   → 改为整宽多行 <textarea>（rows=2、min-height 64px、可纵向拉伸），
     与定宽 340px 的策略名并排（.params-meta flex），窄屏自动上下堆叠；
     实时字数 (N/300) 已在提示里。

2. 「太多地方没有对齐」的根因：表单铺满 ~1900px 内容区，5 列各 ~360px，
   控件拉得太开；因子下拉用 1fr 撑到 ~1500px 而权重框才 118px，比例失调；
   数字输入还有 max-width:180px 上限，比同行下拉窄一截。
   → .params-form 约束到 ~1100px（每列 ~210px，所有控件按 1fr 等宽，
     左右边缘严格对齐）；移除已多余的 max-width:180px（限宽后它反而
     制造新的不等宽），数值/日期改为填满单元格；因子行首列封顶 460px、
     整行限宽 720px，条件行同理（首列 ≤360px、限宽 760px）；
     复权口径选项去掉括号里的「股息策略推荐」（已在 hint 说明），不再截断。

验证方式也升级了：这次是**截图后用 read_image 看渲染像素**确认，而不只量几何。
对齐自检同步把 textarea（高度随行数变、本就该比单行高）排除出「同排等高 /
高度归一」比较，并把数字过宽阈值调到 240px（限宽后 ~210px 属正常）。

门禁：tsc 0 错误、图表单测 7/7、next build 成功、页面 200、
对齐自检 140/140、契约自检 59/59；/backtest 与 /strategies 截图复核通过。
 2026-09-30 19:56:40 +08:00
Simon 9aaca12751 fix(web): 控件对齐与输入友好整改（控件高度令牌化 + 对齐自检脚本） 
问题不是"不好看"，而是**可测量的错位**：同一行里原生 date 输入 38.8px、数字输入
36.8px、按钮 34px；16px 的勾选框与 36.8px 的下拉同排；因子行的下拉与权重框没有
可见标签；列表里的勾选框点不中；参数非法时「运行回测」直接置灰且不说原因。

根因：控件高度靠「上下 padding + 行高」拼出来，而 input / select / button 的原生行高
各不相同（Chrome 的 date 还会多 2px），必然参差；加上各处内联像素宽度
（style={{width:220}}、flex:1）与自搓布局，列自然对不齐。

改动：
- 新增控件高度令牌 --ctl-h-sm/md/lg（28/34/38px）与 --ctl-px，.input/select/.btn/
  .icon-btn/date 统一显式 height（不再拼 padding）；原生 checkbox/radio 统一 16px，
  点击热区交给外层 label（.check/.radio-row/.check--cell），表格整格可点
- 因子行、选股条件行改为「表头 + CSS 栅格」成列对齐，列宽由样式决定，
  去掉内联像素宽度与 flex 拉伸，配 aria-label 供读屏分辨重复行
- 表单友好化：错误提示改为**失焦或提交后**才出现（清空重填的瞬间不再标红）；
  提交被拦下时一次展开全部行内错误 + 自动聚焦并滚动到第一个问题字段；
  运行/保存按钮不再因参数非法而置灰（灰按钮不说原因 = 看起来不可点却无响应），
  改为可点击并讲清原因；补齐 topN/costs 两处「产生了却没人显示」的行内错误落点
- 数值字段补 inputMode/step/min/max 与单位、取值范围提示；工具条检索/筛选用
  .input--search/.input--filter/.input--picker 类，不再写内联宽度
- /experiments 筛选无结果的空态与「暂无实验」区分开（原文案会让人以为归档丢了）
- 同一页面可能挂两份表单：radio name 与 label/for 加表单实例前缀（useId），
  否则两边单选互相取消、label 指错控件
- 新增 scripts/verify_ui_alignment.py：系统 Chrome + 原生 CDP（仅标准库，
  独占随机端口与临时 profile），按 7 个页面 × 1500/375px 检查同排等高、
  高度取值归一、点击目标、标签与无障碍名、字号圆角一致、尺寸匹配内容、
  横向溢出、提示裁切；本次基线 108/32 → 现 140/140

验证：pytest 388 passed、ruff 全绿（顺带清掉 qlib_verify.py 一处死代码）、
tsc 0 错误、图表单测 7 passed、next build 成功、契约自检 59/59、
对齐自检 140/140（含 375px 小屏）。
 2026-09-27 09:01:55 +08:00
Simon 23972e7063 feat: 股息率案例口径 + 策略库与图表统一 + 回测存档完整化 
汇总三轮未提交的开发（每轮均在本机 MariaDB + 真实浏览器上验证）：

1) 股息率案例（全市场股息率最高 n 只，默认 20，每 m 月择股）
   - 新增日频估值表 daily_basic + 迁移；股息率因子（dv_ratio / dividend_yield / TTM）
   - 名称历史表 stock_name_history：剔除 ST 按**择股日当时名称**判定，消除
     「曾高股息后 ST」的股息陷阱（实测 3.70pp 偏差）
   - 区间择股/调仓双周期（m 择股 / y 调仓）、指数成分与白名单、停牌近似剔除
   - 复权因子口径核对（4,164,742 行、缺失 0.0%）、收盘价成交与涨跌停拦单
   - 案例实测：2020-01-01~2026-09-04 总收益 +24.86%（年化 3.52%、回撤 -28.58%）

2) 策略库与前端统一
   - strategy 表 + CRUD/PUT 原地更新 + `describe_strategy` 按 spec 真实推导
     「一句话说明 + 计算公式 + 执行步骤 + 注意事项」（与引擎实执行规则同源）
   - 任何出现股票代码处都成对显示名称且可点击进个股页
   - 全站图表基座统一 TradingView Lightweight Charts（ECharts 依赖、
     锁文件、组件与文档标注一并清除），买卖点标记只落在真实交易日上

3) 回测存档完整化（可往复查看）
   - 同步端点（POST /api/backtests、/api/factor-tests）此前完全不落库 → 现在同样归档，
     归档 id 经响应头 X-Experiment-Id 返回（不破坏 response_model）
   - data_version 首次真实写入（数据快照指纹：最新交易日 + 各表规模）
   - 个股收益曲线默认**全量保存**（此前硬截断 60 只）；超出体积预算才裁剪，
     并写 archive_meta（机器可读）+ unimplemented（人可读）如实标注
   - 列表 kind/q 过滤 + X-Total-Count（此前 limit=50 静默截断）、DELETE 归档
   - 只读归档页 /experiments/{id}（Server Component，SSR 直出**选股条件**与
     **交易执行依据**）；结果视图按 kind 分发（backtest/factor_test/selection），
     非回测归档不套用回测口径
   - 新增 CLI：prune_experiments（保留策略，默认 dry-run）、
     restore_experiment_from_job（从 Job 副本按原 id 重建被删的历史归档，默认 dry-run）

门禁：pytest 388 passed、ruff All checks passed、tsc 0 错误、图表单测 7 passed、
next build 成功、契约脚本 verify_strategy_workspace 59/59（含按 kind 逐类验证归档页）。
 2026-09-20 07:31:04 +08:00
Simon 861a4051ca feat(job): D2 全市场选股 Job 化（kind=selection 异步） 
- Job kind=selection：executor 分支用 SelectionService（spec=SelectionQuery），结果
  落 result_json、自动归档 Experiment（summary：as_of + 选出 N）；/api/jobs 与
  /api/experiments 的 result 解码支持 SelectionResult
- POST /api/selections/jobs：提交 SelectionQuery 为异步 Job（BackgroundTasks/subprocess）
- Web 选股页新增「异步（全市场）」按钮：提交 Job → waitJob 轮询结果（解决同步 60s+）
- tests/test_selection_job.py：executor 执行归档（SelectionResult/Experiment kind）、
  API 提交→轮询→结果与实验列表；全量 pytest + tsc 通过
 2026-09-09 07:43:35 +08:00
Simon 03fb463216 feat(web): K线图库对比 —— TradingView Lightweight Charts 实现 + 双库切换 
- 按确认方案「两套实现并存对比」：
  - npm 依赖 lightweight-charts@4.2.3（v3 §21 推荐库）
  - components/StockChart/chartTypes.ts：共享 props 接口
  - CandleChart.tsx（ECharts 版，重构复用共享类型）+ CandleChartLW.tsx
    （Lightweight 版：蜡烛+成交量副刻度+MA+成交实心箭头/未成交信号圆点 markers）
  - StockChart.tsx wrapper；个股页顶部「ECharts / Lightweight」切换（默认 Lightweight）
- /stocks/600519.SH 冒烟 200；tsc --noEmit 通过
 2026-09-09 07:21:07 +08:00
Simon e1a0a8aa38 feat(web): M9-4 Stock Research Page /stocks/[symbol]（v3 §20.4） 
- 个股统一研究页：K 线（chart API，none/qfq/hfq 显示切换）+ 量 + MA +
  成交 fills/未成交信号标记 + 该股历史选股命中与信号记录（点击看原因/价格）
- 股票池每行代码可点击进入本页
- 数据全部来自 Chart API（前端不重算）；类型补齐 Stock.market/exchange
- 冒烟：/stocks/600519.SH 200，MySQL 上 qfq K 线返回正常；tsc --noEmit 通过
 2026-09-09 07:14:44 +08:00
Simon e5a23f176d feat(web): M8.6b 回测页做实 + 首页入口更新（零新后端 API） 
- backtest 页：成本参数表单（手续费/印花税/滑点 %）+ 初始资金 → ResearchSpec.costs/
  initial_capital；结果新增年度收益卡与成交明细表（买/卖日、买/卖价、收益、累计换手）
- Dashboard 入口卡加入「股票筛选」「交易信号」（6 张）
- lib/types.ts：ResearchSpec 增加 price_adjustment/costs/portfolio/initial_capital，
  Trade 补 entry_price/exit_price
- 页面 200 冒烟 + tsc --noEmit 通过
 2026-09-09 00:41:49 +08:00
Simon e1ac23fa25 feat(web): M8.6a 交易信号页（/signals）+ 导航与类型 
- app/signals/page.tsx：因子+买卖排名阈值+时点+白名单 → BUY/WATCH/SELL 表格
  （类型 Pill 着色、得分/价格/触发理由）+ 最近信号记录回看
- app-shell 导航加入「交易信号」；lib/types.ts 增加 Signal* 类型与 universe.symbols
- 真实 MySQL 端到端：/api/signals 返回可解释信号（跌破 MA60 的 SELL 警示等）；
  /signals 页面 200；tsc --noEmit 通过
 2026-09-09 00:40:22 +08:00
Simon 0ab9038570 feat(web): M6.5 股票筛选页（/selection）—— 评分/条件双模式 + 当前/历史选股 
- app/selection/page.tsx：因子评分（多因子+权重+TopN）与条件模式（结构化条件行
  编辑：static.*/因子/close>ma60/ROE 等，AND 语义）；as_of 留空=最近交易日；
  结果表（rank/symbol/score/因子值/入选理由）+ 最近选股记录点击回看
- lib/types.ts：SelectionQuery/Condition/Candidate/Result/Meta/Run DTO
- app-shell 导航加入「股票筛选」；rail 脚注与 Dashboard 文案 SQLite→MySQL（M-DB 收尾）
- 端到端验证：真实 MySQL 上 POST /api/selections 返回候选并落库可读回；
  /selection 页面 200；后端全量 pytest + 前端 tsc --noEmit 通过
 2026-09-09 00:25:27 +08:00
Simon db520d0430 build(web): Noto Sans SC 本地自托管，移除 Google Fonts 在线依赖 
- 经 3128 代理下载可变字体（400-700）101 个 unicode-range 子集到 public/fonts
- app/fonts.css 生成本地 @font-face 表，globals.css 改用 @import './fonts.css'
- 页面运行期不再请求 fonts.googleapis.com / fonts.gstatic.com
 2026-09-08 21:48:23 +08:00
Simon 24f98e90c6 feat(web): 按 ui-ux-pro-max 设计系统重构前端（侧边导航 + 组件库 + 图标 + 可视化） 
- 设计令牌与组件体系：语义色/间距/圆角/状态 + Card/Metric/Pill/Btn/Field/Empty/Skeleton/Progress 等
- 桌面左侧导航 + 窄屏抽屉（usePathname 高亮、ESC/遮罩关闭）；修复抽屉/遮罩占据网格把 main 挤到第二行的问题
- 自绘内联 SVG 图标集替代 emoji；图标/表格/按钮等交互态齐全，空态/加载/错误/禁用态补齐
- 因子研究分层柱状、因子组合与回测净值/回撤双图 + 月度收益热力表、实验页任务状态徽标
- LineChart 主题化并按需引入 echarts（回测/组合首载 JS 448k→281k）；next.config 放行局域网 dev 来源
 2026-09-08 21:48:20 +08:00
Simon a77d3c13c3 feat(web): 因子研究升级 + 因子组合页 
- 因子元数据增加 brief 使用简介（后端 FactorDef + /api/factors 返回，9 个内置因子补齐文案）
- 因子研究页：
  · 时间默认「今日 ~ 近 6 个月」
  · 因子多选，逐个跑 IC/RankIC Job 并分卡展示报告
  · 目录显示使用简介，行点击展开公式/方向/用法详解
  · 新增计分规则说明与「去因子组合」入口
- 因子组合页 /factors/compose：多因子勾选+权重、组合得分规则说明（z-score×权重求和→TopN），
  可配 topN/调仓/区间/ST，一键回测 Job → 净值/回撤/月度/未建模标注
- 回测页时间默认同样近 6 月
- 验证：tsc + next build 通过；组合回测（momentum_60×1.5 + volatility_60×1.0）Job 成功归档
  EXP-330CAAAE（-13.51%，交易 20）；后端 factors/research/api 相关测试通过 / ruff clean
 2026-09-07 21:36:16 +08:00
Simon 1cf7c84897 fix(web): 因子研究/回测改走异步 Job（修复全市场研究长请求被代理中断 500） 
- 根因：全市场因子测试同步执行约 47s，经 Next 同源代理转发时长请求被 socket 中断（前端日志：Failed to proxy .../api/factor-tests [socket hang up]）
- factors/backtest 页改为 POST /api/jobs 提交 → 轮询 GET /api/jobs/{id} → 取内嵌结果（AGENT §19 异步化）
- 新增 lib/jobs.ts（submitJob / waitJob，超时 10 分钟），运行中显示 Job 号
- 端到端验证：全市场 momentum_60 测试 JOB-93479087 → success（IC -0.0598，样本 323 日）+ Experiment 归档
- tsc + next build 通过；同步接口保留（适合小样本/脚本调用）
 2026-09-07 20:38:56 +08:00
Simon 0ea229d766 feat: Phase 4 — Experiment 自动归档 + 异步 Job（状态机 / SSE / 一键复跑） 
- 数据表：job / experiment（spec/result JSON 存档、code_version），Alembic 迁移 53113c80257f
- Job：queued→running→(success|failed) 状态机，BackgroundTasks 本地执行 + 失败兜底标记；结果与 Experiment 关联
- Experiment：每次研究成功自动归档（含 git commit 与收益摘要），支持一键复跑（同 spec 重建 Job）
- API：POST /api/jobs、GET /api/jobs/{id}（内嵌结果）、SSE /api/jobs/{id}/events、/api/experiments 列表/详情/rerun
- 前端：新增「实验」页（列表 / 详情 / 复跑 + Job 轮询）；导航更新
- 端到端验证：真实 20 股 job 提交→后台执行→success→EXP 归档（-12.41%）；executor 成功/失败路径单测
- 测试 73 passed（新增 5 项 Job/Experiment）/ ruff clean / 前端 tsc + build 通过
 2026-09-06 17:18:46 +08:00
Simon 92627f5b6b feat: Phase 3 Web — 业务 API（stocks/factors/backtests）+ Next.js 前端 
- 后端业务 API：GET /api/stocks(搜索/分页)、GET /api/factors（因子目录）、POST /api/factor-tests 与 /api/backtests（Research Spec 驱动同步执行）、GET /api/backtests/last；Annotated 依赖注入 + CORS(dev)
- Repository 批量查询 get_range_many（研究装配一次查询，避免逐只拉取）
- 前端 frontend/web：Next.js 15(TS) + ECharts —— 总览 / 股票池 / 因子研究(IC·RankIC·分层展示) / 回测（净值·回撤·月度·持仓·未建模标注）
- 前端只消费业务 API 与标准化 BacktestResult，无 Qlib/SQL 概念泄漏
- 真实数据：同步 20 只权重股 2023-2024 日线（9680 根）支撑截面研究
- 验证：API 集成测试 8 项（DTO 校验/装配/引擎/标准结果，内存 repo 全链路）+ 全量 pytest 68 passed；前端 tsc + next build 通过；无头浏览器端到端（factors/backtest 页面渲染后端数据）
- ruff clean
 2026-09-06 17:14:33 +08:00