SK-prestep-filter

Files (1)

• SKILL.md

SKILL.md (first lines)

# SK-prestep-filter 先验筛选（被动·用户指令触发）

> 🔴**适用域边界（已修正）**: 阈值全部来自 **Matches.csv 22.7 万场（五大联赛）** → **欧国联/国家队（league_id=5）评分超域** → **NL 场不打 PreStep 分**·直接走 `SK-league-nations`（R1-R10·658 场）。🔴**赛程拉取已打通**: Odds-API **确实收录**欧国联（16 slug·`international-uefa-nations-league-league-{A-D}-gr-{1-4}`·实测 pending 156 场）→ `prestep_fetch.LG` 已纳入·**「未收录」为 2026-09-23 早期错误结论·已推翻**

🔴**PreStep 实操口径（6 项）**:
① **NL 场分流**——欧国联/国家队场分值**不混入正式双轨表**，移入『NL 超域区·仅供参考·不参与判定』（`prestep_dual.print_table` 已实现）
② **slug 三态**——拉取失败（404/429）必须**列名 + 提示「可能漏场」**，429 自动重试 1 次（`prestep_fetch` 已实现）
③ **主水必传**——`prestep_dual --match` 未传第 10 位主水 → **W1(主水诱主 −0.5) 失效·方向分偏高**（实测差 0.5 分）·脚本已加告警
④ **分数留痕**——`prestep_window.json` 已增 `dir_score`/`score_score`/`tag` 三字段（可事后审计当批分数）
⑤ **NL ELO**——NL 场 ELO 改读 `nl_data/elo_current.json`（313 队·clubelo 无国家队档案）
⑥ **输出两层**——双轨分数表 + 人话推荐（中文队名）·缺任一层 = 输出不完整

## 🔴触发条件
- 用户消息含「先验」（如「先验一下今晚的五大联赛」「筛选信号强的比赛」）→ **执行本 skill**
- 未下达先验指令直接发竞彩txt → **跳过本 skill·按原模型 Step0-11**（被动模块·零干扰原流程）

## 流程

### PreStep1 数据获取（Odds-API）
🔴**时间窗口（固定）**: 指令发出当天 **北京时间22:00 → 次日凌晨06:00**（8小时窗口）= UTC **当天14:00 → 当天22:00**
1. `get_events(sport=football, league={england-premier-league|spain-laliga|germany-bundesliga|italy-serie-a|france-ligue-1}, from=<当天>T14:00:00Z, to=<当天>T22:00:00Z, status=pending)` → 窗口内五大联赛全部赛事（eventId+球队）
2. `get_multi_odds`（≤10 event 一次）或逐场 `get_odds(eventId, bookmakers=1xbet,Bet365)` → 每场 ML/Spread(亚盘水位)/Totals(大小球)
3. 数据缺失/网络故障 → 标注「数据获取失败·稍后重试」·不臆造

#
### 🔴 PreStep2 双向评级（V2··用户要求"每次 prestep 同时输出方向评分和比分评分"）

**执行方式（脚本化·避免手算）**:
```bash
python data/tmp/prestep_dual.py --match "赛事,主,平,客,让球,O25[,水位差,联赛]"
python data/tmp/prestep_dual.py --file data/tmp/_prestep_input.txt   # 每行一场（🔴该文件为**运行时生成**的临时输入·非固定文件·不存在属正常）
```
**输出（每场两套独立评级 + 综合判定）**:
| 输出项 | 含义 |
|:--|:--|
| **方向分** | V3 重标 10 信号（D1/D2/D3/N3/N4/G1/H1/H2/O10/H3·G2 已移出）· **≥3.0 = 推荐（71.22% 命中·相当于旧体系 ≥3.5）**· ≥2.5 观察 |
| **比分分** | V3.1 比分可预测性（强小球+0.5·中盘+1.0·深让+1.0·极端共振-5.0…）· **≥2.0 = 强推荐（锚Top2 24.51%）**· ≥1.0 参考 |
| **比分锚建议** | 按 方向+让球层+O25档 查表（Top2 ~25%·粗粒度参考）|
| **双向评级** | 🔴双推荐 / ✅仅方向推荐 / ⚡比分有谱方向弱 / ⏸️比分不可预测 / ❌双低跳过 |

**三档分档（🔴2026-09-20 V3.1 重标·Matches 227518 场实测）**:
| 比分分 | 档位 | 实测锚Top2 | 覆盖 |
|:--|:--|:--|:--|
| **≥2.0** | 强推荐(比分) | **24.51%** | 7.24% |
| ≥1.0 | 参考(比分) | 21.99% | 17.66% |
| <0 | 不可预测 | ≈19-20% | — |
🔴旧 ≥1.5 = 20.24% < 全样本基准 21.18%（无增益·已证伪）·旧 ≥2.5 = 23.67%

