一款面向竞彩足球固定赔率过关玩法的桌面缩水工具,仿《传统足球缩水》交互,支持 5 种玩法(胜平负、让球胜平负、比分、总进球、半全场)+ 混合过关,把复式选择按 M串N 拆注,并提供旋转矩阵缩水、SP/奖金过滤、分组胆拖与注水、奖金优化和赛果复盘。适合需要系统控制注数与资金的竞彩玩家。
一、这是什么 / 适用场景
- 从中国竞彩网官方 API 拉取每日受注赛程与实时 SP 值(赔率),支持胜平负(had)、让球胜平负(hhad)、比分(crs)、总进球(ttg)、半全场(hafu) 五种玩法及混合过关(同一票不同场次不同玩法)。
- 对所选 2–8 场比赛做复式选择(单选/双选/多选),按 M串N 或自由过关拆成可直接出票的单式清单,计算注数、金额与理论奖金区间。
- 用旋转矩阵(中 M 保 N)和条件过滤(含 SP/奖金/冷门等竞彩特有维度)压缩注数。
- 通过分组胆拖、分组叠加、注水、奖金优化进一步调整方案,并可录入/拉取赛果做命中复盘。
- 工具仅做数学缩水与过滤,不涉及自动投注。
提醒:SP 值为拉取时刻参考值,实际奖金以出票时 SP 为准;理性购彩,量力而行。
二、环境准备与安装启动
- 安装 Python 3.8+(当前
.venv为 3.12/3.13)。 - 安装依赖:
pip install -r requirements.txt
依赖:customtkinter>=5.2.2、requests>=2.28、openpyxl>=3.1。
- 启动入口:
python main.py(内容为from gui import run)。 - 联网要求:首次需访问竞彩网官方接口
https://webapi.sporttery.cn;请求需带浏览器 UA 与Referer: https://www.sporttery.cn/,接口可能返回 567 限流,程序有本地缓存与重试降级。
三、快速上手(第一次怎么用)
- 启动程序,顶部选择玩法栏目(胜平负 / 比分 / 总进球 / 半全场 / 混合过关),选日期,点【拉取赛程】。界面会显示当日场次、联赛、主客队、开赛时间,选项按钮下方实时显示 SP 值。
- 在左侧场次表格点选每场结果(可多选做复式,最多选 8 场);有把握的单选场次可勾「胆」参与胆拖拆注。玩法下拉可在同一栏内切换(如胜平负/让球胜平负混过关)。
- 选择过关方式(M串N 下拉,或自由过关勾选 2–8 关)。
- 可选:勾「旋转矩阵」设"m 场 k 串 1,中 g 场保中";点【过滤条件】设区间;点【分组·注水】设置胆拖/叠加/注水。
- 点【开始缩水】,右侧结果区显示注数、金额、奖金区间与单式清单(每条含场次选项组合 / SP / 理论奖金)。
- 用【复制全部】/【导出 TXT】/【导出 Excel】保存结果;点【方案】保存/载入方案 JSON;开奖后点【回测】或【复盘】录入/拉取赛果判定命中。
四、核心功能详解
- 五种玩法与过关:胜平负(3选)、让球胜平负(带让球数,3选)、比分(31 种)、总进球(0~7+ 共 8 种)、半全场(9 种)。单场最大可过关数
MAX_LEGS:had/hhad 8、ttg 6、crs/hafu 4。内置完整 M串N 标准拆解表(2串1 到 8串247,如 3串4=3×2串1+1×3串1、8串247=2~8关全组合),并支持自由过关。 - 拉取赛程与刷新赔率(
jc_api.py):赛程接口getMatchListV1.qry、赔率计算器getMatchCalculatorV1.qry(一次取全部玩法 SP);缓存到data/matches_YYYY-MM-DD.json,【刷新赔率】只更新 SP 避免频繁请求。胜平负与让球胜平负归为同一栏目可同票过关,混合过关栏目可跨 4 类玩法。 - 过关拆注引擎(
split_core.py):M串N → C(M,k) 小关组合;每小关内各场选项笛卡尔积 → 每条 2 元单式及 SP 组合;输出注数、金额、理论奖金(SP 连乘×2)与最低/最高奖金范围。含组合爆炸保护(超限提示并抽样)。 - 旋转矩阵缩水(
shrink_core.py,中 M 保 N):复用传统足球缩水的贪心集合覆盖算法,把"场次组合"作为覆盖对象,使"猜对 N 场时至少一条小关全中"(如官方示例 7 场 4串1 猜对 5 场保中)。矩阵决定保留哪些场次组合,被选中的小关内仍可做复式展开。 - 条件过滤(
filters.py,过滤对话框):选项个数区间;竞彩特有维度——SP 连乘积、单注奖金、冷门个数(SP≥阈值)、指定场次单场 SP;容错设"允许几个启用条件不满足"防止误杀。 - 分组·注水插件(
plugins.py,二期功能已落地):分组胆拖 / 分组叠加(按组拆注,旋转矩阵不生效)、标准注水(正路=每场已选 SP 最低项)、冷门注水(冷门=每场已选 SP 最高项),某场目标选项在结果中 0 次出现即补 1 注。 - 奖金优化(
prize_opt.py):保本模式optimize_breakeven,在满足"猜对 N 场"前提下调整倍数使回报≥投入。 - 方案与复盘(
scheme.py/review.py):方案 JSON 保存玩法、期次、复式、胆、过关方式、过滤与矩阵设置;载入时按对阵对齐、SP 用当前最新值;复盘可拉取赛果或录入各场半场/全场比分,高亮命中注单并统计奖金回收。
五、近期更新功能(重点)
说明:本项目唯一文档《计划方案.md》标注为 v0.1 草案(2026-10-30),本身即 2026-05 之后的产物;而全部核心代码于 2026-11-01 集中更新。以下内容依据计划文档 + 代码时间戳与结构整理。
- 从草案到可用软件:核心代码集中落地(2026-11-01)(更新前 → 更新后)
- 更新前:计划方案仅为设计草案(P1–P6 阶段规划)。
- 更新后:
gui.py(95KB)、jc_api.py、models.py、split_core.py、shrink_core.py、filters.py、plugins.py、prize_opt.py、review.py、scheme.py全部实现并更新;赛程数据持续拉取到 2026-11-02/03。计划中列为"二期"的混合过关、中N保N插件、奖金优化均已在代码中出现。 - 用户影响:现已是功能完整的可用桌面软件,不再是规划稿。
- 混合过关与胜平负栏目合并(更新前 → 更新后)
- 更新前:计划里"一期先做单玩法过关,混合过关二期支持"。
- 更新后:代码中新增
MIX_LABEL="混合过关"、MIX_PLAY="mix",并把胜平负 had 与让球 hhad 合并为同一栏目hadmix,可同票混过关;混合过关栏目可跨 4 类玩法。用户可在同一张票里对不同场次选不同玩法。
- 中N保N插件(分组胆拖/叠加、注水)已实现(更新前 → 更新后)
- 更新前:计划里列为二期扩展模块。
- 更新后:
plugins.py(14KB)与【分组·注水】按钮、PluginDialog对话框已落地,支持分组胆拖、分组叠加、标准/冷门注水;prize_opt.py实现保本奖金优化。用户可通过按钮直接使用这些进阶策略。
- 拉取范围扩展与单关支持:
gui.py中SPAN_LABELS=("今天","连续2日","连续3日","连续4日"),默认连续 3 日(官方赔率计算器一次返回最近 3 天在售场次);场次行尾标识「单关」,官方允许单关的场次可单独投注。
- 赛果复盘闭环:【回测】按钮自动对齐方案赛程、生成并打开复盘对话框判定命中;【复盘】可录入各场半场/全场比分。计划 P5 阶段已落地。
六、常见问题与排错(FAQ)
- 拉取赛程失败/报 567? 官方接口有限流,程序会重试与降级;稍后再试或用本地缓存(
data/matches_YYYY-MM-DD.json),刷新赔率不宜过频。 - 复式注数过大无法展开? 有组合爆炸保护;8 场全选比分(31^8)不可展开,请减少复式选项或改用关数更少的过关方式/旋转矩阵。
- 奖金显示与出票不一致? 工具内 SP 为拉取时刻参考值,实际奖金以出票时 SP 为准。
- 载入旧方案对不上场次? 方案按对阵对齐保存,跨日赛程可能已下架;载入时会尽量对齐,SP 自动用当前最新值。
- 过滤后注单为 0? 条件过严或容错设得太低;放宽区间或调高容错(允许更多条件不满足)。
七、补充信息
- API 基础地址
https://webapi.sporttery.cn,接口与《体彩足球竞彩》项目jc_official_api.py同源;请求头需带User-Agent与Referer: https://www.sporttery.cn/。 - 核心文件:
gui.py(界面)、jc_api.py(官方 API 封装)、models.py(玩法与 M串N 拆解表)、split_core.py(拆注引擎)、shrink_core.py(旋转矩阵)、filters.py(过滤)、plugins.py(分组/注水)、prize_opt.py(奖金优化)、review.py(复盘)、scheme.py(方案)。 - 关联项目:《传统足球缩水》(本工具界面与算法的原型)、《体彩足球竞彩》(API 接口来源)。
- 主要文档:《计划方案.md》(v0.1 草案,含 5 玩法规则、M串N 标准表、API 方案、缩水方法调研)。