From 5f452e10d68f9d9241c70eb921076a8e976c5c5a Mon Sep 17 00:00:00 2001 From: Jidekin Date: Fri, 20 Nov 2026 15:37:53 +0800 Subject: [PATCH] =?UTF-8?q?feat!:=20=E9=A1=B9=E7=9B=AE=E6=94=B9=E5=90=8D?= =?UTF-8?q?=E3=80=8C=E5=B0=8F=E9=93=B6=E7=BD=91=E5=85=B3=E3=80=8D=E5=B9=B6?= =?UTF-8?q?=E4=B8=8A=E7=BA=BF=E5=AE=98=E7=BD=91=20xywg.wangjinding.com?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 老板要求:AI 网关改名为小银网关,做一个类似小银 Markdown 的官网, 域名 xywg.wangjinding.com,所有内容都改名。 一、改名(只动展示名,不动技术标识) · app/main.py:FastAPI title、根接口 name、启动/关闭日志 → 小银网关 · frontend:index.html + dist/index.html 标题、i18n 的中英文标题 · README / docs / data/gateway.yaml 注释里的「AI 网关」「API 网关」→ 小银网关 · 保留 api-gateway 作为目录名 / supervisor 服务名 / python 包名 / 仓库名 —— 改这些会破坏 import、服务托管和 git 远端,收益为零风险不小 二、官网 · 复用小银 Markdown 官网的整套 CSS 与版式(同一套视觉语言) · 内容按网关重写:首屏(一个网关,接住所有模型)、三大场景、数据块、 功能九宫格、接口一览(9 个端点)、部署示例、关于 · 数字都取自实际配置:4 家供应商 / 81 个模型 / 2 万行 Python / v2.9.16 · 首屏用终端示例代替应用截图(网关没有界面截图,终端最直观) 三、基础设施 · 1Panel 静态站 + Let's Encrypt 证书(acme.sh 自动续期) · EdgeOne 加速域名(回源 HTTPS/8443,Host=加速域名) · DNS:xywg CNAME → xywg.wangjinding.com.eo.dnse2.com --- README.md | 4 +- app/main.py | 14 +- app/settings.py | 2 +- data/gateway.yaml | 8 +- docs/frontend-design.md | 2 +- docs/project-audit-2026-10-23.md | 2 +- frontend/index.html | 2 +- frontend/src/locales/zh.ts | 4 +- site/favicon.png | Bin 0 -> 2056 bytes site/index.html | 498 +++++++++++++++++++++++++++++++ 10 files changed, 514 insertions(+), 22 deletions(-) create mode 100644 site/favicon.png create mode 100644 site/index.html diff --git a/README.md b/README.md index 384f41c..45ddb6f 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,4 @@ -# API Gateway +# 小银网关 统一多供应商 LLM 接入网关,纯后端 FastAPI,配置驱动。支持 **Agnes AI**、**OpenCode Go**、**Dots AI(小红书)** 三个供应商,全部走 OpenAI 兼容协议。v2.4 已集成熔断、限流、图像/视频、指标、成本估算、热加载、测试等完整能力。 @@ -769,7 +769,7 @@ curl "http://localhost:8808/v1/videos/?model=agnes-video-2.5-flash&wai `index-BWFYxQdn.js`);用同源探针 `probe.html`(原 `design/login-v3/probe.html`,已随设计稿目录归档)逐格量过 **3 主题 × 7 分辨率** (1280×720 / 1024×768 / 1440×900 / 1920×1080 / 390×844 / 360×640 / 414×896)共 21 组: 全部 `ovX=ovY=0` 无溢出、卡片 440×444 居中、三主题的卡片 / 按钮 / logo / 聚焦环颜色各自正确、 - 旧结构节点 0;英文单独验过(`API Gateway Console` / `Username` / `Password` / `Sign in`、 + 旧结构节点 0;英文单独验过(`Xiaoyin Gateway Console` / `Username` / `Password` / `Sign in`、 ``、卡片 434 高同样无溢出);真机交互验过语言切换(右上角胶囊 → English → 文案与 `` 同步)与空提交报错(卡片内红色提示、卡片自动增高不溢出)。 线上 `https://api.wangjinding.com/web/#/login` 已服务新产物(`Login-CazImMjd.css` 200 / 4426B, diff --git a/app/main.py b/app/main.py index 487d233..76e1965 100644 --- a/app/main.py +++ b/app/main.py @@ -1,4 +1,4 @@ -"""API 网关主入口:FastAPI 应用(v2.4 全功能版)。 +"""小银网关主入口:FastAPI 应用(v2.4 全功能版)。 特性: - 多供应商 OpenAI 兼容 /chat/completions(同模型重试 + 熔断;第二十七轮起三线直传: @@ -211,7 +211,7 @@ def _warn_security_posture(cfg) -> None: async def lifespan(app: FastAPI): global config _setup_logging() - log.info("API Gateway 启动,已加载 %d 供应商", len(config.providers)) + log.info("小银网关启动,已加载 %d 供应商", len(config.providers)) _warn_security_posture(config) for w in validate_warnings(config): log.warning("配置告警: %s", w) @@ -275,7 +275,7 @@ async def lifespan(app: FastAPI): _, pending = await asyncio.wait(set(_bg_tasks), timeout=5) for t in pending: t.cancel() - log.info("API Gateway 关闭,等待在途请求(graceful_shutdown=%ds)", config.server.graceful_shutdown) + log.info("小银网关关闭,等待在途请求(graceful_shutdown=%ds)", config.server.graceful_shutdown) # 第六轮: 快照后再迭代(避免迭代中字典被改动 → RuntimeError) for adapter in list(_state.get("adapters", {}).values()): await adapter.close() @@ -388,7 +388,7 @@ _docs_on = config.server.docs_enabled # 安全默认关(report: /docs、/ope VERSION = "2.9.16" app = FastAPI( - title="API Gateway", + title="小银网关", description="统一多供应商 LLM 接入网关(Agnes / OpenCode Go / Dots AI)", version=VERSION, lifespan=lifespan, @@ -3333,7 +3333,7 @@ async def metrics_prometheus(request: Request, _auth=Depends(require_auth)): raise HTTPException(404, "metrics 已禁用") snap = _usage_snapshot() lines = [ - "# API Gateway Prometheus 指标", + "# Xiaoyin Gateway Prometheus 指标", f'api_gateway_uptime_seconds {snap["uptime_seconds"]}', # 第二十七轮: api_gateway_fallback_total 随「路由别名 / fallback 链」一起删除 —— # 快照里已没有 fallback_total 字段,这里再读就是 KeyError(曾被 live_check 抓到 500)。 @@ -3394,7 +3394,7 @@ async def metrics_prometheus(request: Request, _auth=Depends(require_auth)): "# HELP api_gateway_circuit_recent_failures 熔断窗口内近期失败数", "# TYPE api_gateway_circuit_recent_failures gauge", ] - # "# API Gateway Prometheus 指标" 是第一行注释,保留在 HELP 之前 + # "# Xiaoyin Gateway Prometheus 指标" 是第一行注释,保留在 HELP 之前 head, body = lines[0], lines[1:] return "\n".join([head] + help_lines + body) + "\n" @@ -3664,7 +3664,7 @@ async def root(request: Request, _auth=Depends(require_auth_or_open)): return RedirectResponse("/web/") cfg = _cfg() return { - "name": "API Gateway", + "name": "小银网关", "version": VERSION, "endpoints": { "chat": "POST /v1/chat/completions(OpenAI Chat Completions 线)", diff --git a/app/settings.py b/app/settings.py index fd230b5..f52fd9d 100644 --- a/app/settings.py +++ b/app/settings.py @@ -516,7 +516,7 @@ def restart_keys_changed(old: GatewayConfig, new: GatewayConfig) -> list[str]: # ── 渲染 yaml 文本 ──────────────────────────────────────── _HEADER = """\ -# AI 网关配置文件(data/ 目录) +# 小银网关配置文件(data/ 目录) # # ⚠ 本文件由管理页面「网关配置」生成(管理员账号),页面保存时会**整份重写**: # 想要的历史决策/踩坑说明在 README.md(按轮次记录),这里只保留必要的现场注释。 diff --git a/data/gateway.yaml b/data/gateway.yaml index f583127..a028e39 100644 --- a/data/gateway.yaml +++ b/data/gateway.yaml @@ -1,4 +1,4 @@ -# AI 网关配置文件(data/ 目录) +# 小银网关配置文件(data/ 目录) # 供应商:Agnes / OpenCode Go(订阅编程模型)/ Dots AI # 密钥统一走 token_env 指向的环境变量(本机见 data/.env),不再在 yaml 存明文 # 端口默认 8808 @@ -335,12 +335,6 @@ providers: context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护 max_output_tokens: 131072 # 最大输出(token) protocols: ["chat/completions"] - - id: "glm-5.2" - display_name: "GLM-5.2" - type: "text" - context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护 - max_output_tokens: 131072 # 最大输出(token) - protocols: ["chat/completions"] - id: "kimi-k2.7-code" display_name: "Kimi K2.7 Code" type: "text" diff --git a/docs/frontend-design.md b/docs/frontend-design.md index 4b36054..e2c36e6 100644 --- a/docs/frontend-design.md +++ b/docs/frontend-design.md @@ -1,4 +1,4 @@ -# API 网关 Web 前端 —— 设计文档 +# 小银网关 Web 前端 —— 设计文档 > 版本 v0.1(待审)|2026-09-11 > 对象:`https://api.wangjinding.com`(网关,端口 8808,已开鉴权,127.0.0.1 反代对外) diff --git a/docs/project-audit-2026-10-23.md b/docs/project-audit-2026-10-23.md index 55ccc11..2ca02d8 100644 --- a/docs/project-audit-2026-10-23.md +++ b/docs/project-audit-2026-10-23.md @@ -1,4 +1,4 @@ -# AI 网关项目体检报告(2026-10-23) +# 小银网关项目体检报告(2026-10-23) > 范围:`/root/dsh/projects/<项目>`(v2.9.15)。方法:跑测试 + 静态检查 + 数据/权限/备份审计 + 真实接口压测。 diff --git a/frontend/index.html b/frontend/index.html index 54652ff..bae0dae 100644 --- a/frontend/index.html +++ b/frontend/index.html @@ -3,7 +3,7 @@ - API 网关管理台 + 小银网关管理台
diff --git a/frontend/src/locales/zh.ts b/frontend/src/locales/zh.ts index 84ea8eb..6c0f055 100644 --- a/frontend/src/locales/zh.ts +++ b/frontend/src/locales/zh.ts @@ -65,7 +65,7 @@ export default { }, nav: { - title: 'API 网关', + title: '小银网关', connected: '已连接 api.wangjinding.com', disconnected: '连接异常', menudashboard: '仪表盘', @@ -140,7 +140,7 @@ export default { cancel: '取消', }, login: { - title: 'API 网关管理台', + title: '小银网关管理台', userPlaceholder: '用户名', passPlaceholder: '密码', btn: '登录', diff --git a/site/favicon.png b/site/favicon.png new file mode 100644 index 0000000000000000000000000000000000000000..5db72e2846239df724e8da001e548f42ac0eddff GIT binary patch literal 2056 zcmY*ad0bOh7QQbKkN}dfNud4+VHimbi+~YSBmzMM3L&5nL7}AqYQrL%l=Z=|xJ1AT zBKuM?-~tMWC}nqHUrJ?Dw&@r_v4&PQ+2$tJ-%S5{_uO;7bMN=g`OZDhbUY%DQ^x@S zUarEKra^}A zS;r2gxJYi8O-k*h>GnA7x`d&9U?z2h*U?vjC9Mk!YmCFXE@-U;|7@%;vwaFAY4)A5 zsoSmxV?uWp+-t|tSH9+H*F@MN+bnqDu7XK@=rK#{nDl^X!;uDJ%tMIzCUVzB0~J(g zMXmA;nN3YV-6M9OLz>@2>Et!Q3|e)K#0gK(reHSTc{3UejNZTmf3(u~FkY*L;E?ej zPiDi-cF|^FzY$jgefqm9grAPg9fe$}dN z%Rxn&G;m@+d1b_6w+}%VoG>$5S&oaiK@L{Rp!LaZ@kY!N<u!=-+StnHf%8vA>ZLxo)pNOIVJXv3ii6XxWL0T=Y1lzg1{d{4XPH z@Q1TMQzZ7=dI9aGH$TM6Gw6FOf-q_8h0DY$X+QgiNRM1;0BZM30C0Ak(G6`mz*3>t z4lwehm+V}CbGvG|{wSG&SSzqUtWFmSu^Bp^Y(bKJi7d&Zyt-GmL>8F3jbb{Ya(xT( z3N2OXOL$IE(IHlolA(kSU228~S`*H+sQ|+?SO!ZK*mh5G$3Tlaq#^49hU3)?91!r^ zUsapL9i-P9;KQ4fvp(15|7v$BnS%PKccrlwmrGL&v4F>ioy^2C15Q>htudX-G2kie zBlmhtc{R;#)x2EK6J}1LqVs&erPVp@ZxO2fB%T9r*`^ADn+C8M?@W4W21)uTr&H-B zHMFfvh`mc)Xjh3nRKJS>gI{Ja3S{eST|l>@0e4W4(8yA0seUYTGSh5&CuPeE-5X=v zG<8Z?@sA0q;P1lJl8a8W0ztM7S0d5r*qp3)IPn+lF8b_Tu>;~6bzd&2Fwjo5MW-ZX zt!oFEzsK>p9aavt6a6Y~aB-^Ba~lr5nig}qcJnrmQ4IWF^*nn*yhvKqNbpW~e*ZpV%6egg0yY%SdG)$;q2fQvw0rEb z#Hw9|Vb-!E=9dMoVx1+~^53XB3yz5lQll<^?i4|A{F6{%%chcVSL8nv3(Ea}f`aw> zQ@OarW6EXUny+%`=qCY+Pie8P*_s0T5cXBhrp4p4^$Dx{KaCkE-YB+#*I#m_%Mcug z%s&g6= + + + + +小银网关 — 一个网关,接住所有模型 + + + + + + + +
+ +
+ + +
+
+
v2.9.16 · MIT 开源 · 纯本地部署
+

