前言¶
接入自建或團隊內部的 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 安裝文檔；技能詳情與安裝入口：
