7.1 【边界声明】我们公开什么、闭源什么
先读这篇
内容太多,看不完或者看不太懂?
复制一段话发给你的 AI,它会自己读完官方文档、装好技能包,再来回答你的问题。
点这里复制给 AI →
想知道每项数据覆盖了哪些赛事?
88 项赛事的数据项覆盖情况一览:赛程比分、首发阵容、球员与球队统计、进阶指标、伤停、天气等,每日自动统计并如实公开。
查看数据覆盖说明 →
把下面这段发给你的 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(豆包、千问、WorkBuddy、Qoder 等都可以)。
这一篇不是技术文档,是一份说明:这个系列会讲什么、不会讲什么,以及你该怎么用它。
一、这篇声明要解决什么问题?
很多平台讲「算法」时都含含糊糊,让你搞不清哪些是真的、哪些是话术。我们把边界画清楚:
| 你会知道 | 你不会知道 |
|---|---|
| 每个指标是怎么算出来的(思路与公式结构) | 生产环境用的具体参数取值 |
| 每个指标的能力边界(能回答什么、不能回答什么) | 内部系统的评级权重与决策阈值 |
| 怎么验证一个指标靠不靠谱 | 具体的模型训练数据与调参过程 |
说清这一点,是因为知道边界比知道参数更有用——你不需要复刻我们的参数,你需要知道一个指标在什么情况下会失效。
二、三层信息是怎么切分的?
| 层次 | 内容 | 公开程度 |
|---|---|---|
| 第一层 · 原始数据 | 赛程、赛果、技术统计、事件流 | 通过 API 完全开放 |
| 第二层 · 方法论 | 指标的定义、公式结构、验证方法、边界声明 | 本系列完整公开 |
| 第三层 · 生产参数 | 具体的权重取值、阈值、评级规则 | 不公开 |
这个切分的原则是:方法可以教,参数是资产。你拿着方法论可以做出自己的版本;拿着我们的参数只能复刻一个一模一样的——而那对你没有意义,因为你的数据和我们的不一样。
三、为什么公开中间层是有意义的?
因为绝大多数人卡住的不是参数,是思路。
- 不知道该看哪些数据 → 公开的字段清单就能解决;
- 不知道两个指标该信哪个 → 边界声明就能解决;
- 做出一个指标但不知道准不准 → 验证方法就能解决;
- 做出来的东西看着合理但总是错 → 避坑清单就能解决。
这四件事占了自学过程中八成的时间。而这些恰好不涉及任何商业机密。
四、为什么不给参数?
三个原因,都很实际:
- 给了也没用。参数是在我们的数据分布上标定的。换一套数据源、换一个联赛范围,最优值就不一样了;
- 会害了你。直接照抄别人的阈值,最常见的后果是「指标看起来正常但完全无效」——因为你没有验证过它在你手上的表现;
- 它确实是我们的投入。标定这些参数花了大量时间和算力,这属于产品的核心资产。
💬 让 AI 把这个系列的文章讲到你能懂 入门
我正在读球小策创作者学院的「进阶开发者」系列,这一篇讲的是【粘贴你不理解的那一段】。
请帮我:
1. 用大白话把这段重讲一遍,假设我只会用 Excel、没写过代码;
2. 指出这段的核心结论是什么(一句话);
3. 告诉我:如果我想自己动手做这件事,第一步该做什么、需要哪些数据;
4. 列出 2 到 3 个我可能会误解的地方。
如果你需要我先补充什么信息(比如我手上有哪些数据),直接问我。
不要给我代码,我要的是思路。
五、你可以用这些内容做什么?
| 你的目标 | 这个系列能帮你到哪一步 |
|---|---|
| 看懂我们返回的指标 | 完全够用——每个指标的定义与边界都会讲清 |
| 做一套自己的分析框架 | 够用——四类构造方法 + 验证方法 + 避坑清单 |
| 搭一个自动化流水线 | 够用——架构设计 + 成本控制 + 告警 |
| 复刻我们一模一样的分数 | 做不到,也不建议——参数不公开 |
六、这系列后面会讲什么?
| 篇目 | 内容 |
|---|---|
| 7.2 | 四类构造方法总览(概率建模 / 窗口聚合 / 加权评分 / 分布特征) |
| 7.3 | 你能拿到的原始字段盘点 |
| 7.4~7.7 | 四个完整构造示例(xG / 攻防强度 / 伤停折损 / 市场预期) |
| 7.8~7.9 | 权重怎么定、怎么验证一个指标到底有没有用 |
| 7.10 | 特征工程避坑清单 |
| 7.11~7.13 | 系统架构、预警机器人、自动化流水线 |
| 7.14 | 回测:怎么验证你的整套框架 |
读的顺序建议:先读 7.3(看清原料)→ 再挑一个 7.4~7.7 的示例动手 → 然后读 7.8、7.9(定权重与验证)。前面几步没做,直接跳到 7.11 谈架构,容易搭出空中楼阁。
七、看之前需要什么基础?
比你想的低。需要的是:
- 能看懂表格和简单的比例关系(比如「近 5 场场均 1.8」是什么意思);
- 会把需求说给 AI 听——这个系列里的每一步,你都可以让 AI 帮你实现;
- 有基本的常识判断力——比如「预期失球 4.2」这种数字明显不对,要能看出来。
不需要的是:会写代码。本系列的每一篇都会给出「怎么让 AI 帮你完成」的具体说法。你要做的是判断和决策,实现交给工具。
下一步该看什么?
- 四类构造方法总览 → 7.2 四条技术路线
- 先看清手上的原料 → 7.3 基础数据盘点
- 指标的对外边界 → 3.1 数据全景
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策