前言¶
接入自建或团队内部的 AIGate 平台后，Token 余额、当日用量和月度汇总往往要单独打开控制台或查接口。日常在 IDE 里用 Agent 写代码、调模型时，切出去核对成本既打断节奏，也容易漏看限额。下面介绍 SkillHub 上的 AIGate Token用量查询（@user_0f7a070e/aigate-token-query）：把查询能力做成 Agent Skill，在对话里用自然语言触发，无需自己写查询脚本。
这是什么¶
AIGate Token用量查询 是社区来源（community）的 Agent Skill，当前版本 v1.0.2，SkillHub 分类为 data-analysis。发布坐标为 @user_0f7a070e/aigate-token-query，页面由作者「曾小闲」维护。
官方简介概括为：一键查询自定义 AIGate 平台的 Token 余额、每日消耗与月度统计；支持任意含 Token 关键词的对话触发；面向「零代码基础」的使用方式。Skill 标签标明 requires_api_key=true，使用前需要完成与 AIGate 相关的 API Key 配置（具体项以安装后技能包内 SKILL.md 为准）。
核心功能¶
依据 SkillHub 已公开说明，该 Skill 目前可核对的能力包括：
- Token 余额：查询当前 AIGate 账户或项目下的可用 Token 余额。
- 每日消耗：查看按日汇总的 Token 消耗情况。
- 月度统计：查看月度维度的 Token 使用统计。
- 关键词触发：在 Agent 对话中提到含 Token 的表述即可唤起查询流程，无需记忆固定命令名。
以上能力均针对「自定义 AIGate 平台」场景，适合已部署 AIGate、又希望在 Cursor 等客户端里直接问用量的团队或个人。
安装与启用¶
安装前确认本机已有 SkillHub CLI；若尚未安装，可按官方安装文档检查或安装：
command -v skillhub && skillhub --version
未安装时，可使用文档中的推荐方式（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。官方给出的常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
在对应目录下执行安装（将 <skills 目录> 替换为上述路径之一）：
skillhub install user_0f7a070e/aigate-token-query --dir <skills 目录>
也可将下面提示词发给 AI，让其按 SkillHub 安装说明 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_0f7a070e/aigate-token-query`。
安装完成后，根据 Skill 标签 requires_api_key=true 配置 API Key，并重启或重新加载 Agent 使技能生效。Cursor、Codex、Claude Code 等对 skills 目录的约定不同，以你当前客户端文档与上表路径为准。
典型用法¶
该 Skill 的设计重点是「对话内一键查询」，而不是在终端里敲子命令。在已启用技能的 Agent 会话中，可以用包含 Token 的自然语言发起查询，例如：
帮我查一下 AIGate 的 Token 余额和今天用了多少。
Token 月度统计能看一下吗？
Agent 会按技能包中的说明调用 AIGate 相关接口，返回余额、日消耗或月度统计（以平台实际返回为准）。具体请求参数、鉴权方式与错误处理以安装目录内 SKILL.md 及 AIGate 平台文档为准；本文不展开未在官方页面列出的配置字段名。
适用场景与注意¶
适合谁
- 已在使用 自定义 AIGate 平台，需要频繁核对 Token 余额与用量的开发者或运维。
- 希望在 Cursor / Claude Code / Codex 等支持 Skill 的客户端里，用对话完成用量查询、而不想每次打开控制台的人。
- SkillHub 分类为 data-analysis，与用量、统计类问题场景一致。
使用注意
- API Key：标签 requires_api_key=true 表示必须正确配置密钥；未配置或密钥无效时，查询无法完成。
- 平台地址：Skill 面向「自定义 AIGate 平台」；若你的网关地址、租户或项目与作者预设不一致，需在技能说明或环境配置中按
SKILL.md调整，勿假设与公有云默认端点相同。 - 触发词：依赖对话中出现含 Token 的表述；若 Agent 未加载该 Skill 或未识别意图，先确认安装目录与客户端 skills 路径是否一致。
- 版本：页面标注版本为 v1.0.2；升级可用
skillhub的 upgrade 能力，并再次核对SKILL.md变更。
结尾¶
AIGate Token用量查询 把 AIGate 的 Token 余额、日消耗与月度统计收敛到 Agent 对话里，适合在开发环境中快速核对用量。安装与优先源策略见 SkillHub 安装文档；技能详情与安装入口：
