OctoSwitch
聚合多源大模型 API 的本地统一网关 — 一个网关入口，组合多家供应商能力，协同完成任务。
Desktop app and local LLM API aggregation gateway. Aggregate multiple upstream providers (OpenAI, Anthropic, GitHub Copilot, and more) behind a single local gateway endpoint, combine their models into groups, and orchestrate multi-source API calls to complete tasks collaboratively.
面向个人使用的桌面应用与本地 大模型 API 聚合网关：将多个供应商的大模型 API 统一接入、分组编排，通过单一网关地址对外提供服务，灵活组合多源模型能力协同完成任务。客户端只需连接一个本地地址，无需频繁切换配置。
Highlights
- 🔗 多源聚合 — 接入 OpenAI、Anthropic、Copilot 等多协议供应商，统一网关入口
- 🎯 组合调用 — 将不同供应商的模型编组，以分组别名对外暴露，组内成员协同切换
- 🔄 无缝切换 — 客户端无需重启，在组内一键切换活动上游模型
- 📊 可观测性 — 用量指标、健康检查、熔断机制，掌握各供应商状态
- 🔒 隐私优先 — 数据本地 SQLite 存储，密钥不外泄
- ☁️ WebDAV 同步 — 通过 WebDAV 在设备间同步配置，支持坚果云 / Nextcloud / Synology
- ⬆️ 应用内更新 — 点击更新按钮自动下载对应平台的安装包、静默安装、自动重启，无需手动下载（macOS/Linux/Windows）
How it works
Clients (Claude Code, Cursor, etc.)
│
│ base_url = http://127.0.0.1:PORT
│ model = "Sonnet" (分组别名 / group alias)
▼
┌─────────────────────────────────────────┐
│ OctoSwitch Gateway │
│ │
│ model_group "Sonnet" │
│ ├── binding A → OpenAI provider │
│ ├── binding B → Anthropic provider │
│ └── binding C → Copilot provider │
│ ▲ │
│ active binding = A ← UI 随时切换 │
└─────────────────────────────────────────┘
│ │
┌────┴────┐ ┌────┴────┐
▼ ▼ ▼ ▼
OpenAI Anthropic Copilot ...
(多源供应商，按需组合，协同完成任务)
工作流程： 客户端只需指向一个本地地址，OctoSwitch 将请求路由到分组中当前活动的上游供应商。在 UI 中切换活动成员，客户端无感知——模型别名始终不变。
Interface
Providers（供应商）
Configure upstream connections by API format (OpenAI-compatible, Anthropic-style, GitHub Copilot, etc.), attach model bindings, reorder cards, and use Copilot reverse proxy or Add provider from the toolbar.
供应商：API 格式、已绑定模型与快捷操作
Groups（分组）
Group aliases are the model names your clients send (e.g. Sonnet, Opus). Each group aggregates members from multiple upstream providers, with one active target model. This is the core of multi-source composition—one alias, many providers behind it.
Click the Register in CC Switch button to generate a ccswitch:// deep link that imports the group as a provider in CC Switch with one click.
分组列表：别名 ↔ 多源上游模型
Group editor（编辑模型分组）
Open a group to add members from different providers, mark one member as active, and keep the client-facing alias stable while you switch backends. Mix and match providers in the same group to combine their strengths—e.g. use Provider A as primary, fall back to Provider B when needed.
分组内汇聚多供应商成员、设活动模型、与别名校验提示
Settings → Data（设置 · 数据）
Export or import JSON config, one-click import from cc-switch (reads the local cc-switch database; supports Claude / Codex / Gemini-style entries among others), WebDAV sync across devices, and local-only SQLite storage with privacy notes on secrets.
配置导入导出与本地数据说明
Import from cc-switch（从 cc-switch 一键导入）
cc-switch keeps Claude / Codex / Gemini-style provider entries in a local SQLite database. On the same machine, open Settings → Data and use One-click import (一键导入): OctoSwitch reads those rows and creates matching providers and model bindings. You can then refine groups and upstream model lists in OctoSwitch without retyping endpoints.
若本机已安装并配置 cc-switch，OctoSwitch 可在 设置 → 数据 中通过 一键导入 读取 cc-switch 本地数据库中的供应商与模型配置（支持 Claude、Codex、Gemini 等类型），导入后在分组与供应商页继续调整即可。
设置 → 数据：从 cc-switch 导入配置（一键导入）
Core capabilities
Multi-provider aggregation（多源供应商聚合）
Connect to multiple upstream providers simultaneously—OpenAI-compatible APIs, Anthropic-style routes, GitHub Copilot, and more. Each provider maintains its own API format and model bindings, all unified behind a single gateway endpoint. Your clients talk to one address, OctoSwitch routes to many providers.
同时接入多个上游供应商（OpenAI、Anthropic、Copilot 等），统一收敛至单一网关地址，客户端无需分别对接各家。
Model grouping & collaborative routing（分组编排 · 组合调用）
