mcpField
C
cli-providers

cli-providers

github.com/diegosouzapw云与 DevOps82.6k1.0k 次安装今天更新
代码仓库

关于 cli-providers

cli-providers 是用于通过 OmniRoute 命令行管理服务商连接、凭据、OAuth 和路由相关资源的技能，提供连接测试、状态与指标查看，以及服务商节点和路由组合管理。

主要功能

  1. 01浏览和管理服务商连接
  2. 02测试并验证连接
  3. 03轮换密钥并管理 OAuth
  4. 04查看服务商状态和指标
  5. 05管理服务商节点与路由组合

适用场景

  1. 01按名称或类别查找服务商
  2. 02测试所有活动连接
  3. 03刷新 OAuth 凭据
  4. 04查看使用指标和配额

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/diegosouzapw/omniroute --skill cli-providers

安装后在 Claude Code 中输入/cli-providers确认已加载。

详细介绍

概述

通过 CLI 管理提供商连接：列出可用/已配置的提供商、添加、测试、测试所有连接、验证、轮换 API 密钥，以及查看各提供商的指标。

快速安装

npm install -g omniroute   # or: npx omniroute
omniroute --version

子命令

provider-cmd provider [subcommand]

管理提供商连接（使用

示例：

omniroute provider-cmd provider [subcommand]
providers

示例：

omniroute providers
providers available

显示 OmniRoute 目录中的可用提供商

标志：

  • --json
  • --search <query>
  • -q, --q <query>
  • --category <category>

示例：

omniroute providers available
providers list

列出已配置的提供商连接

标志：

  • --json

示例：

omniroute providers list
providers test <idOrName>

测试已配置的提供商连接

标志：

  • --json

示例：

omniroute providers test <idOrName>
providers test-all

测试所有启用的提供商连接

标志：

  • --json

示例：

omniroute providers test-all
providers validate

验证本地提供商配置，不调用上游

标志：

  • --json

示例：

omniroute providers validate
providers rotate <idOrName>

标志：

  • --new-key <key>
  • --from-env <VAR>
  • --oauth
  • --yes
  • --skip-test
  • --dry-run

示例：

omniroute providers rotate <idOrName>
providers status

标志：

  • --provider <name>
  • --json

示例：

omniroute providers status
providers metrics

标志：

  • --provider <id>
  • --connection-id <id>
  • --period <p>
  • --metric <m>
  • --sort-by <field>
  • --limit <n>
  • --watch
  • --compare <list>

示例：

omniroute providers metrics
providers metric <connectionId> <metric>

标志：

  • --period <p>

示例：

omniroute providers metric <connectionId> <metric>
test-provider test [provider] [model]

标志：

  • --all-providers
  • --json
  • --latency
  • --repeat <n>
  • --compare <models>
  • --save <path>

示例：

omniroute test-provider test [provider] [model]

OmniRoute — CLI 提供商与密钥

需要 omniroute CLI。有关安装和全局标志，请参阅 CLI entry-point skill。

提供商目录（可用提供商）

omniroute providers available                        # Full OmniRoute provider catalog
omniroute providers available --search openai        # Filter by id, name, alias
omniroute providers available --category api-key     # Filter by category
omniroute providers available --json                 # Machine-readable JSON

类别：api-key、oauth、free、local、combo。

已配置的提供商连接

omniroute providers list                             # Connections in your DB
omniroute providers list --json

测试连接

omniroute providers test <id|name>                   # Test one configured connection
omniroute providers test-all                         # Test every active connection (TUI progress)
omniroute providers validate                         # Local-only structural validation (no HTTP)

test-all 会打开交互式 TUI，实时显示每个连接通过或失败的状态。使用 --json 获取机器可读的结果：

omniroute providers test-all --json

API 密钥管理（OmniRoute 密钥）

这些命令管理在 API Manager 下签发的 OmniRoute API 密钥，而非提供商凭据。

omniroute keys list                                  # List all OmniRoute API keys
omniroute keys add <provider> [apiKey]               # Add an API key for a provider
omniroute keys remove <provider>                     # Remove an API key
omniroute keys regenerate <id>                       # Regenerate (rotate) a key
omniroute keys revoke <id>                           # Revoke a key (disables it)
omniroute keys reveal <id>                           # Show the full key value
omniroute keys usage <id>                            # Show usage stats for a key

omniroute keys rotate <id>                           # Rotate + revoke old key atomically
omniroute keys expiration list                       # List key expiration times
密钥策略
omniroute keys policy show <id>                      # Show rate-limit / permission policy
omniroute keys policy set <id> \
  --rate-limit 100 \
  --rate-window minute \
  --permissions chat,models                          # Set policy on a key

模型

omniroute models                                     # List all models (all providers)
omniroute models openai                              # Filter by provider
omniroute models --search gpt                        # Search by name
omniroute models --json                              # JSON output

OAuth 提供商

omniroute oauth list                                 # List OAuth-configured providers
omniroute oauth login <provider>                     # Start browser-based OAuth flow
omniroute oauth logout <provider>                    # Revoke OAuth token
omniroute oauth status <provider>                    # Show token state + expiry
omniroute oauth refresh <provider>                   # Force token refresh

对于 OAuth 提供商（Gemini、Windsurf、Antigravity 等），login 命令会在浏览器中打开 OmniRoute 控制面板的 OAuth 流程。

提供商节点（多账户路由）

提供商节点让你可以将多个 API 密钥/账户关联到一个逻辑提供商，以实现轮询或故障转移。

omniroute nodes list <provider>                      # List nodes for a provider
omniroute nodes add <provider> --api-key <key>       # Add a node
omniroute nodes remove <provider> <nodeId>           # Remove a node
omniroute nodes test <provider> <nodeId>             # Test one node

路由组合（CLI）

在终端中创建和管理路由组合：

omniroute combo list                                 # List all combos
omniroute combo create <name> \
  --strategy priority \
  --targets anthropic/claude-opus-4-7,openai/gpt-4o  # Create combo
omniroute combo switch <name>                        # Activate a combo as default
omniroute combo delete <name>                        # Delete a combo
omniroute combo suggest --task "code review"         # Ask OmniRoute to recommend a combo

有关组合的完整 REST API，请参阅 omni-combos-routing skill。

配额与用量

omniroute quota                                      # Provider quota usage + reset times
omniroute usage                                      # Request + token usage summary
omniroute cost                                       # Cost breakdown (by provider/model)

压缩（CLI）

omniroute compression status                         # Current compression mode + savings stats
omniroute compression set --mode rtk                 # Enable RTK compression
omniroute compression set --mode stacked             # Enable stacked (RTK + Caveman)
omniroute compression set --mode off                 # Disable compression
omniroute compression preview --mode rtk --text "..."  # Preview savings for sample text

健康状态

omniroute health                                     # Detailed health: circuit breakers, cache, memory

错误

  • providers test <id> 失败并返回 401 → 为该提供商存储的 API 密钥有误；使用 keys remove + keys add 重置
  • oauth login 打开但未完成 → OAuth 令牌端点可能被防火墙阻止；改用 API 密钥认证
  • combo create 失败并提示 strategy unknown → 使用以下策略之一：priority、weighted、round-robin、fill-first、least-used、cost-optimized、auto、random、strict-random、p2c、reset-aware、lkgp、context-optimized、context-relay

评论

支持 Markdown