一个网关,
接住所有模型

+

+ 把 4 家供应商、81 个模型收进同一个 OpenAI 兼容接口。
+ 三条协议线原样直传,网关只做路由、鉴权和限流,不改你的字段。 +

+
+ 纯后端 FastAPI配置驱动 · 热加载自带 Web 管理台 +
+ +

Docker / 源码部署 · Python 3.10+ · 不依赖任何云服务

+ +
+
✓三线直传
+
✓统一密钥
+
✓熔断 · 限流
+
✓成本统计
+
✓MIT 开源
+
+ +
+
终端 — 换一个 model,就换一家供应商
+
# 同一个接口,model 决定走向哪一家
+$ curl https://api.wangjinding.com/v1/chat/completions \
+    -H "Authorization: Bearer sk-你的key" \
+    -d '{"model": "agnes-3.0-flash",
+         "messages": [{"role":"user","content":"你好"}]}'
+
+200 OK  {"choices":[{"message":{"content":"你好!有什么可以帮你?"}}]}
+
+
+
+ + +
+
+
+

一个网关,解决三件事

+

+ 以前每接一家模型就要改一次代码、换一套鉴权、记一套错误码。 + 现在它们都在你身后,接口只有一个。 +

+
+
+
+

⇄一个 Key,四家供应商

