OSW 是什么

OSW 是一个跑在你本机的 AI 网关。它在本地起一个 HTTP 服务，你所有的 AI 客户端都指向这一个地址；请求经它转发到你配置的上游模型服务，并且在某个上游失败时自动改试下一个。

它解决的问题很具体：当你手上有多个模型服务（不同厂商、不同 Key、不同额度），客户端里各自配一堆地址和密钥，一个挂了要手动去改。OSW 把这些收拢到一层，客户端只需要认一个地址。

一段请求的旅程

flowchart LR
  A[客户端] -->|一个地址| B[OSW 本地服务]
  B --> C{选路}
  C -->|逻辑模型| D[候选上游 1]
  D -.失败.-> E[候选上游 2]
  D -->|成功| F[交回客户端]
  E -->|成功| F

1. 客户端把请求发到本地地址（协议可以是 OpenAI 或 Anthropic，见本服务支持的协议）。
2. OSW 按当前生效的路由定义决定这条请求落到哪个逻辑模型。
3. 逻辑模型下挂着若干供应商模型（真实上游），按优先级/故障转移选择一个发起请求。
4. 上游失败且属于可改试的失败时，换下一个候选；成功的响应（含流式）原样交回客户端。

它不是什么

OSW 是本地网关，不外挂云服务，也不接管你的系统网络。几条边界先划清：

确定要往下走了？从安装与启动开始，或者直接跳三步搭好网关。