**组合评级（🔴双推荐（方向≥3.0+比分≥2.0）/ ✅方向优先（方向≥3.0·比分<2.0）/ ⚡比分优先（比分≥2.0·方向<3.0）/ ⏸️比分不可预测（比分<0 或 锚不可信）/ 其余参考。
🔴**方案验证结论**: 用户方案 V2.0 经独立复现——①结论可复现（强推荐 29.48%·+4.60pp）②**方案有符号 bug**（`handi=-hs` 致 S2/S3/S9/S10/S11 让球信号全失效）→ 修正后 **30.53%（+5.65pp）**③本模型比分分**等效且覆盖率 2.8×**（802 场 vs 285 场）→ 保留本模型分值。**方向代价**: 比分推荐组方向 38-39%（基准 51%）——侧重比分的必然取舍。
⚠️ 锚建议为**粗粒度参考**（实测该档 Top2 约 25%）·精细锚仍需 Step7 完整流程（查表+泊松+资金流）。

### 🔴 PreStep2-b 比分命中评分（V2··用户要求"侧重比分命中兼顾方向"）

**回测依据**（`data/tmp/prestep_score_backtest.py`·12000 场时间分割·见 `data/online_learning/docs/PreStep比分导向回测_20260911.txt`）：
全局基准 比分Top2 **25.19%** / 方向 50.30%。**关键发现：方向强度与比分可预测性负相关**（主赔<1.30 方向 82.45% 但比分 -1.17pp）。

| 比分可预测性信号 | 实测比分Top2增量 | **比分分** |
|:--|:--|:--|
| **O25>2.10（强小球）** | +2.8pp（重测) | **+0.5**（原+3→+1.5→+0.5）|
| **主赔 1.80-2.20（中盘）** | **+1.16pp** | **+1.0** |
| **让≥1.5（深让·排除搭配极端大球）** | +0.70~1.28pp | **+1.0** |
| 主赔 1.50-1.80 | +0.46pp | **+0.5** |
| O25 1.65-1.90（中性） | -1.03pp | **-1.0** |
| O25<1.65（大球侧） | -2.3~3.6pp | **-2.5** |
| **O25<1.5 + 让≥1.5（极端共振）** | **-5.35pp** | 🔴**-5.0（不推荐）** |
| **贴水浅让（主<1.5+让<1）** | **-5.06pp** | 🔴**-5.0（不推荐）** |
| O25<1.7 + 隐含差>25pp | -1.82pp | **-2.0** |

🔴**独立打分（重申）**: 方向分与比分分**各自独立评级·不合并总分**（禁数值相加·仅输出组合标签）

🔴**锚可信度分级铁律（案例库 157 场锚命中回测固化）**: 比分锚(主锚/次锚)的可信度由【预期总进球量级×净胜档】决定，必须显式声明——实测(真实赛果分档·锚命中率): 实际总进球 ≤3球 **36.4%**(n=88) vs ≥4球 **2.9%**(n=69)·5+球 **0%**(n=38)；净胜≤1球占命中场 76%·净胜≥3仅 **5.4%**；交叉「≤3球且净胜≤1」**40.0%**(n=65) vs「≥4球且净胜≥2」**4.9%**；命中比分 88% 落在 {1:1,2:1,1:0,0:1,2:0}。→ **①大球场(预期≥3.4球/O25<1.50) 或 深盘大胜(净胜档≥3) → 锚不可信 → 禁把"主锚/次锚"当高置信输出·改输出「宽候选池+比分不可预测」标注(方向仍可用) ②低分小净胜场 → 锚可信(40%)·精细锚定 ③🔴HIGH 置信度 ≠ 比分可信**(实测 HIGH 场锚命中 15.4% 最低档·因 HIGH 多为深盘悬殊场)。**脚本**: prestep_dual.anchor_trust 每场判级(✅可信/⚠️弱/🔴不可信)·output_checker **N08** 块·check_sync 防回退。
**推荐线（比分分 **≥2.0** → 比分强推荐场（输出主锚/次锚+该档锚命中率 24.51%）· 比分分 **<0** → 标注"比分不可预测·仅方向参考"

**📌 输出要求（每场·🔴方向与比分独立打分·不合并总分）**: ①**方向分**（独立·≥3.0 推荐 71.22%）②**比分分**（独立·三档：≥2.0强推荐/≥1.0参考/<0不可预测）③**主锚/次锚**（锚可信度分级 + 查表建议）④该档历史锚命中率 ⑤**组合标签**（🔴双推荐/✅方向优先/⚡比分优先/⏸️比分不可预测·非数值相加）

