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
7 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 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 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 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 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 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