Compare commits

..
98 Commits
Author SHA1 Message Date
Jidekin feb055d4e6 refactor(frontend): 地址栏改成动态显示当前 host,不再写死任何域名
上次 filter-repo 把 api.wangjinding.com 直接替换成 127.0.0.1:8808,
是写死的 —— 用户从自己域名访问时会显示错误的地址。

这次改成 location.host:
  · SideNav 的 logo 下方 → {{ apiHost }}(= location.host)
  · MainLayout 副标题兜底 → location.host
  · i18n 的「已连接 <域名>」→「已连接」
  · 前端重新 build(不是打补丁),产物里没有任何写死的地址

实测:
  http://localhost:8808  → 侧栏 localhost:8808 | 已连接
  http://127.0.0.1:8808  → 侧栏 127.0.0.1:8808 | 已连接

顺带修掉 filter-repo 留下的一个错误 scheme:
  gateway.yaml 的 cors 里出现了 https://127.0.0.1:8808(应为 http),已删除。
2026-11-20 17:22:32 +08:00
Jidekin ebbe64ce61 chore: 隐藏项目地址 —— api.wangjinding.com 全部换成 127.0.0.1:8808
老板要求:官网和 git 上都不要出现 api.wangjinding.com。

前端(这次是根治)
  · SideNav 的 logo 下方、MainLayout 的副标题兜底:改成 location.host
    → 从哪个地址访问就显示哪个,截图走 127.0.0.1 时自然显示 127.0.0.1:8808
  · i18n 的「已连接 api.wangjinding.com」→「已连接」(不再拼域名)
  · dist 产物同步打补丁

配置
  · gateway.yaml 的 cors_origins 去掉公网域名(控制台与 API 同源,不受 CORS 影响)

文档与站点
  · README / CHANGELOG / docs 里的 https://api.wangjinding.com → http://127.0.0.1:8808
  · 站点终端示例同步

截图
  · 从 http://127.0.0.1:8808 重新截取 4 张,界面里显示的是 127.0.0.1:8808
  · 旧截图(含域名)已从 git 历史中彻底移除,不是覆盖

历史
  · 用 git filter-repo 把 api.wangjinding.com 从全部提交里抹掉
2026-11-20 17:19:30 +08:00
Jidekin d3d6424aca docs(site): 官网加 4 张管理台真实截图
老板要求:放几张真实截图,但不能有泄密数据。

截图来源
  · 用临时演示账号 demo 登录管理台,Playwright 逐页抓(2x 缩放,1440×900)
  · 抓完立刻删除该账号、清理它产生的对话历史,并验证登录已失效
  · 4 张:仪表盘 / 模型与供应商 / 指标与成本 / 对话(对话里发了一条真实提问)

为什么这几页安全
  · 仪表盘、模型、指标:只有模型名、供应商名、用量数字,没有 Key/IP/用户
  · 对话:模型名 + token 数 + 耗时 + 内容,没有身份信息
  · 避开:用户管理(真实用户名)、用户反馈(用户内容)、API 密钥(Key 值)、
    网关配置(内部地址与备注)

站点
  · 新增「这些都是真实界面」区块(2×2 网格,浏览器外框样式)
  · 导航加「管理台」
  · 图片压缩到 1600 宽 JPEG(105–137KB)
2026-11-20 17:12:19 +08:00
Jidekin 69f0039256 refactor!: 技术标识也全部换掉(logger / UA / 脚本 / 前端 / 文档)
老板要求:技术标识也要换,脚本啥的都换。

运行时
  · 所有 logging.getLogger("api-gateway…") → "xiaoyin-gateway…"(main/metrics/circuit/settings/sessions/users/gomodels/video_owners/adapters)
  · app/main.py 的上游 User-Agent 默认值 → xiaoyin-gateway/{VERSION}
  · data/gateway.yaml 里 opencode 的 UA 覆盖 → xiaoyin-gateway/2.4.0
  · run.py 启动横幅 → [xiaoyin-gateway]

脚本
  · scripts/sync_models.py、sync_onemin.py 的探测 UA
  · scripts/ci_check.sh 的横幅

前端
  · 配置备份文件的 kind: api-gateway-backup → xiaoyin-gateway-backup
    (导入逻辑本来就不校验 kind,旧备份照样能恢复)
  · dist 产物同步打补丁,不用重新 build

文档
  · README / CHANGELOG 里的服务名、`supervisorctl restart api-gateway:api-gateway_00` 等
  · 另一个技能 dsh-plugin-publish 的敏感词规则里也提到了旧名,一并更新

唯一没动的
  · .gitignore 里那行指向 /root/.trash/2026-09-13-api-gateway-cleanup 的注释 ——
    那是磁盘上真实存在的历史目录名,改了反而指错地方
2026-11-20 16:30:42 +08:00
Jidekin cc2d7bec5a refactor!: 全量改名 —— 仓库 / 目录 / 服务 / 文档 / 站点全部换成 xiaoyin-gateway
老板要求「全改」,所以这次不只是展示名:

仓库
  · Gitea  Jidekin/api-gateway      → Jidekin/xiaoyin-gateway
  · GitHub wangjinding/api-gateway   → wangjinding/xiaoyin-gateway
  · 本地 remote 两个都改了,ls-remote 验证可访问

本机
  · /root/dsh/projects/api-gateway → xiaoyin-gateway
  · /root/.venvs/api-gateway       → xiaoyin-gateway
  · supervisor [program:api-gateway] → [program:xiaoyin-gateway]
    (reread + update + 重启后 RUNNING,根接口正常返回 小银网关 2.9.16)

引用同步
  · security/uptime-check.sh、backup-app-data.sh、backup-restore-drill.sh 的路径
  · AGENTS.md、home-network.md(后者已同步思源)
  · README / CHANGELOG / docs / Makefile 提示语 / 前端包名 / 站点里的 git clone 地址

有意保留的两处
  · 前端备份数据的 kind: 'api-gateway-backup' —— 数据格式标识,改了旧备份认不出来
  · frontend/dist 里的同名常量(同上)
2026-11-20 16:07:31 +08:00
Jidekin c1f8882e9a fix(site): 管理台路径 /admin → /web;smoke_test 描述改名 2026-11-20 15:52:49 +08:00
Jidekin c176dd832b fix(site): 关于区块图标换成可渲染字形;补充 .env/Makefile/en.ts 的改名 2026-11-20 15:42:00 +08:00
Jidekin 04cfbc4876 feat!: 项目改名「小银网关」并上线官网 xywg.wangjinding.com
老板要求: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
2026-11-20 15:37:53 +08:00
Jidekin 9eb1c01b7b fix(models): 「Go 额度」列全空 —— goMeta 挂错数组(主表格绑的是 modelRows)
现象:列出来了、但每一格都是「—」。

根因:模型页有**两个**行数组——
  · `modelRows`(`{...m, key_set}`)—— 第 88 行 `<el-table :data="modelRows">` 真正绑的是它;
  · `textModelRows` —— 只用来数「全部文本模型」的条数、以及测速按钮的 id 列表。
我把 `goMeta: m.go || null` 只加在了后者,主表格的 row 上根本没有这个字段,
模板 `v-if="row.goMeta"` 永远为假 → 全部走「—」分支。

修复:把 goMeta 挂到 modelRows(并注释说明两个数组的分工,避免再踩)。
后端无需改动 —— 用临时实例(8899,隔离 users 文件)实测真实 HTTP:
  GET /v1/models → 200 / 28950B / 83 个模型 / 28 个带 go
  glm-5.3 → {'monthly_usage': {'go': 60, 'go-plus': 180, 'go-teams': 65},
             'training': False, 'zdr': True}
另外给 app/gomodels.py 补了日志(成功 INFO「已载入 N 个模型」/ 失败 WARNING 带异常),
以后这一列再空,看日志就能立刻区分「没拉到」还是「没渲染」。
2026-11-19 09:53:51 +08:00
Jidekin 61ddbb673e fix(config,test): 补 auth_fail_ban_seconds 进面板 + 测试与封禁互不干扰
上一轮「封禁列表」功能的两个收尾漏洞(跑测试时暴露):

1. 配置项漏搬面板:server.auth_fail_ban_seconds 在 yaml 与 config.py 里都有,
   但 settings.py 的 _SERVER_KEYS / config_to_view 没带上 → 面板保存一次配置
   就会把它写丢(回退默认 3600)。test_config_view_masks_secrets_and_roundtrips
   正是这道闸。
2. 测试被自己的封禁功能打红:测试会故意制造大量鉴权失败,而「鉴权失败自动封禁」
   会在同一进程内把 testclient 拉黑 60 分钟,导致后半场测试全变 429
   (test_disabled_flag... / test_download_rejects... 等)。测试启动时关掉封禁
   (只保留限流)并清空计数,生产逻辑不变。
3. 顺手更新过时样本:官方把 longcat-2.5-preview-free 改名成 longcat-2.5-free,
   免费模型测试的样本改成"现网确实免费的那几个之一",避免上游改名再把测试打红。

效果(tests/test_gateway.py 直跑):改动前 206 passed / 19 failed,
改动后 214 passed / 11 failed。剩余 11 个为既有失败(日志/账号/视频/CORS 等,
多为跨用例状态污染,单独复现 test_full_view_put_rewrites_nothing 为 0 差异),
不在本轮范围。
2026-11-19 08:23:15 +08:00
Jidekin 9b36374bfc feat(models): 前端展示 OpenCode Go 的月度额度与训练策略
老板要求:模型清单里能直接看到「这个模型每月能调多少」「是否拿你的代码训练」。

数据源:官方 models 接口(与 1.0.6 的同步修复同源,无需鉴权)
  go.monthly_usage = {go, go-plus, go-teams}   # 官方口径:只用这一个模型时各套餐每月额度
  go.training      = false                     # 是否用你的请求训练
  go.zdr           = true                      # 零数据保留

为什么不写进 gateway.yaml:这是上游随时会变的市场信息,不属于网关静态配置,
也不该让每日同步脚本再背一层 plan/落盘逻辑。改为后端按需拉取 + 6 小时缓存:

- app/gomodels.py(新增):拉取 + 缓存 + 失败保留旧值(5 分钟后重试),
  任何异常都不影响 /v1/models(最坏就是前端不显示这一列)。
- app/main.py:_models_payload() 拆成 base + 合并层。
  base 仍按配置 mtime 缓存;合并层再按 (base 对象, go 缓存时间戳) 缓存,
  两个都没变时返回同一个对象(保持原有缓存身份语义),任一变化自动重拼。
  别名条目不重复挂 go(额度/训练口径就是目标模型的,前端按 alias_of 取)。
- 前端 Models.vue:新增「Go 额度」列 —— 默认档额度(如 $100)+ 训练徽章
  (不训练=绿 / 会训练=红),悬浮显示三档明细与零数据保留说明;
  非 OpenCode 供应商显示「—」。
- locales:中英文各补 8 个键(check:i18n 通过)。

验证:直接调 _models_payload() —— 83 个模型里 28 个带 go 字段、其余为 None;
前端 vite build 通过;api-gateway 重启后 /healthz 200。
2026-11-19 08:23:15 +08:00
Jidekin 1ed82f6d73 feat(admin): 封禁列表管理页(/admin/banned + Banned.vue)
- 后端新增 8 个接口:GET/POST /admin/banned、PUT/DELETE /admin/banned/{ip}、
  GET /admin/banned/history、DELETE /admin/banned/history[/{hid}]、DELETE /admin/banned
- 配置新增 server.auth_fail_ban_seconds(默认 3600,0=只限流不拉黑):
  同一 IP 每分钟鉴权失败超限即自动封禁,被封期间该 IP 的 API 请求返回 429
- 前端新增「封禁列表」页(仅管理员可见)+ 中英文文案,
  支持单个解封 / 全部解封 / 删除历史记录 / 查看解封时间与剩余时长
2026-11-19 08:09:28 +08:00
Jidekin 8320258ff0 fix(sync): OpenCode 模型改用官方 models 接口,修复文档改版导致的连续两天 exit=2
官方把文档的 `## Endpoints` 表改成「看 console 页 / 用 models 接口」,
HTML 里不再有带 opencode.ai/ 地址的模型行,fetch_opencode() 的 <tr>/<td>
解析拿不到任何行 → 自动化日报「模型清单同步」整块失败:

  [2026-11-17 23:02:18] exit=2  RuntimeError: OpenCode 文档没解析出 Endpoints 表
  [2026-11-18 23:02:29] exit=2  同上

改为优先读官方 models 接口(实测无需鉴权):
  GET https://opencode.ai/inference/go/v1/models   (zen/go/v1/models 同源同内容)

每条自带 id/name/type/api{chat-completions,responses,messages,generate-content}/
recommended_api/limit{context,output}/cost.text.*.price/go.limited_regions,
据此推导协议线、免费标记与地区限制;HTML 表解析降级为兜底(接口不可用才走)。

首次落盘:
  - 删除 opencode/mimo-v2.5、mimo-v2.5-pro(上游已被 V2.6 取代)
  - 上下文 hy4-flash-free → 1048576/65536;qwen4-max → 1000000/262144
  - 跳过 gemini-4-argon(仅 generate-content)、beam-free 与 muse-spark-1.2/1.3(地区限制)

验证:落盘后 28 个模型、/healthz 200、hot_reload 自动生效未重启、重跑「无漂移」;
sync_onemin.py 同步通过(49 接口 / 43 配置 / 跳过重名 6)。

顺带把运行时的 data/ban_history.jsonl 加进 .gitignore(含被封 IP,属隐私)。
2026-11-19 08:09:28 +08:00
Jidekin b96d318e7a feat(provider): 接入 1min.AI(43 个模型)+ 独立同步脚本 + 「未监控」改「空闲」
老板:「查看 1min.ai 文档,把 1min 供应商加入 ai 网关项目里」。

### ① 新增 onemin 供应商
- base_url: https://api.1min.ai/openai/v1(OpenAI 兼容端点)
- 鉴权走 token_env: ONEMIN_API_KEY(不落明文,key 存 data/.env)
- 43 个模型,全部 chat/completions 单线
- **剔除 6 个与 opencode 重名的**(qwen3.7-plus / deepseek-v4-pro /
  glm-5.3 / glm-5.2 / gpt-5.6-luna / gpt-6-luna)—— 重名会让网关
  「按 id 调用始终命中先定义的那个」,把 opencode 的主路由抢走

### ② 新增 scripts/sync_onemin.py
独立同步脚本(不动 sync_models.py 的 3 家逻辑):
- 拉 GET /openai/v1/models(当前 49 个),与配置比对
- 新增补进配置、接口下线的删掉、**永远跳过与其他供应商重名的 id**
- 写盘走「备份 + 原子替换 + 回读校验」,校验不过自动还原
- 退出码:0 无变化/已同步 · 1 有漂移未写盘 · 2 抓取/写盘失败
- 已接入每日 05:00 的定时任务(步骤 1b)

### ③ 前端「未监控」→「空闲」
`circ_not_tracked` 的中文标签从「未监控」改成「空闲」,
英文从「Not monitored」改成「Idle」。

原因:熔断器是懒创建的 —— 供应商没被调用过就没有 breaker 实例,
`/health` 里 `circuit=not_tracked`。「未监控」听起来像监控坏了,
实际只是「还没被用过」。

### ④ .gitignore 补 *.bak-*
避免手工备份文件被误提交。

### 验证
- 直连 1min:GET /models → 200,49 个模型
- 经网关:/v1/models → 80 个(onemin 43 / opencode 26 / agnes 9 / dots 1)
- 实测调用 qwen3.7-flash / deepseek-flash 均正常返回
- 安全审查:12 类敏感模式(API Key / Token / 密码 / 私钥)0 命中
2026-11-01 23:01:54 +08:00
jidekin fd39929415 feat(ops+ui): WAF 自愈定时器 + 存活监控 + 恢复演练 + /metrics days 口径
- waf-whitelist-guard.sh + 每小时 timer:^/v1/ 规则被面板覆盖时自动补回并 reload
- uptime-check.sh 接入每日报告:本机/公网/4 台关键服务存活
- backup-restore-drill.sh 接入每日报告:解包校验 SQLite/JSON/权限
- /metrics 新增 days 参数;指标页加「今天/7天/30天/全部」切换
- docs/project-audit-2026-10-23.md:体检结论(含明确不做的项与理由)
- 版本 2.9.15 → 2.9.16
2026-10-23 16:51:28 +08:00
jidekin 1cf94dae7b feat(ops): 每日备份 + 每人 20 QPS + 调用日志体积上限/VACUUM
- 新增 backup-app-data.sh(VACUUM INTO 快照 + 配置/账号/会话/历史)+ dsh-gateway-backup.timer(每天 03:30,留 14 份)
- gateway.yaml: server.rate_limit_rps null → 20(按账号桶,实测 120 并发触发 55 个 429)
- calllog: CALLLOG_MAX_BYTES(2GiB) 按有效数据量精确收紧 + 按需 VACUUM(含 wal_checkpoint)
- 修:体积判断改用 (page_count-freelist)*page_size;VACUUM 后 checkpoint 才能真正缩文件
- 版本 2.9.14 → 2.9.15
2026-10-23 16:31:45 +08:00
jidekin 80bd551656 test: 修复 7 个失败用例 + 测试隔离(225/225 全绿)
- 新增 tests/conftest.py:CALLLOG_DB 指向临时目录 + 自动打开库(TestClient 不走 lifespan)
- 4 个 /logs 用例适配读库后的行为(断言前 flush;只看自己改为库里塞记录 + /logs/calls 断言)
- 夹具 grok-4.6 → grok-4.7(模型清单已同步)
- api_calls 增 video_id 列(自动迁移),/logs 映射补回该字段
- requirements-dev.txt(pytest);测试改为幂等
- 版本 2.9.13 → 2.9.14
2026-10-23 16:17:19 +08:00
jidekin a9a200bf9c feat(persist): 视频回调任务落库续跑 + /logs 改读库
- 新表 video_jobs:回调任务先落库再派生,结束标记 done/failed
- 启动时 pending_jobs() 续跑(6 小时内),provider 不存在/超时标记 failed/expired
- /logs 与 /logs/recent 共用 _recent_entries() 读库;删除遗留 _logs_for_account()
- 版本 2.9.12 → 2.9.13
2026-10-23 16:06:45 +08:00
jidekin 8e346161a6 feat(logs): 详情彻底不截断(捕获 4MiB / 入库 8MiB)+ 实时页按需取全文
- 请求体捕获上限 128KiB → 4MiB(CALLLOG_BODY_MAX);在途缓存条数 128 → 64 控内存
- 入库上限 256KiB → 8MiB(CALLLOG_CONTENT_MAX)
- 新增 GET /logs/entry/{id}:本人或管理员可取该条完整提示词/回复(实时页展开时调用)
- 实时列表仍给 8KB 预览 + body_len/resp_len,展开替换为全文并显示「完整 N 字」
- 实测 285KiB 提示词完整落库与返回
- 版本 2.9.11 → 2.9.12
2026-10-23 16:01:24 +08:00
jidekin f864dd33b5 fix(ui): 资产卡片模型名/日期分两行 + 命中率加口径说明
- Users.vue:模型名一行、日期一行(不再挤一起被省略),图像/视频共用
- 命中率(CallLogs 列表列 + Logs 实时 chip)加 hover 说明:
  首次请求/短提示词/前缀变化时命中率为 0 属正常
- 版本 2.9.10 → 2.9.11
2026-10-23 15:45:29 +08:00
jidekin fc176ae7bc fix(users): 资产卡片文字压叠 + 失效图片改为友好占位
- .asset-grid 由 flex(固定 150px) 改为 grid(minmax 170px),.asset-cell 加 min-width:0
- 缩略图 width:100% + aspect-ratio 4/3;元信息行加 ellipsis;下载按钮贴底
- el-image 加 #error 插槽:过期签名 CDN 链接显示「链接已失效」而非「加载失败」整块
- 版本 2.9.9 → 2.9.10
2026-10-23 15:41:52 +08:00
jidekin 49e69bf5ad feat(logs): 调用日志列表加「缓存命中」列(量 + 命中率)
数据本来就有(tok_cached/tok_prompt),只是列表没显示:命中率此前只在详情弹窗里。
- 列表新增列:命中量(k/M 缩写)+ 命中率%(按档位配色)
- 实测 107 条带 token 记录:命中 62 条,中位 83.9%,最高 99.7%
- 版本 2.9.8 → 2.9.9
2026-10-23 15:37:02 +08:00
jidekin 2b15db905b feat(logs): 视频轮询时间线落库(重启不丢)
- 新增 video_polls 表(video_id/ts/status/progress/ok/error/raw,索引 (video_id,ts))
- metrics.video_poll_push 同步落库(唯一写入点,同时保留内存态)
- _attach_polls 改为优先读库、回落内存;/logs/recent 补上 _attach_polls 调用
- 保留策略与 api_calls 共用 90 天
- 版本 2.9.7 → 2.9.8
2026-10-23 15:34:28 +08:00
jidekin f68aad743a feat(users): 移除用户管理里的「调用日志」页签(已有独立日志页)
- Users.vue 活动抽屉去掉 logs 页签与表格,默认停在「图像」;只拉 history/images|videos
- 删除后端 GET /auth/users/{username}/logs(唯一调用方即该页签)
- 移除 i18n users.tabLogs(zh/en)
- 版本 2.9.6 → 2.9.7
2026-10-23 15:31:34 +08:00
jidekin 018ba70d43 feat(logs): 实时日志改为读库,重启不丢
- 新增 GET /logs/recent?n=200(从 api_calls 取最近 N 条,形状与 /logs 条目一致)
- 权限口径不变:只看自己的(admin 也只看自己);看全站走 /logs/calls
- 前端实时页改调 /logs/recent,保留 5 秒自动刷新
- 修 query() 漏选 tok_* 四列导致实时页 token 显示为 0
- 版本 2.9.5 → 2.9.6
2026-10-23 15:28:09 +08:00
jidekin af2b9995c4 fix(calllog): 流式请求的请求内容为空(请求体被提前 pop)
_flush_calllog 原先无条件 BODY_BY_RID.pop(rid),但流式请求的访问日志条目
要等 SSE 发完才由 AccessLog.add 产生,中间件收尾在 SSE 开始前就 pop 走了请求体。
改为:流式只 peek(留给 AccessLog.add),非流式才 pop(早失败条目必须在此取走)。
版本 2.9.4 → 2.9.5
2026-10-23 15:22:18 +08:00
jidekin d2214bd355 feat(logs): 实时日志展开显示单笔 token 用量与缓存命中率
- calllog 新增 peek_tokens(rid):只读不消耗,供实时日志展示(落库仍由 _row pop)
- AccessLog.add 把 token 挂到条目 tokens 字段
- 实时日志展开新增「Token 用量」块:输入/输出/缓存命中/推理 + 命中率(cached÷prompt)
- 调用日志详情弹窗补同样一行 token(数据取自 tok_* 列)
- 版本 2.9.3 → 2.9.4
2026-10-23 15:19:39 +08:00
jidekin fdeeee5066 chore(sync): 2026-10-23 模型清单同步(minimax-m3.1-flash-free → minimax-m3.1-flash)
scripts/sync_models.py 每日同步产物:官方文档把免费版 id 去掉了 -free 后缀,
按官方最新清单更新。
2026-10-23 13:42:22 +08:00
jidekin e8a2d71d8e style(calllog): 详情弹窗固定高度,内容区内部滚动
- 弹窗 height: min(78vh,860px),el-dialog__body overflow:hidden(弹窗自身不出滚动条)
- 内容/提示词/回复三块 flex 等分剩余高度,各自 overflow:auto 内部滚动
- 原 max-height:460px 改为 none,min-height:90px 兜底
- el-dialog teleport 到 body,故用非 scoped 全局样式块(选择器挂在 .calllog-dlg 下)
- 版本 2.9.2 → 2.9.3
2026-10-23 13:38:28 +08:00
jidekin 8e23a5ed1b feat(calllog): 详情不截断记录(捕获/清洗/入库三处上限全部放开)
- 请求体捕获 8000 → 128KiB(_CONTENT_MAX,可用 CALLLOG_BODY_MAX 调)
- 回复文本改用新增的 _content():128KiB 且保留换行/制表(_logsafe 会把换行压成 ?)
- 入库上限 CALLLOG_CONTENT_MAX 默认 8000 → 256KiB(实际等于不截断)
- 详情新增 prompt_full(完整提取内容,保留换行),与原始 JSON 并列展示
- BODY_BY_RID 有界 128 条,防止宽上限下内存膨胀
- 版本 2.9.1 → 2.9.2
2026-10-23 11:36:26 +08:00
jidekin 6b3607c35f feat(calllog): 列表加「内容」列,显示请求体 messages 的 content
- 新增 prompt_preview():抽取用户实际输入(兼容 chat/responses/messages 三种格式)
- 列表返回 prompt_text(单行/240字),不再吐原文;详情也带 prompt_text
- 前端:模型列后新增「内容」列 + 详情弹窗「内容」块
- 版本 2.9.0 → 2.9.1
2026-10-23 11:32:37 +08:00
jidekin 9ddd2fb16b chore(metrics): 补提交 RID contextvar(2.9.0 的 token 侧信道依赖它)
上一个提交漏了本文件:main.py 的 RID.set(rid) 与 calllog.note_tokens 都依赖
app/metrics.py 里新加的 RID ContextVar,不同步提交会导致仓库检出后无法启动。
2026-10-23 11:29:06 +08:00
jidekin 3af915910c feat(metrics): 指标改由 SQLite 提供(重启不清零)+ 月度用量导出
- 新增 _usage_snapshot():调用数/供应商/token/耗时(p50,p95) 走 api_calls 聚合,
  运行时长/在途/熔断仍取内存;库不可用自动回落内存态
- 影响 /metrics、/metrics/prometheus、/health.models;口径从「启动以来」变「最近 90 天」
- token 落库:表加 4 列(老库自动 ALTER),用 rid contextvar + token 侧信道关联
- 新增 /logs/usage/monthly 与 /logs/usage/monthly/export(仅管理员)+ 前端月度用量弹窗
- 模型统计排除无模型行(匿名早失败不再显示 ?)
- 版本 2.8.0 → 2.9.0
2026-10-23 11:28:53 +08:00
jidekin e1e7fc2566 fix(calllog): 翻译键移回顶层 + 内容上限 2000→8000
- calllogs.* 的 i18n 段此前被插进 upload 段内部,导致新面板全部显示原始键名;
  已移到 logs 之后作为顶层键,zh/en 结构复核一致
- 请求体摘要 raw[:2000]→8000、回复文本 _logsafe(...,2000)→8000(5 处),
  实测 6000 字提示词可完整落库
2026-10-23 11:24:19 +08:00
jidekin 2c53504ad4 feat(calllog): 调用日志落地(SQLite / 90 天 / 管理员可查全部)
- app/calllog.py:SQLite 表 api_calls(21 列,含提示词与回复)+ 异步批量写 + 双向握手
  (流式请求的访问日志条目比响应晚到也能落库)+ 早失败补记 + 失败也记 Key 前 8 位
- 新增 4 个仅管理员端点:/logs/calls、/logs/calls/stats、/logs/calls/{id}、/logs/calls/export
- 前端:日志页新增「实时 / 调用日志」页签,新组件 CallLogs.vue(筛选/分页/详情/CSV 导出)
- 保留 90 天;队列满丢弃计数,不反压请求;零新依赖
- docs:新增 docs/call-log-design.md(方案对比与三个关键设计)
- 版本 2.7.3 → 2.8.0
2026-10-23 10:02:07 +08:00
jidekin 19224f1993 fix(security): 成员不再读到全站用量(/health 按角色分流)+ WAF 放行 /v1/
- /health: 非 admin 只回运行态(status/version/uptime/in_flight/in_flight_peak/providers 名称与模型数);
  全局 tokens、各模型全局调用/失败率、供应商熔断状态收口到管理员
- /metrics: 明确保留按账号聚合(老板口径:成员首页要看自己的调用次数),未收成仅管理员
- docs: 新增 docs/waf-api-access.md,沉淀 AI 编程客户端被 1Panel WAF 误杀 403 的根因/修复/排查
- CHANGELOG: 记录本次工单全过程
- 版本 2.7.2 → 2.7.3
2026-10-22 19:41:05 +08:00
Jidekin 1576162ecc chore(sync): 2026-10-21 二次同步(剔除 3 个地区受限模型)
opencode 28 → 25:-beam-free -muse-spark-1.3-contributor -muse-spark-1.2-contributor
补上下文窗口:minimax-m3.1-flash-free 1M/512K、step-5-preview 1M/64K、agnes-2.5-pro-beta 1M/64K
热重载 10:46:23 已生效。
2026-10-21 10:46:56 +08:00
Jidekin 7d0561da78 fix(sync): 中国大陆地区受限的 OpenCode 模型不再同步进网关
文档 Go 页脚注写明了地区限制,之前只解析表格、把脚注漏了:
  Beam Free: Not available in ... China (including Hong Kong and Macau) ...
  Muse Spark 1.x Contributor: ... regions permitted by Meta's Geographic Use Policy
本机出口在中国大陆,实测 beam-free / muse-spark-1.3 / muse-spark-1.2 在
zen 与 inference 两条端点均 403 RegionError「This model is not available in
your country」(同批 minimax-m3.1-flash-free / step-5-preview 均 200)。

新增 OC_REGION_BLOCKED 名单:同步时跳过(不新增;网关里已有的按已下线删除),
并在报告里单列「跳过(对中国大陆出口不可用,RegionError)」。
以后换境外出口或文档解除限制,把 id 从名单移走即可恢复。
2026-10-21 10:46:56 +08:00
Jidekin 73aed4ff22 chore(sync): 2026-10-21 模型清单同步(+4 / -7)
opencode: +beam-free +minimax-m3.1-flash-free +step-5-preview
          -deepseek-v4-flash -deepseek-v4-flash-vision-exp -grok-4.6
          -kimi-k2.6 -minimax-m2.7 -space-bunny -step-5-preview-free
agnes:    +agnes-2.5-pro-beta(¥3/¥6)
重新适配文档后首次落盘,热重载已生效。
2026-10-21 10:26:51 +08:00
Jidekin c2e1226836 fix(sync): 适配 OpenCode 文档改版(Endpoints 改为 /inference/go/<vendor>/v1/)
文档 Endpoints 表地址从 https://opencode.ai/zen/go/v1/<path> 改为按供应商分线:
  /inference/go/openai/v1/{chat/completions,responses}
  /inference/go/anthropic/v1/messages
  /inference/go/google/...(Google 原生,网关不支持)
旧的 "/zen/go/v1/" 硬匹配导致一个模型都解析不出,每日同步固定 exit 2。
改为按路径末尾识别三条协议线(新旧格式都兼容),认不出的跳过并在报告里单列。
2026-10-21 10:26:51 +08:00
Jidekin db0a73031f chore(frontend): package-lock 去掉腾讯云内网镜像源,改用官方源
194 处 resolved 指向 http://mirrors.tencentyun.com/npm/(腾讯云内网地址,
仅腾讯云机器可达)。在非腾讯云环境 npm ci 会直接失败:
  npm error network request to http://mirrors.tencentyun.com/npm/... failed,
  reason: getaddrinfo ENOTFOUND mirrors.tencentyun.com

改为 https://registry.npmjs.org/ —— 只换 URL,依赖版本与 integrity 哈希完全不变。
本机另配 registry=npmmirror + replace-registry-host=always,安装时自动走国内镜像。
实测:删掉 node_modules 后 npm ci 12.5s 通过,npm run build 28.7s 通过。
2026-10-16 16:06:40 +08:00
api-gateway f7a94d0116 docs(cleanup): 历史条目里的旧托管字样一并清掉
老板「全清」:CHANGELOG 里的历史提及(如「已推 CNB <sha>」「立『上生产必推 CNB』规则」)全部改写/去除,
不再保留。纯文档改动,未升版本号。
2026-10-12 14:46:40 +08:00
api-gateway b922b21b3f chore(cleanup): 清除 CNB 残留(远端 / 脚本 / 文档)
老板:「CNB 的都删了,代码,文档相关的都去掉」。

- scripts/push_cnb.sh 移除(归档 /root/.trash/2026-10-12-cnb-retire-cleanup/ + MANIFEST)
- scripts/push_gitea.sh 注释去掉 CNB 表述
- README 发布纪律段、docs/agents-dev-plan.md 的 CNB 表述改 Gitea
- 历史条目(CHANGELOG/MEMORY/日记)保留不改写;纯文档/配置清理,未升版本号
2026-10-12 14:35:10 +08:00
api-gateway d53b296e43 chore(branch): 分支统一为 main(master 改名 main)
老板:「统一成 main,都默认 main 分支」。

- 本地 git branch -m master main;本机 git config --global init.defaultBranch main
- README 发布纪律段分支名同步改 main(历史 CHANGELOG 条目保留 master 原文)
- CHANGELOG 记本轮;纯文档/分支名改动,未升版本号
2026-10-12 14:26:19 +08:00
api-gateway 8e4208c09a chore(release): Gitea 推送改为免密(建 API token push-automation)
老板:「新建凭据吧,把凭据记到记忆和 md 文件里,不要丢失了,后面直接免密推送」。

- 新建 Gitea API token(name=push-automation,scope=write:repository,够 push 私有仓库)
- scripts/push_gitea.sh 改为默认免密:凭据顺序 GITEA_TOKEN → 参数 → GITEA_PASS → ~/.gitea_token(600)
- 安全口径不变:一次性内嵌、输出打码、不写 .git/config、推完核对远端=本地并复查无明文(退出码 2/3/4/5)
- 凭据只落本机两处(~/.gitea_token + MEMORY.md),**不写进本仓库任何文件**
- README 发布纪律段与 CHANGELOG 同步说明
2026-10-12 14:17:50 +08:00
api-gateway 64982e95e1 docs+tooling: 代码托管改推自建 Gitea(CNB 退役,老板 2026-10-12 改口径)
老板原话:「以后改动的代码不提交 cnb 了,改成提交到 gitea 上」→ 推翻 2026-09-24 的「上生产必推 CNB」。

- 新增 scripts/push_gitea.sh:与 push_cnb.sh 同一套安全口径(一次性带密码内嵌 URL;
  无密码退 2 / 工作区脏退 3 / 推完核对远端=本地 / 复查 .git/config 无明文;密码不内置进任何文件),
  目标换成 https://git.wangjinding.com/Jidekin/api-gateway.git
- scripts/push_cnb.sh 保留但**已停用**(文件头加醒目说明)
- README「版本号与发布纪律 → 发布流程」:推 CNB → 推 Gitea,并写明原 CNB 口径作废
- CHANGELOG 记本轮

背景:CNB 那把 token 已实测失效(push/ls-remote 回 Repository Not Found、API 回 errcode:16 not logged in、
SSH 22 端口超时);同期老板起了自建 Gitea(容器 1Panel-gitea-CjQz,commitgo/gitea-ee:27.3.8,
公网 https://git.wangjinding.com),三个项目已建 private 仓库并推全量历史。

注:纯文档/工具改动,**未升版本号**(与 3a118c2「立推 CNB 规则」同类,历史先例同样不升)。
2026-10-12 14:13:25 +08:00
api-gateway 48f19a0386 feat(models): 单独测速改并发(每行独立、上限 3)+ 收尾每日同步漂移(2.7.1 → 2.7.2)
老板:「单独测速能异步测速不,不用等到上一个回来后才能测速其他的」

- 单独测速(每行常驻 ⚡)改为**并发**:状态从单个 latCurrentId 换成 latRunning 集合,
  每行自己的加载图标与按钮状态、互不阻塞;并发上限 SPEEDTEST_MAX_CONCURRENCY=3,
  到上限按钮置灰并在悬浮里说明「同时最多测 3 个,等一个回来再点」。
- 一键测速**保持串行**(老板定的口味:测一个显示一个;且并发会把免费额度瞬间打满 → 上游 429
  会把结果刷成一片失败)。整轮在跑时单测按钮禁用;有单测在飞时一键测速按钮禁用(互斥)。
- 抽 probeOne() 共用「一次探针 = 一个模型」的取数与出错处理(整轮 / 单测同一份逻辑)。
- i18n 新增 models.testOneRunning / models.testOneBusy(中英对称 751/751),
  speedtestHint 补「每行 ⚡ 单测可同时跑 {n} 个」。后端零改动(该端点本就是 async)。

收尾(每日同步 10-07~10-10 落盘的漂移,一直未入库):
- data/gateway.yaml:space-bunny-free → space-bunny(官方改名并转收费 $0.15/$0.60)、
  新增 space-bunny / claude-haiku-5-5 / step-5-preview-free,opencode 30 → 32 个模型。
- tests:test_models_payload_marks_free_models 样本 space-bunny-free → longcat-2.5-preview-free
  (否则该用例因配置漂移假红);app/config.py 注释同步。

验证:单测 225 passed / 0 failed、ci_check.sh 六门禁全绿;线上真机实测——同时点 3 行 ⚡
(agnes-3.0-flash / deepseek-v4.1-flash / dots3-note-prev)3 行**同时**转圈、各自独立回
621/1662/951 ms,第 4 行按钮置灰(悬浮=上限提示),一键测速按钮同时置灰;三个回来后
按钮全部恢复、未测的行仍为「—」;一键测速仍串行(全程 1 个转圈)、36/36 行填满
(4 行失败为上游真实原因:1 超时 + 2 DataPolicyError + 1 Endpoint unavailable)。
2026-10-12 13:44:26 +08:00
api-gateway 33d79194b8 feat(ui): 界面提示白话化 + 清理未引用的死键(版本 2.7.0 → 2.7.1)
老板要求「检查所有界面提示,客户不需要知道的不用提示」,
二次确认口径:普通成员看不到内部实现;术语要换成大白话
(「管理员也不懂熔断器是啥」)。

- 熔断术语白话化:熔断器/熔断状态 → 「供应商自动保护」;
  CLOSED/HALF_OPEN/OPEN → 「正常 / 恢复中 / 已暂停」;
  探测中 → 「检测中」;熔断冷却 → 「暂停时长」;窗口/阈值 → 「统计次数/触发次数」
  (指标页、仪表盘、API 文档端点说明)
- 智能体页去内部实现暴露:
  · 删掉 cfgWorkspace 整行(原显示内部 agent_id)
  · cfgEngine 值由「qwenpaw · https://...」改为文案「由平台提供」
  · 引擎就绪/不可达 → 「可用/暂不可用」;引擎连接中断 → 「连接中断」
  · slug → 「标识」;“显示名与 slug 可改” → “显示名与标识可改”
  · 去掉"在服务器上"等部署细节措辞
- 其它白话化:in-flight → “当前并发”;「开始与网关对话」→「开始对话」;
  “参数由网关固定/上游硬约束” → “参数已固定”;
  “上游一次只出 1 张/上游没有返回图片” → 去"上游"措辞;
  “下载走网关代拉” → “下载更省心”;“协议线” → “格式”
- 保留(老板确认):API 文档页的技术契约(Bearer/400/路径格式名)、
  配置页的文件名与变量名(gateway.yaml/.env/token_env)
- 删除 120 个未被引用的死键(gc 段早期表格化编辑设计残留:
  f_*/h_*/circuit/tab*/pKey 等,页面只用 YAML 编辑器与 env 两块)
  及 subHint(暴露引擎名+内部 URL 的孤儿键)

i18n 869 → 749 键(中英对称)。ci_check.sh 六道门禁全绿。
2026-09-30 15:26:12 +08:00
api-gateway 69f7175424 feat(providers): 按老板要求整个删除「火山方舟 Coding Plan」供应商(版本 2.6.1 → 2.7.0)
火山方舟 Coding Plan 已停止(后续不可用),涉及的全部清除:

- data/gateway.yaml:删 providers.volc_engine 整块、pricing 里的
  ark-code-latest、头部/协议线/下载白名单相关注释
- .env / data/.env / .env.example:删 VOLC_API_KEY(顺带清 .env 里
  遗留的 B_AI_API_KEY 空变量)
- app/main.py:FastAPI description、注释去火山(版本 2.6.1 → 2.7.0)
- app/config.py / settings.py / adapters/{__init__,openai_compat}.py:注释去火山
- frontend/src/views/Settings.vue:对话默认模型下拉删 ark-code-latest
- README.md / docs/frontend-design.md:供应商表、价格表、活体检查等去火山
- design/v1/board.html、design/v3/agents.py:设计稿演示数据换掉火山
- tests/test_gateway.py:改写配置用例的样本改用 agnes/opencode;
  保留「已删模型不该残留」的回归护栏

删除(老板确认不保留):
- /root/api-gateway/ 旧副本(非运行目录)
- data/*.bak 7 个历史配置备份
- design/design/v2/ 过时设计稿(含 b.ai/智谱/火山演示数据)

验证:单测 225 passed / 0 failed;ci_check.sh 六道门禁全绿;
已重启上线(pid 1704259),/v1/models 供应商仅 agnes/opencode/dots、无 ark-code。
CHANGELOG 历史条目(真实变更记录)保留。
2026-09-30 15:13:50 +08:00
api-gateway 8a773b8ab3 style(agents): 模型切换挪到对话框左下角 + 去掉所有 QwenPaw 外链与内部提示(版本 2.6.0 → 2.6.1)
老板三条要求:①模型切换放对话框左下角,不用去配置页;②去掉所有「打开 QwenPaw」
外链;③客户不需要知道的提示(如「提示词归 QwenPaw 管」)全去掉。

- 切换器移入输入区左下角(原静态模型名位置):紧凑 .model-inline 样式、
  可搜索、按供应商分组 + 视觉标;进页面即 loadEngineModels(),展开时兜底刷新
- 配置页模型栏改只读展示 + 一行「在对话框左下角切换」指引
- 删除 qwenpawUrl 计算属性 + 3 处 QwenPaw 外链
- i18n 删 14 个内部/面向 QwenPaw 的键(整键删,不留空串——体检器不允许空文案),
  并改写 sub/subagents/engineBadge/engineDownHint/cfgSlugHint/cfgSuffixHint/
  sharedNote/listFootHint 为客户视角措辞;中英 869/869 对称
- 纯前端改动(后端端点与测试未变,224 passed)

验收:线上实测左下角下拉显示 wjd → 切 deepseek-v4-pro 生效并落盘 → 已恢复 wjd;
配置页截图确认无任何 QwenPaw 字样;重启网关不会回退模型(已实测)。
2026-09-30 14:51:04 +08:00
api-gateway 678b984b95 feat(agents): 模型改为页面可选(方案 A)+ 修引擎模型读不到的静默 bug(版本 2.5.4 → 2.6.0)
推翻旧结论:模型不是全局唯一,而是每个 profile 各存一份 active_model
(PUT /api/models/active scope=agent → workspaces/<profile>/agent.json),
改完即时生效不用重启 —— 实测切模型后真对话 turn_usage 的 model_name 确实变了。

真 bug:refresh_engine_live() 读的是 /api/providers/active,那条是 404,
异常被吞 → engine_live['model'] 恒为空串 → 配置页模型栏一直显示「—」。
改用 ACTIVE_MODEL_PATH=/api/models/active + get_active_model()。

新增:
- 适配器 get_active_model / set_active_model(4xx 抛 EngineError 并透传引擎原文)
- GET /agents/engine/models(只列真能用的;实时 current,不走 TTL 缓存)
- PUT /agents/engine/model(带防自指护栏,不得指向 agent/*)
- 前端配置页模型栏:只读 → 可搜索下拉(按供应商分组 + 视觉标)+ 刷新;失败回滚
- i18n 删过期键、加 5 新键(中英 883/883 对称)
- 测试 +5(端点/路径常量回归/body 与头/4xx 抛错/防自指),224 passed

语义:方案 A = 所有智能体共用这一个模型(一个 profile 一个 active_model),
做不到 A 用 flash 且 B 用 pro 并存;那需方案 B(一智能体一 profile)。
2026-09-30 14:40:58 +08:00
api-gateway a92fc3c788 style(agents): 对话与配置两个 Tab 内容间距放宽 + 补缺失的 --gap-xs(版本 2.5.3 → 2.5.4)
- style.css 补上缺失的 --gap-xs: 6px(Agents.vue 早已引用但全局未定义,两处 margin 静默失效)
- 对话:.conv 行距/padding 放宽、.chat-main 补 gap、composer .bar 顶距语义化、trace/step 放宽
- 配置:.frow 行距 8→14px、.f-val padding 8px、.f-hint 行高 1.65、.cfg-grid .card-h 补底距、.row-actions 顶距
- 列表/头部:.ag padding 11px、.ag-list gap 4px、.ag-tabs padding 8px
- .ops-row:empty { display:none } 去掉不流式时的幽灵行
- vite.config.ts 补 /agents dev 代理
- 量测验收:frow 行距 28→30、行间 8→14;conv 高 65→68;页面无横向溢出
- ci_check.sh 六道门禁全绿
2026-09-30 14:07:23 +08:00
api-gateway 66f548586e style(agents): 修 KPI 与下方块 0 间距 + 左右两栏恢复等高(版本 2.5.2 → 2.5.3)
老板圈红框指出 KPI 卡与下面内容之间空得太明显。先量后改,定位到两个叠加根因:

1. KPI 与下方块间距 = 0(kpis.bottom=219 == ag-layout.y=219,两排卡紧贴)
2. .ag-layout 被 min-height: calc(100vh - 300px) 撑到 733px,而左列表卡内容
   只有 ~150px → 卡下方 580px 空白

改法:
- .ag-kpis 加 margin-bottom: var(--gap-lg) → KPI 与下方 14px
- 去掉 .ag-layout 的 min-height 撑高;左卡改 align-self:stretch + 内部列表
  flex:1 滚动,不再单独设高度上限

验收实测:row-h 78→102 / 14px / kpis 116→219 / 14px / ag-layout 233→966,
左列表卡与右详情均 233→966 (h=733) 完全齐平。

测试 219 全过;ci_check 全绿。
2026-09-30 11:31:58 +08:00
api-gateway 733c8593d4 style(agents): 智能体页间距与对齐优化(版本 2.5.1 → 2.5.2)
老板反馈「智能体的界面不是很美观,优化下,特别是间距和对齐地方」。

先量后改 —— 用 Playwright 读实际布局矩形定位,修完再量验收。

修复前实测到的 6 个问题:
1. 左右两栏底部差一截(左卡 h=149 vs 右卡 h=492)
2. 卡片套卡片(详情区外层是 .card,内部对话区又各有 .card)
3. KPI 注脚基线不齐(第1张两行、其余一行)
4. 对话区左栏独立色块错位(自带底色+圆角,与主区对不上)
5. 左栏卡标题被挤成两行(「智能 体」)
6. 页面底部大空白(内容未撑满视口)

改法:
- 左卡 align-self:stretch + 内部列表 flex:1 滚动 → 两卡 y=219/bottom=952 齐平
- 详情区去掉外层 .card,身份条+Tab 合成「头部卡」;对话区整体一张卡,
  左栏改 border-right 分隔线
- KPI 注脚 margin-top:auto + nowrap + 省略号 → 四张注脚 y 全为 182
- 列表卡标题独占一行;底部加共用引擎的说明引导
- .ag-layout 加 min-height: calc(100vh - 300px) 撑满视口

验收:listCard.bottom == chat.bottom == 952;四张 KPI 注脚 y 一致;无 JS 错误。
测试 219 全过;ci_check 全绿。
2026-09-29 14:28:37 +08:00
api-gateway c62be67aa8 feat(agents): 图片附件 + 修两个真 bug(版本 2.5.0 → 2.5.1)
老板要求「图片附件功能加上,其他的先不做」。

QwenPaw 侧格式(实测确认后再动手):{"type":"image","image_url":"<data-URI>"
—— 塞纯红 64×64 PNG 的 data URI,模型正确答出「红色」。

改动:
- app/adapters/qwenpaw_engine.py:放行图片内容块,并同时支持两种写法 ——
  AgentScope 原生 image 与 OpenAI 风格 image_url(前端发的是后者);
  新增 _image_url();缺 url 的块跳过;audio/video/file 仍忽略
- views/Agents.vue:对话输入区加附件按钮(pickImage 复用现有浏览器内压缩,最多 4 张)
  + 待发缩略图可删 + 消息气泡内渲染图片;允许「只发图不带字」
- lib/agents.ts:content 放宽为 string | any[]
- i18n 新增 4 键,中英对称 879/879

修掉两个真 bug(本轮才暴露):
1. image_url 写法被忽略 —— 分支只认 type=="image",而前端发 image_url
   → 图片会静默丢失(功能等于没做)。测试用例抓出来的。
2. /agents/{slug}/chat 500 —— 上轮加计量打标时 log.info(..., rounds) 写在
   rounds = ... 之前,UnboundLocalError → 端点 500。已加回归用例
   test_agent_chat_endpoint_source_order 固化(这类声明顺序错误跑不出来)。

上线实测:两张图(红+蓝)→ 模型答「红色,蓝色」顺序正确,system_suffix 同时生效,
usage wjd/24112 tokens/缓存 2048;浏览器路径也验证过(上传→缩略图→发送→渲染→无 JS 错误)。

已知引擎侧行为(非网关问题):QwenPaw SSE 只有 text 事件、无独立 reasoning 通道,
模型有时把思考写进正文;且上下文会污染视觉判断(同图脏上下文答「白色」、干净会话答「蓝色」)。

测试 218 → 219 全过。
2026-09-29 14:00:49 +08:00
api-gateway c0706d1846 feat(agents): 新增「智能体」功能模块(路线 A)+ 版本 2.5.0
老板要求「在 ai 网关里做智能体 agent,新的一个菜单」,一期仅管理员、成熟后下发。
完整设计(27 条决策,4 轮评审)见 docs/agents-dev-plan.md。

架构(路线 A):界面与权限在网关,执行在 QwenPaw(独立 profile ai-gateway)。
网关当门面(鉴权/计量/灰度/审计),引擎提供工具能力(文件/命令/浏览器)。

Step -1 技术验证(实测,全部改变或确认了设计):
- 请求级指定模型【无效】:传 model 被忽略,turn_usage 回 provider_id=opencode、
  model_name=deepseek-v4.1-flash;AgentRequest 无 model 字段。模型是 profile 级。
  → 甲案:所有智能体共用 ai-gateway 一个 profile ⇒ 共用同一模型,配置页模型栏只读。
- role:"system"【被接受且生效】:塞入「只用英文回答」后模型真的用英文
  → params.system_suffix 走注入 system 消息。
- SSE 事件谱已录制 → tests/fixtures/sse-tool-flow.sse + docs/qwenpaw-agent-api-sse.md

后端:
- app/agents.py:AgentStore(data/agents.yaml,600/原子写/mtime 热载)+ 严格校验
  (slug 三重查重:模型 id/别名/QwenPaw profile;params 4 键白名单;suffix 限长 2000;
   max_agents=5 软上限,归档不计入;restore 可恢复)
- app/adapters/qwenpaw_engine.py:OpenAI 形状 ↔ AgentScope Agent API + SSE 翻译器
  (text 累积、delta:false 快照忽略、plugin_call→轨迹、call_id 配对 output、turn_usage→计量)
- app/agents_routes.py:GET/POST/PUT/DELETE /agents、/restore、/chat(SSE)、/stop、
  /runs、/sessions、/test + 新增 GET /auth/me(灰度通道,features.agents 后端权威);
  权限唯一入口 can_use_agent();防自指(引擎模型不得指向 agent/*)
- app/history.py:会话类别扩展支持 agent_<slug>(复用现有存储)
- data/agents.yaml(配置,入库);data/agent_runs.json(运行时,gitignore)

前端:
- views/Agents.vue(列表 + 对话/配置/运行记录)+ lib/agents.ts(SSE 解析)
- 菜单核心组第 5 位 + 图标 bot;router meta.admin 双层守卫;i18n 中英对称 871/871

上线实测:真实对话跑通 —— 让智能体 read_file 读 /etc/hostname,前端正确显示
「执行了 1 步」+ 工具参数、正文、计量(wjd · 47196 tokens · 缓存 13696)、终态;
引擎调用经 wangjinding 过网关(计量闭环)。

测试 209 → 217 全过(新增 8 条,含用真实夹具验证 SSE 翻译器);ci_check 全绿。
2026-09-29 13:22:12 +08:00
api-gateway 4c04a5ed0e 样式规范统一:版本 2.4.0→2.4.1 + 页面四周等距 + 间距走令牌
前端间距(老板反馈「卡片上下左右间距不一样」):
- .page / .page-fill 由 (上下≠左右)改为 var(--pad-page)=四周 16px;
  窄屏 12px 14px → 四周 12px
- 新增间距阶梯令牌 --pad-page / --gap-lg / --gap-sm;grid2/grid3/grid-eq/kpis/set-grid/
  m-grid 的 gap 统一走 --gap-lg;窄屏 kpis 10px → var(--gap-sm)
- 新增 .page-col > * + * 通用规则:纵向堆叠的卡片自动有间距

版本号纪律(老板 2026-09-29 立):
- VERSION 2.4.0 → 2.4.1,README 新增「版本号与发布纪律」专章(含每次改动都要加版本号、
  唯一权威定义处为 main.py 的 VERSION、发布流程、上生产必推 CNB)

其他:
- .gitignore 新增 design/ 规则(设计稿脚本与 PNG 约 11MB,历史上从未入库,保持不入库)
- docs/agents-dev-plan.md 智能体功能开发计划(27 条决策,待开工)
2026-09-29 12:08:04 +08:00
api-gateway 3993df5f4f Dots AI 纳入每日模型清单同步
老板要求:「把 https://dots.ai/platform/docs 加入每日定时任务的同步任务来」。

这条源和另两家不同:dots 文档页是 **SPA**,正文(模型定价表、上下文窗口、「免费体验」说明)
**不在 HTML 里**,而是随前端 JS chunk 发布(实测在 assets/ApiDocsPage-*.js,chunk 名带 hash、
发版就变)→ 抓取走两步发现:文档页 → 主包 index-*.js → ApiDocsPage-*.js → 取该 chunk。

同步三项:
- 模型清单:取自定价表行 {model:"…",input:"$…",output:"$…"}(按出现次数全收,加模型不用改代码);
- 免费状态:取「免费体验」横幅 —— **它是"当前免费试用"**(原文:恢复收费前会提前告知),
  横幅在=free:true、横幅没了=按报价收费 → 落盘改 false(试用结束会在每日报告里现形);
- 上下文窗口:正文「…上限为 524,288 Token」。
- **不写定价**:文档报价是 USD/M,网关 pricing 是 ¥/M → 换算要汇率、不能猜,只列在报告里给人看。

健壮性:这条链路最脆(SPA + hash chunk),故**失败不致命** —— main() 单独兜住,失败置空、
跳过 Dots 比对并在报告里写「⚠ 文档抓取失败」,另两家照常;解析不出模型则抛错交给这层兜。

顺带修:_set_free() 幂等 —— 同一条同步说明不重复追加(原先重复应用同一 plan 会把注释滚成
「原注释;说明;说明」;不同日期的说明仍各记一条=变更历史)。

验证:
- 干跑(真实配置):三家「无漂移 ✓」,Dots 段带报价行,plan_is_empty → 「无需落盘」;
  实测 --apply 也是「无需落盘:网关已与文档一致 ✓」;
- 造副本模拟漂移(free=false/context=131072):两处漂移都报出 + 两条落盘动作 → --apply 写盘成功、
  回读校验过、复跑无漂移(幂等);
- 新增测试「Dots 抓取口径 + 漂移识别 + 落盘幂等」→ 208 → 209 全过。

cron 任务 d83693fc-… 同步更新:名称改为「模型清单每日同步(OpenCode Go + Agnes + Dots → ai 网关)」,
提示词加第三家来源 + 「Dots 抓取失败不致命、照实带出来」,并要求带出 Dots 报价行、
「受保护不删」段与视频默认模型标记。
2026-09-29 10:00:30 +08:00
api-gateway 15a1c13711 接入 Dots AI(小红书)+ 新增 api-key 鉴权样式
老板要求:「查看 https://dots.ai/platform/docs 文档,帮我在 ai 网关上配置 dots.ai 的
供应商」(API Key 由老板提供,落 data/.env,不入库、不写进任何提交内容)。

文档要点(通读):base https://note3-prev-api.askdiandian.com/v1;两条线
POST /v1/chat/completions(OpenAI 兼容)与 POST /v1/messages(Anthropic 兼容,需固定头
anthropic-version: 2023-06-01);**认证是自定义头 `api-key: <KEY>`**(既不是 Bearer 也不是
x-api-key);模型 dots3-note-prev 上下文窗口 512K(524,288)、当前免费体验;
官方限流按单个 Key 计 60 次/分钟、1,500,000 Tokens/分钟。

改动:
- 新增鉴权样式 `api-key`(AUTH_STYLES 由 bearer/x-api-key/none 扩为四种):适配器
  auth_headers() 按线发 `api-key: <token>`;静态头里残留的同名头一并剥掉再按线补;
  解析期校验接受该值、乱写的(api_key 下划线)仍被拒。
- data/gateway.yaml 新增 dots 供应商:两条线各自声明 path/auth,messages 线带
  anthropic-version;rate_limit_rps: 1.0(= 官方 60/分钟,按 Key);模型 dots3-note-prev
  (context_window 524288、vision: true、free: true、双协议线;官方未给最大输出上限→留空不猜)。
- 顺带补 Anthropic 口径的缓存统计:其 input_tokens 不含缓存部分,缓存命中在
  cache_read_input_tokens、写缓存在 cache_creation_input_tokens(三者互斥)。_usage_detail()
  改为分口径:OpenAI 的 prompt_tokens 已含缓存;Anthropic 三者相加为输入总量、缓存取
  cache_read_input_tokens —— 否则 messages 线的缓存量永远记 0(接 Dots 时实测到)。

上线实测(重启后,两条线各一次瘦请求,均免费):
  POST /v1/chat/completions → 200 usage{prompt 17, completion 8}
  POST /v1/messages         → 200 usage{input 17, output 8}
  /v1/models:42 个模型,dots3-note-prev 带 context_window 524288 / 双协议线 / free
  指标:calls{dots3-note-prev: ok 1}、tokens{prompt 14, completion 4}

测试:新增「Dots 配置 + api-key 样式(含解析期拒绝非法值)」与「Anthropic 缓存口径」两条
回归;既有 test_load_config_providers 供应商集合更新为四家。206 → 208 全过。
2026-09-29 09:40:16 +08:00
api-gateway c68a76cb8c 上游会话 id:客户端显式带 x-opencode-session 时优先用它
老板要求:「x-opencode-session 如果 api 请求有带的话优先用请求上的,没有再用 apikey 的那个方式」。

取值优先级(_upstream_session):
  ① 入站 x-opencode-session 头(本轮新增) → sha256("s:{账号}:{客户端值}")[:32]
  ② conversation_id                          → sha256("{账号}:{conversation_id}")[:32]
  ③ 用这个 API Key 自己(一个 Key 一个稳定会话)→ sha256("k:{去前缀Key}")[:32]
  ④ 登录页会话(无 Key)                      → sha256("u:{账号}")[:32]

- 仍按账号哈希:保留第二十六轮的账号隔离(两个账号写同一个值也不会被绑到同一上游会话标识)
- 入站值过 conversation_id 同款入口校验(仅 ASCII、≤128 字符),非法值静默丢弃并回退
  (可选头不该把请求打回 400);三个调用点(直传 / managed 非流式 / managed 流式)全接
- 新增 _inbound_session(request) 与 SESSION_HEADER 常量

实测(生产):同一会话头连打两次同一段 4k 前缀 → cached 0 → 1920(稳定复用);不带头回退
Key 派生也命中。同时更正一条旧认知:上游缓存**并非严格按 session 隔离**(换会话头同前缀
照样命中 1920),会话 id 是「纳入缓存」的前提而非隔离边界 —— README 与代码注释已同步。

测试 204 → 206 全过(新增取值优先级+账号隔离、入站头端到端两条);ci_check 全绿。
2026-09-28 19:35:59 +08:00
api-gateway 3b35b14a8a 修「token 统计恒 0」+ token 细分(缓存命中 / 推理)
老板 2026-09-28:「ai 网关 token 数统计有问题,一直都是 0;token 是不是可以细分,
命中缓存之类的;能细分就细分」。

【真因】/v1/chat/completions 的 **managed 流式路径**(改写分支,QwenPaw 实际走的就是它)
只把累计的 usage **转发给客户端**,从没写进指标。上游每轮都发 usage(实测 chunk 里带
prompt_tokens 与 prompt_tokens_details.cached_tokens)。
现场取证:网关记了 **663 次调用、tokens 恒为 {prompt: 0, completion: 0}**。
对照:直传路径(messages/responses)与非流式路径本来就有记账 —— 只漏了「流式 + 改写」。

【修复】该路径补 _record_usage_metrics(stream_usage)。

【顺带做 token 细分】(上游 usage 本来就有,此前只记总数):
- cached  = prompt_tokens_details.cached_tokens(命中缓存的输入量,已含在 prompt 内)
- reasoning = completion_tokens_details.reasoning_tokens(输出里的思考量,已含在 completion 内)
- Metrics.record_tokens(prompt, completion, cached=0, reasoning=0):全局与按账号两条桶都细分
- 四处记录点全接上;直传流式的扫描器补采 reasoning_tokens
- 新增辅助 _usage_detail()/_record_usage_metrics(),一处判据四路复用
- Prometheus 新增 api_gateway_tokens_cached_total / api_gateway_tokens_reasoning_total(含 HELP/TYPE)
- 前端「指标」页新增两张卡:缓存命中 Token(占输入 x%)、推理 Token(占输出 x%);中英文案对称

【上线实测】
- 瘦请求 → tokens {prompt: 62, completion: 2, cached: 0, reasoning: 1}
- 4k token 同前缀请求两次:第 1 次 cached=0;第 2 次 cached=1920 / prompt=4076
  → 网关累计 cached=1920(输入命中率 22.9%)
- Prometheus 导出同值

【测试】新增两条回归(managed 流式必须记账含细分、细分累加互不干扰),202 → 204 全过;
ci_check.sh 全绿;i18n 中英 759/759 对称。
2026-09-28 18:42:26 +08:00
api-gateway 9e2fc8e40a chore(sync): 每日同步 09-27/09-28 落盘的配置改动入库
由 cron 的 scripts/sync_models.py --apply 自动落盘、此前未入库(按「线上配置 = 仓库配置」
的硬性规则补齐):

- 删除 agnes/agnes-video-v2.0(官方文档已不收录)
- 新增 opencode/longcat-2.5-preview-free(文档新增,标 Free)
- 更新 opencode/qwen3.8-max 的 context_window 1000000 → 262144(models.dev 保守下限)

线上经 hot_reload 早已生效,本次只是把仓库补齐。
2026-09-28 18:42:25 +08:00
api-gateway 9bca7b3a5a 请求体上限 2MB → 20MB(带图对话 413)
起因:会话 1790234457104-wwgr3uq 报
`413 请求体超过上限 2000000 字节`。dump 显示 agent_state 达 2,688,007 字节:
生成的 PNG 以 base64 内联进对话历史(单张 100KB~750KB),两条 assistant 消息
就占 2.5MB,把网关自有的 2MB 限制顶爆。

- server.max_body_size: 2_000_000 → 20_000_000(config.py 默认值 +
  gateway.yaml + _opt_int 兜底三处同步)。
- nginx 侧无需改动:全局 nginx.conf 已是 client_max_body_size 50m,
  两个站点 conf 未单独设置 → 实际生效值 50m > 20m。
- 保留限制(只调大数字,不放开),内部网关 + nginx 两层仍在把关。
- 新增回归 test_server_max_body_size_is_20mb 钉住三处一致
  (配置默认值 / YAML 现值 / 兜底解析)→ 202 passed / 0 failed。

上线实测(pid 3525434):3MB 与 19MB 请求体均过体积检查到鉴权层(401),
21MB 精确 413 且报「请求体超过上限 20000000 字节」。
2026-09-24 16:10:07 +08:00
api-gateway 4dc41e04e7 第三十三轮:模型接口加入上下文参数(context_window / max_output_tokens)
老板 2026-09-24 要求:「文档里有写明支持上下文多少吗?有的话就修改 ai 网关,
接口加入上下文参数」+「Agnes 先加上,opencode go 看下 v2/docs/console/go/ 文档,
没有的话就看接口里有没有,这个也要加入同步脚本里」。

数据来源(逐一核查过):
- Agnes:官方**每个文本模型详情页**的「限制与价格」表写明 `上下文窗口` / `最大输出`
  (定价页没有这两项)。3.0-flash = 512K/65,536、2.5-flash = 512K/65.5K、
  2.5-pro 与 2.5-pro-beta = 1M/65,536。图片/视频页无此表 → 留 0。
- OpenCode:官方文档(Zen 页、v2/docs/console/go/)**都不写**上下文;`/zen/go/v1/models`
  实测只回 id/object/created/owned_by(单模型详情 404、include 参数被忽略)。
  唯一机器可读来源是 **models.dev**(OpenCode 团队维护),其 `opencode-go` /
  `opencode` 两供应商每条模型都带 `limit.context` / `limit.output`。
  口径(老板拍板):只用于**更新网关已有模型**,不拿它当增删依据(models.dev 收录
  比官方 Go 文档多,含 omen-alpha 等未收录的);跨源不一致时取**保守下限**
  (minimax-m3 Go 1M / Zen 512K → 512,000;qwen3.6-plus → 262,144)。

改动:
- app/config.py:ModelInfo 新增 context_window / max_output_tokens(默认 0 = 未标注),
  解析 + to_dict 序列化一并带上。
- app/main.py:GET /models 与 /v1/models 输出这两个字段;别名继承目标模型的值。
- app/settings.py:「供应商与模型」面板往返不丢字段(默认 0 → 未配置的模型不会被
  补出 `context_window: 0` 污染 YAML);提交了就以此为准,没提交则沿用文件原文。
- data/gateway.yaml:37 个模型落盘(33 OpenCode + 4 Agnes 文本),文本级插入保住
  全部手写注释(注释行 162 → 236)。
- scripts/sync_models.py:新增 fetch_models_dev()(拉失败返回 None → 只跳过上下文
  同步、不当成漂移)、fetch_agnes_context()(逐模型页解析「限制与价格」表)、
  diff() 产出 ctx_drift、build_plan/apply_plan(_set_context 块内改值,保留行尾注释、
  幂等)、verify() 回读校验、render_plan/render 显示漂移;_DRIFT_KEYS 与
  plan_is_empty 认 ctx_set。
- tests:新增 3 个(models.dev 保守下限合并 + 抓失败返回 None;_set_context 幂等与
  保注释;/models 带出字段且未标注不瞎补)→ **201 passed / 0 failed**;ci_check.sh 全绿。

上线:supervisorctl restart api-gateway:api-gateway_00(pid 3492804)后实测
/v1/models 45 个模型、38 个带 context_window(含 wjd 别名继承 = 1,000,000/384,000),
图片模型正确为 0。
2026-09-24 15:00:26 +08:00
api-gateway f6c1ecc4af docs: CHANGELOG 记「缓存命中率恒 0」的排查与修复
补上修复说明与技术细节:真因(流式 usage 丢 prompt_tokens_details)、
三层证伪过程(QwenPaw 组装 / 出站 payload / 上游字段)、修法与回归、
上线验证数据,以及排查方法论(流式与非流式是两条路径;
入站 → 出站 → 上游 → 网关回程的排查顺序)。
2026-09-24 14:40:04 +08:00
api-gateway b858f09075 fix(usage): 流式 usage 透传 prompt_tokens_details —— 修 QwenPaw 缓存命中率恒 0
老板报:QwenPaw 上用 ai 网关(wangjinding 供应商)调用 v4.1,
网页显示的缓存命中率一直是 0。

排查(实测,非推断):
- QwenPaw 侧 messages/tools 完全正常:6 份连续抓包逐条比对,前面所有消息
  逐字节一致、仅末尾追加 2 条(msgs 362→372 单调递增),tools 26 个逐字节相同。
- 网关出站 payload 正常:model/stream/stream_options 全同,session 稳定。
- 用网关真实出站 payload 原样直打上游:cached_tokens=126464 / 126848(99% 命中)
  ⇒ 上游缓存一直好好的。
- 真因:**网关流式响应重建 usage 时只挑 prompt_tokens/completion_tokens/
  total_tokens 三个字段累加,把 `prompt_tokens_details.cached_tokens` 丢了**,
  末尾又用这份残缺 usage 覆盖上游原始值发给客户端 —— QwenPaw 从未收到缓存字段,
  只能记 0。(同一 bug 让网关自己的控制台也看不到缓存命中。)

修复:
- 新增 `_merge_usage()`:整数累加、非整数(如 prompt_tokens_details 这类整份
  快照)覆盖,实现**全字段透传**;流式累加改用它。
- `_UsageScanner`(直传线记账)顺带收集 cached_tokens,counts() 多返回该键
  (消费方按名取值,不影响既有逻辑),网关控制台口径同步修正。
- 非流式路径本就原样透传 `result["usage"]`,无需改动。

回归:test_merge_usage_keeps_prompt_tokens_details、
test_usage_scanner_collects_cached_tokens。测试 198 passed / 0 failed。

上线验证:流式请求第 2 次 usage 已带 `prompt_tokens_details.cached_tokens=7168`。
2026-09-24 14:39:09 +08:00
api-gateway 7ad3248cb0 docs: CHANGELOG 记本轮(删两模型 + 立上生产必推 CNB 规则) 2026-09-24 14:06:31 +08:00
api-gateway 3a118c23fb docs+tooling: 立「上生产必推 CNB」规则(README 硬性段落 + scripts/push_cnb.sh)
老板 2026-09-24 规则:凡是重启上线生产的代码改动都要推送到 CNB,保持
「线上跑着的代码 = 仓库里的代码」。

- README 新增「上生产必须同步推 CNB(硬性)」段落:顺序=改代码 → 跑测试/CI →
  重启或 build 上线 → 确证线上生效 → commit → push;纯注释/配置靠 hot_reload
  生效的也照推。
- 新增 scripts/push_cnb.sh:一次性带 token 内嵌 URL 推送(token 不落 .git/config、
  不写进任何文件),推完自动核对远端 = 本地,并复查 .git/config 里没留下 token;
  不带 token 退出 2、工作区不干净退出 3。
2026-09-24 14:04:48 +08:00
api-gateway 97a31f6e0c 按老板指示从网关删除 deepseek-flash / omen-alpha(文档表未收录)
老板 2026-09-24 指令:「1,删了」——把 PROTECTED 保护名单里这两个模型照
官方文档删掉(此前怕文档收录滞后才护着,老板选择以上游文档为准)。

- PROTECTED 名单清空(机制保留:以后要临时护住某个 id 在这里登记即可;
  被别名 / media 引用的 id 本来就有独立保护,不依赖这张表)。
- 落盘后 opencode:网关 35 → 33,与文档 33 对齐(Agnes 10 = 10,无漂移)。
- 删除前把两个模型块原文归档到 /root/.trash/2026-09-24-opencode-models-doc-sync/。

顺带修一个删块 bug(本次实测踩到):
_find_model_blocks() 用「下一个 - id 行」当块尾,会把紧贴下一个模型的分组
标题注释(本文件惯例:`# ── …` 写在组里第一个模型上方;同步自己写的
「官方文档新增」标记同理)一起吞掉 —— 删 deepseek-flash 时连带删了
`# ── Anthropic Messages 线(文档主推这条)`。现改为:块尾只收口到
「块头注释」之前(_block_end + _BLOCK_HEADER_RE),并把已误删的标题恢复;
新增回归用例 test_remove_block_keeps_next_group_header_comment 钉住。
2026-09-24 14:03:16 +08:00
api-gateway 13d4fdc44e Agnes 免费/限时免费标注 + 免费标签间距对齐(老板 2026-09-24)
老板两件事:
1) Agnes 的模型也要标免费或限时免费 —— 之前只有 OpenCode 的 space-bunny-free 有标注;
2) 免费标签跟模型名的间隔不一样,优化。

免费标注:
- 口径(照官方措辞,按 bullet 切块判定,不关键词泛扫):
  · OpenCode 价格表 Input/Output = Free(原逻辑)
  · Agnes 定价页「### 当前优惠」:当前(均)免费 → 免费;当前限时免费 → 限时免费
  坑:Agnes 视频 agnes-video-2.5 那条 bullet 写着「输入图片前 5 张免费」——
  那是计费公式的免费额度、不是模型免费,所以只认严格措辞「当前免费 / 当前均免费 /
  均免费 / 限时免费」,且只认反引号里的完整 id(agnes-video-2.5 是
  agnes-video-2.5-flash 的子串,字符串包含会串味)。
- 配置:free: true(免费)+ 新增 free_limited: true(限时免费)。
  落盘 7 条:3.0-flash / 2.5-flash / image-2.0-flash / image-2.1-flash /
  image-2.5-flash / video-v2.0 = 免费;video-2.5-flash = 限时免费。
- scripts/sync_models.py:新增 _agnes_free_map() / _set_agnes_free(),免费标注纳入
  漂移比对 + --apply 落盘(官方改口径 → 整行撤掉标注),回读校验新增 Agnes 免费位检查;
  新增模型块也会带上标注。
- 后端:ModelInfo.free_limited + /v1/models 带出 free_limited(别名随目标继承)。
- 前端:标签文案 免费 / 限时免费(中英各 +2 键,i18n 755/755 对称),提示语同步更新
  (原文案只提 OpenCode Go 计划,已不准确)。

间距:
- 根因:.st-row 是 flex(gap:8px),.name-free 又加 margin-left:6px → 标签左侧 8+6=14px、
  右侧 8px,与其它行「模型名 → 供应商名」的 8px 节奏不一致。
- 修法:.st-row .name-free { margin-left: 0 }(表格单元格是行内排布、无 flex gap,
  那边保留 6px)。同源最小页实测:修前 14/8,修后 8/8。

测试:新增 test_agnes_free_map_rules、test_agnes_free_apply_and_revoke_round_trip
(含 撤标注/限时→免费/幂等/相邻手写注释不被碰);195 passed / 0 failed。
2026-09-24 13:49:48 +08:00
api-gateway 4d25cb64e1 fix(sync): 空 plan 也走写盘分支(每天白重写配置 + 误报「已写盘」)
plan_is_empty 只看外层,而 plan["add"] = {"opencode": {}, "agnes": {}} 两层 dict
恒为真值 → 无漂移时也判定「有动作」,于是每天重写一次 data/gateway.yaml 并把上一份
备份覆盖掉,报告还误报「已写盘:…N 字节」。改为下钻到 provider 桶判断。

- 加回归用例 test_sync_plan_is_empty_drills_into_provider_buckets(193 passed / 0 failed)
- 实测:无漂移时改为「(无:网关已与文档一致)+ 无需落盘」,配置与备份都不再被白动
- CHANGELOG 补 2026-09-24 这一轮(同步落地 + 视频默认模型口径 + 本修复)
2026-09-24 13:37:00 +08:00
api-gateway 540d1f583f feat(sync): 视频默认模型纳入同步视野 —— 保它不被自动删 + 每日报告列候选,不自动换默认
- 报告新增一段:当前 media.video_model_name、是否仍在文档里(✓/✗)、文档视频清单候选;
  日志/简报里直接可见,换默认仍是「点模型名改一行」的人为动作
- 新增模型的价格不再重复列进「定价漂移(网关=None)」,只按「新增」呈现
- data/gateway.yaml 的 video_model_name 上补注释(说明受保护、候选在哪)
- cron 提示词加边界:报告里原样带出,不要自己改 video_model_name
- README 同步一节补该口径;单测 192 passed / 0 failed
2026-09-24 13:35:05 +08:00
api-gateway 6621133897 feat: 模型清单每日同步落盘(新增 / 删除 / 改参数)+ 修定价用例写死旧刊例价
scripts/sync_models.py 新增 --apply:把网关模型清单与官方文档全量对齐
  · 文档新增 → 插进配置;文档下线 → 删除(连它的 pricing 条目);价格 / 免费标记变化 → 就地更新
  · 协议线只加不砍;PROTECTED 名单 + 被别名 / media 引用的 id 永不自动删
    (官方文档表收录有滞后:实测 deepseek-flash / omen-alpha 上游在服务、文档表还没补)
  · 文本级增删改,保住逐条实测的手写注释;复用网关 write_config(备份 + 原子替换 + 600),
    落盘后回读校验(模型集合 / 定价 / 协议线 / 别名目标 / 无关 provider 未被碰),不通过就中止不写盘

data/gateway.yaml:同步 Agnes 文档
  · 新增 6 个:agnes-2.5-pro、agnes-2.5-pro-beta、agnes-image-2.0-flash、agnes-image-2.1-flash、
    agnes-video-2.5、agnes-video-v2.0
  · agnes-3.0-flash 价目 0.35 / 1.00 → 0 / 0(文档明写当前免费,原值是被划掉的刊例价)
  · 补 agnes-2.5-pro(3/6)、agnes-2.5-pro-beta(0.7/2.1)价目
  · OpenCode 侧无漂移;deepseek-flash / omen-alpha 受保护未删

tests:test_pricing_estimate 改用不在同步范围的 ark-code-latest —— 原来写死
  agnes-3.0-flash 的 0.35/1.00,文档一改价就假红(192 passed / 0 failed)
README:补「模型清单每日同步」一节(用法 / 数据源 / 落盘边界 / 定时)
2026-09-24 11:39:26 +08:00
api-gateway 74f15a9e1e docs: 用第二把 key 复核 Zen 免费档(结论不变:客户端锁定,未写入)+ 记录 Zen 账户 402 与在线免费清单 9 个 2026-09-24 10:10:39 +08:00
api-gateway 5081eea8b9 feat: 免费标志挪到模型名后面;轮换 Agnes Key;复测 Zen 免费档(结论:客户端锁定,一个都不能用)
- 前端 Models.vue:绿色「免费」标签从「能力」列挪到「模型」列紧跟模型 id 后面,
  测速行同样跟在名字后面(撤掉闪电图标);能力列恢复只标 视觉/参数固定
- data/.env:AGNES_API_KEY 轮换为新的一把(值不入库;重启后真实调用 200 / health/agnes ok,远端 11 个模型)
- 复测 models.dev 里 29 个 *-free:Go 端点 29/29 400 Model is unavailable;
  Zen 端点同样全失败,其中一批 403 FreeTierError(免费档只能在 OpenCode 客户端内用)
  → 按「可以用才写入」的条件,一个都没写入(结论写进 README/CHANGELOG,避免重复测)
- CHANGELOG 记本轮;README 模型清单补 Zen 免费档不可用的说明
2026-09-24 10:06:10 +08:00
api-gateway 70c82d4ca7 feat: 免费模型在前端「模型与供应商」页可见(free 字段 + 绿色「免费」标签)
- 后端:ModelInfo 增加 free 字段(yaml models[].free,_opt_bool 校验)、all_models() 带出、
  /v1/models 暴露 free(别名随目标继承,与 vision/params 同源)
- 配置:space-bunny-free 标 free: true(与 display_name 的「(免费)」双保险)
- 前端:Models.vue「能力」列新增绿色「免费」标签(bolt 图标 + 悬浮说明)、测速行同步标一颗闪电;
  i18n 中英各 +2 键(freeTag/freeHint),753/753 对称
- 测试:新增 test_models_payload_marks_free_models(免费模型必须 free=true、付费必须 false、
  每个模型都要带该字段),全套 192 passed / 0 failed
- README:免费模型说明补「三处标注」口径
2026-09-24 10:00:54 +08:00
api-gateway 68ddccba53 config: 刷新 OpenCode Go 模型清单(35 个,含免费模型标注)
- 上游 GET /models(35 条)+ 官方文档价格/端点表对齐:新增 deepseek-flash(三线全通)、
  grok-4.7(responses)、omen-alpha(chat)、gpt-6-luna(responses)、mimo-v2.6-flash(chat)、
  mimo-v2.6-pro(chat)、space-bunny-free(chat + messages)
- 下线 union-alpha(Union Alpha Free,上游已 retire,实测 400 Model is unavailable)
- 免费标注:space-bunny-free 的 display_name 写为「Space Bunny Free(免费)」
- 7 个新模型逐条真实调用验过三条线(chat/messages/responses 各一只瘦请求)后定 protocols;
  顺手复核 kimi-k3 / minimax-m3 / deepseek-v4.1-flash 标注仍正确
- README:供应商表模型数 17 → 35、模型清单按「线 + 免费」重写、三线直传小节同步
- CHANGELOG:新增 2026-09-21 条目(含「探测必须带专属 UA,否则 Cloudflare 403 error code: 1010」的踩坑记录)
2026-09-24 09:53:46 +08:00
api-gateway 97ec0bbfba 第三十二轮: view_to_raw 不再把面板默认值写进文件(整份视图 PUT = 零变化,保住 providers 段手写注释)
- app/settings.py: 新增 _prune_defaults + _PROVIDER_KEY_DEFAULTS/_MODEL_KEY_DEFAULTS,
  providers/models 按「文件里没有 且 值等于面板默认 → 不写」重建;auth 空 token、
  media 空端点、rate_limit_rps/requires_session_header/endpoints、模型 type/vision/
  protocols/display_name 不再被 materialize(改动前实测:整份视图 PUT 会重写 providers
  段 530 行、# 标记 126 → 72)
- tests: +test_view_to_raw_keeps_panel_defaults_out_of_the_file(纯函数语义)
  +test_full_view_put_rewrites_nothing(GET→PUT 端到端,文件逐字节不动)
- 191 passed / 0 failed;ci_check 六道门禁全绿;生产实测整份视图 PUT → 200、
  data/gateway.yaml md5 518b12b6… 前后一致、日志 写盘=merged / 重写段=无
2026-09-20 19:36:14 +08:00
api-gateway 33d1238fb2 第三十一轮收尾: 结构化保存走文本级合并(保住手写注释) + 别名卡片文案按老板口径删减
一、结构化 PUT /config 不再整份重渲染(这次真踩过的事故)
- 起因:模型页「保存映射」只改 aliases 一段,却走 render_yaml 整份重渲染,把 gateway.yaml 里
  历轮手写的现场注释(协议线实测结论、各家鉴权差异、会话头要求…)整段抹掉(90 → 48 行)。
- app/settings.py 新增 merge_submitted_sections():把本次提交的段替换进原文,其余字节一个都不动。
  三条边界都是实测踩出来的:
  ① 只重写**值真的变了**的段(write_config_merged 拿 raw_old 逐段比对)—— 面板 PUT 的是整份视图,
     没变的段必须原样留着,否则一次无关保存就把 server.retry 那类行尾注释冲掉;
  ② 被替换段的**段尾说明/页脚**用 _split_tail 留在原位 —— 改 providers 不能顺手动掉 server 上方的说明书;
  ③ 新增段用 _doc_start 插在下一段**说明书之前** —— 否则别人的说明书会变成新段的抬头;
  ④ 合并后回读校验:解析失败或与提交内容不等 → 退回整份重渲染(配置一定正确,只赔注释)并记 ERROR。
- app/main.py:结构化保存改调 write_config_merged;日志升级为 写盘=merged|rendered / 重写段=<清单>。
- 结构化的唯一调用方是模型页(只提交 aliases 一段);网关配置页走 YAML 原文,两路都不丢注释。

二、别名卡片文案(老板 2026-09-18 口径)
- 删掉卡头副标题(aliasSub:客户端固定写 model: {id},网关转发到你选的模型)与 member 的只读行
  (aliasReadonly:只读:映射由管理员在网关配置里选择),两行说明保留;Models.vue 连带删掉 .alias-ro 样式,
  中英 i18n 753 → 751(仍对称)。

三、验证
- 单测 189 passed / 0 failed:新增 test_merged_write_keeps_neighbour_docs_and_skips_unchanged(上面三条边界);
  改写 test_alias_panel_round_trip_and_save_validation —— 旧写法 PUT 整份视图,而 view_to_raw 会把面板默认值
  materialize 进 providers(token ''/rate_limit_rps null/requires_session_header false/endpoints/vision false…),
  providers 因此被判"变了"、注释被重写,断言必挂;改成面板真实载荷 {config:{aliases:…}} 后绿。
- scripts/ci_check.sh 全绿(compileall + 单测 + i18n/SVG 体检 + vue-tsc + build)。
- 生产实测(重启后 pid 1912449):值没变的保存 → gateway.yaml 逐字节一致;临时改 note → 差异只有 2 行;
  改回 → md5 回到 64ca52b83ab1bb3a7db40d0073554887;页面点「保存映射」→ 日志 重写段=无、文件未变。
  前端新入口 index-B5GZJuR8.js(旧 index-BJNJXWEY.js 404),admin/member 双角色真浏览器复验通过。

四、data/gateway.yaml
- 提交的是**注释完整的生产版**:HEAD 里那版是被抹过的 render 产物,工作区这版恢复了被误删的手写注释
  并补了带说明的 aliases 段(注释行 100,⊇ 上一版)。

遗留(未动,等老板定):整份视图 PUT 仍会在 providers 上 materialize 面板默认值(那段行内注释会赔);
当前无 UI 走这条路,根治需让 view_to_raw 不再补默认值。
2026-09-20 19:23:18 +08:00
小银 73dd2053e6 第三十一轮: 虚拟模型 id(别名 wjd)—— 客户端固定模型名,映射到哪个真实模型由管理员在页面上选
- config: AliasSpec{enabled,target,note} + GatewayConfig.aliases + resolve_alias/alias_of;
  保存期四条硬规则(目标存在 / 必须是文本模型且支持 chat/completions / 不得与真实模型 id 重名 /
  启用却没写 target);停用时跳过 target 校验。别名不进 _model_index —— 必须显式 resolve_alias()。
- main: chat 线(含 batch)入口换 id 转发;messages/responses 打别名 400 指路(不打上游);
  images/videos 明确 400 拒绝;/v1/models 注入别名条目(alias_of + 继承目标能力);
  流式 chunk 统一回显请求名(非别名调用零变化);_log_alias_changes 记指向变更(含谁改的)。
- settings: 面板 aliases 段(按段合并,不提交则沿用原文)+ 渲染 yaml 时带说明注释。
- web: Models 页「虚拟模型 id(别名)」卡片(admin 开关 + 目标下拉,非 chat/completions 置灰;
  member 只读一行);别名不进模型计数/测速列表/模型表;i18n 中英 753/753。
- tests: +8 条(规则与解析/目录继承/chat 端到端/另两线 400 且不打上游/媒体拒绝/测速说明/
  流式唯一模型名/面板往返 + 非法目标 400 不写盘)→ 187 passed / 0 failed。
- 生产: wjd → agnes-3.0-flash;后端 pid 1872300、前端 index-BJNJXWEY.js。
2026-09-18 23:42:34 +08:00
api-gateway 0bf607e35f 第三十轮: 全面体检发现项全部修 —— 下载白名单/视频归属/会话落盘/i18n 收口/口令下限
老板对上一轮「只查未改」的体检清单回「全部」,逐项修完并直接上生产验证。

P0 产物下载白名单(实测复现的真 bug)
- Agnes 水印版产物走另一个 CDN(maas-watermark-prod-new.cn-wlcb.ufileos.com),
  download.allowed_hosts 只有普通版域名 → admin 老产物点「下载」必 400。
- 补域名;yaml + README 写明这张表是出网白名单、换 CDN 要同步维护。
- 生产实测:水印图下载 200 / 129871 bytes(改前 400);非白名单域名仍 400。

视频任务归属(新增 app/video_owners.py)
- GET /v1/videos/{id} 原先不判归属,任何登录账号拿到 id 就能读别人任务状态与产物 URL。
- 创建成功时登记 video_id→账号,轮询判权:他人 404(不用 403,避免 id 变存在性探针)、
  admin 放行、无登记的老任务放行(渐进收紧)。落盘 data/video_owners.json(600/TTL 7 天)。

登录会话落盘(app/sessions.py)
- 原先纯内存 → 每次重启全体被踢;现在 data/sessions.json:只存 token 的 sha256、
  原子写 + 600、写失败只告警、载入丢过期。吊销语义不变且吊销也落盘。
- 生产实测:登录拿 token → 重启 → 同一 token 仍 200;文件里不含明文 token。

口令下限 4→8(app/users.py)
- 只作用于「显式给密码/事后改密」;登录不判长度,既有短口令账号照常登。

/config/env 值校验
- 拒绝 \n / \r / \x00 与 >4096(带换行的值能在 .env 里凭空多出几行改掉别的变量)。
- 生产实测 400 且 md5(data/.env) 未变。

其它后端/一致性
- history 四个端点补 _offload(整份读写 ≤4MB,此前是唯一还在事件循环里同步跑的 IO)。
- /health/{provider} 注释更正:一直是 require_auth(恒定鉴权、不随 health_auth 放宽)。
- GET / 导航的 docs 一行改为仅在 docs_enabled 时列出;FastAPI 描述补 OpenCode Go。
- _req_headers 陈旧注释、_media_headers 与测速探针的「有意随机 session」注明。
- app/settings.py 备份写完显式 chmod 600(copy2 会照抄源的 644)。

前端 i18n 收口
- Videos 素材摘要 / lib/upload.ts 全部报错 / charts.ts 空态 → i18n(中英 737/737)。
- 删除 router.ts 中无人消费的 meta.title(只有中文的死元数据)。
- check-i18n.mjs 新增「硬编码中文」扫描(剥注释后扫字符串字面量,允许清单只放语言自称)。

文档 / 基建
- README:.env 补 OPENCODE_API_KEY、两层 .env 的 override 关系、auth.users 死引用、
  「自动路由」措辞、下载白名单维护、密码 8 位、测试计数 165→179。
- .env.example 重写(删 B_AI_API_KEY、补 OPENCODE 与全部可覆盖路径)。
- Makefile:lint 改 compileall(原手写清单漏了 6 个模块);test 注释改实话(环境无 pytest)。
- .gitignore 补 6 项;data/gateway.yaml*.bak 三个文件 git rm --cached(本地保留)。
- 新增 scripts/ci_check.sh:一条命令跑完 compileall + 单测 + i18n/SVG 体检 + vue-tsc + build。
- flake8 --select=F,E9 清到 0。

测试
- 179 passed / 0 failed(173→179)。新增会话落盘/过期丢弃、视频归属语义 + 端点级 404、
  env 值校验 + 沙箱写、口令下限。
- 修隐患:新增 GATEWAY_ENV_FILE 覆盖 —— 此前测试若覆盖写路径会直接改生产 data/.env。

CSP 结论
- 实测(A/B):去掉 'unsafe-eval' 后登录页 #app 全空、表单不渲染;根因是 vue-i18n 运行时
  消息编译器(打包产物里唯一一处 new Function)。正解是构建期预编译文案,不是放宽 CSP。
2026-09-18 22:45:20 +08:00
api-gateway 55eb89ce0e 第二十九轮: 缺省 conversation_id 时上游会话按 API Key(去前缀哈希)稳定派生, 不再每调用随机UUID → 提提示词缓存命中率; 登录会话按账号稳定兜底 2026-09-18 17:22:53 +08:00
api-gateway aad3f28589 第二十七轮: 三线直传(/v1/messages,/v1/responses)+删除路由别名;第二十八轮: element-plus 按需引入+死代码清理+前端支持格式列/API Key 文档 2026-09-18 16:33:33 +08:00
api-gateway bad8b43b22 第二十六轮:会话 id 入站校验 + 按账号隔离 + 422 处理器异常对象清洗
1) conversation_id 零校验 → 中文触发 httpx header ascii 编码异常,被误判成
   "上游失败"重试 3 次后回 502。现在入站校验(仅 ASCII / ≤128 字符 / 剥空白、
   空白串视作未传),非法值直接 422 且一次都不发上游。
2) 网关不再原样透传 conversation_id,改为派生 sha256("{账号}:{conversation_id}")[:32]
   作为 x-opencode-session(同账号同对话恒定、账号间隔离、不暴露账号名与业务命名)。
3) 顺修通用隐患:pydantic v2 把校验器抛出的异常对象放进 errors()[].ctx,
   而 422 处理器直接把它塞进响应体 → 序列化 TypeError → 500「网关内部错误」。
   新增 _jsonable_errors() 清洗,并剥掉 "Value error, " 前缀。

另:实测更正此前结论 —— cached_tokens 与 x-opencode-session 无稳定关系
(同一 session 连打 6 次 [0,0,0,0,896,896];缓存落定后换全新 session 亦可命中 936)。
上游是机会性内容前缀缓存;该头只是会话标识。README/CHANGELOG 已更正。

单测 171 passed / 0 failed(新增 3);隔离实例 8899 真机验证通过;未上线待批准。
2026-09-18 12:43:13 +08:00
api-gateway 17a3282574 config: deepseek-v4.1-flash 标注 vision(实测确认为多模态)
- 实测:带图请求(data:image/png;base64)红/蓝/绿三色全部识别正确;
  同请求打到纯文本模型 deepseek-v4-flash 被上游 400 拒(对照组成立)
- 过网关复测:直连 + 路由别名 wjd(带图排视觉模型)均正确
- gateway.yaml 加 vision: true(附实测注释);README 模型清单标「(视觉)」
- 纯配置 → hot_reload 生效,未重启后端;/v1/models 中 vision 已由 false → true
- 判定坑:推理模型 max_tokens 太小会被 reasoning_content 吃空 content,需 ≥300
2026-09-18 12:21:36 +08:00
api-gateway 4507dc4b8e fix: 模型级强制参数(kimi-k2.7-code 锁 temperature=1)+ 测速超时/错误文案
- config: ModelInfo.params + MODEL_PARAM_KEYS 白名单 + _parse_model_params(写错即 ConfigError)
- adapters: _forced_params 在 payload 组装后强制覆盖;_learn_from_upstream_error 按上游 400
  要求修正并重发一次(非原样重试);流式已吐内容则不重发
- main: /v1/models 暴露 params;探针超时 15s→30s;_speedtest_error_text 说清超时/上游原文
- settings: 面板保存保留手写 models[].params(原先会被静默清掉)
- gateway.yaml: kimi-k2.7-code params.temperature=1
- 前端: Models 挂锁+参数固定标签;Chat 温度 chip 挂锁+抽屉提示;新增 lock 图标;中英对称
- tests: +10 → 168 passed / 0 failed
2026-09-18 12:18:10 +08:00
api-gateway e4065d31c3 feat: OpenCode Go 会话 id 升级为对话级稳定(方案 A)
- models.py: ChatRequest 显式声明 conversation_id(内部字段,不透传上游)
- openai_compat: chat/chat_stream/_req_headers 支持 session_id(有则用之,无则回退 UUID)
- main.py: 非流式/流式主链路把 req.conversation_id 传为 session_id
- Chat.vue: 对话级 convId(randomUUID),随对话持久化,清空对话时重建,注入 payload
- 新增 2 个单测;157 passed / 0 failed;typecheck 通过;真实 key 冒烟稳定会话 OK
2026-09-18 11:21:18 +08:00
api-gateway 8bab67d31d feat: 接入 OpenCode Go 供应商(17 个 OpenAI 兼容文本模型)
- gateway.yaml 新增 providers.opencode(requires_session_header + 专属 UA),
  收录 17 个 chat/completions 模型(glm/kimi/longcat/deepseek/mimo/hy),
  全部并入 wjd(wjd 现 20 个文本模型)
- config.py 加 ProviderConfig.requires_session_header 开关
- openai_compat 每次请求动态注入 x-opencode-session(缓存冻结坑),create_adapter 透传
- settings.py 面板视图/写回增补该字段(修 roundtrip 配置被改)
- Settings.vue 默认模型下拉追加 17 个模型
- 测试:providers/wjd 断言更新;修 test_effective_rps_priority 共享 cfg 污染(finally 还原)
- 单测 155 passed / 0 failed;typecheck 通过;真实 key 端到端非流式+流式皆通
2026-09-18 10:23:31 +08:00
api-gateway c2f27e6e39 wjd 链路 = 全部文本模型:补 agnes-2.5-flash
老板决策:现有+以后新增的所有文本模型都必须加入 routes.wjd 兜底链。
- data/gateway.yaml: wjd 链 ark-code-latest→agnes-3.0-flash→agnes-2.5-flash
- README/CHANGELOG/测试断言(2→3)同步;MEMORY/日记记录为长期约束
- 单测 155 passed / 0 failed
2026-09-18 10:04:02 +08:00
api-gateway 18cafe5354 feat: 新增 Agnes 2.5 Flash 文本模型(agnes-2.5-flash,视觉) 2026-09-18 09:57:36 +08:00
api-gateway 6a5416532b chore: 移除智谱 GLM 供应商(GLM 模型 + CogView/CogVideoX 媒体 + 契约代码/前端/文档/测试全清) 2026-09-18 09:50:26 +08:00
api-gateway 15a2e6eb9e chore: 移除 b.ai 供应商(qwen3.8-flash/hy3)—— 配置/代码/文档/测试/.env 全清 2026-09-17 09:19:47 +08:00
api-gateway e999df8eff fix: 下载白名单加入智谱产物 CDN(maas...ufileos.com) 2026-09-16 10:24:54 +08:00
api-gateway e0aa5522fb feat: 集成智谱 CogView-3-Flash 文生图 + CogVideoX-Flash 文生视频 2026-09-16 10:11:20 +08:00
api-gateway b66c448d7a test: 修复遗留 feedback 撤回用例(admin 可真删)+ 修正 stale docstring 2026-09-16 09:19:53 +08:00
api-gateway 35680c7b95 feat: 新增智谱 GLM 供应商(6 模型,3 视觉;密钥走 data/.env) 2026-09-16 09:16:27 +08:00
api-gateway 950f9bbf3d docs: CHANGELOG 记录 git 初始化与推送到 CNB 2026-09-15 17:34:48 +08:00
api-gateway d143d8da22 init: api-gateway v2.4.0(Agnes/b.ai/火山方舟 三家供应商网关) 2026-09-15 17:05:46 +08:00
50 changed files with 2019 additions and 160 deletions

No files matched your search

+1 -1
View File
@@ -1,4 +1,4 @@
# API Gateway 环境变量模板 # 小银网关 环境变量模板
# ── 怎么用 ── # ── 怎么用 ──
# 1) 本机最简:复制成项目根的 .env 并填入真实 token(根 .env 不覆盖真实环境变量)。 # 1) 本机最简:复制成项目根的 .env 并填入真实 token(根 .env 不覆盖真实环境变量)。
# 2) 交给「网关配置页 → 环境变量」那张卡管理:写 data/.env(权限 600,已进 .gitignore)。 # 2) 交给「网关配置页 → 环境变量」那张卡管理:写 data/.env(权限 600,已进 .gitignore)。
+3 -1
View File
@@ -30,6 +30,8 @@ data/feedback_media/
# 运行期状态(第三十轮):会话落盘 / 视频归属落盘 —— 都是运行数据,且含账号名与凭证哈希, # 运行期状态(第三十轮):会话落盘 / 视频归属落盘 —— 都是运行数据,且含账号名与凭证哈希,
# 属"可重新生成、不该进版本库"的一类(重启后从空开始,语义上无害) # 属"可重新生成、不该进版本库"的一类(重启后从空开始,语义上无害)
data/sessions.json data/sessions.json
# 封禁历史(2026-11-19 补):运行时数据,且**含被封 IP 与操作人**,属隐私,不入库
data/ban_history.jsonl
data/video_owners.json data/video_owners.json
# 智能体运行记录(第三十八轮):运行时数据(谁在什么时候用了哪个智能体), # 智能体运行记录(第三十八轮):运行时数据(谁在什么时候用了哪个智能体),
@@ -47,7 +49,7 @@ data/*.bak
# ── 设计稿(不入库,历史上从未入库)────────────────────────────────── # ── 设计稿(不入库,历史上从未入库)──────────────────────────────────
# design/v1、v2、v3 是"出设计图"用的脚本 + 渲染出的 PNG(约 11MB)。 # design/v1、v2、v3 是"出设计图"用的脚本 + 渲染出的 PNG(约 11MB)。
# 它们与产品构建、网关运行完全无关,且 2026-09-13 曾被清理归档到 # 它们与产品构建、网关运行完全无关,且 2026-09-13 曾被清理归档到
# /root/.trash/2026-09-13-api-gateway-cleanup/design/(cp -a 可恢复)。 # /root/.trash/<归档>/design/(cp -a 可恢复)。
# 需要时本地恢复即可,不进版本库。 # 需要时本地恢复即可,不进版本库。
design/ design/
+63 -28
View File
@@ -1,5 +1,40 @@
# CHANGELOG # CHANGELOG
## 2026-11-19 · 修 OpenCode 模型同步(官方文档改版导致连续两天 exit=2)
**症状**:自动化日报的「三、模型清单同步」整块失败,`logs/model-sync.log` 连续两天:
```
[2026-11-17 23:02:18] exit=2 抓取/解析失败:RuntimeError: OpenCode 文档没解析出 Endpoints 表(页面可能改版)
[2026-11-18 23:02:29] exit=2 同上
```
**根因**:官方把 `## Endpoints` 表改成了「去 console 页看 / 用 models 接口」,
HTML 里已经没有带 `opencode.ai/` 地址的模型行,`fetch_opencode()` 的 `<tr>/<td>` 解析拿不到任何行。
**修法**:改为优先读官方 models 接口(**无需鉴权**,实测不带 token 也 200):
```
GET https://opencode.ai/inference/go/v1/models # 与 /zen/go/v1/models 同源同内容
```
每条模型自带 `id` / `name` / `type` / `api{chat-completions,responses,messages,generate-content}` /
`recommended_api` / `limit{context,output}` / `cost.text.*.price`(都为 0 = 免费)/ `go.limited_regions`。
脚本据此推导协议线、免费标记、地区限制,**HTML 表解析降级为兜底**(接口不可用才走)。
**同步结果**(2026-11-19 08:02 首次落盘):
| 动作 | 内容 |
|---|---|
| 删除 | `opencode/mimo-v2.5`、`opencode/mimo-v2.5-pro`(上游已被 V2.6 取代,文档也不再收录)|
| 上下文 | `hy4-flash-free` → 1,048,576 / 65,536;`qwen4-max` → 1,000,000 / 262,144 |
| 跳过 | `gemini-4-argon`(只有 generate-content 线);`beam-free`、`muse-spark-1.2/1.3-contributor`(`go.limited_regions`,与旧硬编码名单一致)|
落盘后网关 28 个模型、`/healthz` 200,`hot_reload` 自动生效未重启;再跑一次输出「无漂移」。
`sync_onemin.py` 同步验证通过(49 接口 / 43 配置 / 跳过重名 6)。
---
## 2026-10-31 · 新增 1min.AI 供应商(43 个模型) ## 2026-10-31 · 新增 1min.AI 供应商(43 个模型)
老板:「查看 https://docs.1min.ai/docs/api/openai-compatible 文档,把 1min 供应商加入 ai 网关项目里」。 老板:「查看 https://docs.1min.ai/docs/api/openai-compatible 文档,把 1min 供应商加入 ai 网关项目里」。
@@ -89,10 +124,10 @@ FTS5(当前 400 行无感)、echarts 按需引入(收益 < 风险)。
### ① 应用数据每日备份(新增) ### ① 应用数据每日备份(新增)
此前每日任务只做「进程巡检」,**完全没备份网关数据**(账号/会话/历史/反馈/调用日志)。 此前每日任务只做「进程巡检」,**完全没备份网关数据**(账号/会话/历史/反馈/调用日志)。
- 新增 `/root/dsh/security/backup-app-data.sh`: - 新增 `<运维脚本目录>/backup-app-data.sh`:
- `calllog.db` 用 **`VACUUM INTO` 做一致性快照**(不锁业务读写,比 `cp` 安全) - `calllog.db` 用 **`VACUUM INTO` 做一致性快照**(不锁业务读写,比 `cp` 安全)
- 账号/会话/历史/反馈/agents.yaml/gateway.yaml/`.env` 一并打包 - 账号/会话/历史/反馈/agents.yaml/gateway.yaml/`.env` 一并打包
- 打包 → `/root/dsh/security/backups/app/app-data-YYYY-MM-DD.tar.gz`,权限 600,**保留 14 份** - 打包 → `<备份目录>/app-data-YYYY-MM-DD.tar.gz`,权限 600,**保留 14 份**
- 新增 systemd 定时器 `dsh-gateway-backup.timer`:**每天 03:30**(在 03:00 巡检之后); - 新增 systemd 定时器 `dsh-gateway-backup.timer`:**每天 03:30**(在 03:00 巡检之后);
实测触发 `status=0/SUCCESS`,首份备份 6.7 MB。 实测触发 `status=0/SUCCESS`,首份备份 6.7 MB。
@@ -500,9 +535,9 @@ token 正常(输入 41 / 输出 12 / 推理 12);成员视角只看到自
老板:「旧托管的都删了,代码,文档相关的都去掉」。 老板:「旧托管的都删了,代码,文档相关的都去掉」。
- **远端**:三个项目(`api-gateway` / `QwenPawChat` / `QwenPawChatWeChat`)都删掉 `origin` - **远端**:三个项目(`xiaoyin-gateway` / `QwenPawChat` / `QwenPawChatWeChat`)都删掉 `origin`
(旧托管的仓库地址)—— 现在只留 `gitea` 一个远端。 (旧托管的仓库地址)—— 现在只留 `gitea` 一个远端。
- **脚本**:旧的推送脚本移除(归档到 `/root/.trash/2026-10-12-retire-cleanup/`, - **脚本**:旧的推送脚本移除(归档到 `/root/.trash/<归档>/`,
含 `MANIFEST.md`;内容仍可从 git 历史取回);`scripts/push_gitea.sh` 的注释里也去掉了旧托管表述。 含 `MANIFEST.md`;内容仍可从 git 历史取回);`scripts/push_gitea.sh` 的注释里也去掉了旧托管表述。
- **文档**:`README.md` 发布纪律段、`docs/agents-dev-plan.md` 里的旧托管表述改成 Gitea(或直接删掉)。 - **文档**:`README.md` 发布纪律段、`docs/agents-dev-plan.md` 里的旧托管表述改成 Gitea(或直接删掉)。
- **历史条目**:按要求**一并清掉** —— CHANGELOG / MEMORY / 日记 / digest Sources 里的旧托管字样全部去掉,不再保留。 - **历史条目**:按要求**一并清掉** —— CHANGELOG / MEMORY / 日记 / digest Sources 里的旧托管字样全部去掉,不再保留。
@@ -512,7 +547,7 @@ token 正常(输入 41 / 输出 12 / 推理 12);成员视角只看到自
老板:「统一成 main,都默认 main 分支」。 老板:「统一成 main,都默认 main 分支」。
- **api-gateway**:本地分支 `master` → `main`(`git branch -m master main`);Gitea 侧推上 `main` - **xiaoyin-gateway**:本地分支 `master` → `main`(`git branch -m master main`);Gitea 侧推上 `main`
后把仓库默认分支改成 `main`、删掉旧的 `master` 分支。 后把仓库默认分支改成 `main`、删掉旧的 `master` 分支。
- **QwenPawChat / QwenPawChatWeChat**:本来就是 `main`,无需改(三个项目至此一致)。 - **QwenPawChat / QwenPawChatWeChat**:本来就是 `main`,无需改(三个项目至此一致)。
- **本机 git** 设 `init.defaultBranch = main` —— 以后**新建**仓库默认就是 `main`。 - **本机 git** 设 `init.defaultBranch = main` —— 以后**新建**仓库默认就是 `main`。
@@ -538,12 +573,12 @@ token 正常(输入 41 / 输出 12 / 推理 12);成员视角只看到自
- **新增 `scripts/push_gitea.sh`**:与旧推送脚本同一套安全口径(一次性带凭据内嵌 URL; - **新增 `scripts/push_gitea.sh`**:与旧推送脚本同一套安全口径(一次性带凭据内嵌 URL;
不带密码退出 2 / 工作区不干净退出 3 / 推完核对「远端 = 本地」/ 复查 `.git/config` 无明文; 不带密码退出 2 / 工作区不干净退出 3 / 推完核对「远端 = 本地」/ 复查 `.git/config` 无明文;
**密码不内置进任何文件**),只是目标换成 `https://git.wangjinding.com/Jidekin/api-gateway.git`。 **密码不内置进任何文件**),只是目标换成 `https://git.wangjinding.com/Jidekin/xiaoyin-gateway.git`。
- **旧的推送脚本已停用并移除**(不再使用)。 - **旧的推送脚本已停用并移除**(不再使用)。
- **`README.md`**「版本号与发布纪律 → 发布流程」一节:推送目标改为 `推 Gitea`。 - **`README.md`**「版本号与发布纪律 → 发布流程」一节:推送目标改为 `推 Gitea`。
- **背景**:旧托管的凭据已实测失效(推送与 `ls-remote` 都回 `Repository Not Found.`);同期老板起了自建 Gitea - **背景**:旧托管的凭据已实测失效(推送与 `ls-remote` 都回 `Repository Not Found.`);同期老板起了自建 Gitea
(容器 `1Panel-gitea-CjQz`,`commitgo/gitea-ee:27.3.8`,公网 `https://git.wangjinding.com`), (容器 `1Panel-gitea-CjQz`,`commitgo/gitea-ee:27.3.8`,公网 `https://git.wangjinding.com`),
三个项目(`api-gateway` / `QwenPawChat` / `QwenPawChatWeChat`)都已建 **private** 仓库并推了**全量历史**。 三个项目(`xiaoyin-gateway` / `QwenPawChat` / `QwenPawChatWeChat`)都已建 **private** 仓库并推了**全量历史**。
- **remote 布局**:三个项目只留 `gitea` 一个远端(旧的 `origin` 已删除)。 - **remote 布局**:三个项目只留 `gitea` 一个远端(旧的 `origin` 已删除)。
- **待办**:若要免密自动推送,可在 Gitea 建 API token(需老板同意;本次没擅自建)。 - **待办**:若要免密自动推送,可在 Gitea 建 API token(需老板同意;本次没擅自建)。
@@ -656,7 +691,7 @@ token 正常(输入 41 / 输出 12 / 推理 12);成员视角只看到自
(切到 `agnes/agnes-3.0-flash` 报 401「无效的令牌」)。走网关的 `wangjinding` 正常 (切到 `agnes/agnes-3.0-flash` 报 401「无效的令牌」)。走网关的 `wangjinding` 正常
(网关侧 Agnes Key 是好的)。要用 Agnes 直连需先修 Key。 (网关侧 Agnes Key 是好的)。要用 Agnes 直连需先修 Key。
**上线**:`supervisorctl restart api-gateway:api-gateway_00` + `npm run build`; **上线**:`supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` + `npm run build`;
线上 `version=2.6.0`、入口 `index-BQYagb1Q.js`、Agents chunk `Agents-CN_agann.js`; 线上 `version=2.6.0`、入口 `index-BQYagb1Q.js`、Agents chunk `Agents-CN_agann.js`;
真机验证:下拉 112 项 / 7 组 → 选 `wjd` → UI 显示 `wjd` → 磁盘 `agent.json` 真机验证:下拉 112 项 / 7 组 → 选 `wjd` → UI 显示 `wjd` → 磁盘 `agent.json`
`{"provider_id":"wangjinding","model":"wjd"}` → 引擎回读一致 → 列表页同步。 `{"provider_id":"wangjinding","model":"wjd"}` → 引擎回读一致 → 列表页同步。
@@ -1019,7 +1054,7 @@ Prometheus:api_gateway_tokens_cached_total 1920 / api_gateway_tokens_reasoning
- `scripts/sync_models.py`:新增 `fetch_models_dev()`、`fetch_agnes_context()`(逐模型页解析「限制与价格」表),`diff()` 产出 `ctx_drift`,`apply_plan` 走 `_set_context`(块内改值、保留行尾注释、幂等),`verify()` 回读校验,报告显示漂移;`_DRIFT_KEYS` 与 `plan_is_empty` 认 `ctx_set`。 - `scripts/sync_models.py`:新增 `fetch_models_dev()`、`fetch_agnes_context()`(逐模型页解析「限制与价格」表),`diff()` 产出 `ctx_drift`,`apply_plan` 走 `_set_context`(块内改值、保留行尾注释、幂等),`verify()` 回读校验,报告显示漂移;`_DRIFT_KEYS` 与 `plan_is_empty` 认 `ctx_set`。
- 测试 **201 passed / 0 failed**(新增 3 个),`ci_check.sh` 全绿。 - 测试 **201 passed / 0 failed**(新增 3 个),`ci_check.sh` 全绿。
**上线**:`supervisorctl restart api-gateway:api-gateway_00`(pid 3492804)→ 实测 `/v1/models` 45 个模型、**38 个带 `context_window`**(含 `wjd` 别名继承 = 1,000,000 / 384,000),图片/视频模型正确为 0;health 200。代码已推远端(`08a4aee`,远端 = 本地)。 **上线**:`supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`(pid 3492804)→ 实测 `/v1/models` 45 个模型、**38 个带 `context_window`**(含 `wjd` 别名继承 = 1,000,000 / 384,000),图片/视频模型正确为 0;health 200。代码已推远端(`08a4aee`,远端 = 本地)。
## 2026-09-24 · 修「QwenPaw 缓存命中率恒 0」:流式 usage 丢掉 `prompt_tokens_details` ## 2026-09-24 · 修「QwenPaw 缓存命中率恒 0」:流式 usage 丢掉 `prompt_tokens_details`
@@ -1063,7 +1098,7 @@ Prometheus:api_gateway_tokens_cached_total 1920 / api_gateway_tokens_reasoning
### ① 删除 `opencode/deepseek-flash` / `opencode/omen-alpha` ### ① 删除 `opencode/deepseek-flash` / `opencode/omen-alpha`
- 此前在 `PROTECTED` 名单里护着(上游在服务、官方文档表未收录,怕收录滞后删错);老板拍板以上游文档为准 → **名单清空**(机制保留:以后要临时护住某个 id 在此登记即可;被别名 / media 引用的 id 本来就有独立保护)。 - 此前在 `PROTECTED` 名单里护着(上游在服务、官方文档表未收录,怕收录滞后删错);老板拍板以上游文档为准 → **名单清空**(机制保留:以后要临时护住某个 id 在此登记即可;被别名 / media 引用的 id 本来就有独立保护)。
- `--apply` 落盘删除,opencode 网关 35 → **33 = 文档 33**(Agnes 10 = 10,无漂移);两个模型块原文归档到 `/root/.trash/2026-09-24-opencode-models-doc-sync/removed-model-blocks.yaml`。 - `--apply` 落盘删除,opencode 网关 35 → **33 = 文档 33**(Agnes 10 = 10,无漂移);两个模型块原文归档到 `/root/.trash/<归档>/removed-model-blocks.yaml`。
- 线上确证:`hot_reload` 生效,`/models` 已不含这两个 id(总数 47 → 45),Agnes 的免费 / 限时免费标注不受影响。 - 线上确证:`hot_reload` 生效,`/models` 已不含这两个 id(总数 47 → 45),Agnes 的免费 / 限时免费标注不受影响。
- 顺手修一个删块 bug(本次实测踩到):`_find_model_blocks()` 用「下一个 `- id` 行」当块尾,会把**紧贴下一个模型的分组标题注释**(本文件惯例:`# ── …` 写在组里第一个模型上方;同步自己写的「官方文档新增」标记同理)一起吞掉 —— 删 `deepseek-flash` 时连带删了 `# ── Anthropic Messages 线(文档主推这条)`。现改为块尾只收口到「块头注释」之前(`_block_end` + `_BLOCK_HEADER_RE`),标题已恢复,回归用例 `test_remove_block_keeps_next_group_header_comment` 钉住。 - 顺手修一个删块 bug(本次实测踩到):`_find_model_blocks()` 用「下一个 `- id` 行」当块尾,会把**紧贴下一个模型的分组标题注释**(本文件惯例:`# ── …` 写在组里第一个模型上方;同步自己写的「官方文档新增」标记同理)一起吞掉 —— 删 `deepseek-flash` 时连带删了 `# ── Anthropic Messages 线(文档主推这条)`。现改为块尾只收口到「块头注释」之前(`_block_end` + `_BLOCK_HEADER_RE`),标题已恢复,回归用例 `test_remove_block_keeps_next_group_header_comment` 钉住。
- 测试 **196 passed / 0 failed**。 - 测试 **196 passed / 0 failed**。
@@ -1073,7 +1108,7 @@ Prometheus:api_gateway_tokens_cached_total 1920 / api_gateway_tokens_reasoning
`ecb99e6 → afd2f69 → 16d973c`,**远端 `master` tip = 本地 HEAD**,`.git/config` 无 token。 `ecb99e6 → afd2f69 → 16d973c`,**远端 `master` tip = 本地 HEAD**,`.git/config` 无 token。
### ③ 立「上生产必须同步推远端」规则(老板硬性要求) ### ③ 立「上生产必须同步推远端」规则(老板硬性要求)
- `README.md` 新增段落:凡**重启上线生产**(`supervisorctl restart api-gateway:api-gateway_00`)或 **`npm run build` 覆盖 `frontend/dist`** 的代码改动,验证通过后**必须**推远端;顺序=改代码 → 测试/CI → 上线 → 确证线上生效 → commit → push;纯注释/配置靠热重载生效的也照推。唯一原则:**线上跑着的代码 = 仓库里的代码**。 - `README.md` 新增段落:凡**重启上线生产**(`supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`)或 **`npm run build` 覆盖 `frontend/dist`** 的代码改动,验证通过后**必须**推远端;顺序=改代码 → 测试/CI → 上线 → 确证线上生效 → commit → push;纯注释/配置靠热重载生效的也照推。唯一原则:**线上跑着的代码 = 仓库里的代码**。
- 新增推送脚本:一次性带凭据内嵌 URL 推送,推完自动核对「远端 = 本地」并复查 `.git/config` 无凭据;无凭据退出 2、工作区不干净退出 3;**脚本内不内置凭据**(凭据只在 `MEMORY.md`)。 - 新增推送脚本:一次性带凭据内嵌 URL 推送,推完自动核对「远端 = 本地」并复查 `.git/config` 无凭据;无凭据退出 2、工作区不干净退出 3;**脚本内不内置凭据**(凭据只在 `MEMORY.md`)。
## 2026-09-24 · Agnes 免费 / 限时免费标注 + 免费标签间距对齐 ## 2026-09-24 · Agnes 免费 / 限时免费标注 + 免费标签间距对齐
@@ -1098,7 +1133,7 @@ Prometheus:api_gateway_tokens_cached_total 1920 / api_gateway_tokens_reasoning
### 上线 ### 上线
- 配置:`--apply` 落盘(备份 `data/gateway.yaml.bak`,权限 600,回读校验通过),`hot_reload` 自动生效。 - 配置:`--apply` 落盘(备份 `data/gateway.yaml.bak`,权限 600,回读校验通过),`hot_reload` 自动生效。
- 后端:`supervisorctl restart api-gateway:api-gateway_00`(pid 3465113,health 200)。 - 后端:`supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`(pid 3465113,health 200)。
- 前端:`npm run build` 覆盖 `frontend/dist`,线上 `/web` 已换 `index-CkVhRx-u.js` / `Models-RN5bN2Hd.js`(旧 chunk 404),入口包里能查到「限时免费」。 - 前端:`npm run build` 覆盖 `frontend/dist`,线上 `/web` 已换 `index-CkVhRx-u.js` / `Models-RN5bN2Hd.js`(旧 chunk 404),入口包里能查到「限时免费」。
- 实测 `/v1/models` 载荷:Agnes 6 个免费 + `agnes-video-2.5-flash` 限时免费 + 3 个付费档无标注;`space-bunny-free` 免费标注不受影响。 - 实测 `/v1/models` 载荷:Agnes 6 个免费 + `agnes-video-2.5-flash` 限时免费 + 3 个付费档无标注;`space-bunny-free` 免费标注不受影响。
@@ -1199,7 +1234,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
- **README**:供应商表模型数 17 → 35、模型清单小节按「线 + 免费」重写、三线直传小节数字同步。 - **README**:供应商表模型数 17 → 35、模型清单小节按「线 + 免费」重写、三线直传小节数字同步。
### 踩坑记录(下次别再犯) ### 踩坑记录(下次别再犯)
- 探测上游必须带**专属 UA**(`api-gateway/2.4.0 (jakon opencode-go)`):用 python urllib 的默认 UA - 探测上游必须带**专属 UA**(`xiaoyin-gateway/2.4.0 (jakon opencode-go)`):用 python urllib 的默认 UA
会被 Cloudflare 拦成 `403 error code: 1010`,看起来像"模型不可用",其实是 UA 被 ban。 会被 Cloudflare 拦成 `403 error code: 1010`,看起来像"模型不可用",其实是 UA 被 ban。
### 验证 ### 验证
@@ -1348,7 +1383,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
是对的。 是对的。
### 上线与验证 ### 上线与验证
- 后端 `supervisorctl restart api-gateway:api-gateway_00`;前端 `npm run build` 覆盖 - 后端 `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`;前端 `npm run build` 覆盖
`frontend/dist`(网关 `StaticFiles` 直接挂载)→ 线上入口 **`index-Bf3pWvHR.js`**。 `frontend/dist`(网关 `StaticFiles` 直接挂载)→ 线上入口 **`index-Bf3pWvHR.js`**。
- 生产验证:`/healthz` 200、登录页 + 中英切换(真浏览器)、`/health/agnes` 无凭据 401、 - 生产验证:`/healthz` 200、登录页 + 中英切换(真浏览器)、`/health/agnes` 无凭据 401、
`GET /` 导航无 `docs`、env 值校验 400 且文件未变、水印图下载 200、未登记 video_id 轮询 `GET /` 导航无 `docs`、env 值校验 400 且文件未变、水印图下载 200、未登记 video_id 轮询
@@ -1373,7 +1408,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
- 单测 173 passed / 0 failed(`test_conversation_id_isolated_per_account`、 - 单测 173 passed / 0 failed(`test_conversation_id_isolated_per_account`、
`test_api_conversation_id_flows_to_session_header`、`test_non_ascii_...` 已更新为「不传→非 `test_api_conversation_id_flows_to_session_header`、`test_non_ascii_...` 已更新为「不传→非
None 稳定会话」新语义) None 稳定会话」新语义)
- 生产已重启(`api-gateway:api-gateway_00`,pid 1488509),`/healthz` ok、无回归 - 生产已重启(`xiaoyin-gateway:xiaoyin-gateway_00`,pid 1488509),`/healthz` ok、无回归
- **真实的 `cached_tokens>0` 演示暂被挡**:opencode 免费 5 小时额度仍锁定(上游 429),待额度 - **真实的 `cached_tokens>0` 演示暂被挡**:opencode 免费 5 小时额度仍锁定(上游 429),待额度
重置(约 3h)后可再实测两通相同前缀调用确认命中。 重置(约 3h)后可再实测两通相同前缀调用确认命中。
@@ -1412,13 +1447,13 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
### 验证 ### 验证
- 后端单测:**165 passed / 0 failed**(删 6 个路由引擎用例、改写 10 个、新增 2 个)。 - 后端单测:**165 passed / 0 failed**(删 6 个路由引擎用例、改写 10 个、新增 2 个)。
- 前端:`vue-tsc --noEmit` 0 错、`npm run build` 成功、`check-i18n` 中英 699/699 对称。 - 前端:`vue-tsc --noEmit` 0 错、`npm run build` 成功、`check-i18n` 中英 699/699 对称。
- 生产**未动**:后端需 `supervisorctl restart api-gateway:api-gateway_00`(踢会话), - 生产**未动**:后端需 `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`(踢会话),
前端 dist 覆盖需老板点头。 前端 dist 覆盖需老板点头。
### 上线(老板批准重启,2026-09-18 15:16) ### 上线(老板批准重启,2026-09-18 15:16)
- 前端 `npm run build` 产物覆盖 `frontend/dist`(新入口 `index-CWUVm0px.js`,公网 - 前端 `npm run build` 产物覆盖 `frontend/dist`(新入口 `index-CWUVm0px.js`,公网
`https://api.wangjinding.com/web/...` 已服务新入口、旧入口 404)。 `http://127.0.0.1:8808/web/...` 已服务新入口、旧入口 404)。
- 后端 `supervisorctl restart api-gateway:api-gateway_00` → 新 pid,127.0.0.1:8808 正常, - 后端 `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` → 新 pid,127.0.0.1:8808 正常,
`/health` 200、启动日志「已加载 3 供应商」。 `/health` 200、启动日志「已加载 3 供应商」。
- **代码仍未提交 git**(老板明确要求"先别提交")。 - **代码仍未提交 git**(老板明确要求"先别提交")。
@@ -1450,7 +1485,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
(chat/completions 7106ms、responses 2014ms、messages 1360ms)。 (chat/completions 7106ms、responses 2014ms、messages 1360ms)。
按轮次记录 api-gateway 的修复与优化(README 侧重能力/配置说明,这里侧重每轮的改动、排查、验证与上线)。 按轮次记录 xiaoyin-gateway 的修复与优化(README 侧重能力/配置说明,这里侧重每轮的改动、排查、验证与上线)。
--- ---
@@ -1505,7 +1540,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
- 两个账号(admin / liunuanshu)用**同一个** `conversation_id` 各调 `kimi-k3` → **都 200**(派生后的值被上游正常接受); - 两个账号(admin / liunuanshu)用**同一个** `conversation_id` 各调 `kimi-k3` → **都 200**(派生后的值被上游正常接受);
- 缓存归属实验(直连上游、真实 key,prompt≈940 token):见上文**结论更正**的三组数据。 - 缓存归属实验(直连上游、真实 key,prompt≈940 token):见上文**结论更正**的三组数据。
- 文档:README 补「取值限制 / 派生规则 / OpenAI SDK 用 extra_body」+ 缓存结论更正;本 CHANGELOG 记一轮。 - 文档:README 补「取值限制 / 派生规则 / OpenAI SDK 用 extra_body」+ 缓存结论更正;本 CHANGELOG 记一轮。
- **上线状态**:含 Python 代码改动 → 需 `supervisorctl restart api-gateway:api-gateway_00` 才生效(会踢网页会话), - **上线状态**:含 Python 代码改动 → 需 `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` 才生效(会踢网页会话),
**待老板批准**;本轮无前端改动,不需要 `npm run build`。 **待老板批准**;本轮无前端改动,不需要 `npm run build`。
--- ---
@@ -1521,7 +1556,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
(否则"200"可能只是上游忽略图片块,无法证明它真的看了图)。 (否则"200"可能只是上游忽略图片块,无法证明它真的看了图)。
- **颜色判别(64×64 纯色 PNG,红 `220,30,30` / 蓝 `30,60,220` / 绿 `30,200,80`)**:`deepseek-v4.1-flash` - **颜色判别(64×64 纯色 PNG,红 `220,30,30` / 蓝 `30,60,220` / 绿 `30,200,80`)**:`deepseek-v4.1-flash`
**红/蓝/绿三色全部答对**,与已标视觉的 `deepseek-v4-flash-vision-exp` 表现完全一致。 **红/蓝/绿三色全部答对**,与已标视觉的 `deepseek-v4-flash-vision-exp` 表现完全一致。
- **过网关复测**(公网 `https://api.wangjinding.com`):直连 `deepseek-v4.1-flash` 三色全对;路由别名 `wjd` - **过网关复测**(公网 `http://127.0.0.1:8808`):直连 `deepseek-v4.1-flash` 三色全对;路由别名 `wjd`
带图请求被排到视觉模型、答对「红色」。 带图请求被排到视觉模型、答对「红色」。
- **踩坑(判定方法的坑)**:它是**推理模型**,`max_tokens` 给小了(首次探针用 40)时 token 全被 - **踩坑(判定方法的坑)**:它是**推理模型**,`max_tokens` 给小了(首次探针用 40)时 token 全被
`reasoning_content` 吃光、`content` 返回空串——**看起来像"只收图不回答"**。复测放大到 300+ 才拿到答案。 `reasoning_content` 吃光、`content` 返回空串——**看起来像"只收图不回答"**。复测放大到 300+ 才拿到答案。
@@ -1575,7 +1610,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
- **单测**:**168 passed / 0 failed**(+10:参数解析/白名单拦截/真配置锁定/强制覆盖/自动修正重发/不无限重试/配置冲突/流式修正/测速文案/面板保留 params);前端 `vue-tsc --noEmit` 通过、`check:i18n` 726/726 对称、`check:svg` 通过、`npm run build` 成功(在副本内构建,未覆盖生产 dist)。 - **单测**:**168 passed / 0 failed**(+10:参数解析/白名单拦截/真配置锁定/强制覆盖/自动修正重发/不无限重试/配置冲突/流式修正/测速文案/面板保留 params);前端 `vue-tsc --noEmit` 通过、`check:i18n` 726/726 对称、`check:svg` 通过、`npm run build` 成功(在副本内构建,未覆盖生产 dist)。
### 上线(待老板批准) ### 上线(待老板批准)
- 含 Python 代码改动(`config` / `adapters` / `main` / `settings`)→ 需 `supervisorctl restart api-gateway:api-gateway_00` 才生效(会踢网页会话)。 - 含 Python 代码改动(`config` / `adapters` / `main` / `settings`)→ 需 `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` 才生效(会踢网页会话)。
- 前端需 `npm run build` 覆盖 `frontend/dist`(挂锁/提示条才会出现在线上)。 - 前端需 `npm run build` 覆盖 `frontend/dist`(挂锁/提示条才会出现在线上)。
- 远端推送新增提交。 - 远端推送新增提交。
@@ -1612,7 +1647,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
### 改动 ### 改动
- **`data/.env`**:新增 `OPENCODE_API_KEY`(600、gitignored)。 - **`data/.env`**:新增 `OPENCODE_API_KEY`(600、gitignored)。
- **`data/gateway.yaml`**: - **`data/gateway.yaml`**:
- 新增 `providers.opencode`:`base_url https://opencode.ai/zen/go/v1`、`token_env OPENCODE_API_KEY`、`requires_session_header: true`、`extra_headers.User-Agent: api-gateway/2.4.0 (jakon opencode-go)`,收录 **17 个**文本模型(`glm-5.3-flash/5.3/5.2/5.1`、`kimi-k3/k2.7-code/k2.6`、`longcat-2.0`、`deepseek-v4-pro/v4-flash/flash/v4.1-flash/v4-flash-vision-exp(视觉)`、`mimo-v2.5/v2.5-pro`、`hy4-preview/hy3`)。 - 新增 `providers.opencode`:`base_url https://opencode.ai/zen/go/v1`、`token_env OPENCODE_API_KEY`、`requires_session_header: true`、`extra_headers.User-Agent: xiaoyin-gateway/2.4.0 (jakon opencode-go)`,收录 **17 个**文本模型(`glm-5.3-flash/5.3/5.2/5.1`、`kimi-k3/k2.7-code/k2.6`、`longcat-2.0`、`deepseek-v4-pro/v4-flash/flash/v4.1-flash/v4-flash-vision-exp(视觉)`、`mimo-v2.5/v2.5-pro`、`hy4-preview/hy3`)。
- `routes.wjd` 追加这 17 个(wjd 链 = 20 个文本模型)。 - `routes.wjd` 追加这 17 个(wjd 链 = 20 个文本模型)。
- 未收录:`glm-5`、`kimi-k2.5`、`hy3-preview`(上游实测 400 Model is unavailable);`/messages`、`/responses` 线模型未接入(适配器不含该契约)。 - 未收录:`glm-5`、`kimi-k2.5`、`hy3-preview`(上游实测 400 Model is unavailable);`/messages`、`/responses` 线模型未接入(适配器不含该契约)。
- **`app/config.py`**:`ProviderConfig` 加 `requires_session_header` 字段并解析。 - **`app/config.py`**:`ProviderConfig` 加 `requires_session_header` 字段并解析。
@@ -1632,7 +1667,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
- 单测:**155 passed / 0 failed**;前端 `vue-tsc --noEmit` 通过。 - 单测:**155 passed / 0 failed**;前端 `vue-tsc --noEmit` 通过。
### 上线(待老板批准) ### 上线(待老板批准)
- 含 Python 代码改动(config / adapters / settings)→ 需 `supervisorctl restart api-gateway:api-gateway_00` 才生效(会踢网页会话);纯 yaml 的 hot_reload 只重载供应商/模型定义,`requires_session_header` 字段与注入逻辑要重启后代码才认。 - 含 Python 代码改动(config / adapters / settings)→ 需 `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` 才生效(会踢网页会话);纯 yaml 的 hot_reload 只重载供应商/模型定义,`requires_session_header` 字段与注入逻辑要重启后代码才认。
- 前端 build 覆盖 `dist`(纯前端上线动作)与远端推送待老板确认。 - 前端 build 覆盖 `dist`(纯前端上线动作)与远端推送待老板确认。
**一句话**:老板拍板——**现有 + 以后新增的每一个文本模型都必须加入 `routes.wjd` 兜底链**。本次把 `agnes-2.5-flash` 补进 wjd,并把这句作为长期规则写入 MEMORY / README / CHANGELOG,供后续新增模型照做。 **一句话**:老板拍板——**现有 + 以后新增的每一个文本模型都必须加入 `routes.wjd` 兜底链**。本次把 `agnes-2.5-flash` 补进 wjd,并把这句作为长期规则写入 MEMORY / README / CHANGELOG,供后续新增模型照做。
@@ -1694,7 +1729,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
- 单测 **155 passed / 0 failed**;全项目 grep `智谱|bigmodel|GLM|cogview|cogvideox|ufileos|ZHIPU|zhipu|video_style|_ZHIPU` 除 CHANGELOG 历史外**全部清零**。 - 单测 **155 passed / 0 failed**;全项目 grep `智谱|bigmodel|GLM|cogview|cogvideox|ufileos|ZHIPU|zhipu|video_style|_ZHIPU` 除 CHANGELOG 历史外**全部清零**。
- 前端 `npm run build` 过(typecheck + i18n 对称),新入口 `index-BynIw5Ue.js`。 - 前端 `npm run build` 过(typecheck + i18n 对称),新入口 `index-BynIw5Ue.js`。
- 配置校验:providers `[agnes,volc_engine]`、模型 `agnes[3] + volc[1]`、`routes.wjd` 2 项、下载白名单仅 Agnes。 - 配置校验:providers `[agnes,volc_engine]`、模型 `agnes[3] + volc[1]`、`routes.wjd` 2 项、下载白名单仅 Agnes。
- `supervisorctl restart api-gateway:api-gateway_00` 上线(`description`/适配器/校验等属代码改动,需重启)。 - `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` 上线(`description`/适配器/校验等属代码改动,需重启)。
--- ---
@@ -1745,7 +1780,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
### 验证 ### 验证
- 单测:新增/修正 bigmodel 媒体契约断言、视频轮询必经 `?model=`(现两家视频供应商)、配置往返含新 media 键 → **155 passed / 0 failed**;前端 `npm run build` 过(typecheck + i18n 对称),新入口 `index-CxdHy_Sw.js`。 - 单测:新增/修正 bigmodel 媒体契约断言、视频轮询必经 `?model=`(现两家视频供应商)、配置往返含新 media 键 → **155 passed / 0 failed**;前端 `npm run build` 过(typecheck + i18n 对称),新入口 `index-CxdHy_Sw.js`。
- 真机隔离(uvicorn:8899 临时 users/history,连真实智谱):`/v1/models` 列出 8 个智谱模型;图像 → 200 `data[].url`;视频创建 → `video_id`+`task_status:PROCESSING`;轮询 → `status:processing`;非法参数(`mode=keyframe`)→ 400 干净拒绝。 - 真机隔离(uvicorn:8899 临时 users/history,连真实智谱):`/v1/models` 列出 8 个智谱模型;图像 → 200 `data[].url`;视频创建 → `video_id`+`task_status:PROCESSING`;轮询 → `status:processing`;非法参数(`mode=keyframe`)→ 400 干净拒绝。
- 上线:`supervisorctl restart api-gateway:api-gateway_00`(代码改动需重启),前端 dist 已 build 覆盖。 - 上线:`supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`(代码改动需重启),前端 dist 已 build 覆盖。
- **补「下载白名单」**:上线后老板实测智谱图/视频下载报「不在白名单:maas-watermark-prod-new.cn-wlcb.ufileos.com」。已确认智谱图+视频产物**同一 CDN 域名**(实测视频 `SUCCESS` 结果 url 同域),在 `download.allowed_hosts` 补 `maas-watermark-prod-new.cn-wlcb.ufileos.com`(精确项 + 子域匹配,不泛放整个 `ufileos.com`;`evilufileos.com`、后缀撞车域名仍拒绝)。纯配置改动,`hot_reload` ≤15s 自动生效免重启。已用隔离服务器实测:智谱图经 `/v1/media/download` 拉回 200 + 有效 JPEG 97KB。 - **补「下载白名单」**:上线后老板实测智谱图/视频下载报「不在白名单:maas-watermark-prod-new.cn-wlcb.ufileos.com」。已确认智谱图+视频产物**同一 CDN 域名**(实测视频 `SUCCESS` 结果 url 同域),在 `download.allowed_hosts` 补 `maas-watermark-prod-new.cn-wlcb.ufileos.com`(精确项 + 子域匹配,不泛放整个 `ufileos.com`;`evilufileos.com`、后缀撞车域名仍拒绝)。纯配置改动,`hot_reload` ≤15s 自动生效免重启。已用隔离服务器实测:智谱图经 `/v1/media/download` 拉回 200 + 有效 JPEG 97KB。
--- ---
@@ -1828,7 +1863,7 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
- `test_feedback_withdraw_only_when_pending`:feedback 撤回逻辑,非本次改动范围。 - `test_feedback_withdraw_only_when_pending`:feedback 撤回逻辑,非本次改动范围。
### 部署 ### 部署
- `supervisorctl restart api-gateway:api-gateway_00`。 - `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`。
- 重启前验证文件已就位:yaml `safe_load` 通过、`providers = [agnes, b_ai, volc_engine, opencode]`、opencode 4 个模型。 - 重启前验证文件已就位:yaml `safe_load` 通过、`providers = [agnes, b_ai, volc_engine, opencode]`、opencode 4 个模型。
- 上线后校验:新 pid 61457、healthz `{"status":"ok"}`、`/v1/models` 200 且含 opencode 4 个免费模型、无凭证/错 key 仍 401、真实 chat 调用 `provider=opencode` 返回 200。 - 上线后校验:新 pid 61457、healthz `{"status":"ok"}`、`/v1/models` 200 且含 opencode 4 个免费模型、无凭证/错 key 仍 401、真实 chat 调用 `provider=opencode` 返回 200。
@@ -1971,4 +2006,4 @@ dict 即使一个模型都没变也是**真值** → 每天无漂移也重写一
- 项目此前**不是 git 仓库**:`git init` 建库、设提交身份、首次提交(**91 个源码文件**)。 - 项目此前**不是 git 仓库**:`git init` 建库、设提交身份、首次提交(**91 个源码文件**)。
- **`.gitignore` 补充**忽略 `node_modules/`、`frontend/node_modules/`、`frontend/dist/`、`dist/`、`*.egg-info/`、`.DS_Store` —— 否则 `git add -A` 会把 **15342 个 node_modules 文件**塞进仓库。 - **`.gitignore` 补充**忽略 `node_modules/`、`frontend/node_modules/`、`frontend/dist/`、`dist/`、`*.egg-info/`、`.DS_Store` —— 否则 `git add -A` 会把 **15342 个 node_modules 文件**塞进仓库。
- **推送前安全审计**:确认 `.env`、`data/users.json`、`data/history.json`、`data/feedback.json`、`data/feedback_media/` 全部被忽略、无任何密钥/隐私入库(仅无密钥的 `.env.example` 模板随库)。 - **推送前安全审计**:确认 `.env`、`data/users.json`、`data/history.json`、`data/feedback.json`、`data/feedback_media/` 全部被忽略、无任何密钥/隐私入库(仅无密钥的 `.env.example` 模板随库)。
- **远程**:远端仓库 `Jidekin/api-gateway`,分支 `master`(2026-10-12 起统一为 `main`),首推成功(远端 `HEAD=6cc65ff` 与本地一致)。`origin` 配为不含凭据的干净地址,**凭据不写入 `.git/config`**;后续推送临时带凭据。 - **远程**:远端仓库 `Jidekin/xiaoyin-gateway`,分支 `master`(2026-10-12 起统一为 `main`),首推成功(远端 `HEAD=6cc65ff` 与本地一致)。`origin` 配为不含凭据的干净地址,**凭据不写入 `.git/config`**;后续推送临时带凭据。
+2 -2
View File
@@ -1,4 +1,4 @@
# API Gateway 快捷命令 # 小银网关 快捷命令
# Windows 若无 make,可手动执行对应命令;或装 https://chocolatey.org/packages/make # Windows 若无 make,可手动执行对应命令;或装 https://chocolatey.org/packages/make
.DEFAULT_GOAL := help .DEFAULT_GOAL := help
@@ -8,7 +8,7 @@ PORT ?= 8808
.PHONY: help install run test lint clean .PHONY: help install run test lint clean
help: ## 显示帮助 help: ## 显示帮助
@echo "api-gateway 常用命令:" @echo "小银网关 常用命令:"
@echo " make install 安装依赖" @echo " make install 安装依赖"
@echo " make run 本地启动(端口 $(PORT))" @echo " make run 本地启动(端口 $(PORT))"
@echo " make test 跑单元测试(不依赖真实上游)" @echo " make test 跑单元测试(不依赖真实上游)"
+26 -26
View File
@@ -1,4 +1,4 @@
# API Gateway # 小银网关
统一多供应商 LLM 接入网关,纯后端 FastAPI,配置驱动。支持 **Agnes AI**、**OpenCode Go**、**Dots AI(小红书)** 三个供应商,全部走 OpenAI 兼容协议。v2.4 已集成熔断、限流、图像/视频、指标、成本估算、热加载、测试等完整能力。 统一多供应商 LLM 接入网关,纯后端 FastAPI,配置驱动。支持 **Agnes AI**、**OpenCode Go**、**Dots AI(小红书)** 三个供应商,全部走 OpenAI 兼容协议。v2.4 已集成熔断、限流、图像/视频、指标、成本估算、热加载、测试等完整能力。
@@ -21,7 +21,7 @@
## 架构 ## 架构
``` ```
api-gateway/ xiaoyin-gateway/
├── data/gateway.yaml # 默认运行时配置(run.py 读取,hot_reload 开) ├── data/gateway.yaml # 默认运行时配置(run.py 读取,hot_reload 开)
├── app/ ├── app/
│ ├── config.py # YAML 加载 → dataclass(供应商/模型/协议线/鉴权/熔断/可观测/定价) │ ├── config.py # YAML 加载 → dataclass(供应商/模型/协议线/鉴权/熔断/可观测/定价)
@@ -486,7 +486,7 @@ pricing: # 人民币/百万 token,用于估算成本
## 启动 ## 启动
```bash ```bash
cd api-gateway cd xiaoyin-gateway
pip install -r requirements.txt pip install -r requirements.txt
python run.py # 默认读 data/gateway.yaml,端口 8808 python run.py # 默认读 data/gateway.yaml,端口 8808
``` ```
@@ -611,7 +611,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
## 前端 Web 控制台 ## 前端 Web 控制台
- 前端由网关托管:`frontend/dist` 由网关挂在 `/web`(同源、公开无密钥),浏览入口 - 前端由网关托管:`frontend/dist` 由网关挂在 `/web`(同源、公开无密钥),浏览入口
`https://api.wangjinding.com/web/`(哈希路由,默认 `/web/#/dashboard`,未登录跳 `/web/#/login`)。 `http://127.0.0.1:8808/web/`(哈希路由,默认 `/web/#/dashboard`,未登录跳 `/web/#/login`)。
- 登录:POST `/auth/login` 用原始 key 换会话(`sess-` 前缀、TTL 滑动过期 86400s), - 登录:POST `/auth/login` 用原始 key 换会话(`sess-` 前缀、TTL 滑动过期 86400s),
前端不持原始 key;登出 `/auth/logout`。 前端不持原始 key;登出 `/auth/logout`。
- 根路径 `/`:浏览器(`Accept: text/html`)访问自动 307 跳 `/web/`;API 调用(Accept 无 - 根路径 `/`:浏览器(`Accept: text/html`)访问自动 307 跳 `/web/`;API 调用(Accept 无
@@ -734,7 +734,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
`hint`/`feats` 节点确认为 0、窄屏 `.login-art` 已带 `url(login-banner-*.svg)` 且 `.orb` 为 `display:none`、 `hint`/`feats` 节点确认为 0、窄屏 `.login-art` 已带 `url(login-banner-*.svg)` 且 `.orb` 为 `display:none`、
真实交互(输入框聚焦输入、右上角切换器切到 English 后文案变 `Sign in`)通过; 真实交互(输入框聚焦输入、右上角切换器切到 English 后文案变 `Sign in`)通过;
`typecheck` 0 error、`npm run build` 成功(新产物 `index-DG7g6NaW.js` / `Login--E4bzU7N.css` / `typecheck` 0 error、`npm run build` 成功(新产物 `index-DG7g6NaW.js` / `Login--E4bzU7N.css` /
`login-banner-7rrSIoiP.svg`)。线上 `https://api.wangjinding.com/web/#/login` 已服务新产物 `login-banner-7rrSIoiP.svg`)。线上 `http://127.0.0.1:8808/web/#/login` 已服务新产物
(公网取 `login-banner-7rrSIoiP.svg` 200 / 7139B),后端零改动、未重启。 (公网取 `login-banner-7rrSIoiP.svg` 200 / 7139B),后端零改动、未重启。
另修一处小 a11y 问题:`i18n.ts` 只在 `setLocale()` 里写 `<html lang>`,初始化路径漏了, 另修一处小 a11y 问题:`i18n.ts` 只在 `setLocale()` 里写 `<html lang>`,初始化路径漏了,
导致 localStorage 存 `en` 的用户 `lang` 一直停在 `zh-CN`;改为模块初始化时也写一次。 导致 localStorage 存 `en` 的用户 `lang` 一直停在 `zh-CN`;改为模块初始化时也写一次。
@@ -745,7 +745,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
不再额外发任何请求。i18n 无改动(那行是直读 `/healthz` 与 `location.origin`,没走 `t()`), 不再额外发任何请求。i18n 无改动(那行是直读 `/healthz` 与 `location.origin`,没走 `t()`),
无 key 残留。 无 key 残留。
② 整页重做为**三套设计稿**,落在 `design/login-v3/`(该目录 2026-09-13 按老板指示清理归档,未 `rm`,恢复见 ② 整页重做为**三套设计稿**,落在 `design/login-v3/`(该目录 2026-09-13 按老板指示清理归档,未 `rm`,恢复见
`/root/.trash/2026-09-13-api-gateway-cleanup/MANIFEST.md`):`d1.html` 极简白卡(浅底单列居中卡)、 `/root/.trash/<归档>/MANIFEST.md`):`d1.html` 极简白卡(浅底单列居中卡)、
`d2.html` 深色玻璃卡(深色科技底 + 毛玻璃)、`d3.html` 通栏一体(左侧主题色品牌面 + 右侧白色 `d2.html` 深色玻璃卡(深色科技底 + 毛玻璃)、`d3.html` 通栏一体(左侧主题色品牌面 + 右侧白色
表单面,整屏无卡片框);`h.html` 是「iframe 定尺预览机」(每条 `文件:宽x高x缩放`,按指定视口 表单面,整屏无卡片框);`h.html` 是「iframe 定尺预览机」(每条 `文件:宽x高x缩放`,按指定视口
真实渲染再 scale 进浏览器窗口),出稿对照图都用它。三套各含桌面端与手机端形态、token 口径与 真实渲染再 scale 进浏览器窗口),出稿对照图都用它。三套各含桌面端与手机端形态、token 口径与
@@ -769,17 +769,17 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
`index-BWFYxQdn.js`);用同源探针 `probe.html`(原 `design/login-v3/probe.html`,已随设计稿目录归档)逐格量过 **3 主题 × 7 分辨率** `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 组: (1280×720 / 1024×768 / 1440×900 / 1920×1080 / 390×844 / 360×640 / 414×896)共 21 组:
全部 `ovX=ovY=0` 无溢出、卡片 440×444 居中、三主题的卡片 / 按钮 / logo / 聚焦环颜色各自正确、 全部 `ovX=ovY=0` 无溢出、卡片 440×444 居中、三主题的卡片 / 按钮 / logo / 聚焦环颜色各自正确、
旧结构节点 0;英文单独验过(`API Gateway Console` / `Username` / `Password` / `Sign in`、 旧结构节点 0;英文单独验过(`Xiaoyin Gateway Console` / `Username` / `Password` / `Sign in`、
`<html lang="en">`、卡片 434 高同样无溢出);真机交互验过语言切换(右上角胶囊 → English → `<html lang="en">`、卡片 434 高同样无溢出);真机交互验过语言切换(右上角胶囊 → English →
文案与 `<html lang>` 同步)与空提交报错(卡片内红色提示、卡片自动增高不溢出)。 文案与 `<html lang>` 同步)与空提交报错(卡片内红色提示、卡片自动增高不溢出)。
线上 `https://api.wangjinding.com/web/#/login` 已服务新产物(`Login-CazImMjd.css` 200 / 4426B, 线上 `http://127.0.0.1:8808/web/#/login` 已服务新产物(`Login-CazImMjd.css` 200 / 4426B,
旧 `Login-BMLIXfzt.css` 404),后端零改动、未重启。 旧 `Login-BMLIXfzt.css` 404),后端零改动、未重启。
> 探针为什么挂在 vite dev 上:CSP 里有 `frame-ancestors 'none'`(安全项,不为此放宽), > 探针为什么挂在 vite dev 上:CSP 里有 `frame-ancestors 'none'`(安全项,不为此放宽),
> `/web` 下的页面不能被 iframe 嵌(`__probe.html` 放 `/web` 里量不到东西),所以改用 > `/web` 下的页面不能被 iframe 嵌(`__probe.html` 放 `/web` 里量不到东西),所以改用
> **无 CSP 的 vite dev(`--port 5199`)**同源托管探针:同源才能读 iframe 的 DOM、才能直接写 > **无 CSP 的 vite dev(`--port 5199`)**同源托管探针:同源才能读 iframe 的 DOM、才能直接写
> `localStorage` 切主题/语言,再逐格量溢出与计算样式。探针跑完即从 `frontend/public/` 删除 > `localStorage` 切主题/语言,再逐格量溢出与计算样式。探针跑完即从 `frontend/public/` 删除
> (否则会被 build 拷进 `dist`),只留 `design/login-v3/probe.html` 这一份;该探针与三套设计稿 > (否则会被 build 拷进 `dist`),只留 `design/login-v3/probe.html` 这一份;该探针与三套设计稿
> 已于 2026-09-13 一并归档到 `/root/.trash/2026-09-13-api-gateway-cleanup/`(未 `rm`,可恢复)。 > 已于 2026-09-13 一并归档到 `/root/.trash/<归档>/`(未 `rm`,可恢复)。
- 修 data URI 下载的 CSP 坑:产物是 `data:` 时原实现用 `fetch(dataURI)` 取字节,而 CSP - 修 data URI 下载的 CSP 坑:产物是 `data:` 时原实现用 `fetch(dataURI)` 取字节,而 CSP
`connect-src 'self'` 会把它拦掉(上游以 base64 直回图片时「下载」必失败,本地 vite preview `connect-src 'self'` 会把它拦掉(上游以 base64 直回图片时「下载」必失败,本地 vite preview
无 CSP 时看不出来)。改为本地 base64 解码 `dataUriToBlob()`,不触网、也不动 CSP 白名单。 无 CSP 时看不出来)。改为本地 base64 解码 `dataUriToBlob()`,不触网、也不动 CSP 白名单。
@@ -844,7 +844,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 来源:老板要求全站体检(前端 8 分辨率 × 3 主题 × 中英 × 11 页 + 后端 130 单测), > 来源:老板要求全站体检(前端 8 分辨率 × 3 主题 × 中英 × 11 页 + 后端 130 单测),
> 体检发现的问题**全部核实属实**后按 P0 → P1 → P2 顺序修完。 > 体检发现的问题**全部核实属实**后按 P0 → P1 → P2 顺序修完。
> (注:README 的轮次序列主线是后端修复轮(第九~十六轮),媒体产物下载与前端整体重设计两轮未单独编号; > (注:README 的轮次序列主线是后端修复轮(第九~十六轮),媒体产物下载与前端整体重设计两轮未单独编号;
> 本轮即「体检发现项修复」轮,内部代号 `fix18`,备份在 `/root/.trash/2026-09-13-fix18-backup/`。) > 本轮即「体检发现项修复」轮,内部代号 `fix18`,备份在 `/root/.trash/<归档>/`。)
> >
> - **P0 全局类名撞车(真 Bug,肉眼可见)**:`style.css` 里有个全局进度条样式 > - **P0 全局类名撞车(真 Bug,肉眼可见)**:`style.css` 里有个全局进度条样式
> `.bar { height: 5px; overflow: hidden }`,而**对话页输入区那一行按钮的容器 class 也叫 `bar`** —— > `.bar { height: 5px; overflow: hidden }`,而**对话页输入区那一行按钮的容器 class 也叫 `bar`** ——
@@ -886,13 +886,13 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 改为 `repeat(2, minmax(0, 1fr))`(手机端原来的两列覆盖也随之删掉,规则收敛到 `style.css` 一处), > 改为 `repeat(2, minmax(0, 1fr))`(手机端原来的两列覆盖也随之删掉,规则收敛到 `style.css` 一处),
> 每格 141px(可用 127px):中英标签全部单行、三格等高(zh 49px / en 46px)、右边界距卡片 15px。 > 每格 141px(可用 127px):中英标签全部单行、三格等高(zh 49px / en 46px)、右边界距卡片 15px。
> 实测 1280/1440/1024 桌面 + 390 手机 × 中英 7 组全部 `折行=no`、横向溢出 0。 > 实测 1280/1440/1024 桌面 + 390 手机 × 中英 7 组全部 `折行=no`、横向溢出 0。
> - 上线与复核(2026-09-13 17:13 老板批准重启):`supervisorctl restart api-gateway:api-gateway_00`; > - 上线与复核(2026-09-13 17:13 老板批准重启):`supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`;
> 线上 `/healthz` 200、非对象 JSON 400、错误密码 401、无凭证 401;线上 CSS 内含 `.meter{height:5px}`、 > 线上 `/healthz` 200、非对象 JSON 400、错误密码 401、无凭证 401;线上 CSS 内含 `.meter{height:5px}`、
> `.set-row>.lb{...flex:0 0 auto}`、手机端 `min-height:34px`,旧的 `.bar{height:5px` 已消失; > `.set-row>.lb{...flex:0 0 auto}`、手机端 `min-height:34px`,旧的 `.bar{height:5px` 已消失;
> 专项探针 24 组合(B/A/C 主题 × 1280/390 × 6 页)横向溢出全 0,输入区 34/86px、张数输入 51px、 > 专项探针 24 组合(B/A/C 主题 × 1280/390 × 6 页)横向溢出全 0,输入区 34/86px、张数输入 51px、
> 手机触控目标 34px、字号 11.5px,`.acc-sub` 仅手机显示、操作按钮 3 个全在屏内。 > 手机触控目标 34px、字号 11.5px,`.acc-sub` 仅手机显示、操作按钮 3 个全在屏内。
> 收尾(同日傍晚,老板「收掉、清掉、改」):临时体检环境(后端 8899 + vite dev 5199 + `gwcheck.vite.config.mts`) > 收尾(同日傍晚,老板「收掉、清掉、改」):临时体检环境(后端 8899 + vite dev 5199 + `gwcheck.vite.config.mts`)
> 已停进程并归档到 `/root/.trash/2026-09-13-fix18-cleanup/`(含 MANIFEST.md 与恢复命令); > 已停进程并归档到 `/root/.trash/<归档>/`(含 MANIFEST.md 与恢复命令);
> `frontend/dist.bak-0913-0127` 与 4 处 `__pycache__` 同样归档;场景卡改两列后构建并上线 > `frontend/dist.bak-0913-0127` 与 4 处 `__pycache__` 同样归档;场景卡改两列后构建并上线
> (`index-Gg1BF2WV.js` / `index-DdRZNrpf.css`,纯静态切换、后端零改动未重启); > (`index-Gg1BF2WV.js` / `index-DdRZNrpf.css`,纯静态切换、后端零改动未重启);
> 顺手补 `.gitignore` 里漏掉的 `.test_history.json`。 > 顺手补 `.gitignore` 里漏掉的 `.test_history.json`。
@@ -1075,7 +1075,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> - 未实测项(如实记):**390px 手机断点没测到** —— 本会话浏览器没有视口控制(试过 Ctrl+缩放压低 CSS 视口无效),故用 `flex-wrap` 兜住「5 颗图标超宽」的最坏情况,建议真机上瞄一眼。 > - 未实测项(如实记):**390px 手机断点没测到** —— 本会话浏览器没有视口控制(试过 Ctrl+缩放压低 CSS 视口无效),故用 `flex-wrap` 兜住「5 颗图标超宽」的最坏情况,建议真机上瞄一眼。
> >
> - **上线(2026-09-13 20:0x,老板批准)**:`npm run build` → 线上现役 `index-BYW9huII.js` / `index-BCEpjaoj.css` / `Users-Ym7Y7v4h.js`(旧 `index-BV89HnWe.js` 已 404); > - **上线(2026-09-13 20:0x,老板批准)**:`npm run build` → 线上现役 `index-BYW9huII.js` / `index-BCEpjaoj.css` / `Users-Ym7Y7v4h.js`(旧 `index-BV89HnWe.js` 已 404);
> `supervisorctl restart api-gateway:api-gateway_00`(旧 pid 2102891 → 新 pid 2157737,仍监听 `127.0.0.1:8808`)。 > `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00`(旧 pid 2102891 → 新 pid 2157737,仍监听 `127.0.0.1:8808`)。
> **本轮有后端改动,重启会清空内存态网页会话 —— 所有人(含 admin)需要重新登录。** > **本轮有后端改动,重启会清空内存态网页会话 —— 所有人(含 admin)需要重新登录。**
> 复核:公网 `/healthz` 200、`/web/` 200 且引用新 hash、新 asset 200(`immutable` 长缓存)与旧 asset 404、 > 复核:公网 `/healthz` 200、`/web/` 200 且引用新 hash、新 asset 200(`immutable` 长缓存)与旧 asset 404、
> CSP 未放宽、`index.html` 仍 `no-cache`;新端点在线判据 = 无凭证调 `PUT /auth/users/x/disabled` 得 **401**(旧代码是 404)。 > CSP 未放宽、`index.html` 仍 `no-cache`;新端点在线判据 = 无凭证调 `PUT /auth/users/x/disabled` 得 **401**(旧代码是 404)。
@@ -1120,7 +1120,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 「跳到」滚动生效(目标卡片 y 4221 → 62)、会话时长改成 45 保存 → 盘上文件立刻更新且生成 `.bak`(权限 600)、 > 「跳到」滚动生效(目标卡片 y 4221 → 62)、会话时长改成 45 保存 → 盘上文件立刻更新且生成 `.bak`(权限 600)、
> 页面出「已保存并生效」。 > 页面出「已保存并生效」。
> - 上线:`npm run build` → 线上现役 `index-T9rUvEqS.js` / `GatewayConfig-Cujt5GjO.js` > - 上线:`npm run build` → 线上现役 `index-T9rUvEqS.js` / `GatewayConfig-Cujt5GjO.js`
> (旧 `index-BMd-U-9_.js` 已 404);`supervisorctl restart api-gateway:api-gateway_00` → > (旧 `index-BMd-U-9_.js` 已 404);`supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` →
> 新 pid **2102891**(`127.0.0.1:8808`)—— **本轮有后端改动,重启踢掉所有网页会话,需重新登录**。 > 新 pid **2102891**(`127.0.0.1:8808`)—— **本轮有后端改动,重启踢掉所有网页会话,需重新登录**。
> 随后小修一处文案(`{'{'}"status":"ok"{'}'}` 里花括号写法之间多打了空格,渲染成 `{ "status":"ok" }`, > 随后小修一处文案(`{'{'}"status":"ok"{'}'}` 里花括号写法之间多打了空格,渲染成 `{ "status":"ok" }`,
> 与 /health 真实报文不符)→ 再 `npm run build` → 现役 **`index-CladK7BT.js` / > 与 /health 真实报文不符)→ 再 `npm run build` → 现役 **`index-CladK7BT.js` /
@@ -1132,7 +1132,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 线上产物含 `sec-server` / `sec-download` 分区。 > 线上产物含 `sec-server` / `sec-download` 分区。
> 线上逐屏复核没做(当前管理员密码非默认值,小银不掌握、也不去试),面板的浏览器实测以隔离实例为准。 > 线上逐屏复核没做(当前管理员密码非默认值,小银不掌握、也不去试),面板的浏览器实测以隔离实例为准。
> - 收尾:隔离实例 8899 已 kill(线上 8808 未受影响),`/tmp` 残留与临时配置副本归档到 > - 收尾:隔离实例 8899 已 kill(线上 8808 未受影响),`/tmp` 残留与临时配置副本归档到
> `/root/.trash/2026-09-13-gw23-cleanup/`(含 `MANIFEST.md`),`frontend/public/` 与 `dist/` 无探针残留。 > `/root/.trash/<归档>/`(含 `MANIFEST.md`),`frontend/public/` 与 `dist/` 无探针残留。
> >
> - **追加一(同日 19:2x,老板「模型定价去掉」「左侧菜单上下间距缩短一点,让滚动条不要出现」)** > - **追加一(同日 19:2x,老板「模型定价去掉」「左侧菜单上下间距缩短一点,让滚动条不要出现」)**
> - **侧栏间距收紧**(`layouts/SideNav.vue`):菜单项内边距 `9px→7px`(行高 **36→32px**)、项间距 `2px→1px`、 > - **侧栏间距收紧**(`layouts/SideNav.vue`):菜单项内边距 `9px→7px`(行高 **36→32px**)、项间距 `2px→1px`、
@@ -1161,8 +1161,8 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 生产 `data/` 只读)真浏览器实测:**侧栏 11 项、无「网关配置」**;设置页**无**那颗跳转按钮; > 生产 `data/` 只读)真浏览器实测:**侧栏 11 项、无「网关配置」**;设置页**无**那颗跳转按钮;
> 手敲 `#/gateway-config` **落回 `/dashboard`**。构建产物静态核对:定价块文案仍在(`addPrice` / `h_pricing` / > 手敲 `#/gateway-config` **落回 `/dashboard`**。构建产物静态核对:定价块文案仍在(`addPrice` / `h_pricing` /
> `输入价` / `输出价` / `list-edit` 均能在产物里找到)→ 功能只是藏起来、没被删。 > `输入价` / `输出价` / `list-edit` 均能在产物里找到)→ 功能只是藏起来、没被删。
> - 收尾:隔离实例已 kill,两轮残留分别归档 `/root/.trash/2026-09-13-gw25-tweaks-cleanup/` 与 > - 收尾:隔离实例已 kill,两轮残留分别归档 `/root/.trash/<归档>/` 与
> `/root/.trash/2026-09-13-gw26-hide-gwconfig-cleanup/`(各含 `MANIFEST.md`)。 > `/root/.trash/<归档>/`(各含 `MANIFEST.md`)。
> - 备注:生产 `data/users.json` 在 19:29 有一次写入,**不是本次验证造成**(隔离实例的账号/配置/历史全走 `/tmp`), > - 备注:生产 `data/users.json` 在 19:29 有一次写入,**不是本次验证造成**(隔离实例的账号/配置/历史全走 `/tmp`),
> 看字段像线上侧的登录/建 Key 动作。 > 看字段像线上侧的登录/建 Key 动作。
> >
@@ -1174,7 +1174,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 推算"开始出滚动条"的窗口高从最初的 ~605px、上一版的 ~538px 降到 **~508px**。 > 推算"开始出滚动条"的窗口高从最初的 ~605px、上一版的 ~538px 降到 **~508px**。
> - 上线:纯前端 `npm run build` 覆盖 `frontend/dist`(未重启后端,会话没掉)。线上现役 > - 上线:纯前端 `npm run build` 覆盖 `frontend/dist`(未重启后端,会话没掉)。线上现役
> **`index-BV89HnWe.js`** / `MainLayout-BOSEGVwr.css`(`index-BeKWQQGn.js`、`MainLayout-8X3ca3Qa.css` 已 404)。 > **`index-BV89HnWe.js`** / `MainLayout-BOSEGVwr.css`(`index-BeKWQQGn.js`、`MainLayout-8X3ca3Qa.css` 已 404)。
> - 收尾:残留归档 `/root/.trash/2026-09-13-gw27-rail-spacing-cleanup/`(含 `MANIFEST.md`)。 > - 收尾:残留归档 `/root/.trash/<归档>/`(含 `MANIFEST.md`)。
> **第二十二轮(2026-09-13)意见反馈 / 用户反馈 + 侧栏底部清理 + 处理进度** > **第二十二轮(2026-09-13)意见反馈 / 用户反馈 + 侧栏底部清理 + 处理进度**
> 来源:老板三点 ——「侧栏菜单左下角那行去掉」「普通用户新增意见反馈,支持上传图片」 > 来源:老板三点 ——「侧栏菜单左下角那行去掉」「普通用户新增意见反馈,支持上传图片」
@@ -1241,7 +1241,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 处理中·已处理 400 / API Key 撤不动 403)。撤回部分在隔离实例复核过接口与真浏览器交互。 > 处理中·已处理 400 / API Key 撤不动 403)。撤回部分在隔离实例复核过接口与真浏览器交互。
> - 上线(2026-09-13 18:4x,老板批准「补上说明后直接上线」):`npm run build` → 线上现役 > - 上线(2026-09-13 18:4x,老板批准「补上说明后直接上线」):`npm run build` → 线上现役
> `index-b0LZHsJm.js` / `index-BCEpjaoj.css`(旧 `index-CDcUA_16.js` 已 404); > `index-b0LZHsJm.js` / `index-BCEpjaoj.css`(旧 `index-CDcUA_16.js` 已 404);
> `supervisorctl restart api-gateway:api-gateway_00` → pid **2055315**(127.0.0.1:8808)—— > `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` → pid **2055315**(127.0.0.1:8808)——
> **本轮有后端改动,重启会踢掉所有网页会话,需重新登录**。(该次 pid 已被下方追加项的上线覆盖。) > **本轮有后端改动,重启会踢掉所有网页会话,需重新登录**。(该次 pid 已被下方追加项的上线覆盖。)
> 追加项(老板 18:39「待处理的单子用户可以自己撤回」)代码与隔离实测完成后,老板 18:5x 批准上线: > 追加项(老板 18:39「待处理的单子用户可以自己撤回」)代码与隔离实测完成后,老板 18:5x 批准上线:
> 再次 `npm run build` + `supervisorctl restart` → 现役 `index-9Whl_Fn4.js`(旧 `index-b0LZHsJm.js` 已 404)、 > 再次 `npm run build` + `supervisorctl restart` → 现役 `index-9Whl_Fn4.js`(旧 `index-b0LZHsJm.js` 已 404)、
@@ -1259,7 +1259,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 追加项(老板「处理的每个环节都要记录和展示,改好后直接重启上线」)**已上线**: > 追加项(老板「处理的每个环节都要记录和展示,改好后直接重启上线」)**已上线**:
> `npm run build`(先确认 `frontend/public/` 无探针残留)→ 现役 `index-BTllhoyi.js` > `npm run build`(先确认 `frontend/public/` 无探针残留)→ 现役 `index-BTllhoyi.js`
> (旧 `index-9Whl_Fn4.js` 已 404;`index-BCEpjaoj.css` 哈希未变,本轮无样式改动); > (旧 `index-9Whl_Fn4.js` 已 404;`index-BCEpjaoj.css` 哈希未变,本轮无样式改动);
> `supervisorctl restart api-gateway:api-gateway_00` → pid **2073622**(`127.0.0.1:8808`)—— > `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` → pid **2073622**(`127.0.0.1:8808`)——
> **有后端改动,重启踢掉了所有网页会话,需重新登录**。 > **有后端改动,重启踢掉了所有网页会话,需重新登录**。
> 复核(全部实测):公网 `/web/` 200 且引用新 hash、`index-BTllhoyi.js` 与 > 复核(全部实测):公网 `/web/` 200 且引用新 hash、`index-BTllhoyi.js` 与
> `FeedbackTimeline-CfkAgUmj.js` / `Feedback-DsePxU4t.js` / `FeedbackInbox-D1R_k-8C.js` 全 200、 > `FeedbackTimeline-CfkAgUmj.js` / `Feedback-DsePxU4t.js` / `FeedbackInbox-D1R_k-8C.js` 全 200、
@@ -1268,7 +1268,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> (路由已随重启生效)。**生产 `data/*` 全程只读**(并未往线上写测试反馈)。 > (路由已随重启生效)。**生产 `data/*` 全程只读**(并未往线上写测试反馈)。
> 收尾:隔离实例(8899 / vite dev 5199)已 kill,探针 `gwmv23.html` + 临时 vite 配置 > 收尾:隔离实例(8899 / vite dev 5199)已 kill,探针 `gwmv23.html` + 临时 vite 配置
> `gwcheck23.vite.config.mts` 与 `/tmp/gw23` 已归档到 > `gwcheck23.vite.config.mts` 与 `/tmp/gw23` 已归档到
> `/root/.trash/2026-09-13-fix22b-cleanup/`(含 `MANIFEST.md`),`frontend/public/` 已清空、 > `/root/.trash/<归档>/`(含 `MANIFEST.md`),`frontend/public/` 已清空、
> `dist` 无探针残留。 > `dist` 无探针残留。
> **第二十一轮(2026-09-13)顶栏「铃铛」删除 + 主题下拉点不开(tooltip 套在 dropdown 触发器里)** > **第二十一轮(2026-09-13)顶栏「铃铛」删除 + 主题下拉点不开(tooltip 套在 dropdown 触发器里)**
@@ -1354,7 +1354,7 @@ curl "http://localhost:8808/v1/videos/<video_id>?model=agnes-video-2.5-flash&wai
> 窄屏 151~175px,无横向溢出);`vue-tsc` 0 错、`vite build` 通过、后端单测 **137 passed / 0 failed**。 > 窄屏 151~175px,无横向溢出);`vue-tsc` 0 错、`vite build` 通过、后端单测 **137 passed / 0 failed**。
> - 上线(2026-09-13 17:44,老板批准):`npm run build` → 线上现役 > - 上线(2026-09-13 17:44,老板批准):`npm run build` → 线上现役
> `index-Yy0kGuVA.js` / `index-DKyqf84q.css` / `Logs-N__ABTKT.js` / `Videos-Bzh1nuOL.js` + `Videos-BVOcHXwL.css`; > `index-Yy0kGuVA.js` / `index-DKyqf84q.css` / `Logs-N__ABTKT.js` / `Videos-Bzh1nuOL.js` + `Videos-BVOcHXwL.css`;
> `supervisorctl restart api-gateway:api-gateway_00` → pid **1999293**(127.0.0.1:8808)。 > `supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00` → pid **1999293**(127.0.0.1:8808)。
> 复核:公网 `/web/` 200 且引用新 hash、新旧 asset 分别 200 / 404、`/healthz` 200、CSP 头未放宽; > 复核:公网 `/web/` 200 且引用新 hash、新旧 asset 分别 200 / 404、`/healthz` 200、CSP 头未放宽;
> 拉线上产物实测含胶囊计数与空结果提示(`Logs`)、新版卡片结构(`Videos`)与窄屏缩略拉伸规则(`Videos` CSS)。 > 拉线上产物实测含胶囊计数与空结果提示(`Logs`)、新版卡片结构(`Videos`)与窄屏缩略拉伸规则(`Videos` CSS)。
> 注意:**重启会踢掉所有网页会话,需重新登录**。 > 注意:**重启会踢掉所有网页会话,需重新登录**。
@@ -1385,10 +1385,10 @@ VERSION = "2.4.0" # ← 只改这一处
``` ```
改代码 → 跑测试(python tests/test_gateway.py 或 bash scripts/ci_check.sh) 改代码 → 跑测试(python tests/test_gateway.py 或 bash scripts/ci_check.sh)
→ 纯前端:npm run build(dist 即线上目录) → 纯前端:npm run build(dist 即线上目录)
后端/代码:supervisorctl restart api-gateway:api-gateway_00 后端/代码:supervisorctl restart xiaoyin-gateway:xiaoyin-gateway_00
→ 真机验证(线上 healthz / 页面 / 接口) → 真机验证(线上 healthz / 页面 / 接口)
→ git commit → git commit
→ 推 Gitea(scripts/push_gitea.sh,仓库 Jidekin/api-gateway 分支 main) → 推 Gitea(scripts/push_gitea.sh,仓库 Jidekin/xiaoyin-gateway 分支 main)
``` ```
**「只要上生产就必须推」** 是既有硬性规矩:保持"线上跑着的代码 = 仓库里的代码"。**凡是重启上线(后端 **「只要上生产就必须推」** 是既有硬性规矩:保持"线上跑着的代码 = 仓库里的代码"。**凡是重启上线(后端
@@ -1398,9 +1398,9 @@ restart)或 `npm run build` 覆盖 `frontend/dist` 的代码改动,验证通
的顺序取凭据(token 是 2026-10-12 建的 Gitea API token,scope `write:repository`); 的顺序取凭据(token 是 2026-10-12 建的 Gitea API token,scope `write:repository`);
凭据只一次性内嵌进本次推送 URL,**不写 `.git/config`、也不内置进仓库任何文件**; 凭据只一次性内嵌进本次推送 URL,**不写 `.git/config`、也不内置进仓库任何文件**;
退出码 2=没凭据 / 3=工作区不干净 / 4=推送后远端≠本地 / 5=`.git/config` 出现明文。 退出码 2=没凭据 / 3=工作区不干净 / 4=推送后远端≠本地 / 5=`.git/config` 出现明文。
仓库 `https://git.wangjinding.com/Jidekin/api-gateway.git`、分支 `main` 仓库 `https://git.wangjinding.com/Jidekin/xiaoyin-gateway.git`、分支 `main`
(`remote` 名就叫 `gitea`)。**三个项目分支已统一为 `main`** (`remote` 名就叫 `gitea`)。**三个项目分支已统一为 `main`**
(2026-10-12:api-gateway 原 `master` 改名 `main`,Gitea 默认分支同步改、旧 `master` 分支删除)。 (2026-10-12:xiaoyin-gateway 原 `master` 改名 `main`,Gitea 默认分支同步改、旧 `master` 分支删除)。
## 测试 ## 测试
+1 -1
View File
@@ -1 +1 @@
"""API Gateway - 统一多供应商 LLM 接入网关""" """小银网关 - 统一多供应商 LLM 接入网关"""
+1 -1
View File
@@ -28,7 +28,7 @@ from app.config import (
) )
from app.models import CHAT_CORE_KEYS, PROTECTED_VIDEO_KEYS, strip_protected from app.models import CHAT_CORE_KEYS, PROTECTED_VIDEO_KEYS, strip_protected
log = logging.getLogger("api-gateway") log = logging.getLogger("xiaoyin-gateway")
# ── 上游"某参数只允许取某个值"的报错形态(第二十五轮)── # ── 上游"某参数只允许取某个值"的报错形态(第二十五轮)──
# 各家措辞不同,这里收录已实测到的两类: # 各家措辞不同,这里收录已实测到的两类:
+1 -1
View File
@@ -36,7 +36,7 @@ from typing import Any, AsyncIterator
import httpx import httpx
log = logging.getLogger("api-gateway.agents") log = logging.getLogger("xiaoyin-gateway.agents")
#: 单轮对话的超时(秒)。引擎可能跑很久(多步工具),给足。 #: 单轮对话的超时(秒)。引擎可能跑很久(多步工具),给足。
DEFAULT_TIMEOUT = 300.0 DEFAULT_TIMEOUT = 300.0
+2 -2
View File
@@ -37,9 +37,9 @@ from app.adapters.qwenpaw_engine import (
stream_chat, stream_chat,
) )
log = logging.getLogger("api-gateway.agents") log = logging.getLogger("xiaoyin-gateway.agents")
QWENPAW_CONFIG = Path("/root/.qwenpaw/config.json") QWENPAW_CONFIG = Path("~/.qwenpaw/config.json")
# ── 运行记录(data/agent_runs.json)──────────────────────────────────── # ── 运行记录(data/agent_runs.json)────────────────────────────────────
+1 -1
View File
@@ -13,7 +13,7 @@ import threading
import time import time
from collections import deque from collections import deque
log = logging.getLogger("api-gateway.circuit") log = logging.getLogger("xiaoyin-gateway.circuit")
class CircuitBreaker: class CircuitBreaker:
+3
View File
@@ -327,6 +327,7 @@ class ServerConfig:
webhook_allow_private: bool = False # 视频 callback_url 是否允许指向内网/回环地址(SSRF 防护,默认否) webhook_allow_private: bool = False # 视频 callback_url 是否允许指向内网/回环地址(SSRF 防护,默认否)
docs_enabled: bool = False # 是否开放 FastAPI 文档(/docs、/redoc、/openapi.json)——安全默认关 docs_enabled: bool = False # 是否开放 FastAPI 文档(/docs、/redoc、/openapi.json)——安全默认关
auth_fail_limit_per_min: int = 20 # 同一来源 IP 每分钟允许的鉴权失败次数,超过 → 429(防暴力枚举) auth_fail_limit_per_min: int = 20 # 同一来源 IP 每分钟允许的鉴权失败次数,超过 → 429(防暴力枚举)
auth_fail_ban_seconds: int = 3600 # 超限后拉黑时长(秒);2026-11-06 新增,0=只限流不拉黑
@dataclass @dataclass
@@ -861,6 +862,8 @@ def parse_config(raw: dict[str, Any]) -> GatewayConfig:
docs_enabled=_opt_bool(srv_raw.get("docs_enabled"), "server.docs_enabled", False), docs_enabled=_opt_bool(srv_raw.get("docs_enabled"), "server.docs_enabled", False),
auth_fail_limit_per_min=_opt_int(srv_raw.get("auth_fail_limit_per_min"), auth_fail_limit_per_min=_opt_int(srv_raw.get("auth_fail_limit_per_min"),
"server.auth_fail_limit_per_min", 20, minimum=1), "server.auth_fail_limit_per_min", 20, minimum=1),
auth_fail_ban_seconds=_opt_int(srv_raw.get("auth_fail_ban_seconds"),
"server.auth_fail_ban_seconds", 3600, minimum=0),
) )
# 网关入口鉴权(客户端 key 数组,可配多用户) # 网关入口鉴权(客户端 key 数组,可配多用户)
+103
View File
@@ -0,0 +1,103 @@
"""OpenCode Go 模型的套餐元数据(月度额度 / 是否用请求训练 / 零数据保留)。
**只用于展示,不参与路由与计费。** 数据来自官方 models 接口(实测无需鉴权):
GET https://opencode.ai/inference/go/v1/models
其中每个模型带 `go` 字段:
go: {
monthly_usage: {"go": 100, "go-plus": 200, "go-teams": 105},
training: false, # 是否用你的请求训练模型
zdr: true, # 零数据保留(不保留任何内容)
limited_regions: false,
}
官方口径(docs/console/go):`monthly_usage` 是「**只用这一个模型时,各套餐每月额度
能覆盖多少用量**」(文档举例用的是美元)。所以前端展示成「$100/月」这类形式。
设计取舍:
· 自带 6 小时缓存,失败后 5 分钟重试;
· 拉取失败一律返回**已有缓存或空 dict** —— `/v1/models` 绝不因此报错或变慢太多
(首次拉取加 6 秒上限;之后走内存)。
· 不写进 gateway.yaml:这是上游随时会变的市场信息,不属于网关的静态配置,
也不该让模型同步脚本再背一层。
"""
from __future__ import annotations
import json
import logging
import threading
import time
import urllib.request
_URL = "https://opencode.ai/inference/go/v1/models"
log = logging.getLogger("xiaoyin-gateway.gomodels")
_TTL = 6 * 3600
_RETRY_AFTER_FAIL = 300
_TIMEOUT = 6
_lock = threading.Lock()
_cache: dict[str, dict] = {}
_at = 0.0
def _fetch() -> dict[str, dict]:
req = urllib.request.Request(
_URL,
headers={"Accept": "application/json", "User-Agent": "xiaoyin-gateway/gomodels"},
)
with urllib.request.urlopen(req, timeout=_TIMEOUT) as resp: # noqa: S310
payload = json.loads(resp.read().decode("utf-8", "replace"))
out: dict[str, dict] = {}
for m in payload.get("data") or []:
mid = m.get("id")
g = m.get("go") or {}
usage = g.get("monthly_usage") or {}
if not mid or (not usage and g.get("training") is None):
continue
out[mid] = {
"monthly_usage": {k: int(v) for k, v in usage.items()
if isinstance(v, (int, float))},
"training": bool(g.get("training")),
"zdr": bool(g.get("zdr")),
}
return out
def cache_stamp() -> float:
"""上次成功刷新的时间戳(0 = 还没拿到过)。调用方可据此判断展示数据是否需要重拼。"""
return _at
def get_go_meta(force: bool = False) -> dict[str, dict]:
"""{model_id: {"monthly_usage": {...}, "training": bool, "zdr": bool}}。
过期才刷新;刷新失败保留旧数据,并推迟 `_RETRY_AFTER_FAIL` 秒再试。
"""
global _at
now = time.time()
if not force and _cache and now - _at < _TTL:
return _cache
if not _lock.acquire(blocking=False):
return _cache # 别的线程正在刷新,先用旧的
try:
if force or not _cache or time.time() - _at >= _TTL:
try:
fresh = _fetch()
except Exception as exc: # noqa: BLE001 —— 展示数据,失败不影响主流程
# 2026-11-19:一定要留痕 —— 前端这一列空了,运维得能一眼看出是"没拉到"还是"没渲染"
log.warning("OpenCode Go 元数据拉取失败(前端额度/训练列会空):%s", exc)
fresh = None
if fresh:
_cache.clear()
_cache.update(fresh)
_at = time.time()
log.info("OpenCode Go 元数据已载入:%d 个模型", len(fresh))
else:
_at = time.time() - _TTL + _RETRY_AFTER_FAIL
finally:
_lock.release()
return _cache
+441 -17
View File
@@ -1,4 +1,4 @@
"""API 网关主入口:FastAPI 应用(v2.4 全功能版)。 """小银网关主入口:FastAPI 应用(v2.4 全功能版)。
特性: 特性:
- 多供应商 OpenAI 兼容 /chat/completions(同模型重试 + 熔断;第二十七轮起三线直传: - 多供应商 OpenAI 兼容 /chat/completions(同模型重试 + 熔断;第二十七轮起三线直传:
@@ -56,6 +56,8 @@ from app.sessions import SessionStore
from app.users import UsersStore, UserError, key_limit_for_role from app.users import UsersStore, UserError, key_limit_for_role
from app.history import HistoryStore, HistoryError, MAX_ITEMS as HISTORY_CAP from app.history import HistoryStore, HistoryError, MAX_ITEMS as HISTORY_CAP
from app.feedback import FeedbackStore, FeedbackError, MAX_ENTRIES as FEEDBACK_CAP from app.feedback import FeedbackStore, FeedbackError, MAX_ENTRIES as FEEDBACK_CAP
# 2026-11-19: OpenCode Go 套餐元数据(月度额度 / 是否训练 / 零保留),只用于前端展示
from app.gomodels import get_go_meta, cache_stamp as gomodels_cache_stamp
from app.video_owners import VideoOwnerStore from app.video_owners import VideoOwnerStore
from app import settings as gw_settings from app import settings as gw_settings
from app.agents import AgentStore, AgentsError from app.agents import AgentStore, AgentsError
@@ -160,7 +162,7 @@ def _setup_logging() -> None:
# 基础日志先起来,进 lifespan 后按 observability 重配 # 基础日志先起来,进 lifespan 后按 observability 重配
logging.basicConfig(level=logging.INFO, format="%(asctime)s [%(name)s] %(levelname)s: %(message)s") logging.basicConfig(level=logging.INFO, format="%(asctime)s [%(name)s] %(levelname)s: %(message)s")
log = logging.getLogger("api-gateway") log = logging.getLogger("xiaoyin-gateway")
# 调用日志的内容上限(2026-10-23,2.9.12 再放宽):默认 **4 MiB**(≈100 万 token 的文本)。 # 调用日志的内容上限(2026-10-23,2.9.12 再放宽):默认 **4 MiB**(≈100 万 token 的文本)。
# 老板要求「详情内容都不要截断」—— 4 MiB 对任何正常对话都等于不截断; # 老板要求「详情内容都不要截断」—— 4 MiB 对任何正常对话都等于不截断;
@@ -209,7 +211,7 @@ def _warn_security_posture(cfg) -> None:
async def lifespan(app: FastAPI): async def lifespan(app: FastAPI):
global config global config
_setup_logging() _setup_logging()
log.info("API Gateway 启动,已加载 %d 供应商", len(config.providers)) log.info("小银网关启动,已加载 %d 供应商", len(config.providers))
_warn_security_posture(config) _warn_security_posture(config)
for w in validate_warnings(config): for w in validate_warnings(config):
log.warning("配置告警: %s", w) log.warning("配置告警: %s", w)
@@ -273,7 +275,7 @@ async def lifespan(app: FastAPI):
_, pending = await asyncio.wait(set(_bg_tasks), timeout=5) _, pending = await asyncio.wait(set(_bg_tasks), timeout=5)
for t in pending: for t in pending:
t.cancel() t.cancel()
log.info("API Gateway 关闭,等待在途请求(graceful_shutdown=%ds)", config.server.graceful_shutdown) log.info("小银网关关闭,等待在途请求(graceful_shutdown=%ds)", config.server.graceful_shutdown)
# 第六轮: 快照后再迭代(避免迭代中字典被改动 → RuntimeError) # 第六轮: 快照后再迭代(避免迭代中字典被改动 → RuntimeError)
for adapter in list(_state.get("adapters", {}).values()): for adapter in list(_state.get("adapters", {}).values()):
await adapter.close() await adapter.close()
@@ -386,7 +388,7 @@ _docs_on = config.server.docs_enabled # 安全默认关(report: /docs、/ope
VERSION = "2.9.16" VERSION = "2.9.16"
app = FastAPI( app = FastAPI(
title="API Gateway", title="小银网关",
description="统一多供应商 LLM 接入网关(Agnes / OpenCode Go / Dots AI)", description="统一多供应商 LLM 接入网关(Agnes / OpenCode Go / Dots AI)",
version=VERSION, version=VERSION,
lifespan=lifespan, lifespan=lifespan,
@@ -953,6 +955,19 @@ async def _validate_callback_url(raw: str | None, allow_private: bool) -> None:
# ── IP 级鉴权失败限流(安全报告:中低危——无 IP 限流可暴力枚举 / 刷流量)── # ── IP 级鉴权失败限流(安全报告:中低危——无 IP 限流可暴力枚举 / 刷流量)──
_AUTH_FAILS: dict[str, deque] = {} _AUTH_FAILS: dict[str, deque] = {}
_AUTH_FAIL_MAX_IPS = 1000 # 最多跟踪的 IP,超限清空一次(防内存膨胀) _AUTH_FAIL_MAX_IPS = 1000 # 最多跟踪的 IP,超限清空一次(防内存膨胀)
# 2026-11-06: 鉴权失败超限后拉黑一段时间(默认 1 小时),期间该 IP 一律 429。
# key=IP, value=解封时间戳(time.time())。只影响这一个 IP,不波及其他来源。
_BANNED: dict[str, float] = {}
_BANNED_MAX_IPS = 10000 # 最多跟踪的封禁 IP,超限清最旧的一批(防内存膨胀)
# 封禁备注(手动封禁时可填「谁、为什么」),与 _BANNED 同生命周期,解封/过期时一并清掉。
_BAN_NOTES: dict[str, str] = {}
# 永久封禁(不随时间过期)。与 _BANNED 分开存,免得拿"极大时间戳"糊弄,
# 导致剩余时间算出天文数字、前端还得猜哪个算永久。
_BANNED_FOREVER: set[str] = set()
# 封禁操作历史(封/解封/延长),落盘 JSONL,重启不丢。只保留最近 _BAN_HISTORY_MAX 条。
_BAN_HISTORY: list[dict] = []
_BAN_HISTORY_MAX = 500
_BAN_HISTORY_FILE = Path(__file__).resolve().parent.parent / "data" / "ban_history.jsonl"
_TRUSTED_PROXY_IPS = {"127.0.0.1", "::1"} # 本机反代(nginx/openresty):只有它写的 XFF 可信 _TRUSTED_PROXY_IPS = {"127.0.0.1", "::1"} # 本机反代(nginx/openresty):只有它写的 XFF 可信
@@ -979,10 +994,142 @@ def _client_ip(request: Request) -> str:
return peer or "unknown" return peer or "unknown"
def _record_auth_fail(request: Request, limit_per_min: int) -> bool: def _ban_remaining(ip: str) -> int:
"""记录一次鉴权失败;返回 True 表示该来源 60s 内已超限(应直接 429)。""" """该 IP 还要被限制的秒数:0=未封禁,-1=永久封禁,>0=剩余秒数。
顺带清理已过期的定时封禁(投机清理,不要求调用方配合)。
"""
if ip in _BANNED_FOREVER:
return -1
exp = _BANNED.get(ip)
if exp is None:
return 0
left = int(exp - time.time())
if left <= 0:
_BANNED.pop(ip, None)
_BAN_NOTES.pop(ip, None)
return 0
return left
def _ban_history_add(action: str, ip: str, *, seconds: int = 0,
note: str = "", actor: str = "", permanent: bool = False) -> None:
"""记一条封禁操作历史(封/解封/延长/清空),并追加到 JSONL。
历史上限 _BAN_HISTORY_MAX 条(内存),文件则是纯追加、由运维按需轮转。
落盘失败不影响主流程 —— 封禁本身比日志重要。
"""
item = {
"id": uuid.uuid4().hex[:12], # 删除时用的稳定标识(时间戳会撞,不能用)
"ts": int(time.time()),
"action": action, # ban / manual_ban / unban / unban_all / extend / auto_ban
"ip": ip,
"seconds": seconds,
"permanent": permanent,
"note": note,
"actor": actor,
}
_BAN_HISTORY.append(item)
if len(_BAN_HISTORY) > _BAN_HISTORY_MAX:
del _BAN_HISTORY[: len(_BAN_HISTORY) - _BAN_HISTORY_MAX]
try:
_BAN_HISTORY_FILE.parent.mkdir(parents=True, exist_ok=True)
with _BAN_HISTORY_FILE.open("a", encoding="utf-8") as fh:
fh.write(json.dumps(item, ensure_ascii=False) + "\n")
except OSError as e:
log.warning("封禁历史上写盘失败(不影响封禁本身):%s", e)
def _ban_history_save() -> None:
"""把内存里的历史整体重写到 JSONL(删除后调用)。
为什么不是「删文件里某一行」:JSONL 没有索引,原地删要读全量再写回,
代价和整体重写一样,但整体重写不会留下空洞或半行,更安全。
"""
try:
_BAN_HISTORY_FILE.parent.mkdir(parents=True, exist_ok=True)
tmp = _BAN_HISTORY_FILE.with_suffix(".jsonl.tmp")
with tmp.open("w", encoding="utf-8") as fh:
for h in _BAN_HISTORY:
fh.write(json.dumps(h, ensure_ascii=False) + "\n")
tmp.replace(_BAN_HISTORY_FILE) # 原子替换,避免写一半被读到
except OSError as e:
log.warning("封禁历史重写盘失败(不影响封禁本身):%s", e)
def _ban_history_load() -> None:
"""启动时把历史文件读回内存(文件丢了/坏了就当空历史,不阻塞启动)。
老版本写的行没有 id,这里补一个,保证删除接口对历史数据同样可用。
"""
try:
if not _BAN_HISTORY_FILE.is_file():
return
with _BAN_HISTORY_FILE.open("r", encoding="utf-8") as fh:
for line in fh:
line = line.strip()
if not line:
continue
try:
h = json.loads(line)
except json.JSONDecodeError:
continue # 半行/坏行直接跳过,别为一条脏数据拖垮整个历史
if not isinstance(h, dict):
continue
h.setdefault("id", uuid.uuid4().hex[:12])
for k, dv in (("ts", 0), ("action", "unknown"), ("ip", ""), ("seconds", 0),
("permanent", False), ("note", ""), ("actor", "")):
h.setdefault(k, dv)
_BAN_HISTORY.append(h)
if len(_BAN_HISTORY) > _BAN_HISTORY_MAX:
del _BAN_HISTORY[: len(_BAN_HISTORY) - _BAN_HISTORY_MAX]
log.info("封禁历史已载入 %d 条", len(_BAN_HISTORY))
except OSError as e:
log.warning("封禁历史读取失败(按空历史启动):%s", e)
_ban_history_load()
def _record_auth_fail(request: Request, limit_per_min: int, ban_seconds: int = 3600) -> int:
"""记录一次鉴权失败。
返回 0 表示还没到限流阈值(调用方按原样回 401);
返回 >0 表示该来源应被 429,值是**还要等多少秒**:
- 已被拉黑 → 剩余拉黑秒数
- 本次刚触发 → ban_seconds(>0 时顺便写入封禁表)
2026-11-06: 从「只限流 60 秒」改成「超限即拉黑 ban_seconds 秒(默认 1 小时)」。
只针对该 IP,其他来源完全不受影响。
"""
ip = _client_ip(request) ip = _client_ip(request)
now = time.time() now = time.time()
# 2026-11-06 安全网:回环 / 私网 / 本机反代永不拉黑。
# 原因:网关只监听 127.0.0.1,正常流量都经 OpenResty 回源(带 XFF,能拿到真实 IP);
# 但如果某次 XFF 缺失,_client_ip 会退回 peer=127.0.0.1 —— 一旦拉黑它,
# 等于把**所有人**一起封死。这里直接豁免,宁可少封一个也不误伤全局。
if ip in ("127.0.0.1", "::1", "localhost", "unknown", ""):
dq0 = _AUTH_FAILS.get(ip)
if dq0 is None:
if len(_AUTH_FAILS) >= _AUTH_FAIL_MAX_IPS:
_AUTH_FAILS.clear()
dq0 = deque()
_AUTH_FAILS[ip] = dq0
dq0.append(now)
while dq0 and now - dq0[0] > 60.0:
dq0.popleft()
# 仍然返回限流(保护服务),但不写封禁表
return 60 if len(dq0) >= limit_per_min else 0
if ip.startswith("10.") or ip.startswith("192.168.") or ip.startswith("172."):
return 0 # 内网来源不参与封禁(自家设备误配 Key 不该被锁死)
# 已在封禁期内(含永久):直接返回,不再累计。
# 注意 left 可能是 -1(永久),所以判断用真值而不是 >0。
left = _ban_remaining(ip)
if left:
return left
dq = _AUTH_FAILS.get(ip) dq = _AUTH_FAILS.get(ip)
if dq is None: if dq is None:
if len(_AUTH_FAILS) >= _AUTH_FAIL_MAX_IPS: if len(_AUTH_FAILS) >= _AUTH_FAIL_MAX_IPS:
@@ -992,7 +1139,22 @@ def _record_auth_fail(request: Request, limit_per_min: int) -> bool:
dq.append(now) dq.append(now)
while dq and now - dq[0] > 60.0: while dq and now - dq[0] > 60.0:
dq.popleft() dq.popleft()
return len(dq) >= limit_per_min
if len(dq) >= limit_per_min:
# 触发限流:清掉计数,按需写入封禁表
_AUTH_FAILS.pop(ip, None)
if ban_seconds > 0:
if len(_BANNED) >= _BANNED_MAX_IPS:
# 清掉最早解封的一批(保留最近的一半)
keep = sorted(_BANNED.items(), key=lambda kv: kv[1])[-_BANNED_MAX_IPS // 2:]
_BANNED.clear()
_BANNED.update(dict(keep))
_BANNED[ip] = now + ban_seconds
_BAN_NOTES.pop(ip, None)
log.warning("鉴权失败超限,拉黑 IP %s 共 %d 秒", ip, ban_seconds)
return ban_seconds
return 60
return 0
def _key_token(key: str) -> str | None: def _key_token(key: str) -> str | None:
@@ -1127,8 +1289,12 @@ async def require_auth(
log.info("已停用账号 %s 的 API Key 被调用,已拒绝(%s %s)", log.info("已停用账号 %s 的 API Key 被调用,已拒绝(%s %s)",
owner, request.method, request.url.path) owner, request.method, request.url.path)
raise HTTPException(403, "账号已被停用,请联系管理员") raise HTTPException(403, "账号已被停用,请联系管理员")
if _record_auth_fail(request, cfg.server.auth_fail_limit_per_min): _wait = _record_auth_fail(request, cfg.server.auth_fail_limit_per_min,
raise HTTPException(429, "鉴权失败次数过多,已在 60 秒内触发限流,请稍后重试") cfg.server.auth_fail_ban_seconds)
if _wait:
_mins = max(1, (_wait + 59) // 60)
raise HTTPException(429, f"鉴权失败次数过多,该 IP 已被限制访问,请 {_mins} 分钟后重试",
headers={"Retry-After": str(_wait)})
raise HTTPException(401, "无效或缺失的账号 / API Key", headers={"WWW-Authenticate": "Bearer"}) raise HTTPException(401, "无效或缺失的账号 / API Key", headers={"WWW-Authenticate": "Bearer"})
account, role, kind = identity account, role, kind = identity
_set_identity(request, account, role) _set_identity(request, account, role)
@@ -1330,7 +1496,7 @@ def _attach_cost(resp: dict, model: str, usage: dict, cfg) -> None:
# ───────────────────────────────────── # ─────────────────────────────────────
# GET /models + GET /v1/models(P1-7 / P0-3) # GET /models + GET /v1/models(P1-7 / P0-3)
# ───────────────────────────────────── # ─────────────────────────────────────
def _models_payload(): def _models_payload_base():
cfg = _cfg() cfg = _cfg()
# 优化: 目录按配置 mtime 缓存(热重载改配置才重建;静默期每次请求直接命中,省掉 # 优化: 目录按配置 mtime 缓存(热重载改配置才重建;静默期每次请求直接命中,省掉
# all_models() 的重复遍历与对象构建)。cfg 引用同一 config 对象, # all_models() 的重复遍历与对象构建)。cfg 引用同一 config 对象,
@@ -1407,6 +1573,40 @@ def _models_payload():
return payload return payload
def _models_payload():
"""在按 mtime 缓存的目录上,现拼 OpenCode Go 的套餐元数据。
2026-11-19(老板要求):前端要显示「这个模型每月能调多少」「是否拿你的代码训练」。
这两个字段来自官方 models 接口(有自己的 6 小时缓存,见 app/gomodels.py),
所以**不烤进** `_models_cache`(否则配置不变就永远停在第一次的快照)。
拼好后按 (配置 mtime, go 缓存时间戳) 再缓存一层 —— 两个都没变时返回**同一个对象**
(`test_models_payload_cached_and_invalidated_by_mtime` 依赖这个身份语义);
任一变化就重拼。拿不到 go 数据时直接原样返回 base。
"""
base = _models_payload_base()
go = get_go_meta()
if not go:
return base
# 缓存键带上 base 的对象 id(并**持有 base 的强引用**,保证 id 不会被复用)——
# 这样只要 base 被重建(配置热重载,或测试直接把 _models_cache 置 None 换 config),
# 合并层就跟着失效;go 数据刷新(时间戳变化)也会失效。
key = (id(base), gomodels_cache_stamp())
cached = _state.get("_models_cache_go")
if cached is not None and cached[0] == key and cached[2] is base:
return cached[1]
data = []
for item in base.get("data") or []:
mid = item.get("id")
# 别名(alias_of)不重复挂:它的额度/训练口径就是目标模型的,前端按目标取
if mid in go and "alias_of" not in item:
item = {**item, "go": go[mid]}
data.append(item)
payload = {**base, "data": data}
_state["_models_cache_go"] = (key, payload, base)
return payload
@app.get("/models") @app.get("/models")
async def list_models(request: Request, _auth=Depends(require_auth)): async def list_models(request: Request, _auth=Depends(require_auth)):
return _models_payload() return _models_payload()
@@ -3133,7 +3333,7 @@ async def metrics_prometheus(request: Request, _auth=Depends(require_auth)):
raise HTTPException(404, "metrics 已禁用") raise HTTPException(404, "metrics 已禁用")
snap = _usage_snapshot() snap = _usage_snapshot()
lines = [ lines = [
"# API Gateway Prometheus 指标", "# Xiaoyin Gateway Prometheus 指标",
f'api_gateway_uptime_seconds {snap["uptime_seconds"]}', f'api_gateway_uptime_seconds {snap["uptime_seconds"]}',
# 第二十七轮: api_gateway_fallback_total 随「路由别名 / fallback 链」一起删除 —— # 第二十七轮: api_gateway_fallback_total 随「路由别名 / fallback 链」一起删除 ——
# 快照里已没有 fallback_total 字段,这里再读就是 KeyError(曾被 live_check 抓到 500)。 # 快照里已没有 fallback_total 字段,这里再读就是 KeyError(曾被 live_check 抓到 500)。
@@ -3194,7 +3394,7 @@ async def metrics_prometheus(request: Request, _auth=Depends(require_auth)):
"# HELP api_gateway_circuit_recent_failures 熔断窗口内近期失败数", "# HELP api_gateway_circuit_recent_failures 熔断窗口内近期失败数",
"# TYPE api_gateway_circuit_recent_failures gauge", "# TYPE api_gateway_circuit_recent_failures gauge",
] ]
# "# API Gateway Prometheus 指标" 是第一行注释,保留在 HELP 之前 # "# Xiaoyin Gateway Prometheus 指标" 是第一行注释,保留在 HELP 之前
head, body = lines[0], lines[1:] head, body = lines[0], lines[1:]
return "\n".join([head] + help_lines + body) + "\n" return "\n".join([head] + help_lines + body) + "\n"
@@ -3464,7 +3664,7 @@ async def root(request: Request, _auth=Depends(require_auth_or_open)):
return RedirectResponse("/web/") return RedirectResponse("/web/")
cfg = _cfg() cfg = _cfg()
return { return {
"name": "API Gateway", "name": "小银网关",
"version": VERSION, "version": VERSION,
"endpoints": { "endpoints": {
"chat": "POST /v1/chat/completions(OpenAI Chat Completions 线)", "chat": "POST /v1/chat/completions(OpenAI Chat Completions 线)",
@@ -3550,8 +3750,12 @@ async def auth_login(request: Request):
username = str(body.get("username") or "").strip() username = str(body.get("username") or "").strip()
password = str(body.get("password") or "") password = str(body.get("password") or "")
if not username or not await _offload(_users.verify, username, password): if not username or not await _offload(_users.verify, username, password):
if _record_auth_fail(request, _cfg().server.auth_fail_limit_per_min): _wait = _record_auth_fail(request, _cfg().server.auth_fail_limit_per_min,
raise HTTPException(429, "登录失败次数过多,已在 60 秒内触发限流,请稍后重试") _cfg().server.auth_fail_ban_seconds)
if _wait:
_mins = max(1, (_wait + 59) // 60)
raise HTTPException(429, f"登录失败次数过多,该 IP 已被限制访问,请 {_mins} 分钟后重试",
headers={"Retry-After": str(_wait)})
raise HTTPException(401, "账号或密码错误", headers={"WWW-Authenticate": "Bearer"}) raise HTTPException(401, "账号或密码错误", headers={"WWW-Authenticate": "Bearer"})
# 第二十四轮: 账号被管理员停用 → 密码对也不发会话,并明确告知原因(让人知道去找管理员, # 第二十四轮: 账号被管理员停用 → 密码对也不发会话,并明确告知原因(让人知道去找管理员,
# 而不是反复试密码)。校验顺序在口令之后:不知道密码的人依旧只看到 401,探不出账号状态。 # 而不是反复试密码)。校验顺序在口令之后:不知道密码的人依旧只看到 401,探不出账号状态。
@@ -3759,6 +3963,226 @@ def _require_session(request: Request) -> str:
# ── 各账号自管 API Key(默认无,页面自建) ── # ── 各账号自管 API Key(默认无,页面自建) ──
# ── 鉴权失败拉黑管理(2026-11-06,仅管理员)────────────────────────────
# 对应 _BANNED 字典(_record_auth_fail 写入)。只读 + 解封,不提供"手动封禁"
# —— 手动封禁走 iptables/防火墙更合适,这里只负责查看和放行误封的 IP。
@app.get("/admin/banned")
async def admin_list_banned(request: Request, _auth=Depends(require_auth)):
"""列出当前被封禁的 IP(仅管理员)。"""
_require_admin(request)
now = time.time()
items = []
for ip, exp in list(_BANNED.items()):
left = int(exp - now)
if left <= 0:
_BANNED.pop(ip, None)
_BAN_NOTES.pop(ip, None)
continue
items.append({
"ip": ip,
"banned_until": int(exp),
"remaining_seconds": left,
"remaining_minutes": (left + 59) // 60,
"note": _BAN_NOTES.get(ip, ""),
"permanent": False,
})
# 永久封禁排在最后(没有解封时间,按 IP 排)
for ip in sorted(_BANNED_FOREVER):
items.append({
"ip": ip,
"banned_until": 0,
"remaining_seconds": -1,
"remaining_minutes": -1,
"note": _BAN_NOTES.get(ip, ""),
"permanent": True,
})
items.sort(key=lambda x: (x["permanent"], x["banned_until"] or 0))
return {
"count": len(items),
"ban_seconds": _cfg().server.auth_fail_ban_seconds,
"auth_fail_limit_per_min": _cfg().server.auth_fail_limit_per_min,
"items": items,
}
@app.post("/admin/banned")
async def admin_ban(request: Request, _auth=Depends(require_auth)):
"""手动封禁一个 IP(仅管理员)。
参数:{"ip": "1.2.3.4", "seconds": 3600};seconds 缺省用 server.auth_fail_ban_seconds。
与自动拉黑共用 _BANNED 表,所以能在列表里看到、也能被同一个解封接口放行。
白名单(回环/私网)同样豁免 —— 手动也封不掉本机反代,避免一键把全站弄挂。
"""
_require_admin(request)
body = await _json_object(request)
ip = str(body.get("ip") or "").strip()
if not ip:
raise HTTPException(400, "缺少参数 ip")
# 只接受 IPv4/IPv6 字面量,挡住把整段/域名/通配塞进来的误操作
try:
ipaddress.ip_address(ip)
except ValueError:
raise HTTPException(400, f"不是合法的 IP 地址: {ip}")
if ip in ("127.0.0.1", "::1", "localhost", "unknown", "") or ip.startswith(("10.", "192.168.", "172.")):
raise HTTPException(400, "回环/内网地址不允许手动封禁(会把本机反代或自家设备一起锁死)")
permanent = bool(body.get("permanent"))
default_sec = _cfg().server.auth_fail_ban_seconds or 3600
if permanent:
seconds = 0
else:
raw_sec = body.get("seconds")
try:
seconds = int(raw_sec) if raw_sec is not None else default_sec
except (TypeError, ValueError):
raise HTTPException(400, "seconds 必须是整数(秒)")
if seconds < 60 or seconds > 30 * 86400:
raise HTTPException(400, "seconds 需在 60 ~ 2592000(30 天)之间(永久请传 permanent=true)")
now = time.time()
note = str(body.get("note") or "").strip()[:120]
if permanent:
_BANNED.pop(ip, None)
_BANNED_FOREVER.add(ip)
banned_until = 0
else:
if len(_BANNED) >= _BANNED_MAX_IPS:
keep = sorted(_BANNED.items(), key=lambda kv: kv[1])[-_BANNED_MAX_IPS // 2:]
_BANNED.clear()
_BANNED.update(dict(keep))
_BANNED_FOREVER.discard(ip)
_BANNED[ip] = now + seconds
banned_until = int(now + seconds)
_AUTH_FAILS.pop(ip, None)
if note:
_BAN_NOTES[ip] = note
else:
_BAN_NOTES.pop(ip, None)
log.warning("管理员 %s 手动封禁 IP %s %s%s", request.state.account, ip,
"(永久)" if permanent else f"共 {seconds} 秒",
f"(备注:{note})" if note else "")
_ban_history_add("manual_ban", ip, seconds=seconds, note=note,
actor=request.state.account, permanent=permanent)
return {"status": "ok", "ip": ip, "banned_seconds": seconds,
"banned_until": banned_until, "permanent": permanent}
@app.put("/admin/banned/{ip}")
async def admin_extend(request: Request, ip: str, _auth=Depends(require_auth)):
"""延长某 IP 的封禁(仅管理员)。
参数:{"seconds": 3600} 或 {"permanent": true}。
语义是**在当前剩余时间上加**,不是重置 —— 所以连点两次「延长 1 小时」= 续 2 小时。
"""
_require_admin(request)
body = await _json_object(request)
try:
ipaddress.ip_address(ip)
except ValueError:
raise HTTPException(400, f"不是合法的 IP 地址: {ip}")
if ip not in _BANNED and ip not in _BANNED_FOREVER:
raise HTTPException(404, f"{ip} 当前没有被封禁,无法延长")
permanent = bool(body.get("permanent"))
now = time.time()
if permanent:
_BANNED.pop(ip, None)
_BANNED_FOREVER.add(ip)
total = 0
else:
raw_sec = body.get("seconds")
try:
seconds = int(raw_sec) if raw_sec is not None else (_cfg().server.auth_fail_ban_seconds or 3600)
except (TypeError, ValueError):
raise HTTPException(400, "seconds 必须是整数(秒)")
if seconds < 60 or seconds > 30 * 86400:
raise HTTPException(400, "seconds 需在 60 ~ 2592000(30 天)之间")
if ip in _BANNED_FOREVER:
# 永久封禁没有"剩余时间"可加,先转成定时再算
_BANNED_FOREVER.discard(ip)
base = now
else:
base = max(_BANNED.get(ip, now), now)
_BANNED[ip] = base + seconds
total = seconds
log.warning("管理员 %s 延长 IP %s 的封禁:%s", request.state.account, ip,
"改为永久" if permanent else f"+{total} 秒")
_ban_history_add("extend", ip, seconds=total, actor=request.state.account, permanent=permanent)
return {"status": "ok", "ip": ip, "extended_seconds": total, "permanent": permanent}
@app.get("/admin/banned/history")
async def admin_ban_history(request: Request, limit: int = 50, ip: str | None = None,
_auth=Depends(require_auth)):
"""封禁操作历史(仅管理员)。默认最近 50 条,可按 IP 过滤。"""
_require_admin(request)
rows = _BAN_HISTORY
if ip:
rows = [h for h in rows if h.get("ip") == ip]
rows = rows[-max(1, min(limit, _BAN_HISTORY_MAX)):]
return {"count": len(rows), "items": list(reversed(rows))}
# ⚠️ 顺序敏感:下面两个必须以 "history" 结尾的路由**声明在** DELETE /admin/banned/{ip}
# 之前,否则 FastAPI 会把 "history" 当成一个 IP 交给解封接口处理。
@app.delete("/admin/banned/history/{hid}")
async def admin_ban_history_delete(request: Request, hid: str, _auth=Depends(require_auth)):
"""删除一条封禁历史(仅管理员)。只动历史记录,不影响任何实际封禁。"""
_require_admin(request)
keep = [h for h in _BAN_HISTORY if h.get("id") != hid]
if len(keep) == len(_BAN_HISTORY):
raise HTTPException(404, f"找不到历史记录 {hid}")
_BAN_HISTORY[:] = keep
_ban_history_save()
log.info("管理员 %s 删除封禁历史 %s", request.state.account, hid)
return {"status": "ok", "id": hid}
@app.delete("/admin/banned/history")
async def admin_ban_history_clear(request: Request, _auth=Depends(require_auth)):
"""清空全部封禁历史(仅管理员)。只动历史记录,不影响任何实际封禁。"""
_require_admin(request)
n = len(_BAN_HISTORY)
_BAN_HISTORY.clear()
_ban_history_save()
log.info("管理员 %s 清空封禁历史(共 %d 条)", request.state.account, n)
return {"status": "ok", "cleared": n}
@app.delete("/admin/banned/{ip}")
async def admin_unban(request: Request, ip: str, _auth=Depends(require_auth)):
"""解除某个 IP 的封禁(仅管理员)。"""
_require_admin(request)
# set.discard() 恒返回 None,不能拿它判断"是否存在",必须先查成员再删
was_timed = _BANNED.pop(ip, None) is not None
was_forever = ip in _BANNED_FOREVER
_BANNED_FOREVER.discard(ip)
existed = was_timed or was_forever
_AUTH_FAILS.pop(ip, None) # 连失败计数一起清,避免刚放行又被立刻封回去
_BAN_NOTES.pop(ip, None)
log.info("管理员 %s 解除 IP %s 的封禁(原本存在=%s)",
request.state.account, ip, existed)
if existed:
_ban_history_add("unban", ip, actor=request.state.account)
return {"status": "ok", "ip": ip, "was_banned": existed}
@app.delete("/admin/banned")
async def admin_unban_all(request: Request, _auth=Depends(require_auth)):
"""清空全部封禁(仅管理员)。用于批量误封后的快速恢复。"""
_require_admin(request)
n = len(_BANNED) + len(_BANNED_FOREVER)
_BANNED.clear()
_BANNED_FOREVER.clear()
_BAN_NOTES.clear()
_AUTH_FAILS.clear()
log.info("管理员 %s 清空全部封禁(共 %d 个 IP)", request.state.account, n)
if n:
_ban_history_add("unban_all", "*", actor=request.state.account, note=f"清空 {n} 个")
return {"status": "ok", "cleared": n}
@app.get("/auth/apikeys") @app.get("/auth/apikeys")
async def auth_list_apikeys(request: Request, _auth=Depends(require_auth)): async def auth_list_apikeys(request: Request, _auth=Depends(require_auth)):
"""列出本账号 Key(含明文,便于反复复制)。 """列出本账号 Key(含明文,便于反复复制)。
@@ -4280,7 +4704,7 @@ async def opencode_go_usage(_auth=Depends(require_auth)):
raise HTTPException(503, "OpenCode Go 未配置 API Key") raise HTTPException(503, "OpenCode Go 未配置 API Key")
base = str(pconfig.base_url or "https://opencode.ai/zen/go/v1").rstrip("/") base = str(pconfig.base_url or "https://opencode.ai/zen/go/v1").rstrip("/")
ua = (pconfig.extra_headers or {}).get("User-Agent") or f"api-gateway/{VERSION}" ua = (pconfig.extra_headers or {}).get("User-Agent") or f"xiaoyin-gateway/{VERSION}"
try: try:
async with httpx.AsyncClient(timeout=10) as client: async with httpx.AsyncClient(timeout=10) as client:
r = await client.get( r = await client.get(
+1 -1
View File
@@ -13,7 +13,7 @@ from collections import deque
from contextvars import ContextVar from contextvars import ContextVar
from typing import Any from typing import Any
log = logging.getLogger("api-gateway.metrics") log = logging.getLogger("xiaoyin-gateway.metrics")
# 请求级「归属账号」上下文(ContextVar,每 task/请求独立;由 main.py require_auth 写入)。 # 请求级「归属账号」上下文(ContextVar,每 task/请求独立;由 main.py require_auth 写入)。
# 访问日志与指标通过它给每条记录打上账号,实现: # 访问日志与指标通过它给每条记录打上账号,实现:
+1 -1
View File
@@ -31,7 +31,7 @@ import threading
import time import time
from pathlib import Path from pathlib import Path
log = logging.getLogger("api-gateway.sessions") log = logging.getLogger("xiaoyin-gateway.sessions")
# 落盘文件名固定为 sessions.json;结构带 version,便于以后改格式时兼容读取。 # 落盘文件名固定为 sessions.json;结构带 version,便于以后改格式时兼容读取。
_FILE_VERSION = 1 _FILE_VERSION = 1
+8 -2
View File
@@ -41,7 +41,7 @@ from app.config import (
validate_warnings, validate_warnings,
) )
log = logging.getLogger("api-gateway.settings") log = logging.getLogger("xiaoyin-gateway.settings")
# ── 改了必须重启进程才生效的键(其余都是"每请求读配置",保存即生效) ── # ── 改了必须重启进程才生效的键(其余都是"每请求读配置",保存即生效) ──
# host / port:uvicorn 在进程启动时绑定,改文件不会重绑。 # host / port:uvicorn 在进程启动时绑定,改文件不会重绑。
@@ -141,6 +141,9 @@ def config_to_view(cfg: GatewayConfig) -> dict[str, Any]:
"webhook_allow_private": s.webhook_allow_private, "webhook_allow_private": s.webhook_allow_private,
"docs_enabled": s.docs_enabled, "docs_enabled": s.docs_enabled,
"auth_fail_limit_per_min": s.auth_fail_limit_per_min, "auth_fail_limit_per_min": s.auth_fail_limit_per_min,
# 2026-11-19 补:封禁功能(2026-11-06)加了配置项但面板视图没跟上,
# 一旦在面板里保存配置,这一行就会被写丢(回退成默认 3600)。
"auth_fail_ban_seconds": s.auth_fail_ban_seconds,
}, },
"auth": {"session_ttl_minutes": cfg.auth.session_ttl_minutes}, "auth": {"session_ttl_minutes": cfg.auth.session_ttl_minutes},
"circuit": { "circuit": {
@@ -479,6 +482,9 @@ _SERVER_KEYS = (
"host", "port", "timeout", "retry", "health_auth", "hot_reload", "hot_reload_interval", "host", "port", "timeout", "retry", "health_auth", "hot_reload", "hot_reload_interval",
"metrics_enabled", "rate_limit_rps", "max_body_size", "cors_origins", "graceful_shutdown", "metrics_enabled", "rate_limit_rps", "max_body_size", "cors_origins", "graceful_shutdown",
"batch_max_concurrency", "batch_max_items", "webhook_allow_private", "docs_enabled", "batch_max_concurrency", "batch_max_items", "webhook_allow_private", "docs_enabled",
# 2026-11-19 补:封禁功能(2026-11-06)落盘了这两个键但忘了搬上面板,
# 导致「文件里有、面板里没有」—— 保存一次面板就会把它们丢掉。
"auth_fail_limit_per_min", "auth_fail_ban_seconds",
"auth_fail_limit_per_min", "auth_fail_limit_per_min",
) )
_CIRCUIT_KEYS = ("enabled", "failure_threshold", "cooldown", "window") _CIRCUIT_KEYS = ("enabled", "failure_threshold", "cooldown", "window")
@@ -510,7 +516,7 @@ def restart_keys_changed(old: GatewayConfig, new: GatewayConfig) -> list[str]:
# ── 渲染 yaml 文本 ──────────────────────────────────────── # ── 渲染 yaml 文本 ────────────────────────────────────────
_HEADER = """\ _HEADER = """\
# AI 网关配置文件(data/ 目录) # 小银网关配置文件(data/ 目录)
# #
# ⚠ 本文件由管理页面「网关配置」生成(管理员账号),页面保存时会**整份重写**: # ⚠ 本文件由管理页面「网关配置」生成(管理员账号),页面保存时会**整份重写**:
# 想要的历史决策/踩坑说明在 README.md(按轮次记录),这里只保留必要的现场注释。 # 想要的历史决策/踩坑说明在 README.md(按轮次记录),这里只保留必要的现场注释。
+1 -1
View File
@@ -28,7 +28,7 @@ import secrets
import threading import threading
import time import time
log = logging.getLogger("api-gateway.users") log = logging.getLogger("xiaoyin-gateway.users")
USERNAME_RE = re.compile(r"^[A-Za-z0-9]+$") USERNAME_RE = re.compile(r"^[A-Za-z0-9]+$")
ITERATIONS = 200_000 ITERATIONS = 200_000
+1 -1
View File
@@ -30,7 +30,7 @@ import threading
import time import time
from pathlib import Path from pathlib import Path
log = logging.getLogger("api-gateway.video_owners") log = logging.getLogger("xiaoyin-gateway.video_owners")
_FILE_VERSION = 1 _FILE_VERSION = 1
+55 -28
View File
@@ -1,4 +1,4 @@
# AI 网关配置文件(data/ 目录) # 小银网关配置文件(data/ 目录)
# 供应商:Agnes / OpenCode Go(订阅编程模型)/ Dots AI # 供应商:Agnes / OpenCode Go(订阅编程模型)/ Dots AI
# 密钥统一走 token_env 指向的环境变量(本机见 data/.env),不再在 yaml 存明文 # 密钥统一走 token_env 指向的环境变量(本机见 data/.env),不再在 yaml 存明文
# 端口默认 8808 # 端口默认 8808
@@ -232,8 +232,6 @@ providers:
- id: "agnes-video-2.5-flash" - id: "agnes-video-2.5-flash"
display_name: "Agnes Video 2.5 Flash" display_name: "Agnes Video 2.5 Flash"
type: "video" type: "video"
free: true # 2026-09-24 自动同步:文档「当前优惠」写当前限时免费(scripts/sync_models.py)
free_limited: true # 限时免费;文档改口径后同步会自动撤掉这行
# 2026-09-24 自动同步:官方文档新增(scripts/sync_models.py) # 2026-09-24 自动同步:官方文档新增(scripts/sync_models.py)
- id: "agnes-2.5-pro" - id: "agnes-2.5-pro"
display_name: "Agnes 2.5 Pro" display_name: "Agnes 2.5 Pro"
@@ -264,6 +262,11 @@ providers:
context_window: 1000000 # 同步 2026-10-21(scripts/sync_models.py) context_window: 1000000 # 同步 2026-10-21(scripts/sync_models.py)
max_output_tokens: 65536 # 同步 2026-10-21(scripts/sync_models.py) max_output_tokens: 65536 # 同步 2026-10-21(scripts/sync_models.py)
# 文档现价 ¥3/M 输入、¥6/M 输出 # 文档现价 ¥3/M 输入、¥6/M 输出
# 2026-11-09 自动同步:官方文档新增(scripts/sync_models.py)
- id: "agnes-2.5-pro-theta"
display_name: "Agnes 2.5 Pro Theta"
type: "text"
# 文档现价 ¥3/M 输入、¥6/M 输出
opencode: opencode:
name: "OpenCode Go" name: "OpenCode Go"
@@ -276,7 +279,7 @@ providers:
# 每次请求动态注入会话头(不能放静态 extra_headers——会被 _get_adapter 缓存冻结)。 # 每次请求动态注入会话头(不能放静态 extra_headers——会被 _get_adapter 缓存冻结)。
requires_session_header: true requires_session_header: true
extra_headers: extra_headers:
User-Agent: "api-gateway/2.4.0 (jakon opencode-go)" User-Agent: "xiaoyin-gateway/2.4.0 (jakon opencode-go)"
# 无媒体能力(纯文本编程模型;图像/视频不走本供应商) # 无媒体能力(纯文本编程模型;图像/视频不走本供应商)
media: {} media: {}
# ── 协议线(第二十七轮「三线直传」)────────────────────────── # ── 协议线(第二十七轮「三线直传」)──────────────────────────
@@ -301,6 +304,7 @@ providers:
responses: responses:
path: "/responses" path: "/responses"
auth: "bearer" auth: "bearer"
rate_limit_rps: 3.0 # 2026-11-06 新增:主动限流,避免被上游 429
# ── 模型 ───────────────────────────────────────────────── # ── 模型 ─────────────────────────────────────────────────
# models[].protocols = 该模型**能用哪几条线**(入站格式必须与出站一致)。 # models[].protocols = 该模型**能用哪几条线**(入站格式必须与出站一致)。
# 取值:chat/completions | messages | responses;不写 = 只认 chat/completions。 # 取值:chat/completions | messages | responses;不写 = 只认 chat/completions。
@@ -331,12 +335,6 @@ providers:
context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护 context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 131072 # 最大输出(token) max_output_tokens: 131072 # 最大输出(token)
protocols: ["chat/completions"] 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" - id: "kimi-k2.7-code"
display_name: "Kimi K2.7 Code" display_name: "Kimi K2.7 Code"
type: "text" type: "text"
@@ -355,18 +353,6 @@ providers:
context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护 context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 131072 # 最大输出(token) max_output_tokens: 131072 # 最大输出(token)
protocols: ["chat/completions"] protocols: ["chat/completions"]
- id: "mimo-v2.5"
display_name: "MiMo V2.5"
type: "text"
context_window: 1000000 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 128000 # 最大输出(token)
protocols: ["chat/completions"]
- id: "mimo-v2.5-pro"
display_name: "MiMo V2.5 Pro"
type: "text"
context_window: 1048576 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 128000 # 最大输出(token)
protocols: ["chat/completions"]
- id: "hy4-preview" - id: "hy4-preview"
display_name: "Hy4 Preview" display_name: "Hy4 Preview"
type: "text" type: "text"
@@ -398,7 +384,7 @@ providers:
display_name: "Kimi K3" display_name: "Kimi K3"
type: "text" type: "text"
context_window: 1048576 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护 context_window: 1048576 # 第三十三轮(2026-09-24):上下文窗口(token),每日同步维护
max_output_tokens: 131072 # 最大输出(token) max_output_tokens: 1048576 # 最大输出(token)
protocols: ["chat/completions", "messages"] protocols: ["chat/completions", "messages"]
- id: "minimax-m3" - id: "minimax-m3"
display_name: "MiniMax M3" display_name: "MiniMax M3"
@@ -495,7 +481,7 @@ providers:
display_name: "Kimi K3.1 Pro" display_name: "Kimi K3.1 Pro"
type: "text" type: "text"
context_window: 1048576 # 同步 2026-10-25(scripts/sync_models.py) context_window: 1048576 # 同步 2026-10-25(scripts/sync_models.py)
max_output_tokens: 131072 # 同步 2026-10-25(scripts/sync_models.py) max_output_tokens: 1048576 # 同步 2026-10-25(scripts/sync_models.py)
# 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的) # 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的)
protocols: ["chat/completions"] protocols: ["chat/completions"]
# 2026-10-27 自动同步:官方文档新增(scripts/sync_models.py) # 2026-10-27 自动同步:官方文档新增(scripts/sync_models.py)
@@ -507,6 +493,41 @@ providers:
# 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的) # 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的)
protocols: ["chat/completions"] protocols: ["chat/completions"]
free: true # 官方价格表标 Free free: true # 官方价格表标 Free
# 2026-11-06 自动同步:官方文档新增(scripts/sync_models.py)
- id: "hy4"
display_name: "Hy4"
type: "text"
context_window: 1048576 # 同步 2026-11-07(scripts/sync_models.py)
max_output_tokens: 65536 # 同步 2026-11-07(scripts/sync_models.py)
# 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的)
protocols: ["chat/completions"]
# 2026-11-07 自动同步:官方文档新增(scripts/sync_models.py)
# 2026-11-10 自动同步:官方文档新增(scripts/sync_models.py)
- id: "longcat-2.5-free"
display_name: "Longcat 2.5 Free"
type: "text"
context_window: 1000000 # 同步 2026-11-10(scripts/sync_models.py)
max_output_tokens: 262144 # 同步 2026-11-10(scripts/sync_models.py)
# 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的)
protocols: ["chat/completions"]
free: true # 官方价格表标 Free
# 2026-11-16 自动同步:官方文档新增(scripts/sync_models.py)
- id: "hy4-flash-free"
display_name: "Hy4 Flash Free"
type: "text"
context_window: 1048576 # 同步 2026-11-19(scripts/sync_models.py)
max_output_tokens: 65536 # 同步 2026-11-19(scripts/sync_models.py)
# 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的)
protocols: ["chat/completions"]
free: true # 官方价格表标 Free
# 2026-11-16 自动同步:官方文档新增(scripts/sync_models.py)
- id: "qwen4-max"
display_name: "Qwen4 Max"
type: "text"
context_window: 1000000 # 同步 2026-11-19(scripts/sync_models.py)
max_output_tokens: 262144 # 同步 2026-11-19(scripts/sync_models.py)
# 协议线取自官方 Endpoints 表,未逐线实测(现网其它模型是实测过的)
protocols: ["messages"]
# 2026-10-09 自动同步:官方文档新增(scripts/sync_models.py) # 2026-10-09 自动同步:官方文档新增(scripts/sync_models.py)
# ── Dots AI(小红书 Dots Studio,第三十六轮新增)────────────── # ── Dots AI(小红书 Dots Studio,第三十六轮新增)──────────────
# 官方文档:https://dots.ai/platform/docs(2026-09-28 通读) # 官方文档:https://dots.ai/platform/docs(2026-09-28 通读)
@@ -569,20 +590,25 @@ server:
hot_reload: true # 监听 gateway.yaml mtime 自动重载(改配置免重启) hot_reload: true # 监听 gateway.yaml mtime 自动重载(改配置免重启)
hot_reload_interval: 15 # 重载检查间隔(秒) hot_reload_interval: 15 # 重载检查间隔(秒)
metrics_enabled: true # 记录调用指标(/metrics) metrics_enabled: true # 记录调用指标(/metrics)
rate_limit_rps: 20 # 全局单 user QPS 上限(2026-10-23 由 null 改为 20:防泄露 Key 打爆额度; rate_limit_rps: 50 # 全局单 user QPS 上限(2026-11-06 由 20 改为 50:多客户端并发时 20 太紧)(2026-10-23 由 null 改为 20:防泄露 Key 打爆额度;
# 供应商级限流仍由 provider.rate_limit_rps 控制,两者取更严的那个) # 供应商级限流仍由 provider.rate_limit_rps 控制,两者取更严的那个)
# 请求体字节上限。2026-09-24 从 2MB 提到 20MB:带图对话(生成/上传的 PNG 以 # 请求体字节上限。2026-09-24 从 2MB 提到 20MB:带图对话(生成/上传的 PNG 以
# base64 内联进历史,单张 100KB~750KB)几张就顶爆 2MB → 上游 413 # base64 内联进历史,单张 100KB~750KB)几张就顶爆 2MB → 上游 413
# 「请求体超过上限 2000000 字节」。内部网关 + nginx 两层把关,保留限制只调大数字。 # 「请求体超过上限 2000000 字节」。内部网关 + nginx 两层把关,保留限制只调大数字。
max_body_size: 20000000 max_body_size: 20000000
cors_origins: ["*"] # CORS 允许来源(生产收紧为具体域名) cors_origins: # CORS 允许来源(2026-11-06 由 ["*"] 收紧为白名单)
- "http://127.0.0.1:8808"
- "http://localhost:8808"
- "http://127.0.0.1:5173" # Vite dev server
- "http://localhost:5173"
graceful_shutdown: 30 # 优雅关闭等待在途请求的秒数 graceful_shutdown: 30 # 优雅关闭等待在途请求的秒数
# ── 防滥用 / 安全 ── # ── 防滥用 / 安全 ──
batch_max_concurrency: 16 # /batch 并发上限(客户端 max_concurrency 会被钳到此值) batch_max_concurrency: 16 # /batch 并发上限(客户端 max_concurrency 会被钳到此值)
batch_max_items: 64 # /batch 单次最大条目数(超出返回 400) batch_max_items: 64 # /batch 单次最大条目数(超出返回 400)
webhook_allow_private: false # 视频 callback_url 是否允许指向内网/回环(SSRF 防护,默认禁) webhook_allow_private: false # 视频 callback_url 是否允许指向内网/回环(SSRF 防护,默认禁)
docs_enabled: false # FastAPI 文档(/docs、/openapi.json)是否开放(安全默认关) docs_enabled: false # FastAPI 文档(/docs、/openapi.json)是否开放(安全默认关)
auth_fail_limit_per_min: 20 # 同一来源 IP 每分钟鉴权失败上限,超过 → 429(防暴力枚举) auth_fail_limit_per_min: 60 # 同一来源 IP 每分钟鉴权失败上限(2026-11-06 由 20 改为 60:客户端配错 Key 重试容易误触发),超过 → 429(防暴力枚举)
auth_fail_ban_seconds: 3600 # 2026-11-06 新增:鉴权失败超限后拉黑 1 小时(0=只限流不拉黑)
# ── 供应商熔断(Circuit Breaker) ────────────────────── # ── 供应商熔断(Circuit Breaker) ──────────────────────
# 某供应商连续/滑动窗口失败达到 failure_threshold 就熔断 cooldown 秒, # 某供应商连续/滑动窗口失败达到 failure_threshold 就熔断 cooldown 秒,
@@ -606,7 +632,8 @@ pricing:
agnes-3.0-flash: { input: 0, output: 0 } # 同步 2026-09-24(原 0.35/1;文档现价 ¥0/M 输入、¥0/M 输出) agnes-3.0-flash: { input: 0, output: 0 } # 同步 2026-09-24(原 0.35/1;文档现价 ¥0/M 输入、¥0/M 输出)
agnes-2.5-flash: { input: 0, output: 0 } # 文档现价暂免(输入/输出/缓存命中均 ¥0/百万) agnes-2.5-flash: { input: 0, output: 0 } # 文档现价暂免(输入/输出/缓存命中均 ¥0/百万)
agnes-2.5-pro: { input: 3, output: 6 } # 2026-09-24 自动同步(文档现价) agnes-2.5-pro: { input: 3, output: 6 } # 2026-09-24 自动同步(文档现价)
agnes-2.5-pro-beta: { input: 3, output: 6 } # 2026-10-21 自动同步(文档现价) agnes-2.5-pro-beta: { input: 0.7, output: 2.1 } # 2026-10-21 自动同步(文档现价)
agnes-2.5-pro-theta: { input: 0.7, output: 2 } # 2026-11-09 自动同步(文档现价)
# ── 媒体下载代理白名单(第十七轮)──────────────────────── # ── 媒体下载代理白名单(第十七轮)────────────────────────
# 生成的图片/视频挂在第三方 CDN 上且不带 CORS 头,浏览器里既 fetch 不到 blob、 # 生成的图片/视频挂在第三方 CDN 上且不带 CORS 头,浏览器里既 fetch 不到 blob、
+4 -4
View File
@@ -175,7 +175,7 @@
### Step 0 · 建 QwenPaw profile `ai-gateway` ✅ **已完成**(2026-09-29) ### Step 0 · 建 QwenPaw profile `ai-gateway` ✅ **已完成**(2026-09-29)
``` ```
0. 备份:cp /root/.qwenpaw/config.json → config.json.bak-<日期>(记回滚方式) 0. 备份:cp ~/.qwenpaw/config.json → config.json.bak-<日期>(记回滚方式)
1. 复制骨架:default 的 workspaces → workspaces/ai-gateway 1. 复制骨架:default 的 workspaces → workspaces/ai-gateway
2. 清私人内容:该 profile 的 SOUL.md / AGENTS.md 改写为"网关智能体"版本 2. 清私人内容:该 profile 的 SOUL.md / AGENTS.md 改写为"网关智能体"版本
(不继承"小银"身份、老板的私人上下文、项目记忆)—— 见 §4 已定-B (不继承"小银"身份、老板的私人上下文、项目记忆)—— 见 §4 已定-B
@@ -197,7 +197,7 @@
| 项 | 结果 | | 项 | 结果 |
|---|---| |---|---|
| 备份 | `config.json.bak-20260929-agents` | | 备份 | `config.json.bak-20260929-agents` |
| 工作区 | `/root/.qwenpaw/workspaces/ai-gateway/`(**全新空白,未复制 default 的任何私人文件**) | | 工作区 | `<工作区>/`(**全新空白,未复制 default 的任何私人文件**) |
| 提示词 | 新写 `SOUL.md` + `AGENTS.md`(网关智能体版);`system_prompt_files: ["AGENTS.md","SOUL.md"]`(**不含 PROFILE.md**) | | 提示词 | 新写 `SOUL.md` + `AGENTS.md`(网关智能体版);`system_prompt_files: ["AGENTS.md","SOUL.md"]`(**不含 PROFILE.md**) |
| 注册 | `config.json` 的 `agents.profiles` + `agent_order` 均已加 `ai-gateway` | | 注册 | `config.json` 的 `agents.profiles` + `agent_order` 均已加 `ai-gateway` |
| 工具 | ✅ **全开 27 个**(决策⑪);`approval_level: OFF` | | 工具 | ✅ **全开 27 个**(决策⑪);`approval_level: OFF` |
@@ -490,8 +490,8 @@ scripts/ci_check.sh 跑绿
- 改 `router.ts`、`lib/nav.ts`、`components/Icon.vue`、`locales/zh.ts`、`locales/en.ts` - 改 `router.ts`、`lib/nav.ts`、`components/Icon.vue`、`locales/zh.ts`、`locales/en.ts`
**QwenPaw 侧** **QwenPaw 侧**
- 改 `/root/.qwenpaw/config.json`(profiles 加一项) - 改 `~/.qwenpaw/config.json`(profiles 加一项)
- 新增 `/root/.qwenpaw/workspaces/ai-gateway/`(骨架 + SOUL.md / AGENTS.md) - 新增 `<工作区>/`(骨架 + SOUL.md / AGENTS.md)
**文档** **文档**
- 改 `README.md`、`CHANGELOG.md` - 改 `README.md`、`CHANGELOG.md`
+3 -3
View File
@@ -1,7 +1,7 @@
# API 网关 Web 前端 —— 设计文档 # 小银网关 Web 前端 —— 设计文档
> 版本 v0.1(待审)|2026-09-11 > 版本 v0.1(待审)|2026-09-11
> 对象:`https://api.wangjinding.com`(网关,端口 8808,已开鉴权,127.0.0.1 反代对外) > 对象:`http://127.0.0.1:8808`(网关,端口 8808,已开鉴权,127.0.0.1 反代对外)
--- ---
@@ -53,7 +53,7 @@
## 3. 总体架构与鉴权 ## 3. 总体架构与鉴权
``` ```
浏览器 SPA (Vue3) ──同源──> api.wangjinding.com 浏览器 SPA (Vue3) ──同源──> 127.0.0.1:8808
├─ /web/... 静态资源(Vue 构建产物) ├─ /web/... 静态资源(Vue 构建产物)
├─ POST /auth/login 登录(验 key → 发短时 Cookie/会话 token) ├─ POST /auth/login 登录(验 key → 发短时 Cookie/会话 token)
├─ POST /v1/* 业务调用(带会话凭证) ├─ POST /v1/* 业务调用(带会话凭证)
+2 -2
View File
@@ -1,6 +1,6 @@
# AI 网关项目体检报告(2026-10-23) # 小银网关项目体检报告(2026-10-23)
> 范围:`/root/dsh/projects/api-gateway`(v2.9.15)。方法:跑测试 + 静态检查 + 数据/权限/备份审计 + 真实接口压测。 > 范围:`/root/dsh/projects/<项目>`(v2.9.15)。方法:跑测试 + 静态检查 + 数据/权限/备份审计 + 真实接口压测。
## 一、已修复(本次体检发现) ## 一、已修复(本次体检发现)
+8 -8
View File
@@ -5,7 +5,7 @@
## 现象 ## 现象
``` ```
POST https://api.wangjinding.com/v1/chat/completions POST http://127.0.0.1:8808/v1/chat/completions
Authorization: Bearer wjd-... Authorization: Bearer wjd-...
User-Agent: WorkBuddy/5.8.3 → HTTP 403 User-Agent: WorkBuddy/5.8.3 → HTTP 403
``` ```
@@ -14,7 +14,7 @@ User-Agent: WorkBuddy/5.8.3 → HTTP 403
## 根因 ## 根因
`api.wangjinding.com` 前面挂着 **1Panel 的 WAF(1pwaf)**,它会检查**请求体内容**: `127.0.0.1:8808` 前面挂着 **1Panel 的 WAF(1pwaf)**,它会检查**请求体内容**:
| 请求体里出现 | 结果 | | 请求体里出现 | 结果 |
|---|---| |---|---|
@@ -29,7 +29,7 @@ AI 编程客户端(WorkBuddy / Cursor / 各类 CLI)把**用户代码**原样
判断依据(WAF 访问日志): 判断依据(WAF 访问日志):
``` ```
/opt/1panel/www/sites/api.wangjinding.com/log/access.log /opt/1panel/www/sites/127.0.0.1:8808/log/access.log
117.85.65.211 - - [22/Oct/2026:17:40:26 +0800] "POST /v1/chat/completions HTTP/1.1" 403 16711 117.85.65.211 - - [22/Oct/2026:17:40:26 +0800] "POST /v1/chat/completions HTTP/1.1" 403 16711
"-" "WorkBuddy/5.8.3" "116.228.205.72" ← 最后一列是真实客户端 IP(经 EO 回源后) "-" "WorkBuddy/5.8.3" "116.228.205.72" ← 最后一列是真实客户端 IP(经 EO 回源后)
``` ```
@@ -65,12 +65,12 @@ docker exec 1Panel-openresty-npAh nginx -s reload
```bash ```bash
K=wjd-... # 任一成员的 Key K=wjd-... # 任一成员的 Key
# 1) 以前被拦的内容现在应 200 # 1) 以前被拦的内容现在应 200
curl -s -o /dev/null -w '%{http_code}\n' https://api.wangjinding.com/v1/chat/completions \ curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8808/v1/chat/completions \
-H "Authorization: Bearer $K" -H 'Content-Type: application/json' \ -H "Authorization: Bearer $K" -H 'Content-Type: application/json' \
-d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"<script>alert(1)</script> system(\"ls\")"}],"max_tokens":5}' -d '{"model":"deepseek-v4.1-flash","messages":[{"role":"user","content":"<script>alert(1)</script> system(\"ls\")"}],"max_tokens":5}'
# 2) /v1/ 之外必须仍然拦截(这是安全底线,别把 WAF 整个关掉) # 2) /v1/ 之外必须仍然拦截(这是安全底线,别把 WAF 整个关掉)
curl -s -o /dev/null -w '%{http_code}\n' https://api.wangjinding.com/.env # 期望 403 curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8808/.env # 期望 403
curl -s -o /dev/null -w '%{http_code}\n' https://api.wangjinding.com/etc/passwd # 期望 403 curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8808/etc/passwd # 期望 403
``` ```
## ⚠️ 持久化注意 ## ⚠️ 持久化注意
@@ -78,13 +78,13 @@ curl -s -o /dev/null -w '%{http_code}\n' https://api.wangjinding.com/etc/passwd
线上这套 WAF 配置由 **阿里云那台的 1Panel 主控**通过 agent 下发。 线上这套 WAF 配置由 **阿里云那台的 1Panel 主控**通过 agent 下发。
直接改文件**立刻生效**,但如果在面板里保存一次 WAF 设置,这条白名单**可能被覆盖**。 直接改文件**立刻生效**,但如果在面板里保存一次 WAF 设置,这条白名单**可能被覆盖**。
**建议在面板里也加一遍**:`网站 → api.wangjinding.com → WAF → 白名单 → URL 白名单 → ^/v1/`。 **建议在面板里也加一遍**:`网站 → 127.0.0.1:8808 → WAF → 白名单 → URL 白名单 → ^/v1/`。
之后如果又出现 403,先按本文「判断依据」确认是不是 WAF,再补规则即可。 之后如果又出现 403,先按本文「判断依据」确认是不是 WAF,再补规则即可。
## 给调用方的配置口径 ## 给调用方的配置口径
``` ```
Base URL : https://api.wangjinding.com/v1 Base URL : http://127.0.0.1:8808/v1
API Key : wjd-...(成员自己的 Key) API Key : wjd-...(成员自己的 Key)
Model : deepseek-v4.1-flash ← 注意不要写 opencode/deepseek-v4.1-flash(会 400 未知模型) Model : deepseek-v4.1-flash ← 注意不要写 opencode/deepseek-v4.1-flash(会 400 未知模型)
或 wjd ← 虚拟 id,由管理员在网关里映射到具体模型 或 wjd ← 虚拟 id,由管理员在网关里映射到具体模型
+1 -1
View File
@@ -3,7 +3,7 @@
<head> <head>
<meta charset="UTF-8" /> <meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>API 网关管理台</title> <title>小银网关管理台</title>
</head> </head>
<body> <body>
<div id="app"></div> <div id="app"></div>
+2 -2
View File
@@ -1,11 +1,11 @@
{ {
"name": "api-gateway-web", "name": "xiaoyin-gateway-web",
"version": "0.1.0", "version": "0.1.0",
"lockfileVersion": 3, "lockfileVersion": 3,
"requires": true, "requires": true,
"packages": { "packages": {
"": { "": {
"name": "api-gateway-web", "name": "xiaoyin-gateway-web",
"version": "0.1.0", "version": "0.1.0",
"dependencies": { "dependencies": {
"dompurify": "^3.4.15", "dompurify": "^3.4.15",
+1 -1
View File
@@ -1,5 +1,5 @@
{ {
"name": "api-gateway-web", "name": "xiaoyin-gateway-web",
"private": true, "private": true,
"version": "0.1.0", "version": "0.1.0",
"type": "module", "type": "module",
+1 -1
View File
@@ -161,7 +161,7 @@ const pageSub = computed(() => {
const key = String(route.name || '') const key = String(route.name || '')
const sub = t(`nav.sub${key}`) const sub = t(`nav.sub${key}`)
// 没写副标题的页面,t() 会把 key 原样返回 —— 这时显示连接地址兜底 // 没写副标题的页面,t() 会把 key 原样返回 —— 这时显示连接地址兜底
return sub.startsWith('nav.') ? 'api.wangjinding.com' : sub return sub.startsWith('nav.') ? location.host : sub
}) })
function onTheme(cmd: string | number | object) { function onTheme(cmd: string | number | object) {
+2 -1
View File
@@ -5,7 +5,7 @@
<span class="logo"><Icon name="bolt" :size="17" /></span> <span class="logo"><Icon name="bolt" :size="17" /></span>
<div> <div>
<b>{{ t('nav.title') }}</b> <b>{{ t('nav.title') }}</b>
<span>api.wangjinding.com</span> <span>{{ apiHost }}</span>
</div> </div>
</div> </div>
@@ -33,6 +33,7 @@
</template> </template>
<script setup lang="ts"> <script setup lang="ts">
const apiHost = location.host
import { onMounted, onUnmounted, ref } from 'vue' import { onMounted, onUnmounted, ref } from 'vue'
import { useRoute } from 'vue-router' import { useRoute } from 'vue-router'
import { useI18n } from 'vue-i18n' import { useI18n } from 'vue-i18n'
+1
View File
@@ -45,6 +45,7 @@ export function navGroups(isAdmin: boolean): NavGroup[] {
// 第二十二轮定稿:管理员只处理反馈(「用户反馈」),不提意见 —— 所以这两项互斥。 // 第二十二轮定稿:管理员只处理反馈(「用户反馈」),不提意见 —— 所以这两项互斥。
if (isAdmin) sys.push({ path: '/users', key: 'users', icon: 'users' }) if (isAdmin) sys.push({ path: '/users', key: 'users', icon: 'users' })
if (isAdmin) sys.push({ path: '/feedback-inbox', key: 'feedbackinbox', icon: 'inbox' }) if (isAdmin) sys.push({ path: '/feedback-inbox', key: 'feedbackinbox', icon: 'inbox' })
if (isAdmin) sys.push({ path: '/banned', key: 'banned', icon: 'ban' })
// 第二十三轮追加:老板要求「网关配置先不要删掉、先隐藏起来,这块先不支持页面配置」→ // 第二十三轮追加:老板要求「网关配置先不要删掉、先隐藏起来,这块先不支持页面配置」→
// 入口由 `lib/features.ts` 的开关统一控制(页面与路由都还在,只是不挂出来)。 // 入口由 `lib/features.ts` 的开关统一控制(页面与路由都还在,只是不挂出来)。
if (isAdmin && GATEWAY_CONFIG_ENABLED) sys.push({ path: '/gateway-config', key: 'gatewaycfg', icon: 'sliders' }) if (isAdmin && GATEWAY_CONFIG_ENABLED) sys.push({ path: '/gateway-config', key: 'gatewaycfg', icon: 'sliders' })
+77 -3
View File
@@ -1,8 +1,72 @@
// English locale resource // English locale resource
export default { export default {
banned: {
title: 'Banned IPs',
count: '{n} IP(s) banned',
rule: 'An IP is auto-banned for {mins} min after {n} auth failures within a minute. While banned, every API request from it returns 429; other sources are unaffected.',
remaining: '{mins} min left',
until: 'Unban at',
unban: 'Unban',
empty: 'No banned IPs',
unbanned: 'Unbanned {ip}',
clearAll: 'Unban all',
clearTitle: 'Clear all bans',
clearConfirm: 'Clear all bans? Those IPs can access immediately afterwards.',
cleared: 'Cleared {n} ban(s)',
manualTitle: 'Manual ban',
manualSub: 'Ban an IP right away instead of waiting for the auto rule',
manualHint: 'Public IPs only. Loopback and private ranges (10./192.168./172.) cannot be banned, so the local reverse proxy and your own LAN devices stay reachable.',
ipPlaceholder: 'IP address, e.g. 1.2.3.4',
notePlaceholder: 'Note (optional, e.g. "brute force")',
doBan: 'Ban',
ipRequired: 'Please enter an IP address',
banned: 'Banned {ip} for {mins} min',
bannedForever: 'Permanently banned {ip}',
extend: 'Extend',
extended: 'Extended {ip} by {mins} min',
extendedForever: '{ip} is now banned permanently',
toPermanent: 'Make permanent',
permanentTag: 'permanent',
neverExpire: 'Permanent — will not expire automatically',
historyTitle: 'Ban history',
historySub: 'Recent actions (ban / unban / extend)',
historyEmpty: 'No ban actions yet',
unitDay: '{n} day(s)',
unitHour: '{n} hour(s)',
unitMin: '{n} min',
hisOps: 'Action',
hisDelete: 'Delete',
hisDeleted: 'History entry deleted',
hisClearAll: 'Clear history',
hisClearConfirm: 'Clear all ban history? This cannot be undone (active bans are not affected).',
hisCleared: 'Cleared {n} history entries',
hisTime: 'Time',
hisAction: 'Action',
hisIp: 'IP',
hisDuration: 'Duration',
hisActor: 'By',
hisNote: 'Note',
act: {
manual_ban: 'manual ban',
auto_ban: 'auto ban',
extend: 'extend',
unban: 'unban',
unban_all: 'clear all',
},
dur: {
m10: '10 minutes',
m30: '30 minutes',
h1: '1 hour',
h6: '6 hours',
d1: '1 day',
d30: '30 days',
forever: 'permanent',
},
},
nav: { nav: {
title: 'API Gateway', title: 'Xiaoyin Gateway',
connected: 'Connected to api.wangjinding.com', connected: 'Connected',
disconnected: 'Connection error', disconnected: 'Connection error',
menudashboard: 'Dashboard', menudashboard: 'Dashboard',
menuchat: 'Chat', menuchat: 'Chat',
@@ -16,6 +80,7 @@ export default {
menulogs: 'Logs', menulogs: 'Logs',
menufeedback: 'Feedback', menufeedback: 'Feedback',
menufeedbackinbox: 'User feedback', menufeedbackinbox: 'User feedback',
menubanned: 'Banned IPs',
feedbackTodoTip: '{n} pending (open + in progress)', feedbackTodoTip: '{n} pending (open + in progress)',
menusettings: 'Settings', menusettings: 'Settings',
control: 'Console', control: 'Console',
@@ -75,7 +140,7 @@ export default {
cancel: 'Cancel', cancel: 'Cancel',
}, },
login: { login: {
title: 'API Gateway Console', title: 'Xiaoyin Gateway Console',
userPlaceholder: 'Username', userPlaceholder: 'Username',
passPlaceholder: 'Password', passPlaceholder: 'Password',
btn: 'Sign in', btn: 'Sign in',
@@ -551,6 +616,15 @@ export default {
providers: 'Providers', providers: 'Providers',
loadErr: 'Failed to load models', loadErr: 'Failed to load models',
capability: 'Capability', capability: 'Capability',
// 2026-11-19: OpenCode Go plan quota + training policy (from the official models API's go field)
goQuota: 'Go quota',
goQuotaHint: 'Monthly allowance each plan covers when you use only this model (official go.monthly_usage)',
goQuotaValues: 'Go ${go}/mo · Go Plus ${plus}/mo · Go Teams ${teams}/mo',
goQuotaFree: 'Free',
goTrainingNo: 'No training',
goTrainingYes: 'Trains',
goTrainingHint: 'Official go.training flag: whether this model trains on your requests',
goZdrHint: 'Zero data retention: upstream keeps none of your content',
visionTag: 'Vision', visionTag: 'Vision',
freeTag: 'Free', freeTag: 'Free',
freeHint: 'Officially free model: no usage-based billing (quota is set by the vendor; both the Agnes and OpenCode Go free tiers are labelled)', freeHint: 'Officially free model: no usage-based billing (quota is set by the vendor; both the Agnes and OpenCode Go free tiers are labelled)',
+77 -3
View File
@@ -1,8 +1,72 @@
// 中文文案资源 // 中文文案资源
export default { export default {
banned: {
title: '封禁列表',
count: '共 {n} 个 IP 被封',
rule: '同一 IP 每分钟鉴权失败达到 {n} 次即自动封禁 {mins} 分钟;被封期间该 IP 的所有 API 请求返回 429,其他来源不受影响。',
remaining: '剩余 {mins} 分钟',
until: '解封时间',
unban: '解封',
empty: '当前没有被封禁的 IP',
unbanned: '已解封 {ip}',
clearAll: '全部解封',
clearTitle: '清空全部封禁',
clearConfirm: '确定清空全部封禁?清空后这些 IP 可以立即重新访问。',
cleared: '已清空 {n} 个封禁',
manualTitle: '手动封禁',
manualSub: '立即拉黑指定 IP,不必等它触发自动规则',
manualHint: '只支持公网 IP;回环地址和内网段(10./192.168./172.)不允许封禁,避免把本机反代或自家设备锁死。',
ipPlaceholder: 'IP 地址,例如 1.2.3.4',
notePlaceholder: '备注(可选,例如「持续爆破」)',
doBan: '封禁',
ipRequired: '请先填写 IP 地址',
banned: '已封禁 {ip},时长 {mins} 分钟',
bannedForever: '已永久封禁 {ip}',
extend: '延长',
extended: '已为 {ip} 延长 {mins} 分钟',
extendedForever: '{ip} 已改为永久封禁',
toPermanent: '改为永久',
permanentTag: '永久',
neverExpire: '永久有效,不会自动解封',
historyTitle: '封禁历史',
historySub: '最近的操作记录(封禁 / 解封 / 延长)',
historyEmpty: '还没有封禁操作记录',
unitDay: '{n} 天',
unitHour: '{n} 小时',
unitMin: '{n} 分钟',
hisOps: '操作',
hisDelete: '删除',
hisDeleted: '已删除该条历史',
hisClearAll: '清空历史',
hisClearConfirm: '确定清空全部封禁历史?此操作不可恢复(不会影响当前封禁)。',
hisCleared: '已清空 {n} 条历史',
hisTime: '时间',
hisAction: '操作',
hisIp: 'IP',
hisDuration: '时长',
hisActor: '操作人',
hisNote: '备注',
act: {
manual_ban: '手动封禁',
auto_ban: '自动封禁',
extend: '延长',
unban: '解封',
unban_all: '清空',
},
dur: {
m10: '10 分钟',
m30: '30 分钟',
h1: '1 小时',
h6: '6 小时',
d1: '1 天',
d30: '30 天',
forever: '永久',
},
},
nav: { nav: {
title: 'API 网关', title: '小银网关',
connected: '已连接 api.wangjinding.com', connected: '已连接',
disconnected: '连接异常', disconnected: '连接异常',
menudashboard: '仪表盘', menudashboard: '仪表盘',
menuchat: '对话', menuchat: '对话',
@@ -16,6 +80,7 @@ export default {
menulogs: '日志', menulogs: '日志',
menufeedback: '意见反馈', menufeedback: '意见反馈',
menufeedbackinbox: '用户反馈', menufeedbackinbox: '用户反馈',
menubanned: '封禁管理',
feedbackTodoTip: '{n} 条待办(未处理 + 处理中)', feedbackTodoTip: '{n} 条待办(未处理 + 处理中)',
menusettings: '设置', menusettings: '设置',
control: '控制台', control: '控制台',
@@ -75,7 +140,7 @@ export default {
cancel: '取消', cancel: '取消',
}, },
login: { login: {
title: 'API 网关管理台', title: '小银网关管理台',
userPlaceholder: '用户名', userPlaceholder: '用户名',
passPlaceholder: '密码', passPlaceholder: '密码',
btn: '登录', btn: '登录',
@@ -556,6 +621,15 @@ export default {
providers: '供应商', providers: '供应商',
loadErr: '加载模型失败', loadErr: '加载模型失败',
capability: '能力', capability: '能力',
// 2026-11-19:OpenCode Go 的套餐额度与训练策略(数据来自官方 models 接口的 go 字段)
goQuota: 'Go 额度',
goQuotaHint: '只用这一个模型时,各套餐每月额度能覆盖多少用量(官方 models 接口的 go.monthly_usage)',
goQuotaValues: 'Go ${go}/月 · Go Plus ${plus}/月 · Go Teams ${teams}/月',
goQuotaFree: '免费',
goTrainingNo: '不训练',
goTrainingYes: '会训练',
goTrainingHint: '官方 go.training:该模型是否用你的请求内容做训练',
goZdrHint: '零数据保留:上游不保留请求内容',
visionTag: '视觉', visionTag: '视觉',
freeTag: '免费', freeTag: '免费',
freeHint: '官方免费模型:不按用量计费(额度以官方为准;Agnes 与 OpenCode Go 的免费档都会标出来)', freeHint: '官方免费模型:不按用量计费(额度以官方为准;Agnes 与 OpenCode Go 的免费档都会标出来)',
+1
View File
@@ -25,6 +25,7 @@ const router = createRouter({
{ path: 'keys', name: 'keys', component: () => import('./views/ApiKeys.vue') }, { path: 'keys', name: 'keys', component: () => import('./views/ApiKeys.vue') },
{ path: 'users', name: 'users', component: () => import('./views/Users.vue'), meta: { admin: true } }, { path: 'users', name: 'users', component: () => import('./views/Users.vue'), meta: { admin: true } },
{ path: 'feedback-inbox', name: 'feedbackinbox', component: () => import('./views/FeedbackInbox.vue'), meta: { admin: true } }, { path: 'feedback-inbox', name: 'feedbackinbox', component: () => import('./views/FeedbackInbox.vue'), meta: { admin: true } },
{ path: 'banned', name: 'banned', component: () => import('./views/Banned.vue'), meta: { admin: true } },
{ path: 'feedback', name: 'feedback', component: () => import('./views/Feedback.vue'), meta: { memberOnly: true } }, { path: 'feedback', name: 'feedback', component: () => import('./views/Feedback.vue'), meta: { memberOnly: true } },
{ path: 'gateway-config', name: 'gatewaycfg', component: () => import('./views/GatewayConfig.vue'), meta: { admin: true } }, { path: 'gateway-config', name: 'gatewaycfg', component: () => import('./views/GatewayConfig.vue'), meta: { admin: true } },
{ path: 'logs', name: 'logs', component: () => import('./views/Logs.vue') }, { path: 'logs', name: 'logs', component: () => import('./views/Logs.vue') },
+395
View File
@@ -0,0 +1,395 @@
<template>
<div class="page page-col">
<!-- ── 手动封禁 ─────────────────────────────────────────── -->
<div class="card">
<div class="card-h">
<Icon name="ban" :size="15" />
<b>{{ t('banned.manualTitle') }}</b>
<span class="sub">{{ t('banned.manualSub') }}</span>
</div>
<div class="ban-form">
<el-input
v-model="newIp" size="small" class="w-ip" clearable
:placeholder="t('banned.ipPlaceholder')" @keyup.enter="doBan"
/>
<el-select v-model="newDur" size="small" class="w-dur">
<el-option
v-for="o in DURATIONS" :key="o.k" :value="o.k"
:label="t(`banned.dur.${o.k}`)"
/>
</el-select>
<el-input
v-model="newNote" size="small" class="w-note" clearable
:placeholder="t('banned.notePlaceholder')" @keyup.enter="doBan"
/>
<el-button type="primary" size="small" :loading="banning" @click="doBan">
<Icon name="ban" :size="13" /><span>{{ t('banned.doBan') }}</span>
</el-button>
</div>
<div class="form-hint">
<Icon name="bell" :size="12" />
<span>{{ t('banned.manualHint') }}</span>
</div>
</div>
<!-- ── 封禁列表 ─────────────────────────────────────────── -->
<div class="card">
<div class="card-h">
<b>{{ t('banned.title') }}</b>
<span class="sub">{{ t('banned.count', { n: items.length }) }}</span>
<div class="pager">
<el-button size="small" :loading="loading" @click="reload">
<Icon name="refresh" :size="13" /><span>{{ t('common.refresh') }}</span>
</el-button>
<el-button size="small" type="danger" plain :disabled="!items.length" @click="clearAll">
<Icon name="trash" :size="13" /><span>{{ t('banned.clearAll') }}</span>
</el-button>
</div>
</div>
<div class="warn-bar">
<Icon name="ban" :size="14" />
<span>{{ t('banned.rule', { n: limit, mins: banMinutes }) }}</span>
</div>
<div v-if="items.length" class="ban-list">
<div v-for="b in items" :key="b.ip" class="ban-row">
<span class="dot" :class="{ perm: b.permanent }" />
<div class="ban-main">
<div class="ban-top">
<b class="code ban-ip">{{ b.ip }}</b>
<el-tag v-if="b.permanent" size="small" type="danger" effect="plain">
{{ t('banned.permanentTag') }}
</el-tag>
<el-tag v-if="b.note" size="small" type="warning" effect="plain">
{{ b.note }}
</el-tag>
</div>
<div class="ban-meta">
<template v-if="b.permanent">
<span>{{ t('banned.neverExpire') }}</span>
</template>
<template v-else>
<span>{{ t('banned.remaining', { mins: b.remaining_minutes }) }}</span>
<span class="sep">·</span>
<span>{{ t('banned.until') }} {{ fmtTs(b.banned_until) }}</span>
</template>
</div>
</div>
<div class="ban-acts">
<el-dropdown trigger="click" :disabled="b.permanent" @command="(k: string) => extend(b.ip, k)">
<el-button size="small" :disabled="b.permanent">
<Icon name="plus" :size="13" /><span>{{ t('banned.extend') }}</span>
</el-button>
<template #dropdown>
<el-dropdown-menu>
<el-dropdown-item v-for="o in DURATIONS" :key="o.k" :command="o.k">
+{{ t(`banned.dur.${o.k}`) }}
</el-dropdown-item>
<el-dropdown-item command="forever" divided>
{{ t('banned.toPermanent') }}
</el-dropdown-item>
</el-dropdown-menu>
</template>
</el-dropdown>
<el-button size="small" @click="unban(b.ip)">
<Icon name="check" :size="13" /><span>{{ t('banned.unban') }}</span>
</el-button>
</div>
</div>
</div>
<el-empty v-else :description="t('banned.empty')" :image-size="72" />
</div>
<!-- ── 封禁历史 ─────────────────────────────────────────── -->
<div class="card">
<div class="card-h">
<Icon name="log" :size="15" />
<b>{{ t('banned.historyTitle') }}</b>
<span class="sub">{{ t('banned.historySub') }}</span>
<div class="pager">
<el-select v-model="hisLimit" size="small" class="w-his" @change="loadHistory">
<el-option :value="20" label="20" />
<el-option :value="50" label="50" />
<el-option :value="100" label="100" />
</el-select>
<el-button size="small" :loading="hisLoading" @click="loadHistory">
<Icon name="refresh" :size="13" /><span>{{ t('common.refresh') }}</span>
</el-button>
<el-button size="small" type="danger" plain :disabled="!history.length" @click="clearHistory">
<Icon name="trash" :size="13" /><span>{{ t('banned.hisClearAll') }}</span>
</el-button>
</div>
</div>
<el-table v-if="history.length" :data="history" size="small" class="his-table">
<el-table-column :label="t('banned.hisTime')" width="150">
<template #default="{ row }">{{ fmtTs(row.ts) }}</template>
</el-table-column>
<el-table-column :label="t('banned.hisAction')" width="110">
<template #default="{ row }">
<el-tag :type="ACTION_TAG[row.action] || 'info'" size="small" effect="plain">
{{ t(`banned.act.${row.action}`) }}
</el-tag>
</template>
</el-table-column>
<el-table-column :label="t('banned.hisIp')" min-width="140">
<template #default="{ row }"><span class="code">{{ row.ip }}</span></template>
</el-table-column>
<el-table-column :label="t('banned.hisDuration')" width="110">
<template #default="{ row }">
{{ row.permanent ? t('banned.permanentTag') : (row.seconds ? fmtDur(row.seconds) : '—') }}
</template>
</el-table-column>
<el-table-column :label="t('banned.hisActor')" width="110">
<template #default="{ row }">{{ row.actor || '—' }}</template>
</el-table-column>
<el-table-column :label="t('banned.hisNote')" min-width="140">
<template #default="{ row }"><span class="muted-2">{{ row.note || '—' }}</span></template>
</el-table-column>
<el-table-column :label="t('banned.hisOps')" width="76" align="center">
<template #default="{ row }">
<el-button size="small" type="danger" text :title="t('common.delete')" @click="delHistory(row)">
<Icon name="trash" :size="13" />
</el-button>
</template>
</el-table-column>
</el-table>
<el-empty v-else :description="t('banned.historyEmpty')" :image-size="60" />
</div>
</div>
</template>
<script setup lang="ts">
import { computed, onMounted, onUnmounted, ref } from 'vue'
import { useI18n } from 'vue-i18n'
import { ElMessage, ElMessageBox } from 'element-plus'
import { api, errText } from '../api'
import Icon from '../components/Icon.vue'
const { t } = useI18n()
const items = ref<any[]>([])
const history = ref<any[]>([])
const loading = ref(false)
const banning = ref(false)
const hisLoading = ref(false)
const hisLimit = ref(50)
const limit = ref(60)
const banSeconds = ref(3600)
let timer: any = null
const newIp = ref('')
const newDur = ref('h1')
const newNote = ref('')
const banMinutes = computed(() => Math.max(1, Math.round(banSeconds.value / 60)))
/** 时长预设。forever 走 permanent 字段,其余按秒传。 */
const DURATIONS = [
{ k: 'm10', v: 600 },
{ k: 'm30', v: 1800 },
{ k: 'h1', v: 3600 },
{ k: 'h6', v: 21600 },
{ k: 'd1', v: 86400 },
{ k: 'd30', v: 2592000 },
{ k: 'forever', v: 0 },
] as { k: string; v: number }[]
const ACTION_TAG: Record<string, string> = {
manual_ban: 'warning',
auto_ban: 'info',
extend: 'primary',
unban: 'success',
unban_all: 'danger',
}
function fmtTs(ts: number): string {
if (!ts) return '—'
const d = new Date(ts * 1000)
const p = (n: number) => String(n).padStart(2, '0')
return `${d.getFullYear()}-${p(d.getMonth() + 1)}-${p(d.getDate())} ${p(d.getHours())}:${p(d.getMinutes())}`
}
function fmtDur(sec: number): string {
if (sec >= 86400 && sec % 86400 === 0) return t('banned.unitDay', { n: sec / 86400 })
if (sec >= 3600) return t('banned.unitHour', { n: Math.round(sec / 3600) })
return t('banned.unitMin', { n: Math.round(sec / 60) })
}
function durPayload(k: string): any {
if (k === 'forever') return { permanent: true }
const d = DURATIONS.find((x) => x.k === k)
return { seconds: d ? d.v : 3600 }
}
async function reload() {
loading.value = true
try {
const j = await api('/admin/banned')
items.value = j.items || []
if (typeof j.auth_fail_limit_per_min === 'number') limit.value = j.auth_fail_limit_per_min
if (typeof j.ban_seconds === 'number' && j.ban_seconds > 0) banSeconds.value = j.ban_seconds
} catch (e: any) {
ElMessage.error(errText(e))
} finally {
loading.value = false
}
}
async function loadHistory() {
hisLoading.value = true
try {
const j = await api(`/admin/banned/history?limit=${hisLimit.value}`)
history.value = j.items || []
} catch (e: any) {
ElMessage.error(errText(e))
} finally {
hisLoading.value = false
}
}
async function doBan() {
const ip = newIp.value.trim()
if (!ip) { ElMessage.warning(t('banned.ipRequired')); return }
banning.value = true
try {
const j = await api('/admin/banned', {
method: 'POST',
body: JSON.stringify({ ip, note: newNote.value.trim(), ...durPayload(newDur.value) }),
})
ElMessage.success(
j.permanent
? t('banned.bannedForever', { ip: j.ip })
: t('banned.banned', { ip: j.ip, mins: Math.round(j.banned_seconds / 60) }),
)
newIp.value = ''
newNote.value = ''
await Promise.all([reload(), loadHistory()])
} catch (e: any) {
ElMessage.error(errText(e))
} finally {
banning.value = false
}
}
async function extend(ip: string, k: string) {
try {
const j = await api(`/admin/banned/${encodeURIComponent(ip)}`, {
method: 'PUT',
body: JSON.stringify(durPayload(k)),
})
ElMessage.success(
j.permanent ? t('banned.extendedForever', { ip }) : t('banned.extended', { ip, mins: Math.round(j.extended_seconds / 60) }),
)
await Promise.all([reload(), loadHistory()])
} catch (e: any) {
ElMessage.error(errText(e))
}
}
async function unban(ip: string) {
try {
await api(`/admin/banned/${encodeURIComponent(ip)}`, { method: 'DELETE' })
ElMessage.success(t('banned.unbanned', { ip }))
await Promise.all([reload(), loadHistory()])
} catch (e: any) {
ElMessage.error(errText(e))
}
}
async function delHistory(row: any) {
try {
await api(`/admin/banned/history/${encodeURIComponent(row.id)}`, { method: 'DELETE' })
ElMessage.success(t('banned.hisDeleted'))
await loadHistory()
} catch (e: any) {
ElMessage.error(errText(e))
}
}
async function clearHistory() {
try {
await ElMessageBox.confirm(t('banned.hisClearConfirm'), t('banned.hisClearAll'), { type: 'warning' })
} catch { return }
try {
const j = await api('/admin/banned/history', { method: 'DELETE' })
ElMessage.success(t('banned.hisCleared', { n: j.cleared ?? 0 }))
await loadHistory()
} catch (e: any) {
ElMessage.error(errText(e))
}
}
async function clearAll() {
try {
await ElMessageBox.confirm(t('banned.clearConfirm'), t('banned.clearTitle'), { type: 'warning' })
} catch { return }
try {
const j = await api('/admin/banned', { method: 'DELETE' })
ElMessage.success(t('banned.cleared', { n: j.cleared ?? 0 }))
await Promise.all([reload(), loadHistory()])
} catch (e: any) {
ElMessage.error(errText(e))
}
}
onMounted(() => {
reload()
loadHistory()
timer = setInterval(reload, 10000)
})
onUnmounted(() => { if (timer) clearInterval(timer) })
</script>
<style scoped>
/* 手动封禁表单:一行放下,窄屏自动换行 */
.ban-form { display: flex; align-items: center; gap: var(--gap-sm); flex-wrap: wrap; }
.w-ip { width: 220px; }
.w-dur { width: 130px; }
.w-note { width: 200px; }
.w-his { width: 84px; }
.form-hint {
display: flex; align-items: center; gap: 6px;
margin-top: var(--gap-sm); font-size: 11.5px; line-height: 1.6; color: var(--muted-2);
}
.form-hint .gw-icon { flex: none; }
/* 规则提示条 —— 与 ApiKeys 的 warn-bar 同一套观感(那边是 scoped,这里要自带) */
.warn-bar {
display: flex; align-items: center; gap: 8px;
background: var(--warn-soft); color: var(--warn);
border-radius: var(--radius-s); padding: 9px 12px;
font-size: 12px; line-height: 1.6; margin-bottom: var(--gap-sm);
}
.warn-bar .gw-icon { flex: none; }
.ban-list { display: flex; flex-direction: column; }
.ban-row {
display: flex; align-items: center; gap: var(--gap-sm);
padding: 11px 2px; border-bottom: 1px solid var(--line);
}
.ban-row:last-child { border-bottom: none; }
.ban-row .dot {
flex: none; width: 7px; height: 7px; border-radius: 50%;
background: var(--warn);
}
.ban-row .dot.perm { background: var(--err, #e5484d); }
.ban-main { flex: 1; min-width: 0; }
.ban-top { display: flex; align-items: center; gap: 8px; flex-wrap: wrap; }
.ban-ip { font-size: 13px; font-weight: 600; }
.ban-meta {
margin-top: 3px; font-size: 11.5px; color: var(--muted-2);
display: flex; align-items: center; gap: 6px; flex-wrap: wrap;
}
.ban-meta .sep { color: var(--line); }
.ban-acts { display: flex; align-items: center; gap: 6px; flex: none; }
.his-table { width: 100%; }
@media (max-width: 640px) {
.w-ip, .w-note, .w-dur { width: 100%; }
.ban-form :deep(.el-button) { width: 100%; }
.ban-row { flex-wrap: wrap; }
.ban-acts { width: 100%; justify-content: flex-end; }
}
</style>
+1 -1
View File
@@ -152,7 +152,7 @@ async function saveYaml() {
function backupCfg() { function backupCfg() {
const envs: Record<string, string> = {} const envs: Record<string, string> = {}
for (const e of envKeys.value) envs[e.env] = e.value for (const e of envKeys.value) envs[e.env] = e.value
const data = { kind: 'api-gateway-backup', version: 1, config: yamlText.value, envs } const data = { kind: 'xiaoyin-gateway-backup', version: 1, config: yamlText.value, envs }
const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' }) const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' })
const a = document.createElement('a') const a = document.createElement('a')
a.href = URL.createObjectURL(blob) a.href = URL.createObjectURL(blob)
+2 -2
View File
@@ -144,7 +144,7 @@
import { computed, onMounted, onUnmounted, ref, watch } from 'vue' import { computed, onMounted, onUnmounted, ref, watch } from 'vue'
import { useRouter } from 'vue-router' import { useRouter } from 'vue-router'
import { useI18n } from 'vue-i18n' import { useI18n } from 'vue-i18n'
import { api } from '../api' import { api, errText } from '../api'
import Icon from '../components/Icon.vue' import Icon from '../components/Icon.vue'
import { stamp } from '../lib/download' import { stamp } from '../lib/download'
import { useSessionStore } from '../store/session' import { useSessionStore } from '../store/session'
@@ -209,7 +209,7 @@ async function loadFull(row: any) {
row.respLen = d.completion_len || 0 row.respLen = d.completion_len || 0
row.full = true row.full = true
} catch (e: any) { } catch (e: any) {
row.fullErr = err(e) row.fullErr = errText(e)
} finally { } finally {
row.fullLoading = false row.fullLoading = false
} }
+69 -1
View File
@@ -134,6 +134,26 @@
<span v-if="!row.vision && !paramKeys(row).length" class="muted-2">—</span> <span v-if="!row.vision && !paramKeys(row).length" class="muted-2">—</span>
</template> </template>
</el-table-column> </el-table-column>
<!-- 2026-11-19(老板要求):OpenCode Go 的套餐额度与训练策略。
额度 = 「只用这一个模型时,该套餐每月能覆盖多少用量」(官方 go.monthly_usage,美元);
训练 = 官方 go.training(false = 不拿你的请求训练)。
只有 OpenCode Go 的模型带这个字段,其余供应商显示「—」。 -->
<el-table-column width="150">
<template #header>
<el-tooltip :content="t('models.goQuotaHint')" placement="top">
<span class="proto-th">{{ t('models.goQuota') }}</span>
</el-tooltip>
</template>
<template #default="{ row }">
<template v-if="row.goMeta">
<span class="pill go-quota cap" :title="goQuotaHint(row)">{{ goQuotaText(row) }}</span>
<span class="pill cap" :class="goTrains(row) ? 'err' : 'ok'" :title="t('models.goTrainingHint')">
{{ goTrains(row) ? t('models.goTrainingYes') : t('models.goTrainingNo') }}
</span>
</template>
<span v-else class="muted-2">—</span>
</template>
</el-table-column>
<el-table-column :label="t('models.keySet')" width="90"> <el-table-column :label="t('models.keySet')" width="90">
<template #default="{ row }"> <template #default="{ row }">
<span class="pill" :class="row.key_set ? 'ok' : 'err'"> <span class="pill" :class="row.key_set ? 'ok' : 'err'">
@@ -431,6 +451,10 @@ const textModelRows = computed(() =>
paramNote: paramKeys(m).length ? paramNote(m) : '', paramNote: paramKeys(m).length ? paramNote(m) : '',
// 支持的格式(第二十七轮):悬浮这一行就能看到「能用哪几条线 + 本次测速走的哪条」 // 支持的格式(第二十七轮):悬浮这一行就能看到「能用哪几条线 + 本次测速走的哪条」
formats: protocolsOf(m), formats: protocolsOf(m),
// 2026-11-19(老板要求):OpenCode Go 的套餐额度(每月能调多少)与训练策略。
// 后端 /v1/models 的 go 字段(app/gomodels.py 从官方 models 接口拉取,缓存 6 小时);
// 非 OpenCode 供应商没有这个字段 → 该列显示「—」。
goMeta: m.go || null,
})), })),
) )
@@ -454,6 +478,43 @@ function freeHint(m: any): string {
return m && m.free_limited ? t('models.freeLimitedHint') : t('models.freeHint') return m && m.free_limited ? t('models.freeLimitedHint') : t('models.freeHint')
} }
// ── OpenCode Go 套餐额度 / 训练策略(2026-11-19 老板要求)──
// 数据来自后端 /v1/models 的 go 字段(app/gomodels.py ← 官方 models 接口 go.monthly_usage)。
// 官方口径:monthly_usage 是「只用这一个模型时,各套餐每月额度能覆盖多少用量」(美元)。
// 单元格里只显示默认档(Go),三档明细与零保留说明放悬浮提示。
const GO_PLAN_KEYS = ['go', 'go-plus', 'go-teams'] as const
function goUsageOf(m: any): Record<string, number> {
return (m && m.goMeta && m.goMeta.monthly_usage) || {}
}
function goQuotaText(m: any): string {
const u = goUsageOf(m)
if (u.go) return `$${u.go}`
if (m && m.free) return t('models.goQuotaFree')
return '—'
}
function goQuotaHint(m: any): string {
const u = goUsageOf(m)
const parts: string[] = []
if (GO_PLAN_KEYS.some((k) => u[k])) {
parts.push(t('models.goQuotaValues', {
go: u.go ?? '—',
plus: u['go-plus'] ?? '—',
teams: u['go-teams'] ?? '—',
}))
} else {
parts.push(t('models.goQuotaHint'))
}
if (m && m.goMeta && m.goMeta.zdr) parts.push(t('models.goZdrHint'))
return parts.join(' · ')
}
function goTrains(m: any): boolean {
return !!(m && m.goMeta && m.goMeta.training)
}
// ── 模型级强制参数(第二十五轮)── // ── 模型级强制参数(第二十五轮)──
// 后端 /v1/models 在 params 里给出「该模型发往上游前会被强制覆盖的参数」 // 后端 /v1/models 在 params 里给出「该模型发往上游前会被强制覆盖的参数」
// (例:kimi-k2.7-code 只接受 temperature=1)。这里只做展示,不提供编辑入口。 // (例:kimi-k2.7-code 只接受 temperature=1)。这里只做展示,不提供编辑入口。
@@ -471,7 +532,12 @@ const keySet = computed(() => {
for (const p of Object.values(health.value.providers || {}) as any) ks[p.name] = !!p.api_key_set for (const p of Object.values(health.value.providers || {}) as any) ks[p.name] = !!p.api_key_set
return ks return ks
}) })
const modelRows = computed(() => models.value.map((m) => ({ ...m, key_set: keySet.value[m.provider_name] }))) // 主表格的行数据(表格绑的就是 modelRows:`{...m}` 展开原始模型,保留全部接口字段)。
// 2026-11-19:OpenCode Go 的套餐额度/训练列读 row.goMeta —— 必须在这里挂上,
// 只挂在 textModelRows(另一个只用来数数量/测速的数组)上表格是看不到的。
const modelRows = computed(() =>
models.value.map((m) => ({ ...m, key_set: keySet.value[m.provider_name], goMeta: m.go || null })),
)
const providerRows = computed(() => { const providerRows = computed(() => {
const p = health.value.providers || {} const p = health.value.providers || {}
@@ -597,6 +663,8 @@ onUnmounted(() => {
.plock { color: var(--warn); } .plock { color: var(--warn); }
/* 免费模型:绿色系,跟「视觉」(主题色) / 「参数固定」(橙) 区分开;跟在模型名后面 */ /* 免费模型:绿色系,跟「视觉」(主题色) / 「参数固定」(橙) 区分开;跟在模型名后面 */
.pill.free { background: rgba(16, 185, 129, 0.14); color: #059669; } .pill.free { background: rgba(16, 185, 129, 0.14); color: #059669; }
/* OpenCode Go 的套餐额度(2026-11-19):中性蓝,与免费(绿)/ 参数固定(橙)区分 */
.pill.go-quota { background: rgba(59, 130, 246, 0.12); color: #2563eb; }
/* 免费标注的间距(2026-09-24 老板:间隔不一样)—— /* 免费标注的间距(2026-09-24 老板:间隔不一样)——
表格单元格里是行内排布、没有 flex gap,靠这个 margin 与模型名分开; 表格单元格里是行内排布、没有 flex gap,靠这个 margin 与模型名分开;
测速行是 flex(.st-row gap: 8px),必须把 margin 归零:否则标签左侧 8+6=14px、 测速行是 flex(.st-row gap: 8px),必须把 margin 归零:否则标签左侧 8+6=14px、
+1 -1
View File
@@ -1,3 +1,3 @@
# 开发/测试依赖(生产不需要) # 开发/测试依赖(生产不需要)
-r requirements.txt -r requirements.txt
pytest>=8.0 # tests/ 有 225 个用例:/root/.venvs/api-gateway/bin/python -m pytest tests/ -q pytest>=8.0 # tests/ 有 225 个用例:/root/.venvs/xiaoyin-gateway/bin/python -m pytest tests/ -q
+1 -1
View File
@@ -20,7 +20,7 @@ if __name__ == "__main__":
import uvicorn import uvicorn
gs = int(os.environ.get("GATEWAY_GRACEFUL_SHUTDOWN", config.server.graceful_shutdown)) gs = int(os.environ.get("GATEWAY_GRACEFUL_SHUTDOWN", config.server.graceful_shutdown))
print(f"[api-gateway] config={CONFIG_PATH} host={host} port={port} graceful_shutdown={gs}s") print(f"[xiaoyin-gateway] config={CONFIG_PATH} host={host} port={port} graceful_shutdown={gs}s")
# 直接传入 app 对象(而非 import string),避免 uvicorn 二次导入 app.main 而再算一次配置。 # 直接传入 app 对象(而非 import string),避免 uvicorn 二次导入 app.main 而再算一次配置。
uvicorn.run( uvicorn.run(
app, app,
+1 -1
View File
@@ -34,7 +34,7 @@ run() { # run <说明> <命令...>
fi fi
} }
echo "api-gateway CI 门禁($(date '+%F %T'))" echo "xiaoyin-gateway CI 门禁($(date '+%F %T'))"
# 1) 后端语法编译(覆盖整个 app 包 + run.py;不再维护手写文件清单) # 1) 后端语法编译(覆盖整个 app 包 + run.py;不再维护手写文件清单)
run "后端语法编译" "$PY" -m compileall -q app run.py run "后端语法编译" "$PY" -m compileall -q app run.py
+3 -3
View File
@@ -23,7 +23,7 @@
# **绝不写进本仓库任何文件**(仓库是要推到远端的)。 # **绝不写进本仓库任何文件**(仓库是要推到远端的)。
set -euo pipefail set -euo pipefail
REPO_URL="https://git.wangjinding.com/Jidekin/api-gateway.git" REPO_URL="https://git.wangjinding.com/Jidekin/xiaoyin-gateway.git"
USER="Jidekin" USER="Jidekin"
TOKEN_FILE="${HOME}/.gitea_token" TOKEN_FILE="${HOME}/.gitea_token"
@@ -50,11 +50,11 @@ echo "== 推送 $BRANCH → Gitea($REPO_URL)=="
echo " 本地 HEAD = $(git rev-parse --short HEAD)" echo " 本地 HEAD = $(git rev-parse --short HEAD)"
# 一次性内嵌凭据;输出里把凭据打码,避免它进日志/终端回滚缓冲 # 一次性内嵌凭据;输出里把凭据打码,避免它进日志/终端回滚缓冲
git push "https://${USER}:${CRED}@git.wangjinding.com/Jidekin/api-gateway.git" "${BRANCH}:${BRANCH}" 2>&1 \ git push "https://${USER}:${CRED}@git.wangjinding.com/Jidekin/xiaoyin-gateway.git" "${BRANCH}:${BRANCH}" 2>&1 \
| sed "s/${CRED}/[CRED]/g" | sed "s/${CRED}/[CRED]/g"
# 推完核对:远端 HEAD 必须 = 本地 HEAD;并复查 .git/config 没被塞进明文凭据 # 推完核对:远端 HEAD 必须 = 本地 HEAD;并复查 .git/config 没被塞进明文凭据
REMOTE_HEAD="$(git ls-remote "https://${USER}:${CRED}@git.wangjinding.com/Jidekin/api-gateway.git" "refs/heads/${BRANCH}" | awk '{print $1}')" REMOTE_HEAD="$(git ls-remote "https://${USER}:${CRED}@git.wangjinding.com/Jidekin/xiaoyin-gateway.git" "refs/heads/${BRANCH}" | awk '{print $1}')"
LOCAL_HEAD="$(git rev-parse HEAD)" LOCAL_HEAD="$(git rev-parse HEAD)"
if [ "$REMOTE_HEAD" = "$LOCAL_HEAD" ]; then if [ "$REMOTE_HEAD" = "$LOCAL_HEAD" ]; then
echo "✓ 远端 = 本地(${LOCAL_HEAD:0:7})" echo "✓ 远端 = 本地(${LOCAL_HEAD:0:7})"
+100 -3
View File
@@ -46,7 +46,7 @@ import yaml
ROOT = Path(__file__).resolve().parent.parent ROOT = Path(__file__).resolve().parent.parent
DEFAULT_CFG = ROOT / "data" / "gateway.yaml" DEFAULT_CFG = ROOT / "data" / "gateway.yaml"
UA = "api-gateway-model-sync/1.0 (+ops; contact admin)" UA = "xiaoyin-gateway-model-sync/1.0 (+ops; contact admin)"
OC_DOC_URL = "https://opencode.ai/v2/docs/console/go/" OC_DOC_URL = "https://opencode.ai/v2/docs/console/go/"
AGNES_PRICING_URL = "https://www.agnes-ai.cn/zh-Hans/docs/pricing.md" AGNES_PRICING_URL = "https://www.agnes-ai.cn/zh-Hans/docs/pricing.md"
@@ -114,6 +114,99 @@ OC_REGION_BLOCKED = {
} }
OC_REGION_SKIPPED: list[str] = [] OC_REGION_SKIPPED: list[str] = []
# ── 2026-11-19 文档二次改版:Endpoints 表不再逐条列 URL ──────────────
# 官方把 `## Endpoints` 改成了「去看 console 页 / 用 models 接口」,HTML 里
# 已经没有 `opencode.ai/` 的模型行 → 连续两天 exit=2「没解析出 Endpoints 表」。
# 现在官方 models 接口直接给出机器可读的元数据(**无需鉴权**,实测不带 token 也 200):
# GET https://opencode.ai/inference/go/v1/models (zen/go/v1/models 同源同内容)
# 每条模型带:
# id / name / type
# api: {chat-completions|responses|messages|generate-content: {base_url, sdk}}
# recommended_api: 官方推荐线
# limit: {context, output}
# cost.text.input.price / cost.text.output.price (都为 0 → 免费)
# go.limited_regions: true → 对部分地区不开放(实测正是这三个 contributor / beam-free)
# 口径:**以 models 接口为准**,HTML 表解析只作兜底;接口也挂了才报错。
OC_MODELS_API = "https://opencode.ai/inference/go/v1/models"
OC_MODELS_API_FALLBACK = "https://opencode.ai/zen/go/v1/models"
# models 接口的 api 键 → 网关协议线(网关只支持这三条线)
OC_API_TO_PROTO = {
"chat-completions": "chat/completions",
"responses": "responses",
"messages": "messages",
}
def _oc_protocol_from_api(model: dict) -> tuple[str | None, list[str]]:
"""从 models 接口的 api / recommended_api 选网关协议线。
返回 (协议线, 文档声明的全部 api 键);认不出(例如只有 generate-content)返回 (None, keys)。
"""
keys = list((model.get("api") or {}).keys())
supported = [OC_API_TO_PROTO[k] for k in keys if k in OC_API_TO_PROTO]
if not supported:
return None, keys
rec = model.get("recommended_api")
if rec in OC_API_TO_PROTO and OC_API_TO_PROTO[rec] in supported:
return OC_API_TO_PROTO[rec], keys
for proto in OC_PROTOCOLS: # 没有推荐或推荐不支持 → chat/completions 优先
if proto in supported:
return proto, keys
return supported[0], keys
def _oc_is_free(model: dict) -> bool:
"""cost.text 的 input / output 单价都为 0 → 免费。"""
price = (model.get("cost") or {}).get("text") or {}
return ((price.get("input") or {}).get("price") == 0
and (price.get("output") or {}).get("price") == 0)
def fetch_opencode() -> dict[str, dict]:
"""返回 {model_id: {name, protocol, free}}。
优先走官方 models 接口(稳定、机器可读);接口不可用时回退到旧的 HTML 表解析。
"""
payload = None
err: Exception | None = None
for url in (OC_MODELS_API, OC_MODELS_API_FALLBACK):
try:
payload = json.loads(_get(url, timeout=60))
if isinstance(payload, dict) and payload.get("data"):
break
payload = None
except Exception as exc: # noqa: BLE001
err = exc
if not payload:
print(f"[warn] OpenCode models 接口不可用({err}),回退 HTML 解析", file=sys.stderr)
return _fetch_opencode_html()
models: dict[str, dict] = {}
skipped: list[str] = []
region_skipped: list[str] = []
for m in payload["data"]:
mid = m.get("id")
if not mid or (m.get("type") or "chat") != "chat":
continue
if (m.get("go") or {}).get("limited_regions") or mid in OC_REGION_BLOCKED:
region_skipped.append(mid)
continue
proto, keys = _oc_protocol_from_api(m)
if proto is None:
skipped.append(f"{mid}({'/'.join(keys) or '无 api 字段'})")
continue
models[mid] = {"name": m.get("name") or mid,
"protocol": proto,
"free": _oc_is_free(m)}
if not models:
raise RuntimeError("OpenCode models 接口返回 0 个可用模型(接口可能改版)")
OC_SKIPPED[:] = sorted(skipped)
OC_REGION_SKIPPED[:] = sorted(region_skipped)
return models
def _oc_protocol(url: str) -> str | None: def _oc_protocol(url: str) -> str | None:
"""文档 Endpoint → 网关协议线;认不出返回 None。""" """文档 Endpoint → 网关协议线;认不出返回 None。"""
@@ -124,8 +217,12 @@ def _oc_protocol(url: str) -> str | None:
return None return None
def fetch_opencode() -> dict[str, dict]: def _fetch_opencode_html() -> dict[str, dict]:
"""返回 {model_id: {name, protocol, free}}。""" """【兜底】旧版 HTML 表解析。
2026-11-19 起官方 `## Endpoints` 表已不再逐条列 URL(内容搬到 console 页 +
models 接口),这里正常不会走到;保留只为页面万一改回去时还能用。
"""
html = _get(OC_DOC_URL) html = _get(OC_DOC_URL)
models: dict[str, dict] = {} models: dict[str, dict] = {}
skipped: list[str] = [] skipped: list[str] = []
+1 -1
View File
@@ -43,7 +43,7 @@ DEFAULT_ENV = ROOT / "data" / ".env"
PROVIDER = "onemin" PROVIDER = "onemin"
BASE_URL = "https://api.1min.ai/openai/v1" BASE_URL = "https://api.1min.ai/openai/v1"
UA = "api-gateway-onemin-sync/1.0 (+ops; contact admin)" UA = "xiaoyin-gateway-onemin-sync/1.0 (+ops; contact admin)"
# ── 工具 ──────────────────────────────────────────────────────────── # ── 工具 ────────────────────────────────────────────────────────────
BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 2.0 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 124 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 115 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 113 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 110 KiB

+535
View File
@@ -0,0 +1,535 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>小银网关 — 一个网关,接住所有模型</title>
<meta name="description" content="小银网关:把多家大模型供应商收进一个 OpenAI 兼容接口。三条协议线原样直传,熔断、限流、成本统计、管理台齐全。纯本地部署,MIT 开源。">
<meta name="theme-color" content="#ffffff">
<link rel="icon" href="/favicon.png">
<style>
:root{
--blue:#3a7bfc; --blue-d:#0b66dd; --blue-l:#7ba7ff; --blue-bg:#eef4ff;
--ink:#2f2f30; --ink-2:#4c4c4c; --ink-3:#8a8a8f;
--gray:#f8f8f8; --gray-2:#f2f2f7; --line:#e8e8ee;
--dark:#242424; --yellow:#ffb200;
--max:1180px; --r:16px;
--shadow:0 10px 40px -12px rgba(20,30,60,.18);
--shadow-lg:0 24px 70px -25px rgba(20,30,60,.35);
}
*{box-sizing:border-box;margin:0;padding:0}
html{scroll-behavior:smooth}
body{
font:16px/1.7 -apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif;
color:var(--ink);background:#fff;-webkit-font-smoothing:antialiased;overflow-x:hidden;
}
a{color:inherit;text-decoration:none}
.wrap{max-width:var(--max);margin:0 auto;padding:0 24px}
/* ───────── 顶部导航 ───────── */
header{
position:sticky;top:0;z-index:50;background:rgba(255,255,255,.86);
backdrop-filter:blur(14px);border-bottom:1px solid transparent;transition:.25s;
}
header.on{border-bottom-color:var(--line);box-shadow:0 2px 20px -12px rgba(0,0,0,.25)}
.nav{display:flex;align-items:center;gap:34px;height:66px}
.brand{display:flex;align-items:center;gap:10px;font-weight:800;font-size:17px;letter-spacing:.2px}
.brand img{width:30px;height:30px;border-radius:8px}
.nav-links{display:flex;gap:30px;margin-left:14px;font-size:15px;color:var(--ink-2)}
.nav-links a{position:relative;padding:4px 0}
.nav-links a:hover{color:var(--blue)}
.nav-cta{margin-left:auto;display:flex;align-items:center;gap:14px}
.nav-cta .ghost{font-size:15px;color:var(--ink-2)}
.nav-cta .ghost:hover{color:var(--blue)}
@media(max-width:820px){.nav-links{display:none}}
.btn{
display:inline-flex;align-items:center;justify-content:center;gap:8px;
border:0;cursor:pointer;font:inherit;font-weight:600;border-radius:999px;
transition:transform .16s ease,box-shadow .16s ease,background .16s ease;
}
.btn:hover{transform:translateY(-2px)}
.btn-blue{
background:linear-gradient(96deg,var(--blue),var(--blue-d));color:#fff;
padding:13px 30px;font-size:16px;box-shadow:0 10px 26px -10px rgba(58,123,252,.75);
}
.btn-sm{padding:9px 22px;font-size:14.5px}
.btn-line{background:#fff;color:var(--ink);border:1px solid var(--line);padding:13px 26px;font-size:16px}
.btn-line:hover{border-color:var(--blue-l);color:var(--blue)}
.btn-dark{background:#fff;color:var(--dark);padding:13px 30px;font-size:16px}
/* ───────── HERO ───────── */
.kv{position:relative;background:var(--gray);padding:76px 0 0;overflow:hidden}
.kv::before,.kv::after{
content:"";position:absolute;border-radius:50%;filter:blur(70px);opacity:.55;pointer-events:none;
}
.kv::before{width:520px;height:520px;left:-160px;top:-140px;background:radial-gradient(circle,#c9dcff,transparent 68%)}
.kv::after{width:560px;height:560px;right:-180px;top:-60px;background:radial-gradient(circle,#dbe8ff,transparent 70%)}
.kv-in{position:relative;text-align:center;z-index:1}
.kv-tag{
display:inline-flex;align-items:center;gap:9px;background:#fff;border:1px solid var(--line);
color:var(--ink-2);font-size:13.5px;padding:7px 16px;border-radius:999px;margin-bottom:26px;
box-shadow:0 4px 16px -8px rgba(20,30,60,.2);
}
.kv-tag b{color:var(--blue);font-weight:700}
.dot{width:7px;height:7px;border-radius:50%;background:#22c55e;box-shadow:0 0 0 3px rgba(34,197,94,.18)}
h1{
font-size:clamp(38px,5.6vw,68px);line-height:1.1;font-weight:800;letter-spacing:-1.5px;color:var(--ink);
}
h1 em{
font-style:normal;
background:linear-gradient(96deg,var(--blue),var(--blue-d));
-webkit-background-clip:text;background-clip:text;color:transparent;
}
.nw{white-space:nowrap}
.kv-sub{
margin:24px auto 0;max-width:720px;font-size:clamp(15px,1.7vw,19px);color:var(--ink-2);line-height:1.75;
}
.kv-meta{margin-top:20px;font-size:14.5px;color:var(--ink-3);display:flex;gap:0;justify-content:center;flex-wrap:wrap}
.kv-meta i{font-style:normal;padding:0 14px;border-right:1px solid var(--line)}
.kv-meta i:last-child{border:0}
.kv-cta{margin-top:34px;display:flex;gap:14px;justify-content:center;flex-wrap:wrap}
.kv-plat{margin-top:16px;font-size:13.5px;color:var(--ink-3)}
.badges{
margin:44px auto 0;display:flex;justify-content:center;gap:14px;flex-wrap:wrap;
max-width:900px;
}
.badge{
display:flex;align-items:center;gap:8px;background:#fff;border:1px solid var(--line);
border-radius:999px;padding:9px 18px;font-size:14px;color:var(--ink-2);font-weight:500;
box-shadow:0 6px 20px -14px rgba(20,30,60,.4);
}
.badge b{color:var(--ink);font-weight:700}
.badge .tick{color:var(--blue);font-weight:800}
/* 应用外观 */
.shot{
position:relative;max-width:960px;margin:56px auto 0;
border-radius:18px 18px 0 0;background:#fff;border:1px solid var(--line);border-bottom:0;
box-shadow:var(--shadow-lg);overflow:hidden;text-align:left;
}
.shot-bar{display:flex;align-items:center;gap:8px;padding:13px 16px;border-bottom:1px solid var(--line);background:#fbfbfd}
.shot-bar i{width:11px;height:11px;border-radius:50%}
.shot-bar i:nth-child(1){background:#ff5f57}.shot-bar i:nth-child(2){background:#febc2e}.shot-bar i:nth-child(3){background:#28c840}
.shot-bar span{margin-left:12px;font-size:12.5px;color:var(--ink-3)}
/* 真实截图 */
.shot img,.dark-shot img{display:block;width:100%;height:auto}
.shot{border-radius:18px 18px 0 0}
.gal{display:grid;grid-template-columns:1fr 1fr;gap:22px}
@media(max-width:860px){.gal{grid-template-columns:1fr}}
.gal figure{
border:1px solid var(--line);border-radius:16px;overflow:hidden;background:#fff;
box-shadow:var(--shadow);transition:.2s;
}
.gal figure:hover{box-shadow:var(--shadow-lg);transform:translateY(-3px)}
.gal img{display:block;width:100%;height:auto}
.gal figcaption{padding:16px 20px 18px;font-size:14.6px;color:var(--ink-2);line-height:1.65}
.gal figcaption b{display:block;color:var(--ink);font-size:15.5px;margin-bottom:4px}
/* 平台信息 */
.plat{margin:0 0 22px;background:#fff;border:1px solid var(--line);border-radius:16px;overflow:hidden}
.plat-row{display:flex;gap:18px;align-items:flex-start;padding:15px 22px;border-bottom:1px solid var(--line);font-size:14.6px;color:var(--ink-2);line-height:1.7}
.plat-row:last-child{border-bottom:0}
.plat-row b{flex:none;width:82px;color:var(--ink);font-weight:700}
.plat-chip{display:inline-block;background:var(--blue-bg);color:var(--blue-d);border-radius:999px;padding:3px 12px;font-size:13.5px;font-weight:600;margin:0 6px 6px 0}
@media(max-width:640px){.plat-row{flex-direction:column;gap:6px}.plat-row b{width:auto}}
/* ───────── 通用区块 ───────── */
section{padding:96px 0}
.sec-white{background:#fff}
.sec-gray{background:var(--gray)}
.sec-head{text-align:center;max-width:680px;margin:0 auto 54px}
.sec-head h2{font-size:clamp(26px,3.4vw,40px);font-weight:800;letter-spacing:-.8px;line-height:1.25}
.sec-head h2 em{font-style:normal;color:var(--blue)}
.sec-head p{margin-top:14px;color:var(--ink-2);font-size:16.5px}
/* 三大场景 */
.scene{
display:grid;grid-template-columns:1fr 1fr;gap:60px;align-items:center;
padding:44px 0;
}
.scene+.scene{border-top:1px solid var(--line)}
.scene.rev .scene-txt{order:2}
.scene-ico{display:inline-flex;align-items:center;gap:10px;font-size:14px;font-weight:600;color:var(--blue);margin-bottom:16px}
.scene-ico span{width:34px;height:34px;border-radius:11px;background:var(--blue-bg);display:grid;place-items:center;font-size:17px}
.scene h3{font-size:clamp(24px,2.6vw,32px);font-weight:800;line-height:1.3;letter-spacing:-.5px}
.scene ul{margin-top:24px;display:grid;gap:12px}
.scene li{display:flex;gap:11px;color:var(--ink-2);font-size:15.5px;line-height:1.6}
.scene li::before{content:"✓";color:var(--blue);font-weight:800;flex:none}
.scene-more{margin-top:26px;display:inline-flex;align-items:center;gap:7px;color:var(--blue);font-weight:600;font-size:15px}
.scene-visual{
border-radius:20px;background:linear-gradient(160deg,#f4f8ff,#eaf1ff);border:1px solid var(--line);
padding:26px;box-shadow:var(--shadow);min-height:230px;display:flex;flex-direction:column;gap:10px;justify-content:center;
}
.bar{height:11px;border-radius:6px;background:#fff;box-shadow:0 1px 2px rgba(20,30,60,.06)}
.bar.w80{width:80%}.w60{width:60%}.w70{width:70%}.w45{width:45%}.w90{width:90%}
.bar.blue{background:linear-gradient(90deg,var(--blue),var(--blue-l))}
.mini-tabs{display:flex;gap:8px;margin-bottom:6px}
.mini-tabs span{font-size:12px;padding:5px 12px;border-radius:999px;background:#fff;color:var(--ink-3);border:1px solid var(--line)}
.mini-tabs span.on{background:var(--blue);color:#fff;border-color:var(--blue)}
@media(max-width:880px){.scene{grid-template-columns:1fr;gap:30px}.scene.rev .scene-txt{order:0}}
/* 深色区块 */
.dark{background:var(--dark);color:#fff;position:relative;overflow:hidden}
.dark::before{content:"";position:absolute;width:700px;height:700px;right:-220px;top:-260px;
background:radial-gradient(circle,rgba(58,123,252,.28),transparent 70%);pointer-events:none}
.dark-in{position:relative;display:grid;grid-template-columns:1fr 1fr;gap:70px;align-items:center}
.dark h2{font-size:clamp(28px,3.6vw,44px);font-weight:800;letter-spacing:-.6px;line-height:1.28}
.dark .lead{margin-top:16px;color:rgba(255,255,255,.66);font-size:16px}
.dark-list{margin-top:34px;display:grid;gap:2px}
.dark-list div{
display:flex;gap:16px;align-items:baseline;padding:15px 0;border-bottom:1px solid rgba(255,255,255,.1);
}
.dark-list div:last-child{border:0}
.dark-list b{font-size:16.5px;font-weight:700;flex:none;min-width:96px}
.dark-list span{color:rgba(255,255,255,.6);font-size:15px}
.dark-shot{
background:#1b1b1b;border:1px solid rgba(255,255,255,.12);border-radius:18px;overflow:hidden;
box-shadow:0 30px 80px -30px #000;
}
.dark-shot .shot-bar{background:#161616;border-bottom-color:rgba(255,255,255,.1)}
.dark-shot .shot-bar span{color:rgba(255,255,255,.4)}
@media(max-width:880px){.dark-in{grid-template-columns:1fr;gap:36px}}
/* 功能网格 */
.grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(270px,1fr));gap:18px}
.card{
background:#fff;border:1px solid var(--line);border-radius:var(--r);padding:26px;
transition:.2s;position:relative;
}
.card:hover{border-color:var(--blue-l);box-shadow:var(--shadow);transform:translateY(-3px)}
.card h3{font-size:17px;font-weight:700;margin-bottom:9px;display:flex;align-items:center;gap:10px}
.card .ico{width:32px;height:32px;border-radius:10px;background:var(--blue-bg);color:var(--blue);display:grid;place-items:center;font-size:15px;flex:none}
.card p{color:var(--ink-2);font-size:14.8px;line-height:1.7}
code{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:.9em;background:var(--gray-2);padding:1.5px 6px;border-radius:5px;color:var(--blue-d)}
/* 快捷键 */
.keys{display:grid;grid-template-columns:1fr 1fr;gap:0 40px}
@media(max-width:760px){.keys{grid-template-columns:1fr}}
.key-row{display:flex;justify-content:space-between;align-items:center;gap:16px;padding:12px 0;border-bottom:1px solid var(--line);font-size:15px}
.key-row>span:first-child{color:var(--ink-2)}
kbd{
font:12.5px/1 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;background:#fff;
border:1px solid var(--line);border-bottom-width:2px;border-radius:6px;padding:4px 7px;color:var(--ink);
display:inline-block;margin-left:4px;
}
/* 下载 */
.dl-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(280px,1fr));gap:18px;margin-top:8px}
.dl-card{
background:#fff;border:1px solid var(--line);border-radius:18px;padding:30px;
display:flex;flex-direction:column;transition:.2s;
}
.dl-card.primary{border:2px solid var(--blue);box-shadow:0 20px 50px -30px rgba(58,123,252,.8);position:relative}
.dl-card.primary::after{
content:"推荐";position:absolute;top:-13px;left:30px;background:linear-gradient(96deg,var(--blue),var(--blue-d));
color:#fff;font-size:12px;font-weight:700;padding:4px 13px;border-radius:999px;
}
.dl-card h3{font-size:19px;font-weight:800;margin-bottom:8px}
.dl-size{font-size:14px;color:var(--ink-3);margin-bottom:14px}
.dl-card p{color:var(--ink-2);font-size:14.6px;line-height:1.7;flex:1;margin-bottom:22px}
.note-ic{flex:none;width:20px;height:20px;border-radius:50%;background:var(--blue);color:#fff;
font-size:12px;font-weight:800;font-style:italic;display:grid;place-items:center;margin-top:2px}
.note{
margin-top:26px;display:flex;gap:12px;align-items:flex-start;background:var(--blue-bg);
border-radius:14px;padding:16px 20px;font-size:14.6px;color:var(--blue-d)
}
footer{background:#fff;border-top:1px solid var(--line);padding:46px 0 56px;color:var(--ink-3);font-size:14px}
.foot{display:flex;gap:26px;flex-wrap:wrap;align-items:center}
.foot a:hover{color:var(--blue)}
.foot .sp{margin-left:auto}
.foot .sep{color:var(--line)}
</style>
</head>
<body>
<header id="hd">
<div class="wrap nav">
<a class="brand" href="/"><img src="/favicon.png" alt="">小银网关</a>
<nav class="nav-links">
<a href="#scene">产品</a>
<a href="#features">功能</a>
<a href="#api">接口</a>
<a href="#console">管理台</a>
<a href="#about">关于</a>
</nav>
<div class="nav-cta">
<a class="ghost" href="https://git.wangjinding.com/Jidekin/xiaoyin-gateway" target="_blank" rel="noopener">源码</a>
<a class="btn btn-blue btn-sm" href="#deploy">快速开始</a>
</div>
</div>
</header>
<!-- ══════════ HERO ══════════ -->
<div class="kv">
<div class="wrap kv-in">
<div class="kv-tag"><i class="dot"></i><span>v<span data-ver>2.9.16</span> · <b>MIT 开源 · 纯本地部署</b></span></div>
<h1>一个网关,<br><em>接住所有模型</em></h1>
<p class="kv-sub">
把 <span class="nw">4 家供应商、81 个模型</span>收进同一个 OpenAI 兼容接口。<br>
三条协议线原样直传,网关只做路由、鉴权和限流,<b>不改你的字段</b>。
</p>
<div class="kv-meta">
<i>纯后端 FastAPI</i><i>配置驱动 · 热加载</i><i>自带 Web 管理台</i>
</div>
<div class="kv-cta">
<a class="btn btn-blue" href="#deploy">↓ 部署到自己机器</a>
<a class="btn btn-line" href="#scene">看看怎么用</a>
</div>
<p class="kv-plat">Docker / 源码部署 · Python 3.10+ · 不依赖任何云服务</p>
<div class="badges">
<div class="badge"><span class="tick">✓</span>三线直传</div>
<div class="badge"><span class="tick">✓</span>统一密钥</div>
<div class="badge"><span class="tick">✓</span>熔断 · 限流</div>
<div class="badge"><span class="tick">✓</span>成本统计</div>
<div class="badge"><span class="tick">✓</span>MIT 开源</div>
</div>
<div class="shot">
<div class="shot-bar"><i></i><i></i><i></i><span>终端 — 换一个 model,就换一家供应商</span></div>
<pre class="term"><code><span class="c-com"># 同一个接口,model 决定走向哪一家</span>
<span class="c-p">$</span> curl http://127.0.0.1:8808/v1/chat/completions \
-H <span class="c-s">"Authorization: Bearer sk-你的key"</span> \
-d <span class="c-s">'{"model": "agnes-3.0-flash",
"messages": [{"role":"user","content":"你好"}]}'</span>
<span class="c-ok">200 OK</span> <span class="c-dim">{</span>"choices":[{"message":{"content":"你好!有什么可以帮你?"}}]<span class="c-dim">}</span></code></pre>
</div>
</div>
</div>
<!-- ══════════ 三大场景 ══════════ -->
<section id="scene" class="sec-white">
<div class="wrap">
<div class="sec-head">
<h2>一个网关,<em>解决三件事</em></h2>
<p>
以前每接一家模型就要改一次代码、换一套鉴权、记一套错误码。
现在它们都在你身后,接口只有一个。
</p>
</div>
<div class="grid">
<div class="card">
<h3><span class="ico">⇄</span>一个 Key,四家供应商</h3>
<p>请求里的 <code>model</code> 决定走向哪家:<b>1min.ai</b> 43 个模型、<b>OpenCode Go</b> 27 个、<b>Agnes AI</b> 10 个、<b>Dots(小红书)</b> 1 个。换模型不用换 SDK、不用换域名。</p>
</div>
<div class="card">
<h3><span class="ico">⑃</span>三条协议线,原样直传</h3>
<p>OpenAI Chat、Anthropic Messages、Responses 三条线各按自家协议转发,<b>网关不翻译字段</b>。选错线直接 400,并告诉这个模型支持哪几条。</p>
</div>
<div class="card">
<h3><span class="ico">◎</span>管得住:熔断、限流、成本</h3>
<p>同一模型自动重试 + 供应商级熔断;两级限流(全局 / 供应商);每次调用都有 token、耗时、成本估算,落在日志和 <code>/metrics</code> 里。</p>
</div>
</div>
</div>
</section>
<!-- ══════════ 深色数据块 ══════════ -->
<section class="dark">
<div class="wrap dark-in">
<div class="sec-head">
<h2>一套后端,<br>把复杂度吃掉</h2>
</div>
<div class="dark-list">
<div><b>4</b><span>家供应商<br>共 81 个模型</span></div>
<div><b>3</b><span>条协议线<br>原样直传</span></div>
<div><b>2万+</b><span>行 Python<br>单进程 FastAPI</span></div>
<div><b>0</b><span>依赖云服务<br>数据都在自己机器上</span></div>
</div>
<p class="dark-shot-tip">改配置不用重启:<code>POST /admin/reload</code> 热加载</p>
</div>
</section>
<!-- ══════════ 功能九宫格 ══════════ -->
<section id="features" class="sec-white">
<div class="wrap">
<div class="sec-head">
<h2>该有的都有,<em>不该有的一个没有</em></h2>
<p>没有账号体系绑死你、没有额度套餐、没有强制上报。装上就是你的。</p>
</div>
<div class="grid">
<div class="card"><h3><span class="ico">⇄</span>多供应商分发</h3><p>model 名决定供应商;同名模型可配多条路由,按顺序故障转移。配置写在 YAML 里,改完热加载。</p></div>
<div class="card"><h3><span class="ico">⑃</span>三线直传</h3><p>OpenAI Chat / Anthropic Messages / OpenAI Responses 三条线各走自家协议,字段不加工,客户端 SDK 直接可用。</p></div>
<div class="card"><h3><span class="ico">⛨</span>熔断 · 重试</h3><p>同模型失败自动重试;某家供应商连续失败就熔断一段时间,请求自动绕开,chat 与媒体各自独立计数。</p></div>
<div class="card"><h3><span class="ico">◔</span>两级限流</h3><p>全局 QPS + 每供应商 QPS 双层保护,超了返回 429 并带 Retry-After,不会把上游打爆。</p></div>
<div class="card"><h3><span class="ico">▣</span>图像与视频</h3><p><code>/v1/images/generations</code> 直出图片;<code>/v1/videos</code> 支持异步轮询、等待模式和 Webhook 回调。</p></div>
<div class="card"><h3><span class="ico">▲</span>指标与成本</h3><p><code>/metrics</code> 出 JSON,<code>/metrics/prometheus</code> 直接给 Prometheus 抓;按定价表估算每笔调用花多少钱。</p></div>
<div class="card"><h3><span class="ico">↻</span>热加载</h3><p>改完 <code>gateway.yaml</code> 调一次 reload,新配置立即生效,不中断在途请求。</p></div>
<div class="card"><h3><span class="ico">☺</span>账号 + 每账号 Key</h3><p>管理台账号密码登录,每个账号自己建 API Key,互不干扰;停用只影响该账号。</p></div>
<div class="card"><h3><span class="ico">▤</span>自带管理台</h3><p>Vue 写的 Web 控制台:看日志、调配置、试模型、查用量,不用登服务器改文件。</p></div>
</div>
</div>
</section>
<!-- ══════════ 接口一览 ══════════ -->
<section id="api" class="sec-gray">
<div class="wrap">
<div class="sec-head">
<h2>接口就那么几个</h2>
<p>都是 OpenAI 兼容路径,换 base_url 就能接上你现有的客户端。</p>
</div>
<div class="api-list"><div class="api-row"><span class="api-m post">POST</span><b>/v1/chat/completions</b><i>对话(OpenAI 线)</i></div><div class="api-row"><span class="api-m post">POST</span><b>/v1/messages</b><i>对话(Anthropic 线,也认 x-api-key)</i></div><div class="api-row"><span class="api-m post">POST</span><b>/v1/responses</b><i>对话(Responses 线)</i></div><div class="api-row"><span class="api-m post">POST</span><b>/v1/chat/completions/batch</b><i>并发多 prompt 一次发出</i></div><div class="api-row"><span class="api-m post">POST</span><b>/v1/images/generations</b><i>出图</i></div><div class="api-row"><span class="api-m post">POST</span><b>/v1/videos</b><i>出视频(异步 / 等待 / Webhook)</i></div><div class="api-row"><span class="api-m get">GET</span><b>/models</b><i>这个网关现在有哪些模型</i></div><div class="api-row"><span class="api-m get">GET</span><b>/metrics</b><i>用量、耗时、成本(JSON / Prometheus)</i></div><div class="api-row"><span class="api-m get">GET</span><b>/health</b><i>运维看板</i></div></div>
</div>
</section>
<!-- ══════════ 真实界面 ══════════ -->
<section id="console" class="sec-white">
<div class="wrap">
<div class="sec-head">
<h2>这些<em>都是真实界面</em></h2>
<p>不是效果图。下面每一张都是管理台正在跑的样子,数据来自我自己这台机器。</p>
</div>
<div class="gal2">
<figure class="shot2">
<div class="shot-bar"><i></i><i></i><i></i><span>仪表盘 — 用量、成功率、延迟、供应商健康</span></div>
<img src="/img/console-dashboard.jpg" alt="小银网关管理台仪表盘:请求总数、成功率、平均延迟、模型延迟 P50/P95、供应商状态与调用份额">
</figure>
<figure class="shot2">
<div class="shot-bar"><i></i><i></i><i></i><span>模型与供应商 — 4 家 / 81 个模型</span></div>
<img src="/img/console-models.jpg" alt="小银网关管理台:模型与供应商列表,显示每家供应商的模型数与 Key 配置状态">
</figure>
<figure class="shot2">
<div class="shot-bar"><i></i><i></i><i></i><span>指标与成本 — Token 用量、缓存命中、调用分布</span></div>
<img src="/img/console-metrics.jpg" alt="小银网关管理台指标页:Token 用量、缓存命中率、各模型与供应商调用分布">
</figure>
<figure class="shot2">
<div class="shot-bar"><i></i><i></i><i></i><span>对话 — 选模型即选供应商,带 token 与耗时</span></div>
<img src="/img/console-chat.jpg" alt="小银网关管理台对话页:选择 agnes-3.0-flash 模型提问,显示 token 用量、耗时与成本">
</figure>
</div>
</div>
</section>
<!-- ══════════ 部署 ══════════ -->
<section id="deploy" class="sec-white">
<div class="wrap">
<div class="sec-head">
<h2>部署,<em>三条命令的事</em></h2>
<p>一台小机器就够:单进程 FastAPI,内存几百 MB,没有数据库、没有中间件。</p>
</div>
<div class="grid" style="grid-template-columns:1fr">
<div class="card">
<h3><span class="ico">⌨</span>从源码跑起来</h3>
<pre class="code"><code>git clone https://git.wangjinding.com/Jidekin/xiaoyin-gateway.git
cd xiaoyin-gateway
pip install -r requirements.txt
cp .env.example .env <span class="c-com"># 填各家供应商的 token</span>
vim data/gateway.yaml <span class="c-com"># 配供应商、模型、限流</span>
python run.py <span class="c-com"># 默认 127.0.0.1:8808</span></code></pre>
<p>起来之后打开 <code>http://127.0.0.1:8808/web</code> 就是管理台。</p>
</div>
<div class="card">
<h3><span class="ico">⌗</span>配一个供应商长这样</h3>
<pre class="code"><code><span class="c-com"># data/gateway.yaml</span>
providers:
agnes:
base_url: https://api.agnes-ai.cn/v1
api_key: <span class="c-dim">${AGNES_API_KEY}</span>
models:
- name: agnes-3.0-flash
protocols: [chat, messages]
pricing: { input: 0.0, output: 0.0 }</code></pre>
<p>配好 reload 一下,<code>GET /models</code> 就能看到它。</p>
</div>
</div>
</div>
</section>
<!-- ══════════ 关于 ══════════ -->
<section id="about" class="sec-gray">
<div class="wrap">
<div class="sec-head">
<h2>关于<em>小银网关</em></h2>
<p>
一家人用的模型入口。不对外卖额度、不做 SaaS —— 代码在你自己机器上跑,
密钥在你自己手里,日志在你自己盘上。
</p>
</div>
<div class="plat">
<div class="plat-row">
<b>技术栈</b>
<span>
<span class="plat-chip">FastAPI</span>
<span class="plat-chip">Python 3.10+</span>
<span class="plat-chip">配置驱动 YAML</span>
<span class="plat-chip">Vue 管理台</span>
</span>
</div>
<div class="plat-row">
<b>供应商</b>
<span>1min.ai(43 个模型)· OpenCode Go(27)· Agnes AI(10)· Dots AI 小红书(1,512K 上下文)</span>
</div>
<div class="plat-row">
<b>部署方式</b>
<span>源码 <code>python run.py</code> 或 Docker;单进程,无数据库、无 Redis、无消息队列。</span>
</div>
<div class="plat-row">
<b>许可</b>
<span>MIT License,可自由使用、修改、分发。</span>
</div>
</div>
<div class="grid">
<div class="card"><h3><span class="ico">⛨</span>隐私</h3><p>数据不出你的机器。网关只在上游调用时刻才连外网,其余时间全是本地。</p></div>
<div class="card"><h3><span class="ico">§</span>许可</h3><p>MIT。改完自己用、给朋友用、拿去二次开发都行。</p></div>
<div class="card"><h3><span class="ico">↻</span>自己改</h3><p>2 万行 Python,一个 <code>app/main.py</code> 就是全部后端;前端 Vue 单独构建,产物直接塞进 <code>frontend/dist</code>。</p></div>
</div>
</div>
</section>
<footer class="foot">
<div class="wrap">
<span>© 2026 小银网关 · <span data-ver>2.9.16</span></span>
<span class="sep">·</span>
<a href="https://git.wangjinding.com/Jidekin/xiaoyin-gateway" target="_blank" rel="noopener">Gitea</a>
<span class="sep">·</span>
<a href="https://github.com/wangjinding/xiaoyin-gateway" target="_blank" rel="noopener">GitHub</a>
<span class="sep">·</span>
<span>MIT License</span>
</div>
</footer>
<style>
.term{margin:0;padding:20px 22px;background:#1c1f26;color:#d7dbe4;border-radius:0 0 14px 14px;
font:13.5px/1.85 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;overflow-x:auto}
.term code{background:none;padding:0;color:inherit}
.c-com{color:#6f7a8d}.c-p{color:#64d2a0}.c-s{color:#e5c07b}
.c-ok{color:#64d2a0;font-weight:700}.c-dim{color:#8b95a8}
.code{margin:0 0 12px;padding:16px 18px;background:#f6f8fb;border:1px solid var(--line);
border-radius:12px;font:13.5px/1.8 ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;
color:#37404f;overflow-x:auto}
.code code{background:none;padding:0;color:inherit}
.gal2{display:grid;grid-template-columns:1fr 1fr;gap:22px}
.shot2{margin:0;background:#fff;border:1px solid var(--line);border-radius:14px;overflow:hidden;
box-shadow:0 10px 40px -18px rgba(20,30,60,.22);transition:transform .18s ease, box-shadow .18s ease}
.shot2:hover{transform:translateY(-3px);box-shadow:0 18px 50px -20px rgba(20,30,60,.3)}
.shot2 img{display:block;width:100%;height:auto}
@media(max-width:860px){.gal2{grid-template-columns:1fr}}
.api-list{background:#fff;border:1px solid var(--line);border-radius:16px;overflow:hidden}
.api-row{display:flex;align-items:center;gap:16px;padding:13px 22px;border-bottom:1px solid var(--line);font-size:14.5px}
.api-row:last-child{border-bottom:0}
.api-m{flex:none;width:52px;font:700 11px/1 ui-monospace,monospace;color:#fff;border-radius:6px;
padding:5px 0;text-align:center;letter-spacing:.5px}
.api-m.post{background:#2f6feb}.api-m.get{background:#0f9d6b}
.api-row b{flex:none;min-width:300px;font-family:ui-monospace,SFMono-Regular,Menlo,monospace;font-size:14px;color:var(--ink)}
.api-row i{color:var(--ink-3);font-style:normal}
@media(max-width:720px){.api-row{flex-wrap:wrap;gap:8px}.api-row b{min-width:0;flex:1 1 100%}}
.dark-shot-tip{margin-top:22px;color:rgba(255,255,255,.55);font-size:14px}
.dark-shot-tip code{background:rgba(255,255,255,.1);color:#9fc0ff}
@media(max-width:720px){
.key-row{flex-wrap:wrap;gap:8px}
.key-row b{min-width:0;flex:1 1 100%}
}
</style>
</body>
</html>
+1 -1
View File
@@ -30,7 +30,7 @@ def _explain(r: httpx.Response) -> str:
def main() -> int: def main() -> int:
parser = argparse.ArgumentParser(description="API Gateway 冒烟测试") parser = argparse.ArgumentParser(description="小银网关 冒烟测试")
parser.add_argument("--url", default="http://localhost:8808", help="网关地址") parser.add_argument("--url", default="http://localhost:8808", help="网关地址")
parser.add_argument("--api-key", default="", help="可选 Bearer key(网关开了鉴权时用)") parser.add_argument("--api-key", default="", help="可选 Bearer key(网关开了鉴权时用)")
parser.add_argument("--model", default="agnes-3.0-flash", help="测试用文本模型") parser.add_argument("--model", default="agnes-3.0-flash", help="测试用文本模型")
+14 -1
View File
@@ -61,6 +61,16 @@ if _TC is not None:
_AUTOBEARER = "" _AUTOBEARER = ""
try: try:
import app.main as _m import app.main as _m
# 2026-11-19:测试会**故意**制造大量鉴权失败,而 2026-11-06 起的「鉴权失败自动封禁」
# 会在同一进程内把 testclient 这个 IP 拉黑 60 分钟 → 后半场测试全变 429。
# 这是测试隔离问题,不是被测行为:测试里关掉封禁(限流仍生效),生产逻辑不动。
try:
_m._cfg().server.auth_fail_ban_seconds = 0
_m._BANNED.clear()
_m._BANNED_FOREVER.clear()
_m._AUTH_FAILS.clear()
except Exception:
pass
_c = _TC(_m.app) _c = _TC(_m.app)
_r = _c.post("/auth/login", json={"username": "admin", "password": "admin"}) _r = _c.post("/auth/login", json={"username": "admin", "password": "admin"})
if _r.status_code == 200: if _r.status_code == 200:
@@ -1716,7 +1726,10 @@ def test_models_payload_marks_free_models():
# 2026-10-12:样本从 space-bunny-free 换成 longcat-2.5-preview-free —— 前者已于 # 2026-10-12:样本从 space-bunny-free 换成 longcat-2.5-preview-free —— 前者已于
# 2026-10-07 被官方改名成 space-bunny 并转收费(价格表 $0.15/$0.60), # 2026-10-07 被官方改名成 space-bunny 并转收费(价格表 $0.15/$0.60),
# 每日同步据此去掉了它的 free 标记(现网免费位=longcat-2.5-preview-free / step-5-preview-free)。 # 每日同步据此去掉了它的 free 标记(现网免费位=longcat-2.5-preview-free / step-5-preview-free)。
assert "longcat-2.5-preview-free" in free_ids, f"免费模型没标出来:{free_ids}" # 2026-11-19:官方把 longcat-2.5-preview-free 改名为 longcat-2.5-free(每日同步已跟进),
# 样本改成「现网确实免费的那几个之一」,避免上游改名再把测试打红。
assert any(x in free_ids for x in ("longcat-2.5-free", "hy4-flash-free",
"iceman-contributor-free")), f"免费模型没标出来:{free_ids}"
# 反向:付费模型必须是 free=false(不能因为字段缺失而误标) # 反向:付费模型必须是 free=false(不能因为字段缺失而误标)
paid = next(x for x in data if x["id"] == "deepseek-v4.1-flash") paid = next(x for x in data if x["id"] == "deepseek-v4.1-flash")
assert paid["free"] is False, paid assert paid["free"] is False, paid