足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策8.2 常见问题 FAQ（持续更新）
FAQ这一篇汇总了最常见的问题。建议遇到疑问先查这里。
一、关于产品定位
Q1：球小策能预测比赛结果吗？
不能，也不做这个承诺。我们提供的是基于公开数据与统计模型的量化分析，用来消除信息不对称、识别市场定价偏差。任何宣称能稳定预测比赛结果的系统都不符合数学规律，详见 1.2 足球预测的数学边界。
Q2：市面上的 AI 预测和你们有什么区别？
核心区别在于有没有真实数据层。大多数「AI 预测」是直接把问题丢给通用大模型，得到的是语义幻觉；我们是先用模型计算客观指标，再交给大模型做推理。详见 1.1 揭穿伪 AI 神话。
Q3：你们提供购买建议吗？
绝对不提供。我们只做数据与分析，不做任何形式的建议引导。这是产品红线，详见 1.6 球小策的自白。
二、关于账号与密钥
Q4：怎么获取 API Key？
进入 我的数据服务，微信扫码登录后自动生成。新用户有免费体验点数。详见 4.1 快速入门。
Q5：密钥泄露了怎么办？
立即到控制台重置。重置后旧密钥马上失效，点数与有效期不受影响。
Q6：密钥有有效期吗？
有。具体有效期在控制台可查看。过期后需要重新获取。
Q7：一个账号能有多个密钥吗？
当前每个账号对应一个专属密钥。如需多环境隔离，建议用环境变量管理，而不是申请多个密钥。
三、关于计费与成本
Q8：点数是怎么扣的？
按接口调用扣点，不同接口权重不同。旗舰接口「单场全景数据包」50 点。完整计费表见 4.2 计费与省钱。
Q9：请求失败会扣点吗？
请求失败（如 4xx / 5xx 错误）不会扣点。只有成功返回数据才计费。
Q10：重复调用同一接口会重复扣点吗？
不会。相同参数在 60 秒内重复请求，点数扣除为 0。响应头中的 X-Dedup-Hit: 1 表示命中免扣。
Q11：怎么最省钱？
四个层次：
① 本地缓存历史数据（省最多）
② 先筛选再深挖，不为无关场次付费
③ 利用 60 秒去重避免重试扣点
④ 用低点接口拿骨架，按需补高价数据
详见 4.2 与 7.13。
Q12：点数会过期吗？
请以控制台显示的有效期为准。
四、关于接口使用
Q13：返回 402 是什么原因？
点数不足或密钥已过期。先用 /quota（0 点，免费）查余额。详见 4.8 错误码手册。
Q14：返回 404 怎么排查？
99% 是 ID 错误。建议先用搜索接口（/teams?q= 或 /players?q=）确认正确 ID，再调详情接口。
Q15：调用频率有限制吗？
有。触发限制会返回 429。建议请求间隔不低于 1 秒，并加入重试与退避机制。
Q16：历史数据会变吗？
已结束比赛的数据不会变化，可以长期缓存。但伤停、数据数值、阵容这类赛前信息会持续更新，不要长期缓存。
Q17：数据覆盖哪些联赛？
以主流联赛与杯赛为主。不同联赛的数据颗粒度存在差异，建议在客户端做字段存在性检查。
五、关于 Skill 与 AI 使用
Q18：Skill 支持哪些 AI 工具？
支持具备工具调用能力的环境，如 WorkBuddy、Cursor、Trae 等。网页版 AI 通常不支持安装 Skill。详见 2.8 工具差异。
Q19：AI 编造数据怎么办？
三道防线：
① 用数据接口提供真实数据，而不是让它回忆；
② 在指令中加入「无数据支撑须标注」的强制约束；
③ 发布前用合规自检指令复核。
详见 2.6 识别与阻止编造。
Q20：AI 回答不满意，怎么继续问？
先诊断根因（缺数据 / 缺约束 / 上下文问题），再对症下药。2.3 追问话术总纲 有完整的症状对照表与话术。
Q21：对话太长了 AI 变笨怎么办？
不要继续追问，让它先生成一份背景摘要，然后开新会话把摘要粘进去。详见 2.7 上下文管理。
六、关于高阶指标与自建系统
Q22：你们的高阶指标是怎么算的？
我们不公开具体参数，但公开完整的方法论——包括函数形式、权重确定方法、验证方式。见 7.1 边界声明 与后续各篇。
Q23：我能自己算 xG 吗？
可以。7.4 给了完整的教学示例。但请注意：教学示例的输出与我们的接口值不会一致，这是有意设计。
Q24：学完能自己做一个分析系统吗？
可以。第七篇从数据获取到系统架构、自动化、回测都有完整覆盖。
Q25：回测结果好就一定能用吗？
不一定。回测必须做样本外验证，且要检查是否存在数据穿越。7.10 特征工程避坑 有完整清单。
七、关于内容创作
Q26：用你们的 API 生成内容发布，需要注意什么？
必须遵守合规红线：不出现购彩建议、不出现绝对化表述、不出现收益暗示、不做未证实指控。详见 6.6 合规红线。
Q27：可以批量生成内容吗？
可以，但建议控制质量：一次不要超过 3 场，且每篇都要人工审校。详见 6.4 批量生产。
Q28：内容里可以引用你们的数据吗？
可以。建议标注数据来源为球小策，这既是对数据的负责，也便于读者核实。
八、其他问题
Q29：有更详细的技术支持吗？
可以联系我们，详见 8.5 联系我们。
Q30：文档会更新吗？
会。8.3 更新日志 会记录所有改动。
Q31：遇到文档没覆盖的问题怎么办？
欢迎反馈。你的提问很可能就是下一篇文档的选题。
