Files
tick-stock-panel/backend/app/api/screener.py
T
kevin9327 40c2468cbc fix(screener): 涨停梯队的时序扩展列只取最新分区, 不再放大行数
ext_{config_id} 视图对 timeseries 模式覆盖 timeseries/**/*.parquet 全部分区
(app/api/ext_data._refresh_views), 一只票在 N 天快照里就有 N 行。梯队直接
LEFT JOIN 该视图, 同一只涨停股被复制 N 份, 各档 count 一并放大 N 倍。

改为与自选股列表 (app/api/watchlist) 同口径: 有配置时走 _read_ext_dataframe
取最新分区, 再按 symbol 去重后 JOIN; 无配置时保留视图查询兜底。
2026-09-10 19:35:32 +09:00

1041 lines
42 KiB
Python

"""Screener API。"""
from __future__ import annotations
import contextlib
import glob as _glob
import logging
import math
import os
import re
import time
from dataclasses import asdict, replace
from datetime import date, datetime
from typing import Any, Optional
from fastapi import APIRouter, HTTPException, Query, Request
from pydantic import BaseModel
from app.config import settings
from app.db_safe import is_valid_ext_ident, quote_ident
from app.services import strategy_cache, strategy_run_queue
from app.services.screener import ScreenerService
from app.strategy import config as strategy_config
logger = logging.getLogger(__name__)
router = APIRouter(prefix="/api/screener", tags=["screener"])
class CustomRequest(BaseModel):
conditions: list[str]
order_by: Optional[str] = None
limit: int = 30
pool: Optional[list[str]] = None
as_of: Optional[date] = None
ext_columns: Optional[str] = None
asset_type: str = "stock"
class PresetRequest(BaseModel):
strategy_id: str
pool: Optional[list[str]] = None
as_of: Optional[date] = None
ext_columns: Optional[str] = None
asset_type: str = "stock"
timeframe: str = "1d"
def _safe(result_dict: dict) -> dict:
"""sanitize for JSON(NaN / Inf → None)."""
rows = result_dict.get("rows", [])
for r in rows:
for k, v in list(r.items()):
if isinstance(v, float) and not math.isfinite(v):
r[k] = None
return result_dict
def _one_word_limit_expr(status_main: str, columns: list[str]) -> Any:
required = {"open", "high", "low", "close", "status"}
if not required.issubset(columns):
import polars as pl
return pl.lit(False)
import polars as pl
return (
(pl.col("status") == status_main)
& (pl.col("close") > 0)
& (pl.col("open") == pl.col("high"))
& (pl.col("high") == pl.col("low"))
& (pl.col("low") == pl.col("close"))
).fill_null(False)
def _safe_ext_value(value: Any) -> Any:
if isinstance(value, float) and not math.isfinite(value):
return None
if isinstance(value, (date, datetime)):
return value.isoformat()
return value
# 标识符安全原语 (转义 + 白名单) 集中在 app.db_safe, 见 Issue #150 注入防护。
# ── 扩展列 value_map 缓存 ────────────────────────────────────────────
# 每次请求 _load_ext_value_maps 都会重新从磁盘读 ext parquet 并重建 {symbol: value}。
# 用底层 parquet 文件的 (路径, mtime) 签名做 memoize: 文件未变则复用上次的 map,
# parquet 被重写 (mtime 变化) 时自动失效重算。仅缓存基于 config 的快照/时序路径,
# 无 config 的 DuckDB view 回退路径不缓存 (少见)。
_ext_value_map_cache: dict[tuple[str, str], tuple[Any, dict[str, Any]]] = {}
def _ext_parquet_signature(cfg, data_dir) -> Optional[tuple]:
"""该扩展配置底层 parquet 文件的 (路径, mtime) 签名; 出错返回 None (禁用缓存)。"""
try:
from app.api.ext_data import _parquet_glob
pattern = _parquet_glob(cfg, data_dir)
files = sorted(_glob.glob(pattern, recursive=True))
if not files:
return None
return tuple((f, os.path.getmtime(f)) for f in files)
except Exception: # noqa: BLE001
return None
def _load_ext_value_maps(repo, ext_columns: Optional[str]) -> dict[str, dict[str, Any]]:
"""按请求加载扩展列,返回 {输出列名: {symbol: value}}。
策略结果缓存是共享文件,不能被不同 ext_columns 组合污染;因此扩展列只在
返回前通过该投影映射追加到结果副本中。
基于 config 的路径按 parquet 文件 mtime 签名 memoize, 文件未变时跳过磁盘重读。
"""
ext_specs = _parse_ext_columns(ext_columns) if ext_columns else []
if not ext_specs:
return {}
import polars as pl
from app.api.ext_data import _read_ext_dataframe
from app.services.ext_data import ExtConfigStore
db = repo.store.db
data_dir = repo.store.data_dir
ext_store = ExtConfigStore(data_dir)
configs = {c.id: c for c in ext_store.load_all()}
value_maps: dict[str, dict[str, Any]] = {}
for config_id, field_name in ext_specs:
out_col = f"{config_id}__{field_name}"
cfg = configs.get(config_id)
cache_key = (config_id, field_name)
sig = _ext_parquet_signature(cfg, data_dir) if cfg else None
try:
if cfg:
# 命中缓存 (文件签名一致) → 复用, 免去磁盘重读
cached = _ext_value_map_cache.get(cache_key)
if cached is not None and sig is not None and cached[0] == sig:
value_maps[out_col] = cached[1]
continue
# 时序扩展表只取最新分区,避免历史分区把同一 symbol JOIN 放大。
ext_df, _ = _read_ext_dataframe(cfg, data_dir)
else:
view_name = f"ext_{config_id}"
ext_df = pl.from_arrow(db.query(
f"SELECT symbol, {quote_ident(field_name)} FROM {view_name}"
).arrow())
if ext_df.is_empty() or "symbol" not in ext_df.columns or field_name not in ext_df.columns:
continue
ext_df = ext_df.select(["symbol", field_name]).unique(subset=["symbol"], keep="last")
vmap = {
str(row["symbol"]): _safe_ext_value(row.get(field_name))
for row in ext_df.to_dicts()
if row.get("symbol")
}
value_maps[out_col] = vmap
if cfg and sig is not None:
_ext_value_map_cache[cache_key] = (sig, vmap)
except Exception as e: # noqa: BLE001
logger.debug("screener ext column join skipped for %s.%s: %s", config_id, field_name, e)
return value_maps
def _row_with_ext(row: dict, ext_values: dict[str, dict[str, Any]], symbol: Optional[str] = None) -> dict:
next_row = dict(row)
sym = symbol or next_row.get("symbol")
for out_col, value_map in ext_values.items():
next_row[out_col] = value_map.get(str(sym)) if sym else None
return next_row
def _rows_with_ext(rows: list[dict], ext_values: dict[str, dict[str, Any]]) -> list[dict]:
if not ext_values:
return rows
return [_row_with_ext(r, ext_values) for r in rows]
def _result_with_ext(result_dict: dict, ext_values: dict[str, dict[str, Any]]) -> dict:
if not ext_values:
return result_dict
return {**result_dict, "rows": _rows_with_ext(result_dict.get("rows", []), ext_values)}
def _results_with_ext(results: dict[str, dict], ext_values: dict[str, dict[str, Any]]) -> dict[str, dict]:
if not ext_values:
return results
return {sid: _result_with_ext(r, ext_values) for sid, r in results.items()}
def _cache_payload_with_ext(cached: dict, ext_values: dict[str, dict[str, Any]]) -> dict:
if not ext_values:
return cached
payload = dict(cached)
payload["results"] = _results_with_ext(cached.get("results", {}), ext_values)
ever_rows = cached.get("today_ever_rows")
if isinstance(ever_rows, dict):
enriched_ever: dict[str, dict[str, dict]] = {}
for sid, sym_map in ever_rows.items():
if not isinstance(sym_map, dict):
continue
enriched_ever[sid] = {
sym: _row_with_ext(row, ext_values, symbol=sym)
for sym, row in sym_map.items()
if isinstance(row, dict)
}
payload["today_ever_rows"] = enriched_ever
return payload
def _update_cache_strategy(data_dir, as_of: str, strategy_id: str, safe_data: dict) -> None:
"""单跑后更新缓存中该策略的结果,保持缓存与最新计算一致。"""
from app.services import strategy_cache
cached = strategy_cache.read_cache(data_dir)
if cached and cached.get("as_of") == as_of:
results = cached.get("results", {})
results[strategy_id] = {
"total": safe_data.get("total", 0),
"as_of": as_of,
"rows": safe_data.get("rows", []),
}
strategy_cache.write_cache(data_dir, as_of, results)
@router.get("/strategies")
def strategies(
request: Request,
asset_type: str = Query("stock"),
timeframe: str = Query("1d"),
):
"""兼容策略清单端点;唯一数据源为 StrategyEngine。"""
data_dir = request.app.state.repo.store.data_dir
engine = getattr(request.app.state, "strategy_engine", None)
if engine is None:
raise HTTPException(status_code=503, detail="策略引擎未初始化")
presets = []
for meta in engine.list_strategies():
if meta.get("research_only"):
continue
if asset_type not in meta.get("asset_types", ["stock"]):
continue
if timeframe not in meta.get("timeframes", ["1d"]):
continue
sid = meta["id"]
overrides = strategy_config.load_override(data_dir, sid)
presets.append({
**meta,
"name": overrides.get("name") or meta["name"],
"description": overrides.get("description") or meta.get("description", ""),
})
return {"presets": presets, "load_errors": engine.load_errors()}
@router.post("/run")
def run_custom(req: CustomRequest, request: Request):
repo = request.app.state.repo
svc = ScreenerService(repo, asset_type=req.asset_type)
as_of = req.as_of or svc.latest_date()
if not as_of:
raise HTTPException(status_code=400,
detail="无可用数据日期 — enriched 表为空,请先运行盘后管道")
result = svc.run(
as_of=as_of,
conditions=req.conditions,
order_by=req.order_by,
limit=req.limit,
pool=req.pool,
)
safe_data = _safe(asdict(result))
ext_values = _load_ext_value_maps(repo, req.ext_columns)
return _result_with_ext(safe_data, ext_values)
@router.post("/run_preset")
def run_preset(req: PresetRequest, request: Request):
repo = request.app.state.repo
svc = ScreenerService(repo, asset_type=req.asset_type)
as_of = req.as_of or svc.latest_date()
if not as_of:
raise HTTPException(status_code=400, detail="无可用数据日期")
# 加载用户保存的策略配置
data_dir = request.app.state.repo.store.data_dir
ext_values = _load_ext_value_maps(repo, req.ext_columns)
overrides = strategy_config.load_override(data_dir, req.strategy_id)
engine = getattr(request.app.state, "strategy_engine", None)
if not engine:
raise HTTPException(status_code=404, detail=f"策略引擎未初始化或策略 {req.strategy_id} 不存在")
try:
if not engine.has(req.strategy_id):
raise ValueError(f"unknown strategy: {req.strategy_id}")
if engine.get(req.strategy_id).meta.get("research_only"):
raise ValueError(f"unknown strategy: {req.strategy_id}")
params = dict(overrides.get("params") or {})
context = svc.build_strategy_context(
engine,
as_of,
[req.strategy_id],
timeframe=req.timeframe,
params_map={req.strategy_id: params},
overrides_map={req.strategy_id: overrides or {}},
)
result = engine.run(
req.strategy_id,
context,
pool=req.pool,
params=params,
overrides=overrides or None,
)
except ValueError as e:
status_code = 404 if "unknown strategy" in str(e) else 400
raise HTTPException(status_code=status_code, detail=str(e)) from e
safe_data = _safe(asdict(result))
# 分钟周期结果不写入盘后缓存 (strategy_cache 是日线语义, as_of/updated_at
# 混入分钟结果会污染页面秒加载路径)。
if req.timeframe == "1d":
_update_cache_strategy(data_dir, str(as_of), req.strategy_id, safe_data)
return _result_with_ext(safe_data, ext_values)
def _cached_with_realtime(request: Request) -> dict:
"""读取盘后缓存,并用监控引擎的实时结果覆盖同策略。"""
data_dir = request.app.state.repo.store.data_dir
cached = strategy_cache.read_cache(data_dir)
if cached is None:
cached = {"as_of": None, "results": {}, "updated_at": None}
# 叠加监控引擎内存里的实时结果 (若有), 用新鲜数据覆盖同策略的盘后结果
monitor_engine = getattr(request.app.state, "monitor_engine", None)
if monitor_engine is not None:
realtime_results = monitor_engine.latest_strategy_results()
if realtime_results:
results = dict(cached.get("results") or {})
results.update(realtime_results)
cached = dict(cached)
cached["results"] = results
# 有实时数据时, 以最新时间戳为准
import time as _time
cached["updated_at"] = int(_time.time() * 1000)
return cached
@router.get("/cached")
def get_cached(
request: Request,
ext_columns: Optional[str] = Query(None, description="逗号分隔: config_id.field_name"),
):
"""读取策略结果缓存, 并叠加监控引擎本轮实时算出的结果。
- 盘后缓存 (strategy_cache.json): 非监控策略 / 页面秒加载用, run_all 写入。
- 监控引擎内存结果 (latest_strategy_results): 实时行情每轮对「加入监控的策略」算出,
不落盘 (避免与 read_cache 的 mtime 校验冲突), 在此直接叠加覆盖盘后结果。
被监控的策略拿到新鲜数据, 非监控策略仍用盘后缓存。
"""
cached = _cached_with_realtime(request)
# 无任何数据 (盘后缓存空 + 无实时结果) → 返回空标记, 前端据此提示
if not cached.get("results") and cached.get("as_of") is None:
return {"as_of": None, "results": {}, "updated_at": None}
ext_values = _load_ext_value_maps(request.app.state.repo, ext_columns)
return _cache_payload_with_ext(cached, ext_values)
@router.get("/cached-summary")
def get_cached_summary(request: Request):
"""返回策略卡片所需的轻量摘要,不序列化股票明细。"""
cached = _cached_with_realtime(request)
results = cached.get("results") or {}
summary = {
sid: {
"total": int(result.get("total") or 0),
"as_of": result.get("as_of"),
# 渐进式 run_all 写入的计算时间戳; 监控实时叠加/旧缓存无此字段 → None,
# 前端视为新鲜 (有值即为最新一轮实时结果)
"computed_at": result.get("computed_at"),
}
for sid, result in results.items()
if isinstance(result, dict)
}
cached_as_of = cached.get("as_of")
ever_rows = cached.get("today_ever_rows") or {}
ever_counts = {}
for sid, result in results.items():
if not isinstance(result, dict) or result.get("as_of") != cached_as_of:
continue
current_symbols = {
str(row["symbol"])
for row in result.get("rows") or []
if isinstance(row, dict) and row.get("symbol")
}
ever_counts[sid] = len(set((ever_rows.get(sid) or {}).keys()) | current_symbols)
return {
"as_of": cached_as_of,
"results": summary,
"today_ever_counts": ever_counts,
"updated_at": cached.get("updated_at"),
}
@router.get("/cached-result/{strategy_id}")
def get_cached_result(
strategy_id: str,
request: Request,
ext_columns: Optional[str] = Query(None, description="逗号分隔: config_id.field_name"),
):
"""按需返回单个策略的完整明细及其今日失效行。"""
cached = _cached_with_realtime(request)
raw_result = (cached.get("results") or {}).get(strategy_id)
if not isinstance(raw_result, dict):
return {
"result": None,
"today_ever_rows": None,
"strategy_ids_by_symbol": {},
"updated_at": cached.get("updated_at"),
}
ext_values = _load_ext_value_maps(request.app.state.repo, ext_columns)
result = {
"as_of": raw_result.get("as_of"),
"strategy": strategy_id,
"rows": _rows_with_ext(raw_result.get("rows") or [], ext_values),
"total": int(raw_result.get("total") or 0),
"elapsed_ms": 0.0,
}
ever_rows = None
if cached.get("as_of") == result["as_of"]:
strategy_ever_rows = (cached.get("today_ever_rows") or {}).get(strategy_id)
if isinstance(strategy_ever_rows, dict):
ever_rows = {
symbol: _row_with_ext(row, ext_values, symbol=symbol)
for symbol, row in strategy_ever_rows.items()
if isinstance(row, dict)
}
selected_symbols = {
str(row["symbol"])
for row in raw_result.get("rows") or []
if isinstance(row, dict) and row.get("symbol")
}
strategy_ids_by_symbol: dict[str, list[str]] = {symbol: [] for symbol in selected_symbols}
for sid, cached_result in (cached.get("results") or {}).items():
if not isinstance(cached_result, dict) or cached_result.get("as_of") != result["as_of"]:
continue
for row in cached_result.get("rows") or []:
symbol = str(row.get("symbol")) if isinstance(row, dict) and row.get("symbol") else None
if symbol in strategy_ids_by_symbol:
strategy_ids_by_symbol[symbol].append(sid)
return {
"result": result,
"today_ever_rows": ever_rows,
"strategy_ids_by_symbol": strategy_ids_by_symbol,
"updated_at": cached.get("updated_at"),
}
@router.get("/market-snapshot")
def market_snapshot(request: Request):
"""最新全市场轻量行情快照,供板块/概念聚合分析使用。"""
import polars as pl
repo = request.app.state.repo
svc = ScreenerService(repo)
as_of = svc.latest_date()
if not as_of:
return {"as_of": None, "rows": []}
df = svc._load_enriched_for_date(as_of)
if df.is_empty():
return {"as_of": str(as_of), "rows": []}
if "close" in df.columns and "total_shares" in df.columns and "market_cap" not in df.columns:
df = df.with_columns((pl.col("close") * pl.col("total_shares")).alias("market_cap"))
if "close" in df.columns and "float_shares" in df.columns and "float_market_cap" not in df.columns:
df = df.with_columns((pl.col("close") * pl.col("float_shares")).alias("float_market_cap"))
cols = [
"symbol", "name", "close", "change_pct", "amount", "volume",
"turnover_rate", "vol_ratio_5d", "total_shares", "float_shares",
"market_cap", "float_market_cap", "consecutive_limit_ups",
]
df = df.select([c for c in cols if c in df.columns])
rows = df.to_dicts()
for r in rows:
for k, v in list(r.items()):
if isinstance(v, float) and not math.isfinite(v):
r[k] = None
return {"as_of": str(as_of), "rows": rows}
def _run_all_progressive(
*,
repo,
engine,
svc: ScreenerService,
as_of,
asset_type: str,
timeframe: str,
all_ids: list[str],
params_map: dict,
overrides_map: dict,
first_return_s: float,
t_total: float,
) -> dict:
"""run_all 渐进式执行: 快策略随响应先返回, 慢策略后台算完逐个落缓存。
执行全程在单飞执行器里 (见 services/strategy_run_queue.py): 相同请求
搭车现有执行, 不同请求排队; HTTP 侧只轮询状态快照到首返时限。
"""
data_dir = repo.store.data_dir
key = (asset_type, timeframe, str(as_of), tuple(sorted(all_ids)))
ordered_ids = strategy_run_queue.order_strategy_ids(
all_ids, strategy_run_queue.load_run_timings(data_dir)
)
def job(handle: strategy_run_queue.StrategyRunHandle) -> None:
context = svc.build_strategy_context(
engine,
as_of,
ordered_ids,
timeframe=timeframe,
params_map=params_map,
overrides_map=overrides_map,
)
# 逐策略 run_all 不会把矩阵回写 context.market → 每个矩阵策略都会重建
# 全市场矩阵 (小服务器上单次数秒到十余秒)。这里按字段并集一次建好复用;
# FakeEngine 等无该方法的实现跳过 (保持旧行为)。
if getattr(context, "market", None) is None:
build_matrix = getattr(engine, "build_shared_matrix", None)
if callable(build_matrix):
matrix = build_matrix(
context,
[(sid, engine.get(sid)) for sid in ordered_ids],
params_map,
overrides_map,
)
if matrix is not None:
context = replace(context, market=matrix)
all_results: dict[str, dict] = {}
elapsed_map: dict[str, float] = {}
for sid in ordered_ids:
t0 = time.perf_counter()
# 逐策略隔离: 单个策略崩溃 (如自定义代码的数据类型错误) 只记
# 错误跳过, 不让整批剩余策略陪葬 — 其余策略照常算完落缓存。
try:
single = engine.run_all(
context,
params_map=params_map,
overrides_map=overrides_map,
strategy_ids=[sid],
parallel=False,
)
result = single[sid]
except Exception as e:
logger.warning("run_all: 策略 %s 执行失败, 跳过: %s", sid, e, exc_info=True)
handle.fail_one(sid, str(e))
continue
payload = {
"total": result.total,
"as_of": str(as_of),
"rows": _safe(asdict(result)).get("rows", []),
"computed_at": int(time.time() * 1000),
}
all_results[sid] = payload
elapsed_map[sid] = (time.perf_counter() - t0) * 1000
# 逐策略增量落盘 (write_cache 同日按 sid 合并), 前端轮询即可逐个看到
try:
strategy_cache.write_cache(data_dir, str(as_of), {sid: payload})
except Exception:
logger.warning("run_all 渐进写入缓存失败: %s", sid, exc_info=True)
handle.complete(sid, {k: v for k, v in payload.items() if k != "rows"})
# 收尾: 与旧版口径一致的整体重写 + 耗时落盘供下次排序
if all_results:
with contextlib.suppress(Exception):
strategy_cache.write_cache(data_dir, str(as_of), all_results)
strategy_run_queue.record_run_timings(data_dir, elapsed_map)
handle = strategy_run_queue.MANAGER.get_or_submit(key, ordered_ids, job)
deadline = time.perf_counter() + first_return_s
snap = handle.snapshot()
while not snap["done"] and time.perf_counter() < deadline:
time.sleep(0.2)
snap = handle.snapshot()
done_results = snap["results"]
if snap["error"] and not done_results:
raise HTTPException(status_code=500, detail=snap["error"])
logger.info(
"run_all: first return %.1fms (%d done, %d pending)",
(time.perf_counter() - t_total) * 1000,
len(done_results),
len(snap["pending"]),
)
return {
"as_of": str(as_of),
"results": done_results,
"pending": snap["pending"],
"errors": snap["errors"],
"complete": snap["done"] and not snap["error"],
"error": snap["error"],
"started_at": snap["started_at_ms"],
}
@router.post("/run_all")
def run_all(request: Request, body: Optional[dict] = None):
"""批量运行指定策略;注册、路由和执行均由 StrategyEngine 负责。"""
from datetime import date as date_type
t_total = time.perf_counter()
body = body or {}
repo = request.app.state.repo
asset_type = str(body.get("asset_type") or "stock")
timeframe = str(body.get("timeframe") or "1d")
svc = ScreenerService(repo, asset_type=asset_type)
engine = getattr(request.app.state, "strategy_engine", None)
if engine is None:
raise HTTPException(status_code=503, detail="策略引擎未初始化")
# 解析日期
raw_date = body.get("as_of")
if raw_date:
# 与 /custom、/preset 的 `as_of: date` 同口径: 只收 ISO 日期字符串。
# 非字符串原样透传会让 str(as_of) 把 "20260904" 之类写进 strategy_cache.json,
# 与其它入口写的 "2026-09-04" 不是同一格式, 后续按 as_of 比对缓存永远失配。
if not isinstance(raw_date, str):
raise HTTPException(status_code=400, detail="as_of 必须是 YYYY-MM-DD 日期字符串")
try:
as_of = date_type.fromisoformat(raw_date)
except ValueError as e:
raise HTTPException(status_code=400, detail=f"日期格式错误: {e}") from e
else:
as_of = svc.latest_date()
if not as_of:
return {"as_of": None, "results": {}}
data_dir = request.app.state.repo.store.data_dir
requested_ids = body.get("strategy_ids")
if requested_ids and isinstance(requested_ids, list):
all_ids = [str(sid) for sid in requested_ids]
unknown = [
sid
for sid in all_ids
if not engine.has(sid) or engine.get(sid).meta.get("research_only")
]
if unknown:
raise HTTPException(status_code=404, detail=f"unknown strategies: {unknown}")
else:
all_ids = [
meta["id"]
for meta in engine.list_strategies()
if not meta.get("research_only")
and asset_type in meta.get("asset_types", ["stock"])
and timeframe in meta.get("timeframes", ["1d"])
]
if not all_ids:
return {"as_of": str(as_of), "results": {}}
# 批量预加载所有 override 配置
t0 = time.perf_counter()
all_overrides = strategy_config.list_overrides(data_dir)
logger.info("run_all: list_overrides took %.1fms (%d overrides)", (time.perf_counter() - t0) * 1000, len(all_overrides))
params_map = {
sid: dict((all_overrides.get(sid) or {}).get("params") or {})
for sid in all_ids
}
overrides_map = {sid: all_overrides.get(sid, {}) for sid in all_ids}
# 渐进式返回 (页面首屏路径): 按历史耗时升序执行, 首返时限内算完的随响应
# 返回, 慢策略转后台继续算并逐个写入策略缓存, 前端轮询 cached-summary 点亮。
# 仅日线 + summary_only (策略页卡片) 启用; 分钟/明细请求保持整段阻塞。
first_return_s = settings.strategy_run_all_first_return_s
if body.get("summary_only") and timeframe == "1d" and first_return_s > 0:
return _run_all_progressive(
repo=repo,
engine=engine,
svc=svc,
as_of=as_of,
asset_type=asset_type,
timeframe=timeframe,
all_ids=all_ids,
params_map=params_map,
overrides_map=overrides_map,
first_return_s=first_return_s,
t_total=t_total,
)
try:
context = svc.build_strategy_context(
engine,
as_of,
all_ids,
timeframe=timeframe,
params_map=params_map,
overrides_map=overrides_map,
)
engine_results = engine.run_all(
context,
params_map=params_map,
overrides_map=overrides_map,
strategy_ids=all_ids,
)
except ValueError as e:
raise HTTPException(status_code=400, detail=str(e)) from e
results: dict[str, dict] = {}
for sid, result in engine_results.items():
safe_rows = _safe(asdict(result)).get("rows", [])
results[sid] = {
"total": result.total,
"as_of": str(as_of),
"rows": safe_rows,
}
elapsed = (time.perf_counter() - t_total) * 1000
logger.info("run_all: total took %.1fms (%d strategies)", elapsed, len(all_ids))
# 写入策略缓存 (供页面秒加载); 分钟周期结果不落盘 (日线语义缓存)
if results and timeframe == "1d":
try:
strategy_cache.write_cache(data_dir, str(as_of), results)
except Exception: # noqa: BLE001
pass
if body.get("summary_only"):
return {
"as_of": str(as_of),
"results": {
sid: {"total": result["total"], "as_of": result["as_of"]}
for sid, result in results.items()
},
}
ext_values = _load_ext_value_maps(repo, body.get("ext_columns"))
return {"as_of": str(as_of), "results": _results_with_ext(results, ext_values)}
@router.get("/limit-ladder")
def limit_ladder(
request: Request,
as_of: Optional[date] = None,
direction: str = Query("up", description="up=涨停梯队 | down=跌停梯队"),
ext_columns: Optional[str] = Query(None, description="逗号分隔: config_id.field_name"),
):
"""连板/连跌梯队 — 按连板数分组, 含三状态。
返回: tiers = [{ boards, count, stocks: [{symbol,name,change_pct,status,...}] }]
direction=up (默认):
status: limit_up=涨停 | broken=炸板(摸板未封) | failed=断板(晋级失败)
direction=down:
status: limit_down=跌停 | recovery=翘板(跌停后回升,含收阳条件) | failed=止跌(昨日跌停今日未跌停也未翘板)
ext_columns: 动态 JOIN 扩展数据, 如 "concept.concept,industry.industry"
"""
import polars as pl
is_down = direction == "down"
# 按 direction 参数化字段映射
if is_down:
sig_col = "signal_limit_down"
consec_col = "consecutive_limit_downs"
broken_col = "signal_limit_down_recovery"
status_main, status_broken, status_failed = "limit_down", "recovery", "failed"
else:
sig_col = "signal_limit_up"
consec_col = "consecutive_limit_ups"
broken_col = "signal_broken_limit_up"
status_main, status_broken, status_failed = "limit_up", "broken", "failed"
repo = request.app.state.repo
svc = ScreenerService(repo)
as_of = as_of or svc.latest_date()
if not as_of:
raise HTTPException(status_code=400, detail="无可用数据日期")
df = svc._load_enriched_for_date(as_of)
if df.is_empty():
return {"as_of": str(as_of), "tiers": [], "counts": {"up": 0, "down": 0}}
# 双方向涨跌停计数(不论当前 direction, 前端始终同时显示)
count_up_raw = int(df.filter(pl.col("signal_limit_up").fill_null(False)).height) if "signal_limit_up" in df.columns else 0
count_down_raw = int(df.filter(pl.col("signal_limit_down").fill_null(False)).height) if "signal_limit_down" in df.columns else 0
# 双方向 sealed 修正: 减去各自的假涨停(假涨停已归炸板, 不计入涨停数)
depth_svc_global = getattr(request.app.state, "depth_service", None)
fake_up = 0
fake_down = 0
sealed_up_ready = False
sealed_down_ready = False
if depth_svc_global:
up_map = depth_svc_global.get_sealed_map(as_of, is_down=False)
down_map = depth_svc_global.get_sealed_map(as_of, is_down=True)
sealed_up_ready = bool(up_map) and depth_svc_global.is_sealed_ready(as_of)
sealed_down_ready = bool(down_map) and depth_svc_global.is_sealed_ready(as_of)
if up_map:
fake_up = sum(1 for v in up_map.values() if v.get("sealed") is False)
if down_map:
fake_down = sum(1 for v in down_map.values() if v.get("sealed") is False)
count_up = count_up_raw - fake_up if sealed_up_ready else count_up_raw
count_down = count_down_raw - fake_down if sealed_down_ready else count_down_raw
# 双方向 sealed 明细(供前端弹窗同时显示涨跌停)
def _count_sealed(m: dict, ready: bool):
if not m or not ready:
return {"real": 0, "fake": 0, "pending": 0}
real = sum(1 for v in m.values() if v.get("sealed") is True)
fake = sum(1 for v in m.values() if v.get("sealed") is False)
pending = sum(1 for v in m.values() if v.get("sealed") is None)
return {"real": real, "fake": fake, "pending": pending}
sealed_counts_up = _count_sealed(up_map, sealed_up_ready)
sealed_counts_down = _count_sealed(down_map, sealed_down_ready)
# 加载前一日的 prev consecutive_limit_ups/downs
# 窄读: 仅取前一交易日的 [symbol, consec_col] 两列 (存储列, 直接谓词下推读 parquet),
# 替代旧的 range(1,10) 循环逐日 _load_enriched_for_date 全量指标重算 (最坏 9× 全市场重算)。
prev_consec: pl.DataFrame = svc.load_prior_consecutive(as_of, consec_col)
if not prev_consec.is_empty():
df = df.join(prev_consec, on="symbol", how="left")
else:
df = df.with_columns(pl.lit(0).cast(pl.UInt32).alias("prev_consec"))
# 表达式
is_limit = pl.col(sig_col).fill_null(False) if sig_col in df.columns else pl.lit(False)
is_broken = pl.col(broken_col).fill_null(False) if broken_col in df.columns else pl.lit(False)
consec = pl.col(consec_col).fill_null(0) if consec_col in df.columns else pl.lit(0)
prev_c = pl.col("prev_consec").fill_null(0)
# 计算 status + boards (结构涨跌停对称, 仅字段与字面量不同)
is_failed = ~is_limit & ~is_broken & (prev_c > 0)
df = df.with_columns([
pl.when(is_limit).then(pl.lit(status_main))
.when(is_broken).then(pl.lit(status_broken))
.when(is_failed).then(pl.lit(status_failed))
.otherwise(None).alias("status"),
pl.when(is_limit).then(consec)
.when(is_broken | is_failed).then(prev_c + 1)
.otherwise(0).cast(pl.UInt32).alias("boards"),
])
df = df.filter(pl.col("status").is_not_null() & (pl.col("boards") > 0))
# ── 五档 sealed 叠加(独立旁路, 不改 signal_limit_up) ──
# 假涨停(收盘价=涨停价但卖一有量)从 limit 降级为 broken(归炸板视图)
# 真涨停保留 + 附封单量; sealed=null(待确认/降级)保持原状
depth_svc = getattr(request.app.state, "depth_service", None)
sealed_ready = False
sealed_age: float | None = None
if depth_svc:
# 复用上方双方向计数已读取的 sealed map: 同一请求、同一 as_of、同一对象,
# 不再第三次读取 (内存路径含全量浅拷贝, parquet 路径含整文件读)。
sealed_map = down_map if is_down else up_map
sealed_ready = bool(sealed_map) and depth_svc.is_sealed_ready(as_of)
sealed_age = depth_svc.get_sealed_age(as_of) if sealed_ready else None
if sealed_map:
# 构建 sealed 列(symbol → sealed bool, vol)
sym_sealed = {s: v.get("sealed") for s, v in sealed_map.items()}
sym_vol = {s: v.get("vol") for s, v in sealed_map.items()}
# JOIN sealed: 对每只 status=main 的票, 看 sealed 值
sealed_rows = pl.DataFrame({
"symbol": list(sym_sealed.keys()),
"_sealed": list(sym_sealed.values()),
"_sealed_vol": list(sym_vol.values()),
}) if sym_sealed else pl.DataFrame()
if not sealed_rows.is_empty():
df = df.join(sealed_rows, on="symbol", how="left")
# 假涨停(main 状态但 sealed=False)→ 降级为 broken
df = df.with_columns(
pl.when(
(pl.col("status") == status_main)
& pl.col("_sealed").is_not_null()
& (pl.col("_sealed") == False) # noqa: E712
).then(pl.lit(status_broken))
.otherwise(pl.col("status")).alias("status"),
# sealed_status: real/fake/pending/null
pl.when(
(pl.col("status") == status_main)
& (pl.col("_sealed") == True) # noqa: E712
).then(pl.lit("real"))
.when(
(pl.col("_sealed") == False) # noqa: E712
).then(pl.lit("fake"))
.when(
(pl.col("status") == status_main)
& pl.col("_sealed").is_null()
).then(pl.lit("pending"))
.otherwise(None).alias("sealed_status"),
pl.col("_sealed_vol").alias("sealed_vol"),
).drop(["_sealed", "_sealed_vol"])
else:
df = df.with_columns(
pl.lit(None).alias("sealed_status"),
pl.lit(None).alias("sealed_vol"),
)
else:
df = df.with_columns(
pl.lit(None).alias("sealed_status"),
pl.lit(None).alias("sealed_vol"),
)
else:
df = df.with_columns(
pl.lit(None).alias("sealed_status"),
pl.lit(None).alias("sealed_vol"),
)
df = df.with_columns(_one_word_limit_expr(status_main, df.columns).alias("is_one_word"))
# 动态 JOIN 扩展数据
ext_specs = _parse_ext_columns(ext_columns) if ext_columns else []
ext_col_names: list[str] = []
if ext_specs:
db = repo.store.db
data_dir = repo.store.data_dir
from app.api.ext_data import _read_ext_dataframe
from app.services.ext_data import ExtConfigStore
ext_store = ExtConfigStore(data_dir)
configs = {c.id: c for c in ext_store.load_all()}
def _dedup_ext(frame: pl.DataFrame, field: str, out_col: str) -> pl.DataFrame | None:
"""(symbol, 字段) 两列并按 symbol 去重; 缺列时返回 None。"""
if frame.is_empty() or "symbol" not in frame.columns or field not in frame.columns:
return None
return (
frame
.select(["symbol", field])
.unique(subset=["symbol"], keep="last")
.rename({field: out_col})
)
for config_id, field_name in ext_specs:
view_name = f"ext_{config_id}"
ext_col_name = f"{config_id}__{field_name}"
try:
# 扩展时序数据必须只取最新分区; 否则一个 symbol 会按历史分区数被 JOIN 放大
# (ext_{id} 视图覆盖 timeseries/**), 与自选股列表同口径。
cfg = configs.get(config_id)
if cfg:
ext_df, _ = _read_ext_dataframe(cfg, data_dir)
else:
ext_df = pl.from_arrow(db.query(
f"SELECT symbol, {quote_ident(field_name)} FROM {view_name}"
).arrow())
joined = _dedup_ext(ext_df, field_name, ext_col_name)
if joined is not None:
df = df.join(joined, on="symbol", how="left")
ext_col_names.append(ext_col_name)
except Exception:
cfg = configs.get(config_id)
if cfg:
try:
ext_df, _ = _read_ext_dataframe(cfg, data_dir)
joined = _dedup_ext(ext_df, field_name, ext_col_name)
if joined is not None:
df = df.join(joined, on="symbol", how="left")
ext_col_names.append(ext_col_name)
except Exception:
pass
# 选择输出列
cols = ["symbol", "name", "close", "change_pct", "boards", "status", consec_col, "sealed_status", "sealed_vol", "is_one_word"] + ext_col_names
df = df.select([c for c in cols if c in df.columns])
# 排序: boards 降序, status 按主状态→炸/翘→断/止
status_order = pl.when(pl.col("status") == status_main).then(0)
status_order = status_order.when(pl.col("status") == status_broken).then(1)
status_order = status_order.otherwise(2).alias("_status_order")
df = df.with_columns(status_order).sort(["boards", "_status_order"], descending=[True, False]).drop("_status_order")
rows = df.to_dicts()
for r in rows:
for k, v in list(r.items()):
if isinstance(v, float) and not math.isfinite(v):
r[k] = None
# 按 boards 分组
tiers: dict[int, list] = {}
for r in rows:
n = int(r.get("boards") or 0)
tiers.setdefault(n, []).append(r)
tier_list = [
{"boards": n, "count": len(stocks), "stocks": stocks}
for n, stocks in sorted(tiers.items(), key=lambda x: -x[0])
]
return {
"as_of": str(as_of),
"tiers": tier_list,
"counts": {"up": count_up, "down": count_down},
"counts_raw": {"up": count_up_raw, "down": count_down_raw},
"sealed_ready": sealed_ready,
"sealed_age": round(sealed_age, 0) if sealed_age is not None else None,
"sealed_counts": {
"real": sum(1 for t in tier_list for s in t.get("stocks", []) if s.get("sealed_status") == "real"),
"fake": sum(1 for t in tier_list for s in t.get("stocks", []) if s.get("sealed_status") == "fake"),
"pending": sum(1 for t in tier_list for s in t.get("stocks", []) if s.get("sealed_status") == "pending"),
},
"sealed_counts_up": sealed_counts_up,
"sealed_counts_down": sealed_counts_down,
}
def _parse_ext_columns(ext_columns: str) -> list[tuple[str, str]]:
"""解析 'config_id1.field1,config_id2.field2' 为 [(config_id, field_name), ...]。"""
result = []
for part in ext_columns.split(","):
part = part.strip()
if "." not in part:
continue
config_id, field_name = part.split(".", 1)
config_id = config_id.strip()
field_name = field_name.strip()
if not config_id or not field_name:
continue
if not is_valid_ext_ident(config_id) or "\x00" in field_name:
continue
result.append((config_id, field_name))
return result