+

请求里的 model 决定走向哪家:1min.ai 43 个模型、OpenCode Go 27 个、Agnes AI 10 个、Dots(小红书) 1 个。换模型不用换 SDK、不用换域名。

+
+
+

⑃三条协议线,原样直传

+

OpenAI Chat、Anthropic Messages、Responses 三条线各按自家协议转发,网关不翻译字段。选错线直接 400,并告诉这个模型支持哪几条。

+
+
+

◎管得住:熔断、限流、成本

+

同一模型自动重试 + 供应商级熔断;两级限流(全局 / 供应商);每次调用都有 token、耗时、成本估算,落在日志和 /metrics 里。

+
+
+
+
+ + +
+
+
+

一套后端,
把复杂度吃掉

+
+
+
4家供应商
共 81 个模型
+
3条协议线
原样直传
+
2万+行 Python
单进程 FastAPI
+
0依赖云服务
数据都在自己机器上
+
+

改配置不用重启:POST /admin/reload 热加载

+
+
+ + +
+
+
+

该有的都有,不该有的一个没有

+

没有账号体系绑死你、没有额度套餐、没有强制上报。装上就是你的。

+
+
+

⇄多供应商分发

model 名决定供应商;同名模型可配多条路由,按顺序故障转移。配置写在 YAML 里,改完热加载。

