一款以「超额 ROI(投资回报率)」为核心 KPI 的赛前盘口信号雷达(设计文档 v1.0)。它把规律评价体系从“命中率”升级为“可结算的注单盈亏”,根治“高命中率假象”——通过同场基线对照、Bootstrap 置信区间、时间衰减、走前检验与注单去重,诚实识别哪些盘口信号真正有增量信息。数据来自主软件「体彩足球竞彩」的监控会话、赛果缓存与 jcw_history.db。面向竞彩盘口数据分析者。
一、这是什么 / 适用场景
- 从命中率到 ROI:命中率不含赔率、反向规则命中率等于基准概率;ROI 雷达把每条信号翻译成真实可投注注单(玩法/选项/赔率/注额),用盈亏评价。
- 超额 ROI 为核心:在规则触发的同一批比赛上同时算
ROI_rule与“无脑买该场最低赔”的ROI_baseline,超额ROI = ROI_rule − ROI_baseline,只有显著为正才算真优势。 - 稳健性约束:样本门槛 30 注起、Bootstrap 置信区间(下界>0 才显著正)、赔率封顶 10、30 天半衰时间衰减、资金曲线与最大回撤、走前检验。
- 15 条规律 / 12 条可执行:R1/R2/R4/R6/R8/R9/R10/R11/R12/R13/R14/R15;R3/R5/R7 仅保留元信息不扫描。
二、环境准备与安装启动
启动方式
- GUI:双击
启动ROI雷达.bat(chcp 65001,优先pythonw main.py),或命令行python main.py。 - 命令行(部分需授权):
python main.py --scan [YYYYMMDD] 扫描并输出日报
python main.py --rules 规律 ROI 排行(B=1000)
python main.py --ledger 导出逐注单账本
python main.py --export [YYYYMMDD] 导出日报
python main.py --backfill [all|YYYYMMDD] 回填会话
python main.py --daemon 后台守护
python main.py --device-id 打印设备 ID
python main.py --version 版本与版权
扫描/排行/账本/导出/回填/守护均需授权;未激活只打印设备 ID 与激活指引。
三、快速上手(第一次怎么用)
- 首次打开自动进入 7 天试用(按设备 ID 绑定);长期用点「注册激活」或「设置 → 注册激活」,复制设备 ID 发给作者生成授权文件后导入。未授权时扫描/导出等功能不可用。
- 先回填:新装软件所有规则都显示“样本不足”,执行
python main.py --backfill all(或设置页历史回填)用已有监控会话形成统计样本。 - 回到 GUI「今日信号」页查看当日比赛卡片、方向倾向、可投注注单与单场结算。
- 打开「ROI 排行」页看规则 × 盘口的超额 ROI、置信区间、星级与校验结论;双击一行看资金曲线。
- 需要逐条记录时到「信号账本」页按规则过滤/搜索/导出;「诊断」页查看数据缺口与规则相关性。
四、核心功能详解
4.1 七页界面
| 页面 | 内容 |
|---|---|
| 今日信号 | 比赛卡片、方向倾向、可投注注单、初终赔、单场结算;统计卡含去重注单/注额/今日盈亏与 ROI |
| ROI 排行 | 规则×盘口,样本/命中率/CLV/ROI/基线/超额/CI/衰减/回撤/走前/星/校验;排序键为超额 ROI |
| 资金曲线 | 信号累计盈亏与同场基线对比、统计摘要、CLV |
| 信号账本 | 一条信号一行,可按规则过滤、搜索、导出 |
| 诊断 | 数据健康(会话/归档缺口、缺赛果、官方赔率缺失)+ 规则相关性矩阵 |
| 设置 | 主软件路径、扫描间隔、历史回填、注册激活、版权、只读 ROI 口径 |
| 说明 | 口径、读法、风险提示 |
界面启动即接入 ResultsWatcher;赛果缓存或 jcw_history.db 变化后去抖 8 秒自动重扫当日并刷新,无需手动“重新扫描”。
4.2 注单翻译与结算
- 正向规则直接买预测方向(注额 1);反向规则(R11~R14)翻译成补集组合注(注额 2,如“客胜不打出”→买{主胜,平}各 1 注);R15 让球买让平。
- 结算:中
min(赔率,10)−1,未中−1;赔率口径默认触发价(ROI_PRIMARY_ODDS="trigger"),官方开奖赔率用于对账。 - 同场同玩法同选项去重(
bet_key = 日期|场次|玩法|排序选项集),__ALL__为去重组合、__RAW__为原始信号。
4.3 统计口径
- 裸 ROI = ΣP&L / Σ注额;超额 ROI = 信号 ROI − 同场基线 ROI(基线=该玩法最低赔 1 注)。
- Bootstrap CI(B=1000,扫描用 300,固定种子可复现);时间衰减
w=0.5^(天数/30);走前检验(前 60% 训练 / 后 40% 验证)。 - 星级:样本<30 → 0 星;置信下界≤0 或走前转负 → 0 星;显著正超额按 ≥6%/≥3%/>0 给 3/2/1 星。
- CLV = 触发赔率/终赔 − 1;历史回填时触发价≈终赔,CLV≈0 显示“—”,只有实时扫描积累后才有判别力。
4.4 授权
与「盘口规律雷达」共用「统一注册管理工具」与 RSA 授权格式;授权绑定设备 ID,换机需重新签发。私钥只本机签发用,对外只留公钥。
五、近期更新功能
本项目本身就是 2026-11 新上线的改造成果,依据设计文档(2026-11-17/18)与文件时间戳:
- 2026-11-17 设计思路落地、核心引擎成型:
ROI雷达设计思路.md(11-17 18:21),随后betting.py(20:51)、auto_updater.py、rules_engine.py/archive.py/roi_engine.py(22:00)陆续生成。对用户的影响:KPI 从命中率换成超额 ROI,排行榜排序键、星级、结论全面改变——命中率高但负 ROI 的规则(如 R11/R14)不再被当成强信号。依据文档与时间戳。 - 2026-11-18 GUI 与命令行定稿:
gui.py(84KB)、main.py、scanner.py、config.py(11-18 10:41~10:42)及设计文档 v1.0 更新。对用户的影响:形成 7 页界面与完整命令行入口,新增赛果变化自动重扫、同源规则计票合并、注单去重等。依据文件时间戳与设计文档 §4.9/§7.11/§7.13。 - 实装数据验证(文档 §11):截至 2026-11-17 回填 27 个会话日、覆盖 31 个比赛日;原始信号 4030 条 ROI −12.7%(超额 +1.7%),去重组合 2405 注 ROI −12.3%(超额 +3.4%);所有规则置信区间均跨 0,当前无规则达显著正超额。对用户的影响:应以“找相对不亏、避开大坑”的视角使用,不要期待盈利。依据设计文档 §11。
- 界面自动重扫与 CLV 显示优化:赛果缓存/历史库变化后去抖 8 秒自动重扫;CLV 全为 0 时显示“—”避免误读。依据设计文档 §4.9/§9.2。
六、常见问题与排错(FAQ)
- 所有规则都显示“样本不足”:正常,新装软件需先回填。
python main.py --backfill all或设置页历史回填。 - CLV 列全是
—:历史回填时触发价≈终赔,CLV 无判别力;只有实时扫描运行、积累真实触发价后才有意义。 - 命中率很高却不给星/不上主推:这是设计红线——样本<30、置信下界≤0 或走前转负都不给星;命中率高但 ROI 为负正是要剔除的假象。
- 扫描/导出提示未授权:扫描、排行、账本、导出、回填、守护均需授权;点顶部按钮或设置页注册激活,未激活只显示设备 ID。
- 赛果变化后界面没刷新:启动即接入 ResultsWatcher,去抖 8 秒自动重扫;若监听缺失会降级轮询,稍等或手动切日期刷新。
- 数据缺口提示:诊断页显示缺失日期,到设置页用“全部”回填。
七、补充信息
- 目录结构:
main.py(入口)、gui.py(7 页界面)、scanner.py(扫描/分段/日报)、rules_engine.py(12 规则+投票星级)、betting.py(注单翻译)、archive.py(归档)、roi_engine.py(统计核心)、features.py/standings.py/h2h.py/match_phase.py(特征/排名/交锋/阶段)、auto_updater.py(守护)、config.py、registration/、reports/(日报、账本、归档)、logs/roi_radar.log。 - 风险提示:竞彩返奖率有下限,长期全策略 ROI 为负是数学必然。本软件用于数据分析与规则评价改进,不构成投注建议;价值在识别相对不亏与避开大坑,不承诺盈利。请理性、量力而行。