梧桐空间
东湖论彩 · 少量开放,精准服务

首页 / 盘口棱镜 / 文章

竞彩足球缩水 使用教程

最后更新:2026-11-19 12:47:08 · 盘口棱镜

一款面向竞彩足球固定赔率过关玩法的桌面缩水工具,仿《传统足球缩水》交互,支持 5 种玩法(胜平负、让球胜平负、比分、总进球、半全场)+ 混合过关,把复式选择按 M串N 拆注,并提供旋转矩阵缩水、SP/奖金过滤、分组胆拖与注水、奖金优化和赛果复盘。适合需要系统控制注数与资金的竞彩玩家。

一、这是什么 / 适用场景

  • 从中国竞彩网官方 API 拉取每日受注赛程与实时 SP 值(赔率),支持胜平负(had)、让球胜平负(hhad)、比分(crs)、总进球(ttg)、半全场(hafu) 五种玩法及混合过关(同一票不同场次不同玩法)。
  • 对所选 2–8 场比赛做复式选择(单选/双选/多选),按 M串N 或自由过关拆成可直接出票的单式清单,计算注数、金额与理论奖金区间。
  • 用旋转矩阵(中 M 保 N)和条件过滤(含 SP/奖金/冷门等竞彩特有维度)压缩注数。
  • 通过分组胆拖、分组叠加、注水、奖金优化进一步调整方案,并可录入/拉取赛果做命中复盘。
  • 工具仅做数学缩水与过滤,不涉及自动投注。
提醒:SP 值为拉取时刻参考值,实际奖金以出票时 SP 为准;理性购彩,量力而行。

二、环境准备与安装启动

  1. 安装 Python 3.8+(当前 .venv 为 3.12/3.13)。
  2. 安装依赖:
   pip install -r requirements.txt

依赖:customtkinter>=5.2.2、requests>=2.28、openpyxl>=3.1。

  1. 启动入口:python main.py(内容为 from gui import run)。
  2. 联网要求:首次需访问竞彩网官方接口 https://webapi.sporttery.cn;请求需带浏览器 UA 与 Referer: https://www.sporttery.cn/,接口可能返回 567 限流,程序有本地缓存与重试降级。

三、快速上手(第一次怎么用)

  1. 启动程序,顶部选择玩法栏目(胜平负 / 比分 / 总进球 / 半全场 / 混合过关),选日期,点【拉取赛程】。界面会显示当日场次、联赛、主客队、开赛时间,选项按钮下方实时显示 SP 值。
  2. 在左侧场次表格点选每场结果(可多选做复式,最多选 8 场);有把握的单选场次可勾「胆」参与胆拖拆注。玩法下拉可在同一栏内切换(如胜平负/让球胜平负混过关)。
  3. 选择过关方式(M串N 下拉,或自由过关勾选 2–8 关)。
  4. 可选:勾「旋转矩阵」设"m 场 k 串 1,中 g 场保中";点【过滤条件】设区间;点【分组·注水】设置胆拖/叠加/注水。
  5. 点【开始缩水】,右侧结果区显示注数、金额、奖金区间与单式清单(每条含场次选项组合 / SP / 理论奖金)。
  6. 用【复制全部】/【导出 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 集中更新。以下内容依据计划文档 + 代码时间戳与结构整理。
  1. 从草案到可用软件:核心代码集中落地(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插件、奖金优化均已在代码中出现。
  • 用户影响:现已是功能完整的可用桌面软件,不再是规划稿。
  1. 混合过关与胜平负栏目合并(更新前 → 更新后)
  • 更新前:计划里"一期先做单玩法过关,混合过关二期支持"。
  • 更新后:代码中新增 MIX_LABEL="混合过关"、MIX_PLAY="mix",并把胜平负 had 与让球 hhad 合并为同一栏目 hadmix,可同票混过关;混合过关栏目可跨 4 类玩法。用户可在同一张票里对不同场次选不同玩法。
  1. 中N保N插件(分组胆拖/叠加、注水)已实现(更新前 → 更新后)
  • 更新前:计划里列为二期扩展模块。
  • 更新后:plugins.py(14KB)与【分组·注水】按钮、PluginDialog 对话框已落地,支持分组胆拖、分组叠加、标准/冷门注水;prize_opt.py 实现保本奖金优化。用户可通过按钮直接使用这些进阶策略。
  1. 拉取范围扩展与单关支持:gui.py 中 SPAN_LABELS=("今天","连续2日","连续3日","连续4日"),默认连续 3 日(官方赔率计算器一次返回最近 3 天在售场次);场次行尾标识「单关」,官方允许单关的场次可单独投注。
  1. 赛果复盘闭环:【回测】按钮自动对齐方案赛程、生成并打开复盘对话框判定命中;【复盘】可录入各场半场/全场比分。计划 P5 阶段已落地。

六、常见问题与排错(FAQ)

  1. 拉取赛程失败/报 567? 官方接口有限流,程序会重试与降级;稍后再试或用本地缓存(data/matches_YYYY-MM-DD.json),刷新赔率不宜过频。
  2. 复式注数过大无法展开? 有组合爆炸保护;8 场全选比分(31^8)不可展开,请减少复式选项或改用关数更少的过关方式/旋转矩阵。
  3. 奖金显示与出票不一致? 工具内 SP 为拉取时刻参考值,实际奖金以出票时 SP 为准。
  4. 载入旧方案对不上场次? 方案按对阵对齐保存,跨日赛程可能已下架;载入时会尽量对齐,SP 自动用当前最新值。
  5. 过滤后注单为 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 方案、缩水方法调研)。
← 返回盘口棱镜文章列表

同栏目其它文章