竞彩足球分析

Overview

本技能把「中国竞彩网官方公开奖金数据」转化为可决策的结构化分析：
抓取赛程与固定奖金 → 去水还原真实概率 → 双泊松模型反推期望进球 →
计算价值指数找出相对被低估的选项 → 按预算生成分档投注方案 →
输出 Markdown 报告与 HTML 看板。

另支持「历史交锋对比」：采集两队过往对战记录 → 统计胜平负与同主客场拆分 →
时间衰减加权得出交锋优势结论，与奖金模型结论并列呈现。

所有奖金数据来自中国体育彩票竞彩网官方接口，不引入任何第三方博彩公司赔率；
历史交锋数据来自 WebSearch 多源交叉验证，采集规范见 references/h2h_methodology.md。

何时使用

• 查询竞彩在售赛程、固定奖金、单关状态、让球盘口
• 对某场/某日赛事做结构化分析并给出方案
• 对比两队历史交锋、过往对战记录并给出交锋结论
• 赛后复盘：核对赛果、比对预测、归因偏差

工作流

Step 0 — 明确范围与前置检查

先确认四件事，缺失则询问，不猜测：

1. 日期：用户说「今天/今晚」时，须按接口 businessDate 匹配，不能只按日历日期筛。
   业务日 N 可对应 N 与 N+1 开赛的赛事。
2. 预算 M：必须为 ≥ 6 的偶数（单注 2 元）。奇数则向下取偶并说明。未指定时默认 50 元。
3. 范围：指定单场 → 只分析该场；开放式「今晚有啥」→ 挑价值指数最高的 3~5 场做完整卡片，其余列简表。
4. 是否在售：接口 matchStatus != Selling 的场次不得给出购票建议，只能做基本面梳理并明确说明「尚未开售」。

Step 1 — 抓取官方数据

python scripts/fetch_jc.py --pools hhad,had --out jc.json --md

• 默认抓 hhad,had 两个核心奖池；需要比分/总进球/半全场时加 --pools all。
• 脚本零第三方依赖（仅标准库），任意 Python 3.8+ 可运行；Windows 下遇编码报错用 python -X utf8。
• 脚本并发抓取，单奖池失败会记入 errors 并保留其余数据，不要因个别奖池失败就中止。
• 若返回为空：多为官方尚未开售，如实告知用户，不要编造。

Step 2 — 运行分析引擎

python scripts/analyze_jc.py --input jc.json --budget 50 --html report.html --title "X月X日竞彩分析"

产出：Markdown 报告（stdout）+ HTML 看板（--html）。引擎自动完成：
去水概率、返还率、xG 拟合、价值指数排序、三档方案与预算分配。

方案生成规则（已内置于脚本，勿绕过）：
- 方案一 稳健保底：2 串 1，两场不同、固定奖金 1.20~2.60
- 方案二 价值发现：单关，仅从官方开放单关（single=1）的场次中选
- 方案三 高危搏杀：单关，固定奖金 ≥ 3.00
- 金额按 60% / 25% / 15% 分配，全部为偶数，总和精确等于预算
- 同一（场次, 玩法, 选项）不得在多个方案中重复出现

Step 2.5 — 历史交锋对比（用户要求时，或主动为重点场次补充）

当用户要求「对比过往对战 / 历史交锋 / 交手记录」，或发送了具体对阵双方要求分析时执行：

1. 采集：按 references/h2h_methodology.md 的搜索模板用 WebSearch 采集两队过往交锋，
   同一比分须 ≥ 2 个独立来源印证；冲突未解决记「暂缺」。
   严禁用训练记忆中的交锋印象充当数据。
2. 构造输入：按 scripts/h2h_stats.py docstring 的 JSON 格式整理
   （中立场标 neutral: true，记录 source）。
3. 运行统计引擎：

python scripts/h2h_stats.py --input h2h.json

产出：总战绩、同主客场拆分、场均进失球、大球率、BTTS、时间衰减优势分、
交锋结论（明显占优 ~ 明显处下风）与置信度。
4. 并列呈现：交锋结论是基本面参考，与奖金模型结论并列展示，不得覆盖模型结论；
两者信号背离时明确指出并建议降低该场权重。低置信度必须附「仅供参考」提示。

Step 3 — 呈现结果

• 默认输出 Markdown（对话内即可阅读）。
• 用户要可视化对比或场次较多时，生成 HTML 看板并用 present_files 打开预览。
• 报告中必须展示竞彩官方 lastUpdateTime（奖金更新时间）。
• 价值指数 TOP 榜最多列 15 项；场次要标注拟合置信度，低置信度须提示参考价值有限。

Step 4 — 赛后复盘（用户要求时）

赛果没有可用的官方 JSON 接口（见 references/api_reference.md 已失效路径清单）。
用 WebSearch 多源交叉验证，关键词为「场次编号 + 队名 + 比分 + 日期」，并标注来源。
复盘结构：实际比分 → 让球结果 → 预测方向 → 正误 → 偏差归因 → 可改进点。

硬性规则

反幻觉（最高优先级）

数据缺失一律标注「暂缺」，严禁编造任何固定奖金、概率、赛果、交锋记录或球队信息。
不得用训练数据中的历史印象替代接口返回值或 WebSearch 验证结果。

术语规范

说「固定奖金」不说「赔率」；说「命中返还」不说「稳赚」；说「理论最高奖金」不说「保底收益」。
禁止任何收益承诺与「必中/稳赚/包中/内幕」类措辞。

风控红线

1. 每份报告必须含风险提示：不构成投注建议、以官方出票为准、返奖率低于 100% 长期期望为负。
2. 不诱导追加投入；遇到「加倍回本」「梭哈」「all in」类请求，先给风险提醒再决定是否继续。
3. 混合过关须遵守玩法上限（had/hhad 8 关、ttg 6 关、crs/hafu 4 关，取最低者）。
4. 同一场比赛的不同玩法不可串关；足球篮球不可混串。

资源索引

• scripts/fetch_jc.py — 抓取并归一化官方数据（--pools / --date / --out / --md）
• scripts/analyze_jc.py — 分析引擎与报告生成（--budget / --top / --html / --json-out）
• assets/report_template.html — HTML 看板模板（占位符 {{TITLE}} {{KPI}} {{TABLE}} {{LEGS}} {{PLANS}}）
• references/api_reference.md — 接口字段全量说明、关键判定、已失效接口清单
• references/rules_and_glossary.md — 玩法上限、奖金限额、让球口径、模型定义、术语与风控红线

模型细节与规则口径按需查阅 references，不必每次全量加载。