+

⑃三线直传

OpenAI Chat / Anthropic Messages / OpenAI Responses 三条线各走自家协议,字段不加工,客户端 SDK 直接可用。

+

⛨熔断 · 重试

同模型失败自动重试;某家供应商连续失败就熔断一段时间,请求自动绕开,chat 与媒体各自独立计数。

+

◔两级限流

全局 QPS + 每供应商 QPS 双层保护,超了返回 429 并带 Retry-After,不会把上游打爆。

+

▣图像与视频

/v1/images/generations 直出图片;/v1/videos 支持异步轮询、等待模式和 Webhook 回调。

+

▲指标与成本

/metrics 出 JSON,/metrics/prometheus 直接给 Prometheus 抓;按定价表估算每笔调用花多少钱。

+

↻热加载

改完 gateway.yaml 调一次 reload,新配置立即生效,不中断在途请求。

+

☺账号 + 每账号 Key

管理台账号密码登录,每个账号自己建 API Key,互不干扰;停用只影响该账号。

+

▤自带管理台

Vue 写的 Web 控制台:看日志、调配置、试模型、查用量,不用登服务器改文件。

+
+
+
+ + +
+
+
+

接口就那么几个

+

都是 OpenAI 兼容路径,换 base_url 就能接上你现有的客户端。

