SuperAPI AI 工具集

omniroute-cli

部署与运维

查看项目

更新于 10-15 21:10

技能介绍

用途:omniroute 二进制随 OmniRoute 服务器提供,既是服务器启动器,也是包含 39 个命令组、250+ 命令的管理 CLI。

安装:npm install -g omniroute,或使用桌面应用内置的二进制。要求 Node.js ≥20.20.2、≥22.22.2 或 ≥24。验证:omniroute --version 打印版本,omniroute --help 显示完整命令树。

连接:与服务器通信的命令读取 Base URL(OMNIROUTE_BASE_URL 或 --base-url)与 API key(OMNIROUTE_API_KEY 或 --api-key)。默认 Base URL 为 http://localhost:20128。远程服务器可设置 OMNIROUTE_BASE_URL 为对应地址。

全局参数:--base-url、--api-key 覆盖本次调用的服务器地址与密钥;--output 指定输出格式(table 默认、json、jsonl、csv);--json 等价于 --output json;--non-interactive 关闭提示,适用于 CI 与 shell 脚本;--no-open 启动时不自动打开浏览器;--port 覆盖默认端口 20128;--help/-h 显示当前命令帮助;--version/-v 打印版本。

输出格式:所有列表命令支持 --output,例如 omniroute combo list 输出表格,加 --output json 输出 JSON 数组,--output jsonl 每行一个 JSON 对象,--output csv 输出带表头的 CSV。

快速开始:运行 omniroute 启动服务器;首次运行可执行 omniroute setup 进入交互式设置向导;执行 omniroute doctor 检查健康状态。

能力技能:服务器管理与备份、提供商与密钥管理、云智能体(Codex / Devin / Jules)、评估与基准测试等技能文档见对应 SKILL.md 链接。若需直接 HTTP 调用而非 CLI,可参考 OmniRoute 入口技能。

错误处理:Connection refused 表示服务器未运行,可运行 omniroute 或 omniroute serve;401 Unauthorized 表示 API key 错误或缺失;command not found: omniroute 表示不在 PATH,可检查 npm root -g 或重新安装;doctor 报告 SQLite incompatible 时,在应用目录执行 npm rebuild better-sqlite3。