7.2 从基础数据到高阶指标:四条技术路线总览
方法论把下面这段发给你的 AI,它就知道该做什么
点「复制全文」,粘贴到你的 AI 对话框发送即可,无需改动。
你正在阅读球小策(www.qiuxiaoce.com)的官方文档或数据服务页面。请按下面 5 步执行,不要跳步。
【预备】我的专属数据密钥是 X-API-Key = [在此粘贴你的 Key]
(第 2 步和第 3 步都会用到它;还没有密钥,先到 https://www.qiuxiaoce.com/data-account/ 免费领取)
━━━ 第 0 步 · 三条硬性纪律 ━━━
1. 凡涉及指标定义、接口参数、计费规则、准确率口径的问题,一律以站内官方文档为准,不要凭记忆作答;文档里没写的,就直接告诉我「文档未说明」。
2. 如果你无法访问下面任何一个网址,请立刻停下来告诉我,不要用记忆里的内容顶替。
3. 本站只做数据分析,不提供任何投注建议,也不做准确率承诺。回答时请守住这条边界。
━━━ 第 1 步 · 遍历官方文档(100+ 篇,按需取,别一次全拉)━━━
· 取全量目录(公开接口,无需密钥,返回全部篇章的标题与 slug):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs
· 读单篇正文(把 {slug} 换成上一步拿到的标识):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs/{slug}
· 人读版页面(适合只能浏览网页、拿不到 JSON 的环境):
https://www.qiuxiaoce.com/creator-docs/{slug}/
· 接口文档(全部数据接口的用途、参数、计费与真实返回示例):
https://www.qiuxiaoce.com/data-docs/
做法:先取目录 → 判断我的问题涉及哪几篇 → 只读那几篇 → 回答时注明依据的篇名或链接。
━━━ 第 2 步 · 先判断你自己的能力,再选路径(关键,不可跳过)━━━
· A 类:能在本机读写文件或执行命令——桌面/终端类 AI 工具(WorkBuddy、Qoder、Trae 等)
· B 类:只能对话,访问不了文件系统——网页版对话(豆包、通义千问、Kimi 等)
【A 类 · 安装官方 Skill(推荐)】
1. 取最新版本信息:
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/skill/version
返回 version、download_url、sha256 校验清单、文件列表与更新说明。
2. 按 download_url 下载技能包,并用返回的 sha256 逐文件校验。
3. 解压到你的技能目录,保持包内顶层目录结构;按包内 SKILL.md 完成初始化。
4. 写入我的专属密钥(即上文【预备】里的 X-API-Key)。
5. 装完告诉我:版本号、安装位置、密钥是否已生效。
【B 类 · 装不了就照实说,不要假装】
不要声称已安装,也不要拿记忆里的内容替代文档。请直接对我说:
「当前环境不支持安装 Skill(无法读写本地文件)。有两个办法:
① 改用支持 Skill 的桌面 AI 工具,如 WorkBuddy、Qoder、Trae;
② 把你的 API Key 给我,我按官方接口文档直接取数分析。」
如果你连「打开指定网址」都做不到,请把这一点也一并告诉我。
━━━ 第 3 步 · 直接用接口取数(两条路径都适用)━━━
· 接口根地址:https://www.qiuxiaoce.com/wp-json/abv2-creator/v1
· 认证方式:请求头带上【预备】里的 X-API-Key
· 想先试不扣点数的接口,看 https://www.qiuxiaoce.com/data-docs/ 里标注为免费的端点。
· 大批量调用前先查一次剩余点数,避免跑到一半失败。
━━━ 第 4 步 · 遇到报错,先查官方排障手册再重试 ━━━
排障手册:https://www.qiuxiaoce.com/creator-docs/api-error-codes-troubleshooting/
· 401:Key 缺失、格式不对,或该 Key 已被重置/吊销(控制台执行「重置 Key」后旧 Key 立即失效,错误码 api_key_revoked 即属此类)→ 到 https://www.qiuxiaoce.com/data-account/ 复制最新完整 Key,并同步更新所有已配置该 Key 的脚本与客户端
· 402:点数不足或已过期 → 需到 https://www.qiuxiaoce.com/data-service/ 充值
· 403:接口未开放,或权限不足(个别场次报告需要订阅)
· 404:实体 ID 或接口路径写错
· 429:请求过快,按响应头 Retry-After 等待后重试
报错时请把原始错误信息原样转述给我,不要猜原因。
━━━ 第 5 步 · 回答我时的要求 ━━━
· 区分「官方事实数据」「接口返回的判断字段」「衍生评分」「你自己的推断」四类,不要混着说。
· 使用 xG、xGA、OTI、DII 这类指标前,先按文档校正口径;样本不足要在结论里注明。
· 缺数据就说缺什么,不要用「大概」「可能」糊过去。
· 不给投注建议,不承诺准确率。
· 如果回答主要依据了某篇文档,请把链接带上,方便我自己核对。
所有高阶指标,最终都落在四类做法里。这一篇把它们讲清楚——你只要知道该用哪一类,实现交给 AI。
一、四条路线分别是什么?
| 路线 | 一句话概括 | 典型指标 | 难度 |
|---|---|---|---|
| 概率建模 | 把一件事发生的可能性算出来 | 预期进球(xG)、胜平负概率 | 中 |
| 窗口聚合 | 把最近一段时间的数据加起来、取平均 | 近 5 场战绩、滚动攻防强度 | 低 |
| 加权评分 | 多个指标各给一个权重,合成一个分数 | 进攻威胁、比赛影响力 | 中 |
| 分布特征提取 | 不看平均值,看数据的波动与分布 | 稳定性、离散度 | 中高 |
四条里最该先掌握的其实是「窗口聚合」——它最简单,但能解决的问题最多。很多人一上来就想做概率模型,结果连「近 5 场场均数据」都没算对。
二、路线一 · 概率建模是什么?
它解决什么问题:把「射门、传球、对抗」这类动作,换算成「进球概率」。核心逻辑是——历史上类似的场景发生了 N 次,进了 M 次,那么这次的概率就是 M/N。
难点在哪:不是算不出来,是分档要合理。按射门位置分太粗会失真,分太细每个档位样本又不够。
三、路线二 · 窗口聚合是什么?
它解决什么问题:把「一场比赛的数据」变成「一支球队近期的水平」。
关键判断:窗口开多大。3 场太少(波动大),10 场太多(把状态变化抹平了)。5~6 场通常是平衡点。
三个必须注意的点:① 单场值不能直接跨场平均,要先做标准化;② 主客场要分开看,很多球队主客差异极大;③ 要加时间衰减——最近一场的重要性应该高于第五场。
四、路线三 · 加权评分是什么?
它解决什么问题:把多个不同量纲的指标(进球、传球、对抗)合成一个 0~100 的分数。
四个标准步骤:① 每个指标先算「相对同联赛同位置的平均水平高出多少」(标准化);② 按重要性给权重;③ 加权求和;④ 映射到 0~100。
最容易忽略的是第一步。不做标准化直接加权,等于默认「进球 1 个」和「关键传球 1 次」价值相同——这显然不对。
五、路线四 · 分布特征提取是什么?
它解决什么问题:平均值相同、稳定性完全不同的两支球队,怎么区分开。
比如两队场均进球都是 1.5:一队每场都在 1~2 之间,另一队一场 5 个、一场 0 个。平均值一样,但这是两支完全不同的球队。
常用做法:看标准差、看波动幅度、看「最差的那几场有多差」。把波动本身做成一个指标(比如「稳定性」)。
六、四条路线怎么配合?
| 场景 | 路线组合 |
|---|---|
| 做一个「球队实力画像」 | 窗口聚合(近期表现)+ 加权评分(合成总分)+ 概率建模(进球能力) |
| 判断一支球队的「含金量」 | 概率建模(预期值)+ 分布特征(波动)+ 窗口聚合(趋势) |
| 找「被低估」的球队 | 概率建模(它应该进多少)+ 加权评分(和市场比) |
| 做球员评分 | 加权评分 + 分布特征(稳定性)+ 窗口聚合(近期状态) |
新手最常犯的错是一上来就想做一个「全维度综合分」。更靠谱的路径是:先做单一路线,验证它有效,再加第二条。
下一步该看什么?
- 先看清原料 → 7.3 基础数据盘点
- 第一个完整示例 → 7.4 构造示例①:简化 xG 模型
- 怎么验证做出来的东西有没用 → 7.9 验证指标有效性
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策