diff --git a/README.md b/README.md index 1d38a7f..7797d40 100644 --- a/README.md +++ b/README.md @@ -49,6 +49,40 @@ LLM_Proxy 的核心价值就在这里: 如果从接入视角描述,这个项目不是单纯的转发层,而是一个带后台管理、路由能力和协议适配能力的 ONE API 接入层。 +## 典型使用场景 + +### 1. 家里 NAS / 小主机部署,供局域网统一使用 + +这个项目很适合部署在家里的 `NAS`、迷你主机或常开服务器上,作为局域网内统一的 LLM 接入入口。 + +常见用法是: + +- 在 `NAS` 上启动 `LLM_Proxy` +- 把不同上游模型能力统一挂到这一个服务后面 +- 在局域网内给桌面端工具、脚本、自动化流程统一提供一个 OpenAI 兼容接口 + +这样做的好处是: + +- 局域网内客户端只需要记住一个代理地址 +- 上游 API Key、Hook 适配逻辑、Provider 路由都集中在服务端管理 +- 更适合做白名单控制、用户管理和请求统计 + +### 2. OpenClaw 等客户端接入局域网代理 + +如果你把服务部署在局域网设备上,那么像 `OpenClaw` 这类客户端看到的只是一个局域网内的 OpenAI 兼容接口,例如: + +```text +http://192.168.1.10:8080/v1/chat/completions +``` + +对客户端来说: + +- 不需要直接感知真实上游厂商地址 +- 不需要关心上游是否是非标准协议 +- 只需要按 OpenAI / ONE API 风格填写局域网代理地址即可 + +而协议转换、鉴权补充、模型路由、白名单控制等能力,全部由 `LLM_Proxy` 在局域网代理层统一处理。 + ## 合规说明 Hook 适配能力的设计目标是支持合法授权前提下的协议兼容和私有集成。