一款与桌面软件「盘口棱镜」(体彩足球竞彩)配套的 规律扫描与复盘桌面工具。它读取主软件导出的监控会话,用内置规则(R1~R15)识别赔率异动中的「共振/预警/假降水」信号,给出每场倾向(主胜/平/客胜、让胜/让平/让负),并提供规律命中率排行、每日复盘日报、联赛排名显示与结果发布到竞彩网页。数据仅供分析研究,不构成投注建议。
一、这是什么 / 适用场景
- 规律扫描:读取主软件的监控会话 JSON,提取特征、触发规则、投票得出每场倾向与共振/预警标记。
- 规律评价:统计每条规则的历史命中率排行,识别哪些规律更有效(新版正在把核心 KPI 从命中率升级为 ROI)。
- 每日复盘:导出「雷达日报」,含「今日待分析场次」与「昨日已完赛复盘」,回看命中情况。
- 结果发布与联动:把方向摘要发布到竞彩网页(
/radar数据),并在卡片/详情页/JSON 中显示球队联赛排名。
二、环境准备与安装启动
依赖:Python 3 + customtkinter(GUI 必需);规律计算依赖主软件「体彩足球竞彩」目录下的 data/monitor_rules.json、exports/monitor_session_*.json、data/jcw_history.db 等;可选 registration 授权。
启动方式(main.py 多种模式):
python main.py # 启动 GUI
python main.py --scan # 命令行扫描今日,输出到控制台
python main.py --scan 20261013 # 扫描指定日期
python main.py --rules # 查看规律排行榜
python main.py --daemon # 后台守护模式(无 GUI,定时扫描)
python main.py --publish # 扫描今天并同步方向摘要到竞彩网页
python main.py --archive # 回填历史会话到投票归档
python main.py --analyze # 分析归档:规律命中率、投票结构 vs 平局/爆冷
python main.py --device-id # 打印设备 ID,填入统一注册管理工具
也可双击 dist/ 下打包好的 EXE(spec:盘口规律雷达.spec)。GUI 有四个页面:今日雷达 / 规律排行 / 使用说明 / 设置。
三、快速上手(第一次怎么用)
- 确认主软件数据:先在「体彩足球竞彩」中用实时监控产生监控会话(导出到
exports/monitor_session_日期.json),并确保data/jcw_history.db有完赛数据。 - 扫描:在「今日雷达」页触发扫描(或命令行
python main.py --scan),读取当日监控会话并计算每场倾向、共振/预警、假降水信号。 - 看结果:卡片按方向展示倾向,点击卡片进详情页看完整规则命中、初赔/临赔、投票分布、规则摘要与阶段(赛前/进行中/完赛)。
- 看排行榜:切到「规律排行」页查看各规则历史命中率(样本≥5 上榜),了解哪些规律更准。
- 导出日报:一天结束后点底部「导出日报」,生成
reports/雷达日报_YYYYMMDD.txt,含今日场次与昨日复盘。 - (可选)发布:需要把方向摘要同步到竞彩网页时,用
python main.py --publish或守护模式的发布功能。
四、核心功能详解
4.1 今日雷达(主界面)
- 扫描流程:监控会话 JSON → 加载 →
extract_features提特征 →scan_triggers触发规则 → 合并历史命中率 → 输出结果。 - 字段:每场有编号、联赛、对阵(带联赛排名如
布里斯班[澳超11])、阶段、倾向、共振/预警/假降水标记、投票(主胜/平/客胜)、初赔/临赔。 - 方向判定:
match_phase.py的judge_lean/judge_direction按阶段与赔率判断;共振(多规则同向)+预警(冲突/冷门)单独标注。 - 规律排行:
get_rule_summary()按命中率排序(样本≥5),每条规则显示命中率与命中/总数。
4.2 雷达日报
- 入口:主界面底部「导出日报」→ 提示「日报已保存:
reports/雷达日报_YYYYMMDD.txt」;文件名带日期,当天覆盖。 - 结构:① 概览(场次数、主胜/平/客胜/分歧/共振/预警计数)→ ② 假降水速查 → ③ 今日场次(未完赛,共振/预警优先,按编号升序)→ ④ 昨日复盘(已完赛,倾向 vs 实际,命中统计)。
- 命中口径:复用
archive._judge_hit();倾向为主胜/平/客胜对比actual_had,让胜/让平/让负对比actual_hhad;「分歧/未判」不计入分母。 - 复盘来源:
archive.py归档时从jcw_history.db回填完赛比分并计算actual_had/actual_hhad;刚完赛的场次需等归档回填后下次扫描才进复盘。
4.3 联赛排名显示
- 效果:主客队名后追加联赛排名,格式对齐竞彩网
布里斯班[澳超11] vs 珀斯[澳超8];卡片列表、详情页标题、radar_latest.json的home_label/away_label均带排名。 - JSON 字段:
home/away保留原始队名(供搜索/匹配),home_rank/away_rank为排名数值,home_label/away_label为带排名显示文本。前端渲染用 label,搜索用原始字段。 - 计算:只用近 365 天已完赛场次,积分=胜×3+平×1,排序=积分→净胜球→进球数→队名;数据库变化时自动重建缓存。
- 覆盖:单一国家联赛(英超/西甲/意甲/德甲/法甲/荷甲/葡超/东欧/北欧/美洲/亚洲/非洲等白名单);杯赛、国际赛、跨俱乐部杯(欧冠等)不显示排名。
4.4 数据发布与同步
radar_publish.py生成方向摘要 JSON(radar_latest.json)供竞彩网页/radar使用;sync_sporttery_odds.sh/sync_sporttery_results.sh把赔率与赛果同步到站点data/目录。- 归档与统计:
python main.py --archive回填历史会话,--analyze分析规律命中率与投票结构(如平局/爆冷相关性)。
五、近期更新功能(重点)
依据 雷达日报-UI说明.md(2026-11-05)、联赛排名显示-UI说明.md(2026-10-31)、ROI雷达设计思路.md(2026-11-17)。
| 时间 | 更新 | 更新前 → 更新后 / 对操作的影响 |
|---|---|---|
| 2026-11-17 | ROI 雷达设计(KPI 升级方向) | 更新前核心 KPI 是命中率,存在"高命中率假象"(猜冷门不中天然高命中、反向规则命中率≈基准概率);设计把 KPI 换为 ROI/超额 ROI:每条信号翻译成可投注注单并锁定触发时赔率,引入同场次基线对照、Bootstrap 置信区间、时间衰减、资金曲线。计划保留命中率作参考列并行一个赛季,ROI 上榜门槛≥30 注、置信下界>0 才显著。这是设计/改造方案,需按 roi_engine.py 等落点实现后才生效,当前排行仍以命中率为主;请理性看待,任何固定策略长期 ROI 均为负。 |
| 2026-11-05 | 雷达日报(v1.0) | 更新前只能看界面实时滚动列表;更新后一键导出纯文本日报,整合"今日待分析场次 + 昨日已完赛复盘",共振/预警优先、按编号排序,复盘给出命中率与共振场命中统计。用户可在每天结束后回看当日分析与命中情况。 |
| 2026-10-31 | 联赛排名显示(v1.0) | 更新前队名只有纯文本;更新后卡片/详情/JSON 队名带 [联赛排名],覆盖各单一国家联赛,三级队名匹配 + 白名单守卫 + 全链路降级(查不到就显示纯队名,不影响旧行为)。normalizer 批量补充 20+ 条竞彩异译(布里斯班→布里斯班狮吼等),修复主软件共享依赖;如需在打包版生效须重新打包 dist/ 副本。用户一眼可看两队实力层级差距。 |
六、常见问题与排错(FAQ)
- 扫描没有数据 / 提示无会话:确认主软件路径正确,且
exports/monitor_session_日期.json存在(需先在主软件用实时监控并导出);可在「设置」页改路径。 - 队名没显示联赛排名:该联赛可能是杯赛/国际赛(不在白名单)或队名在库里查不到,会自动降级为纯队名;确认
jcw_history.db存在且有近 365 天已完赛数据。 - 打包版排名不更新:
team_name_normalizer.py是主软件共享文件,源码改动不会自动同步到dist/副本——需重新打包 EXE。 - 昨日复盘没有某场 / 比分显示「—」:归档(
archive.py)还没跑或未回填赛果,等归档后下次扫描自动进入复盘;刚完赛场次可能仍是 live/pending。 - 日报"没有可导出的扫描结果":先执行扫描再点导出日报;全为 pre 场次时昨日复盘区块不显示。
- 命中率与"实际赢钱"对不上:这正是 ROI 雷达要解决的问题——命中率不含赔率。当前排行仍以命中率为主,参考 ROI 设计思路理性看待,勿把高命中率当作盈利保证。
七、补充信息
- 代码结构:
scanner.py(每日扫描)、features.py(特征提取)、rules_engine.py(规则+R1~R15 元信息+排行)、match_phase.py(阶段/方向判定)、archive.py/archive_analyzer.py(归档与统计)、standings.py(联赛排名)、radar_publish.py(JSON 发布)、auto_updater.py(ResultsWatcher/ScanDaemon)、gui.py(界面)、config.py(路径与阈值)、registration/(授权)。 - 数据依赖:主软件
体彩足球竞彩的data/monitor_rules.json、exports/monitor_session_*.json、data/jcw_history.db;同步脚本写入/www/wwwroot/sporttery.csh.space/data/(或 www.csh.space/sporttery/data)。 - 相关项目:
体彩足球竞彩(主软件盘口棱镜)、体彩足球竞彩网页版(发布目标站)、盘口ROI雷达(ROI 评价的后续独立项目)。