⚠️ 诚实边界: 赔率类信号对比分的增益上限约 **+1.5pp**（单信号）·真正提升比分需 **球队攻防/场均进失/xG**（data_bridge 已接入）·后续用 prediction_log 积累样本复核。

## PreStep2 信号打分（🔴V3 分值体系·消融回测重标·Matches.csv 227,518 场）
```
方向信号（分值来源 = 触发组 vs 未触发组命中率边际差 Δ·1分≈3-5pp·前80%定/后20%验）:
  D1 深盘主胜(主赔<1.5·Δ+27.2pp) = +2
  D2 深盘客胜(亚盘客让0.75+·Δ+14.4pp) = +2
  H2 穿盘区间(主让1.25-1.75·Δ+23.8pp) = +2.0（升权）
  N3 中深盘主胜(主赔1.5-1.8+客赔>4.5·Δ+10.4pp·与D1零重叠) = +1.5
  🔴N4 客队热门(客赔<2.2+主赔>3.0·Δ+6.0pp·孤立仅+2.3) = +1.0（2026-09-20 降权）
  🔴G1 大球确认(O25<1.7·Δ+13.2pp·孤立-3.1 共线依赖) = +1.0（2026-09-20 降权）
  H1 水位背离(主客水位差>0.2·V6修正55: 主高水+大低水58.3%/主高水+小低水58.0%) = +1（Matches 无水位列·待实盘验证）
  🔴D3 均势必平(主客隐含差5-10pp+联赛平率≥27%·Δ**-12.0pp**·孤立场39.86%) = **-1.5**（2026-09-20 改负·均势场方向不可判·平局价值走修正53/R20）
  🔴O10 浅让降权(2026-09-20 严格口径·**仅主让0.25-0.75**) = -1（诱主·D1/N3子集: 浅让57.9% vs 深让80.1%·差22.2pp）
     （旧实现 `handi > -1.0` 误含平手62.69%/受让60.00% → 已修正为 `-1.0 < handi < 0`）
  🔴G2 小球确认(O25>2.1·Δ-7.5pp) → **移出方向分**（小球兑现率60.2%有效但归 Step6 进球信号）
  🔴H3 反直觉(西甲1.5-1.8/法甲深盘·Δ+13.2pp·实测63.16%) → **仅标注·不扣分**（原-1 被数据证伪·绝不反向加客胜纪律保留）
  🔴N4防平注(2026-09-05): 客让<0.75→附加「防平参考」(O2/case123·不扣分仅标注)
🔴已删除: D4平手主胜(42.4%<基准46.2%·无效·平手≠主胜)
```
```
预测方向 = 分数最高的方向类信号（主胜/客胜/平局）·**方向分** = 方向信号+进球信号+盘口信号之和（🔴此为方向分内部构成·与比分分**独立**·两者不合并）

### PreStep3 筛选输出
```
🔴阈值（V3.1·信号后重标）: ≥3.5=推荐(73.22%命中·8.68%覆盖) · ≥3.0=观察(70.65%·12.08%) · <3.0=不推荐(仅用户指定时分析)
🔴V3.2 新信号: E1 ELO差>150 +1.5 / E2 ELO差>100 +1.0 / E3 ELO差<0 -0.5 / W1 主水>2.05 -0.5 / O11 客赔<5.0 -1.5（与N3互斥）/ **F1 Form差≥1.0 +0.5**（F2 Form差<0 仅标注）· 严格协议 6/6 通过 · 数据源 clubelo ELO + Spread 主水 + api-football 近期战绩
输出格式（按分数降序·数量不限）:
 赛事 | 分数 | 触发信号 | 方向倾向 | 置信度层 | 建议
 ─────────────────────────────────────────────
 X vs Y | 5.0 | D1+H2+G1+N3 | 主胜 | HIGH | 推荐(≥3.0)·建议完整分析
 ...
```
输出后 **等用户决定对哪些场做完整分析**（用户发 txt 或点名）→ 转原模型 Step0-11

## 数据档案（可调用）
- 联赛模块: data/league-modules/{E0,SP1,D1,I1,F1}.json（先验/赔率档映射/半场）
- 联赛 skill: SK-league-{epl,laliga,bundesliga,seriea,ligue1}（R1-R12·深盘档位胜率基准）
- 回测脚本: data/tmp/prestep_backtest.py（阈值）· data/tmp/prestep_signal_backtest.py（信号效度）

## 🔴约束
- 被动模块: 无「先验」指令不触发·不干扰原模型 Step0-11
- 信号强标准已回测校准（2026-09-20 V3 消融重标: 方向 ≥3.0=71.22% · 逐信号 Δ 边际差定分值 · D3 改负分/G2 移出/H3 改标注/O10 严格口径/H2 升2.0）

From MENG-COOLMAN/PitchQuant, MIT.

More from MENG-COOLMAN/PitchQuant