simon/qlib
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
73 Commits 1 Branch 0 Tags
50a1030afae4c13a08df46d5a70897437dec2efa
Commit Graph
10 Commits
Author SHA1 Message Date
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 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 63c61ded37 feat(web): M9-3 K线 Chart 组件（candlestick + 量 + MA + Signal↔Fill 标记） 
- components/StockChart/CandleChart.tsx：ECharts candlestick（红涨绿跌）+ 成交量副网格 +
  MA20/MA60 叠加 + 事件标记：成交 fills 实心三角、未成交信号空心三角（v3 §20.3）；
  组件只展示不计算；层隔离便于替换 TradingView Lightweight Charts
- lib/types.ts：ChartResult/OHLC/Volume/Series/Marker DTO
- tsc --noEmit 通过
 2026-09-09 07:13:43 +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 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 b78852f01b fix: 前端同源代理 /api → 后端（任意 IP 访问不再 NetworkError）+ SQLite 写锁等待 
- 根因①：页面硬编码 http://127.0.0.1:8000/api，从 192.168.1.160:3000 访问时浏览器请求自身/跨域失败
- 根因②（500）：全市场数据同步（长写事务）持有 SQLite 锁导致读接口 database is locked
- 前端：next.config.ts rewrites /api/* → http://127.0.0.1:8000/api（BACKEND_API_URL 可覆盖）；
  lib/api.ts 默认相对 /api 同源（NEXT_PUBLIC_API_BASE 保留为直连覆盖项）；.env.local.example 说明两种方式
- 后端：CORS 开发期 allow_origins=["*"]（无凭据，上线前收紧）；SQLite engine busy_timeout=30s
- USAGE FAQ 同步；验证：192.168.1.160:3000/api/health 与 /api/factors 经代理 200，CORS 头 access-control-allow-origin: *
 2026-09-06 19:00:49 +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