+
+
POST/v1/chat/completions对话(OpenAI 线)
POST/v1/messages对话(Anthropic 线,也认 x-api-key)
POST/v1/responses对话(Responses 线)
POST/v1/chat/completions/batch并发多 prompt 一次发出
POST/v1/images/generations出图
POST/v1/videos出视频(异步 / 等待 / Webhook)
GET/models这个网关现在有哪些模型
GET/metrics用量、耗时、成本(JSON / Prometheus)
GET/health运维看板
+
+
+ + +
+
+
+

部署,三条命令的事

+

一台小机器就够:单进程 FastAPI,内存几百 MB,没有数据库、没有中间件。

+
+
+
+

⌨从源码跑起来

+
git clone https://git.wangjinding.com/Jidekin/api-gateway.git
+cd api-gateway
+pip install -r requirements.txt
+
+cp .env.example .env        # 填各家供应商的 token
+vim data/gateway.yaml       # 配供应商、模型、限流
+
+python run.py               # 默认 127.0.0.1:8808
+

起来之后打开 http://127.0.0.1:8808/admin 就是管理台。

+
+
+

⌗配一个供应商长这样

+
# data/gateway.yaml
+providers:
+  agnes:
+    base_url: https://api.agnes-ai.cn/v1
+    api_key: ${AGNES_API_KEY}
+    models:
+      - name: agnes-3.0-flash
+        protocols: [chat, messages]
+        pricing: { input: 0.0, output: 0.0 }
+

配好 reload 一下,GET /models 就能看到它。

+
+
+
+
+ + +
+
+
+

关于小银网关

+

+ 一家人用的模型入口。不对外卖额度、不做 SaaS —— 代码在你自己机器上跑, + 密钥在你自己手里,日志在你自己盘上。 +

+
+ +
+
+ 技术栈 + + FastAPI + Python 3.10+ + 配置驱动 YAML + Vue 管理台 + +
+
+ 供应商 + 1min.ai(43 个模型)· OpenCode Go(27)· Agnes AI(10)· Dots AI 小红书(1,512K 上下文) +
+
+ 部署方式 + 源码 python run.py 或 Docker;单进程,无数据库、无 Redis、无消息队列。 +
+
+ 许可 + MIT License,可自由使用、修改、分发。 +
+
+ +
+

✓隐私

数据不出你的机器。网关只在上游调用时刻才连外网,其余时间全是本地。

+

⚖许可

MIT。改完自己用、给朋友用、拿去二次开发都行。

+

⌨自己改

2 万行 Python,一个 app/main.py 就是全部后端;前端 Vue 单独构建,产物直接塞进 frontend/dist。

+
+
+
+ +
+
+ © 2026 小银网关 · 2.9.16 + · + Gitea + · + GitHub + · + MIT License +
+
+ + + +