Skip to content

Switch 配置说明 ​

打开配置界面 ​

菜单栏图标

macOS / Linux:点击菜单栏图标 →「配置」。

系统托盘

Windows:托盘图标右键 →「打开配置」。

快捷键

Ctrl+Shift+S(Win/Linux)/ Cmd+Shift+S(macOS)。


添加模型提供商 ​

「提供商Provider模型提供商,即上游模型服务(云端 API 或本地推理服务)。Switch 支持配置多个 Provider 并按规则路由。」选项卡 →「添加提供商」,填提供商名称 + API Base URL + API Key:

提供商API Base URLAPI Key
Lurus API 推荐https://hub.lurus.cn/v1Lurus Key(sk- 开头);模型点「自动检测」
OpenAIhttps://api.openai.com/v1sk-...(官方)
Anthropichttps://api.anthropic.com/v1sk-ant-...
Ollama(本地)http://localhost:11434/v1(留空)

路由

配置路由规则

定义哪个请求走哪个提供商,未匹配的请求走默认提供商(默认 → Lurus API)。

按模型名称路由:gpt-* → OpenAI;claude-* → Anthropic;deepseek-* / *(其他)→ Lurus API;llama* → Ollama。JSON:

json
{ "rules": [
    { "pattern": "gpt-*", "provider": "OpenAI" },
    { "pattern": "claude-*", "provider": "Anthropic" },
    { "pattern": "llama*", "provider": "Ollama" },
    { "pattern": "*", "provider": "Lurus API" }
  ] }

按应用路由(高级):为不同本地应用设置不同路由:

json
{
  "app_rules": [
    {
      "app": "cursor",
      "default_provider": "Lurus API",
      "model_override": "deepseek-reasoner"
    },
    {
      "app": "continue",
      "default_provider": "Ollama"
    }
  ]
}

代理端口配置 ​

「通用」→「监听端口」,默认 11434。端口冲突(如与 Ollama)时改为其他端口(如 11435),应用侧相应修改 base_url=http://localhost:11435/v1(api_key 随意填,Switch 用配置的 provider key)。

端口冲突

默认端口 11434 与 Ollama 的默认端口相同。两者同机运行时,把 Switch 改到其它端口(如 11435),并同步更新应用侧的 base_url。

完整配置文件 ​

Switch 配置保存在:

平台路径
Windows%APPDATA%\LurusSwitch\config.json
macOS~/Library/Application Support/LurusSwitch/config.json
Linux~/.config/LurusSwitch/config.json

完整 config.json 示例:

json
{
  "listen_port": 11434,
  "log_requests": true,
  "start_on_login": true,
  "providers": [
    {
      "name": "Lurus API",
      "base_url": "https://hub.lurus.cn/v1",
      "api_key": "sk-your-lurus-key",
      "enabled": true
    },
    {
      "name": "Ollama",
      "base_url": "http://localhost:11434/v1",
      "api_key": "",
      "enabled": true
    }
  ],
  "routing": {
    "default_provider": "Lurus API",
    "rules": [
      { "pattern": "llama*",  "provider": "Ollama" },
      { "pattern": "qwen*",   "provider": "Ollama" },
      { "pattern": "*",       "provider": "Lurus API" }
    ]
  }
}

验证配置 ​

「状态」选项卡显示:各提供商连接状态(绿=正常,红=失败)、当前激活路由规则、最近请求日志。命令行验证(返回正常 JSON 即成功):

bash
curl http://localhost:11434/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"ping"}]}'

下一步 ​

下一步

Powered by Lurus Technologies