为什么是斯鲁特?

与人工智能代理(Claude Code, Cursor, Windsurf, Cline)的编码具有转型性,但开发者不断会跑入墙壁:

* 如何运作

┌─────────────────────────────────────────────────────────────────────────────┐
│                       Your Coding Agents & IDEs                             │
│       (Claude Code, Cursor, Windsurf, Cline, Roo Code, Codex, Aider)        │
└──────────────────────────────────────┬──────────────────────────────────────┘
                                       │ http://localhost:20268/v1
                                       ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                         SRouter Smart AI Gateway                            │
│  • Complexity Gate (System One: routes simple prompts fast, complex deep)  │
│  • Prompt Compressor & Token Saver (compacts tool results, trims context)  │
│  • Protocol Translation (OpenAI ↔ Anthropic Messages ↔ Gemini ↔ Ollama)     │
│  • Per-Key Rate Tracking (RPM / RPD / TPM / TPD tracking with auto-reset)   │
│  • Local AES-256-GCM Key Vault & SQLite Persistence                        │
└──────────────────────────────────────┬──────────────────────────────────────┘
                                       │
        ┌──────────────────────────────┼──────────────────────────────┐
        ▼                              ▼                              ▼
 ┌──────────────────────────┐   ┌──────────────────────────┐   ┌──────────────────────────┐
 │  Tier 1: Sub / Fast Key  │   │  Tier 2: Generous Quota  │   │ Tier 3: 100% Free / Anon │
 │  • Google Gemini 2.5     │   │  • Mistral / Codestral   │   │  • Kilo Gateway (No Key) │
 │  • Groq (Llama 3.3 70B)  │──►│  • Zhipu GLM-4 / CogView │──►│  • OpenCode Free (No Key)│
 │  • Pollinations (Free)   │   │  • Cloudflare Workers AI │   │  • OVH Endpoints (No Key)│
 │  • OpenRouter / DeepSeek │   │  • Cohere / NVIDIA NIM   │   │  • LLM7 / AI Horde       │
 └──────────────────────────┘   └──────────────────────────┘   └──────────────────────────┘

当请求到来时,SRouter会评价模型健康,目前的RPM/RPD限制,以及即时的复杂性. 如果上游提供者返回 429 Too Many Requests 或者说 5xx Server Error,键入临时冷却器和 SRouter 立即重试你倒数链中第二好模式。 。 。 .

QQ 快速启动

1. 通过国家预防机制/国家项目X运行门户

运行 SRouter 任何地方的节点 20+ 安装时不克隆寄存器 :

# Install globally
npm install -g @baiibayu/srouter

# Launch the gateway & open the Web Dashboard (default port 20268)
srouter

# Or run headless with custom port
srouter serve --port 3000 --no-browser

# Or run directly without installing using npx
npx @baiibayu/srouter

Web Dashboard 自动打开 http://localhost:20268中安全存储数据 ~/.srouter。 。 。 .

2. 升级

升级是无缝的——您的 SQLite 数据库和配置幸存更新 :

# Check if a newer version exists
srouter update --check

# Upgrade to latest
srouter update
# or
npm install -g @baiibayu/srouter@latest

3. Docker和GHCR替代品

# Run instantly from GitHub Container Registry
docker run -d --name srouter -p 20268:20268 -v srouter-data:/app/server/data ghcr.io/baiibayu/srouter:latest

* 兼容编码代理件和CLI

SRouter包括自动配置发电机(setup-*),检查您的活模式目录,取用已有设置的时间标记备份,并写出您工具预期的确切配置:

克劳德代码	光标	代码 CLI	线	继续	助手
打开代码	双子座CLI	Roo 代码	Kilo 代码	齐德	喷气管
鹅	Quen 代码	碾碎	工厂机器人	打开Claw	深搜索策略
哦,我的爱	赫尔墨斯	Pi	原子代码	原因	打开阴影

设置命令参考

配置任何带有一个命令的代理 :

# Point Claude Code to SRouter
srouter setup-claude --url http://localhost:20268 --api-key <your-unified-key>

# Or run via npx without global install
npx @baiibayu/srouter setup-cursor --url http://localhost:20268 --api-key <your-unified-key>

零持久性发射器

不为您的磁盘写敏感密钥的发射代理:

# Injects credentials directly into Claude Code's child process environment
srouter launch

# Injects credentials directly into Codex CLI
srouter launch-codex

诊断和健康检查srouter doctor(中文(简体) )

判断您的编码工具是否实际到达网关( 解析环境变量、 配置优先级和可达性) :

srouter doctor
# or check a specific tool:
srouter doctor claude
srouter doctor codex

CLI 生成器旗

提供钥匙管理

