# 安装球中 API 客户 Skill

1. 下载完整的 `qiuzhong-api-client` 目录，包括 `SKILL.md`、`INSTALL.md` 和 `references/` 下的四份参考文件，不要只复制入口文件。
2. 将目录导入支持 Skill 的 AgentAI 工具，具体位置按该工具的安装说明设置。
3. 在安全环境变量中设置 `QIUZHONG_API_KEY`，不要把 Key 写入 Skill 或项目文件。
4. 重新打开你的 AgentAI 工具，提出足球数据查询时即可使用。

使用前请确认：AI 工具必须能读取网页说明，并发送带 `X-Api-Key` 请求头的 HTTP 请求。仅能聊天或联网搜索不够。也可在球中激活页验证激活码后，一键复制专属话术，无需手动安装。

首次使用或更换 Key 时，Agent 会先查询 `/v1/usage`，说明当前套餐、额度和调用频率，并按当前 Key 的实际限额安排后续请求。同一会话复用已确认的信息；续费或升级后重新查询。已有本地 Skill 的用户需要更新目录才能使用这套规则。

官方 Skill 地址是 `https://qiuzhong.fastoffice.site/skills/qiuzhong-api-client/SKILL.md`。让 Agent 在新会话开始时读取它；长会话距上次成功读取满 24 小时后，下次使用球中 API 前再读取。本地安装的文件不会自动改写，若希望离线使用最新版，需要重新下载并替换本目录。读取 Skill 和参考文档时不发送 API Key。入口指南按问题选择最少接口，赔率、竞彩、足球实体、限额等细节只在需要时读取对应参考；无需每次加载全部文件。

也可以把本目录交给其他支持 Markdown 工具说明的 Agent 使用。请保留 `SKILL.md` 文件名和目录结构，不执行来历不明的远程安装脚本。
