前言¶
在 Agent 或自动化脚本里直连大模型时，常见做法是配置一个 API Key。一旦触发厂商速率限制，或某个 Key 失效，整条调用链就会卡住。自己写轮询、重试和切换逻辑不难，但要和各家 SDK、错误码、配额策略对齐，维护成本会越来越高。
下面介绍 SkillHub 上的社区 Skill llm_key_pool（坐标 @user_7c8b7398/llm-key-pool，版本 1.0.0）。它面向「多厂商、多 Key」场景，把分层轮询和故障转移写成 Agent 可遵循的工作流，适合需要绕过单 Key 限速、提高调用可用性，或集中管理密钥池的开发者。
这是什么¶
llm_key_pool 是 SkillHub 分类 ai-agent 下的社区 Skill，发布者为 user_7c8b7398，来源标注为 community。官方简介概括为：
多平台 API Key 分层轮询与智能故障转移；当用户需要绕过单一 API Key 速率限制、实现高可用大模型调用或管理多厂商 API 密钥池时使用。
Skill 标签包含 requires_api_key=true，表示启用后需要自行配置各平台的 API Key，Skill 本身不提供密钥。
在 SkillHub 页面可见当前版本为 v1.0.0；公开统计（以 SkillHub 抓取资料为准）评分 100000，下载约 562 次。
- SkillHub 展示页：https://www.skillhub.cn/skills/user_7c8b7398/llm-key-pool
- API 元数据地址：https://api.skillhub.cn/user_7c8b7398/llm-key-pool
核心功能¶
依据官方简介与 SkillHub 检索结果，可核实的能力边界如下。
- 多平台 API Key 管理：面向多个厂商/多个 Key 的密钥池场景，而不是单 Key 直连。
- 分层轮询：在密钥池内按层级做轮询调度，用于分散请求、缓解单一 Key 的速率压力（具体分层规则以安装后的
SKILL.md为准）。 - 智能故障转移：在某个 Key 不可用或调用失败时，切换到池中其他 Key，支撑更高可用的大模型调用。
公开资料未列出支持的厂商清单、配置文件字段名或具体 HTTP 封装；这些细节应在安装包内的 SKILL.md 中查看。
安装与启用¶
SkillHub 推荐通过官方安装说明安装。页面给出的提示为：参照 https://skillhub.cn/install/skillhub.md，安装 @user_7c8b7398/llm-key-pool。
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 llm_key_pool¶
检索结果给出的安装命令为：
skillhub install llm-key-pool --namespace user_7c8b7398 --dir <skills 目录>
--dir 必须指向当前 Agent 实际读取的 skills 目录；SkillHub 文档说明，省略 --dir 时默认装到 ./skills/，可能不会被 Agent 加载。
常用路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装完成后，按所用客户端要求重启或刷新 Skill 索引，使 Agent 能发现新 Skill。
3、配置 API Key¶
因标签为 requires_api_key=true，需要按 SKILL.md 中的说明填入各平台密钥。公开页面未展开配置项名称；安装后应打开该 Skill 目录下的 SKILL.md，按文档完成密钥池与分层设置。
典型用法¶
公开 SkillHub 页面与 CLI 检索结果未提供独立的代码仓库示例或 curl 片段，典型用法以 Agent 对话 + Skill 工作流 为主：
- 完成上述安装，并配置多厂商/多 Key 密钥池。
- 在对话中说明需求，例如：需要绕过单 Key 限速、在多个 OpenAI 兼容或各厂商 Key 之间轮询、或在某个 Key 报错时自动切换。
- Agent 加载
llm_key_pool后，按SKILL.md中的步骤组织调用顺序、轮询与故障转移逻辑。
若需要核对 Skill 是否已可被检索，可先搜索：
skillhub search llm-key-pool
输出中应出现 @user_7c8b7398/llm-key-pool 及版本 1.0.0 的简介行。
适用场景与注意¶
适合谁
- 已有多个平台或多个 API Key，希望由 Agent 统一遵循轮询与切换策略的开发者。
- 生产或长时间运行的 Agent 任务，对单 Key 限速、偶发鉴权失败比较敏感的场景。
限制与注意
- 社区来源（community），维护节奏与兼容性需自行评估；升级前可用
skillhub查看是否有新版本。 - 密钥由用户自行保管，务必避免把 Key 写进仓库或日志；
requires_api_key=true仅表示 Skill 依赖密钥，不提供托管。 - 公开资料未说明具体支持的平台列表与错误码映射；以安装后的
SKILL.md为唯一操作依据，勿假设未文档化的配置字段。
结尾¶
llm_key_pool 把「多 Key、多平台」下的分层轮询与故障转移收敛为一个 ai-agent 类 Skill，适合在 SkillHub 生态里快速接入，而不是从零维护一套 Key 调度代码。需要安装或更新时，可从 SkillHub 页面进入：https://www.skillhub.cn/skills/user_7c8b7398/llm-key-pool ，或按坐标 @user_7c8b7398/llm-key-pool 用 skillhub install 装到当前 Agent 的 skills 目录。