从终端管理上游提供者密钥而不打开浏览器 。 这些命令使用您的仪表盘会话代号进行认证( NameSROUTER_DASHBOARD_TOKEN 或者说 --token:

export SROUTER_URL=http://localhost:20268
export SROUTER_DASHBOARD_TOKEN='<dashboard-session-token>'

# Interactive prompt (hidden input)
srouter keys add groq

# Non-interactive addition
srouter keys add groq --key 'gsk_...'

# List all stored keys (shows ID, platform, active models, health status)
srouter keys list

# Test provider key health through the gateway
srouter keys test groq
srouter keys test groq --id 3

# Remove a provider key safely
srouter keys remove groq --id 3

* 支助提供者

SRouter合计数 ~60个供应商 财务报告和审定财务报表 ~1,200+ 终点 一个统一后 /v1 终点.

谷歌双子座	格罗克	迷雾	打开路透社	阿里巴巴·克温	诺斯研究
硅花	模型范围	云雾花	代码	齐普 GLM	NVIDIA 尼姆语
白都强活佛	字节方舟	iFlytek Spark (英语)	AMD 雷达	拥抱脸	基罗
法学硕士7	奥拉玛	孤儿	弹道	打开代码	大赦国际

提供者级别

1. 100% 自由/ 无密钥 : Kilo Gateways (无密钥), OpenCode Free (无密钥), OVH AI Endpoints, LLM7, AI Horde.
2. QQ 有密钥的 Generous Free Tier : Google AI Studio (Gemini 2.5 Flash / Pro),Groq (Llama 3.3 70B@30 RPM),Mistral AI (Codestral), Cloudflare 工人AI (Cloudflare systems/日),Cohere,Zhipu GLM-4,NVIDIA NIM.
3. * 区域和高配额: 模型Scope (Aliyun, 2,000 req/日), Baidu Qianfan, Volcengine Ark, Nara Router, 海狮.
4. 本地自定义/ 自定义 : 直接通过 Keys 页面连接 Ollama, LM Studio, vLLM, 或 lama.cpp.

QQ 统一 API 端点

SRouter将不同的API线程翻译为标准表面:

[TIP] 决策系统一/v1/decision: 在发送昂贵的查询之前使用这个端点来确定一个快报是需要轻量级快报模型还是重推理模型.

网络工具( E)/v1/search 打开 /v1/fetch: 内置的网页刮取和搜索工具允许您的编码代理直接通过网关研究最新的文件、软件包和故障排除指南.

QQ MCP 服务器设置

SRouter包括本地人 示范背景协议(MCP) 服务器结束 可流取的 HTTP 时间 http://localhost:20268/mcp。 。 。 .

Claude 桌面配置

将 Sruter 添加到您的 claude_desktop_config.json数字 :

{
  "mcpServers": {
    "srouter": {
      "url": "http://localhost:20268/mcp",
      "headers": {
        "Authorization": "Bearer srouter-your-unified-key"
      }
    }
  }
}

光标/ 线条配置

在编辑器的 MCP 设置中, 添加一个新的服务器 :

• 名称 : srouter
• 类型 : sse 或者说 streamable-http
• URL : http://localhost:20268/mcp
• 标题 : {"Authorization": "Bearer srouter-your-unified-key"}

可用的多边CP工具包括: list_models, (中文(简体) ), get_model_status, (中文(简体) ), check_provider_health,以及 web_search。 。 。 .

安全、安保和地方隐私

• 非破坏性发电机: 生成器命令合并到现有的配置文件, 而不是覆盖它们, 并使用时间戳 .bak 先备份. --dry-run 提前显示准确的 diff .
• 零接触发射器: srouter launch 财务报告和审定财务报表 srouter launch-codex 只将证书输入到子进程内存中——没有键被写入磁盘.
• 当地AES-256-GCM 默认 : 上游 API 密钥在 SQLite 中使用 AES-256-GCM 本地加密(~/.srouter/srouter.db) (中文(简体) ). 没有遥测,没有云接力,没有证书泄漏.
• 无法打开压缩 : Token 保存器和 regex 压缩过滤器会安全打开: 如果过滤器无法解析输入, 原始提示会完整地转发 .

QQ 解决问题和问题

20268号港口已在使用

指定以 --port数字 :

srouter serve --port 3000

速率限制( 429次请求过多)

SRouter自动冷却了已耗尽的密钥,并且无缝地重复了您倒置链中的下一个提供者. 如果该模式级的所有密钥已用尽, 请通过 Web Dashboard 启用100%的无密钥提供者( 如 Kilo Gateway 或 OpenCode Free) .

我的数据存放在哪里?

• 全球CLI: ~/.srouter/srouter.db
• Docker: 已命名的音量 srouter-data (单位:千美元)/app/server/data(中文(简体) )
• 视窗桌面 : %APPDATA%\SRouter\srouter.db
• macOS 桌面 : ~/Library/Application Support/SRouter/srouter.db

QQ 支持开发者

如果 SRouter 保存您符号, 提升您的编码工作流程, 或保存您的钱, 考虑支持开发 。 每一杯咖啡都保持了这个项目的独立性和积极维护!

QQ 许可证和免责声明

• 许可证 : 打开源 MIT 许可证。 。 。 .
• 免责声明: SRouter是为个人发展,实验,和编码剂增强而设计的. 免费等级由各上游提供者的服务规定.
• 仓库 : https://github.com/baiibayu/srouter (英语)
• 作者 : 巴伊巴尤语