第三十轮: 全面体检发现项全部修 —— 下载白名单/视频归属/会话落盘/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。
This commit is contained in:
1 parent
d5ac7ac555
commit
d3fa8f5e20
24 files changed
+887
-535
No files matched your search
+20
-3
@@ -1,13 +1,30 @@
|
||||
# API Gateway 环境变量模板
|
||||
# 复制为 .env 并填入真实 token(本机使用即可;如需版本管理,建议自行把 .env 加进 .gitignore)
|
||||
# 真实环境变量优先级高于 .env(load_dotenv override=False)
|
||||
# ── 怎么用 ──
|
||||
# 1) 本机最简:复制成项目根的 .env 并填入真实 token(根 .env 不覆盖真实环境变量)。
|
||||
# 2) 交给「网关配置页 → 环境变量」那张卡管理:写 data/.env(权限 600,已进 .gitignore)。
|
||||
# 那一层用 load_dotenv(override=True) 加载,**故意压过根 .env** ——
|
||||
# 否则页面里刚改的 Key 会被根 .env 的旧值顶掉。
|
||||
# 3) 真实环境变量(systemd/supervisor/docker 注入)优先级永远最高,也是生产推荐做法。
|
||||
# 密钥**不放** yaml:data/gateway.yaml 各供应商用 token_env 引用下面这些变量名。
|
||||
#
|
||||
# 第三十轮: 删掉 B_AI_API_KEY(b.ai 供应商早已删除,这个空变量只剩误导);
|
||||
# 补上后来实装但一直漏在模板外的 OPENCODE_API_KEY。
|
||||
|
||||
AGNES_API_KEY=
|
||||
B_AI_API_KEY=
|
||||
VOLC_API_KEY=
|
||||
OPENCODE_API_KEY=
|
||||
|
||||
# 运行参数(可选,覆盖 yaml)
|
||||
# GATEWAY_CONFIG=/path/to/gateway.yaml
|
||||
# GATEWAY_HOST=127.0.0.1
|
||||
# GATEWAY_PORT=8808
|
||||
# GATEWAY_GRACEFUL_SHUTDOWN=30
|
||||
|
||||
# 数据文件路径(可选,默认都在 data/ 下;测试/多实例部署时用得上)
|
||||
# GATEWAY_USERS=data/users.json
|
||||
# GATEWAY_HISTORY=data/history.json
|
||||
# GATEWAY_FEEDBACK=data/feedback.json
|
||||
# GATEWAY_FEEDBACK_MEDIA=data/feedback_media
|
||||
# GATEWAY_SESSIONS=data/sessions.json # 登录会话(只存 token 的 sha256)
|
||||
# GATEWAY_VIDEO_OWNERS=data/video_owners.json # 视频任务归属(轮询判权用)
|
||||
# GATEWAY_ENV_FILE=data/.env # 配置页「环境变量」那张卡写哪个文件
|
||||
+11
@@ -23,6 +23,17 @@ data/feedback_media/
|
||||
.test_history.json
|
||||
.test_feedback.json
|
||||
.test_feedback_media/
|
||||
.test_sessions.json
|
||||
.test_video_owners.json
|
||||
.test_env
|
||||
|
||||
# 运行期状态(第三十轮):会话落盘 / 视频归属落盘 —— 都是运行数据,且含账号名与凭证哈希,
|
||||
# 属"可重新生成、不该进版本库"的一类(重启后从空开始,语义上无害)
|
||||
data/sessions.json
|
||||
data/video_owners.json
|
||||
|
||||
# 配置自动备份(每存一次网关配置就多一对):不该跟着源码走,也不该在仓库里堆历史版本
|
||||
data/*.bak
|
||||
|
||||
# 说明:data/gateway.yaml 不含明文 Key —— 三家供应商密钥统一在 .env(已被上面忽略),
|
||||
# 由 yaml 各供应商的 token_env 引用。只要 .env 不提交,密钥就不会进版本库。
|
||||
|
||||
+102
@@ -1,5 +1,107 @@
|
||||
# CHANGELOG
|
||||
|
||||
## 2026-09-18 · 第三十轮:全面体检发现项「全部」修完(下载白名单 / 视频归属 / 会话落盘 / i18n / 口令下限)
|
||||
|
||||
**老板决策**:上一轮交了「只查未改」的体检清单,老板回一句「**全部**」—— 逐项修完并直接上生产验证。
|
||||
|
||||
### P0(实测复现的真 bug)产物下载白名单
|
||||
- `download.allowed_hosts` 只放了 `cos-platform-outputs.agnes-ai.cn`,而 Agnes 的**水印版**
|
||||
产物走另一个 CDN `maas-watermark-prod-new.cn-wlcb.ufileos.com`(admin 历史里 9-16 的 3 条产物
|
||||
都是这个域名)→ 页面「下载」必 400「该地址不在允许下载的域名白名单内」。
|
||||
- 补上水印域名;`data/gateway.yaml` 与 README 都写清**这张表是出网白名单、换 CDN 要同步维护**。
|
||||
- 生产实测:`GET /v1/media/download?url=<水印图>` → **200 / 129871 bytes**(改前 400);
|
||||
非白名单域名(`evil.example.com`)仍 400。
|
||||
|
||||
### 视频任务归属(新增 `app/video_owners.py`)
|
||||
- 原先 `GET /v1/videos/{video_id}` **不判归属**:任何已登录账号拿到 id 就能读别人视频任务的状态
|
||||
与产物 URL(与 users/history/metrics 的「按账号隔离」口径不一致)。
|
||||
- 创建成功那一刻登记 `video_id → 账号`(`_owners.record`,走 `_offload`),轮询据此判权:
|
||||
**非归属账号回 404**(而非 403 —— 403 等于确认 id 存在,会把 id 变成存在性探针)、
|
||||
**admin 放行**、**无登记放行**(改动前创建的老任务 / 落盘丢失时,渐进收紧,不砸正在轮询的流程)。
|
||||
- 落盘 `data/video_owners.json`(600、原子写、TTL 7 天、上限 2000 条)。
|
||||
|
||||
### 登录会话落盘(`app/sessions.py`)
|
||||
- 此前纯内存 → **每次重启把全体网页登录踢下线**。现在落盘 `data/sessions.json`:
|
||||
**只存 token 的 sha256**(不存 token 本身,备份泄漏也无法直接冒充)、原子写 + 权限 600、
|
||||
写失败只告警(退化成原行为)、载入时丢弃已过期会话。
|
||||
- 吊销语义不变且**吊销也落盘**(改密 / 重置 / 删号 / 停用 → 该账号全部会话立即失效)。
|
||||
- 生产实测:登录拿 token → `restart` → **同一 token 仍 200**(`/auth/apikeys`);
|
||||
文件里 `token in raw == False`。
|
||||
|
||||
### 口令下限 4 → 8(`app/users.py`)
|
||||
- `MIN_PASSWORD = 8`。只作用于「建号时显式给密码 / 事后改密」;**登录不做长度校验**,
|
||||
故既有短口令账号(如 `test`)照常能登,只是不能再被改回短口令。前端 `newPw`/`newUserTip` 同步。
|
||||
|
||||
### `/config/env` 值校验(配置页环境变量卡)
|
||||
- 拒绝含 `\n` / `\r` / `\x00` 或长度 > 4096 的值 —— `.env` 是**逐行重建**的,一个带换行的值
|
||||
就能在文件里凭空多出几行、改掉同一份 `.env` 里的其它变量。
|
||||
- 生产实测:换行值 / 超长值 / 非白名单变量名均 400,且 `md5(data/.env)` 前后一致。
|
||||
|
||||
### 性能 / 一致性
|
||||
- `history` 四个端点补 `_offload`:HistoryStore 每次**整份**读写(上限 4MB),此前是唯一还在
|
||||
事件循环里同步跑的文件 IO(users/feedback/config 早已挪到线程池)。
|
||||
- `GET /` 导航里的 `docs` 一行改为**仅当 `docs_enabled` 时**列出(关掉时路由不存在,列着会 404)。
|
||||
- `/health/{provider}` 注释更正:它一直是 `require_auth`(**恒定要鉴权**,不随 `health_auth` 放宽),
|
||||
旧注释误写「同受 health_auth 保护」。保留更严的行为(它会用网关的 Key 打上游 `/models`),改注释。
|
||||
|
||||
### 前端 i18n 收口
|
||||
- `views/Videos.vue` 素材摘要(原硬编码 `首帧:xx.png`)、`lib/upload.ts` 全部用户可见报错与
|
||||
preset 名、`lib/charts.ts` 空态文案 → 全部走 i18n(新增 `videos.media*` 5 键 + `upload.*` 15 键,
|
||||
中英 **737/737** 对称);`lib/upload.ts` 取全局 `i18n.global.t`(模块非组件)。
|
||||
- 删除 `router.ts` 中**无人消费**的 `meta.title`(只有中文的死元数据;菜单标题唯一来源是
|
||||
`lib/nav.ts` + i18n)。
|
||||
- **`frontend/scripts/check-i18n.mjs` 新增「硬编码中文」扫描**:剥掉块/HTML/行注释(避开
|
||||
`https://`)后扫字符串字面量,命中即 build 失败;允许清单仅放「语言自称」(登录页的 `中`)。
|
||||
自测:临时塞一句 `'中文硬编码自测'` → 构建前置检查正确抓出。
|
||||
|
||||
### 文档 / 基建
|
||||
- README:`.env` 段补 `OPENCODE_API_KEY`、说明**两层 `.env`**(`data/.env` 用
|
||||
`override=True` 压过根 `.env`,值不得含换行/控制字符、≤4096)、修掉 `data/gateway.yaml 的
|
||||
auth.users` 死引用与「自动路由」措辞、安全基线补「下载代理白名单维护」「视频任务归属」、
|
||||
数据文件清单补 `sessions.json` / `video_owners.json` 与对应 `GATEWAY_*` 覆盖项、测试计数
|
||||
165 → 179。
|
||||
- `.env.example` 重写:删 `B_AI_API_KEY`(供应商早已删除)、补 `OPENCODE_API_KEY` 与全部可覆盖
|
||||
路径,写清三层优先级(真实环境变量 > `data/.env` > 根 `.env`)。
|
||||
- `Makefile`:`lint` 从**手写文件清单**改 `python -m compileall -q app run.py`(原清单漏了
|
||||
`users.py` / `history.py` / `feedback.py` / `settings.py` / `sessions.py` / `video_owners.py`)。
|
||||
- `.gitignore`:补 3 个测试临时文件、`data/sessions.json`、`data/video_owners.json`、`data/*.bak`;
|
||||
仓库里 3 个 `data/gateway.yaml*.bak` 执行 `git rm --cached`(本地文件保留,只是不再入库)。
|
||||
- `app/settings.py`:配置备份写完后**显式 `chmod 600`**(`shutil.copy2` 会照抄源文件权限,
|
||||
源是历史遗留的 644 时备份也会跟着 644)。
|
||||
- 新增 `scripts/ci_check.sh`:一条命令跑完「后端 compileall + 单测 + i18n/SVG 体检 + `vue-tsc` +
|
||||
build」(`--fast` 跳过 build),本地与 CI 通用;**任何一步失败都继续跑完再汇总**(一次暴露全部问题)。
|
||||
**没写 `.cnb.yml`**:CNB 流水线的配置 schema 我没把握,不想靠猜去改线上流水线 —— 交给老板确认后
|
||||
把 `bash scripts/ci_check.sh` 挂上去即可(脚本退出码就是判定依据)。
|
||||
- `Makefile` 的 `test` 目标注释改成实话:环境里**没装 pytest**,「`pytest tests/ -q`」照着敲只会
|
||||
`command not found`;这套单测是自带 runner 的独立脚本,`python tests/test_gateway.py` 才是能跑的。
|
||||
- `tests/` + `app/` 的 `flake8 --select=F,E9` 清到 **0**(原本 5 处:未用 import ×4、赋值未用 ×1)。
|
||||
- 一键测速探针**不传 session** 处补注释:这是**有意**的 —— 复用真实会话值会被上游前缀缓存拉成
|
||||
「假快」,测速失去意义(所以适配器回退随机值)。
|
||||
|
||||
### 测试
|
||||
- **179 passed / 0 failed**(173 → 179)。新增:会话落盘(跨重启有效 + 盘上无明文 + 吊销落盘)、
|
||||
过期会话载入即丢、视频归属语义(本人 / 他人 / admin / 无登记 + 跨重启保持)、端点级
|
||||
「他人 poll → 404」、`/config/env` 值校验(4 种坏值 + 沙箱写路径生效)、口令下限(含
|
||||
「默认密码=账号名不受限、短口令仍可登录」)。
|
||||
- **修掉一个测试隐患**:写路径此前没有环境变量覆盖,测试一旦覆盖到就会**直接改生产
|
||||
`data/.env`** —— 新增 `GATEWAY_ENV_FILE`(与 `GATEWAY_SESSIONS` / `GATEWAY_VIDEO_OWNERS`
|
||||
同套路),测试全部指到 `.test_*` 沙箱文件。
|
||||
|
||||
### 结论:CSP 的 `'unsafe-eval'` 现在还不能删(有 A/B 实测)
|
||||
- 临时把 CSP 改成 `script-src 'self'` 并重启 → 真浏览器打开 `/web/#/login`:**`#app` 全空、
|
||||
登录表单完全不渲染**;改回 `'unsafe-eval'` → 表单与中英切换全正常。
|
||||
- 根因:打包产物里唯一一处 `new Function` 在 **vue-i18n 的消息编译器**(运行时编译带插值/复数的
|
||||
文案需要 eval)。**正解是把文案编译搬到构建期**(`@intlify/unplugin-vue-i18n` 预编译消息),
|
||||
在没做这件事之前不要动这条 CSP —— 旧注释里「本地无 CSP 的 vite preview 看不出、上线会白屏」
|
||||
是对的。
|
||||
|
||||
### 上线与验证
|
||||
- 后端 `supervisorctl restart api-gateway:api-gateway_00`;前端 `npm run build` 覆盖
|
||||
`frontend/dist`(网关 `StaticFiles` 直接挂载)→ 线上入口 **`index-Bf3pWvHR.js`**。
|
||||
- 生产验证:`/healthz` 200、登录页 + 中英切换(真浏览器)、`/health/agnes` 无凭据 401、
|
||||
`GET /` 导航无 `docs`、env 值校验 400 且文件未变、水印图下载 200、未登记 video_id 轮询
|
||||
照常走通(无 500)、同一会话 token 跨重启仍有效。
|
||||
|
||||
## 2026-09-18 · 第二十九轮:`x-opencode-session` 缺省按 **API Key 稳定**派生(提缓存命中)
|
||||
|
||||
**老板决策**:把网关接入 agent / QwenPaw 时,客户端多数不传 `conversation_id`,网关此前
|
||||
|
||||
@@ -24,10 +24,16 @@ run: ## 本地启动
|
||||
|
||||
test: ## 跑单元测试
|
||||
python tests/test_gateway.py
|
||||
# 或: pytest tests/ -q
|
||||
# 第三十轮: 原来这里写「或: pytest tests/ -q」—— 但环境里**没装 pytest**,
|
||||
# 照着敲只会报 command not found。这套单测其实是**自带 runner 的独立脚本**
|
||||
# (`python tests/test_gateway.py` 直接跑,pytest 只是可选外壳):
|
||||
# 装了 pytest 时 `pytest tests/ -q` 收集的是同一批 test_* 函数,结果等价。
|
||||
|
||||
lint: ## 语法编译检查
|
||||
python -m py_compile app/config.py app/circuit.py app/metrics.py app/main.py app/routing.py app/models.py app/adapters/*.py run.py
|
||||
# 第三十轮: 原来是一个**手写文件清单** —— 新增 app/users.py / history.py / feedback.py /
|
||||
# settings.py / sessions.py / video_owners.py 时没人回来补,等于这几个文件从没被 lint 过。
|
||||
# 改成 compileall:整个包都覆盖,以后加文件也不用记得改这里。
|
||||
python -m compileall -q app run.py
|
||||
@echo "syntax OK"
|
||||
|
||||
clean: ## 清理
|
||||
|
||||
@@ -273,7 +273,8 @@ auth:
|
||||
`admin` 账号永不可停用(唯一管理员被停用后没人能进管理页,只能停机改 `users.json` 救回,故
|
||||
接口直接拒绝,且启动加载时会把手工写入的 `disabled` 自动恢复并告警),也不能停用自己。
|
||||
停用状态落在账号记录的 `disabled` / `disabled_at` 两个字段上。
|
||||
- 普通账号最多 3 把 API Key(到量后页面按钮置灰并给出提示,不再是一句裸 400);**admin 不限数量**。显式设置/修改的密码至少 4 位。
|
||||
- 普通账号最多 3 把 API Key(到量后页面按钮置灰并给出提示,不再是一句裸 400);**admin 不限数量**。显式设置/修改的密码至少 **8 位**(第三十轮从 4 位提到 8 位:4 位在可离线爆破的空间里几乎等于没设)。
|
||||
只作用于「建号时显式给密码 / 事后改密」;**登录不做长度校验**,所以既有短口令账号照常能登,只是不能再被改回短口令。
|
||||
- **Key 明文回显**:创建后页面展示明文,之后随时可在列表里再复制。代价是 `data/users.json` 里额外存一份
|
||||
明文 Key(该文件权限固定 600、已在 `.gitignore`)。因此 `GET /auth/apikeys` 也只认会话凭证——
|
||||
泄漏一把 Key 不该能顺走同账号其它 Key 的明文。此改动之前发的旧 Key 无法反推明文(只回显哈希前缀),
|
||||
@@ -300,6 +301,13 @@ auth:
|
||||
> 登录成功一次即清零该来源计数(避免同出口 NAT 下被前人失败连坐)。
|
||||
> - 防用户名枚举:账号不存在时也会走一次等代价的 PBKDF2,登录响应耗时不随账号存在与否变化。
|
||||
> - 全局限流按**账号**归并成桶:同一账号多开几个会话/多建几把 Key 不再成倍放大配额。
|
||||
> - **产物下载代理**(`/v1/media/download`):出网域名白名单在 `data/gateway.yaml` 的
|
||||
> `download.allowed_hosts`,只代抓这里列出的域名(含子域)。供应商多一套存储(例如 Agnes 的
|
||||
> **水印版**产物走另一个 CDN)而没补进白名单 → 页面「下载」按钮 400「该地址不在允许下载的域名白名单内」。
|
||||
> 换 CDN 记得同步这一行(第三十轮补上水印域名 `maas-watermark-prod-new.cn-wlcb.ufileos.com`)。
|
||||
> - **视频任务归属**(第三十轮):`GET /v1/videos/{video_id}` 按「创建时登记的 video_id → 账号」判权,
|
||||
> 别的账号拿到 id 也读不到(回 404,不用 403,免得 id 变成存在性探针);admin 放行;
|
||||
> 本次改动之前创建的老任务无登记 → 放行(渐进收紧,不砸正在轮询的流程)。
|
||||
|
||||
### 历史(图像 / 视频 / 对话)落盘
|
||||
|
||||
@@ -312,6 +320,16 @@ data/history.json # {账号: {类别: [条目…]}},权限 600,已
|
||||
GATEWAY_HISTORY=<路径> # 可选,测试/多实例时指定
|
||||
```
|
||||
|
||||
同目录还有两份运行期状态文件(第三十轮,均可整份删掉、重启从空开始):
|
||||
|
||||
```
|
||||
data/sessions.json # 登录会话(**只存 token 的 sha256**,不存 token 本身),600
|
||||
data/video_owners.json # 视频任务归属(video_id → 账号),600
|
||||
GATEWAY_SESSIONS=<路径> / GATEWAY_VIDEO_OWNERS=<路径> # 可选覆盖(测试用)
|
||||
```
|
||||
|
||||
会话落盘是为了「重启不再把所有人踢下线」;吊销语义不变(改密/删号/停用仍旧立刻失效,且吊销也落盘)。
|
||||
|
||||
- **按账号隔离**:普通账号只看得到自己的历史;admin 也只看自己的(历史是个人数据,不是运维数据)。
|
||||
- **按 id upsert**:带已存在 id → 原地更新(视频"生成中→完成"走这条);新 id → 插到最前。
|
||||
所以两台设备各自生成不会互相覆盖;也因此**没有**"整份 PUT"那种一提交就把别人抹掉的坑。
|
||||
@@ -375,12 +393,18 @@ python run.py # 默认读 data/gateway.yaml,端口 8808
|
||||
|
||||
```bash
|
||||
cp .env.example .env
|
||||
# 编辑 .env 填入 AGNES_API_KEY / VOLC_API_KEY
|
||||
# 编辑 .env 填入 AGNES_API_KEY / VOLC_API_KEY / OPENCODE_API_KEY
|
||||
python run.py # 启动时自动读取 .env
|
||||
```
|
||||
|
||||
优先级:真实环境变量 > `.env`(密钥所在,经各供应商 `token_env` 引用)> yaml 其它字段。
|
||||
|
||||
> **两层 `.env`**(第三十轮补文档):`data/.env` 是「网关配置页 → 环境变量」那张卡写的那层,
|
||||
> 用 `load_dotenv(..., override=True)` 加载,**故意压过**项目根 `.env` —— 否则页面里刚改的
|
||||
> Key 会被根 `.env` 的旧值顶掉。所以本机想把 Key 交给页面管理,就写 `data/.env`(权限 600,
|
||||
> 已进 `.gitignore`)。页面对值的校验:不得含换行/控制字符、长度 ≤4096(换行会让 `.env`
|
||||
> 凭空多出几行、改到别的变量)。
|
||||
|
||||
|
||||
## API 端点(含 v2.1 新增)
|
||||
|
||||
@@ -438,10 +462,10 @@ python run.py # 启动时自动读取 .env
|
||||
### 调用示例
|
||||
|
||||
```bash
|
||||
# 授权:所有调用带 Bearer(data/gateway.yaml 的 auth.users 里 key)
|
||||
# 授权:所有调用带 Bearer(Key 在「API Key」页自助铸造;admin 密码在 data/users.json)
|
||||
AUTH="Authorization: Bearer <你的 key>"
|
||||
|
||||
# 文本(自动路由)+ 响应带 estimated_cost_cny
|
||||
# 文本(chat/completions 线;第二十七轮起没有路由,model 就是真实模型 id)+ 响应带 estimated_cost_cny
|
||||
curl -X POST http://localhost:8808/v1/chat/completions \
|
||||
-H "$AUTH" -H "Content-Type: application/json" \
|
||||
-d '{"model":"agnes-3.0-flash","messages":[{"role":"user","content":"你好"}],"max_tokens":256}'
|
||||
@@ -1248,7 +1272,9 @@ python smoke_test.py --url http://127.0.0.1:8808
|
||||
python live_check.py --url http://127.0.0.1:8808
|
||||
```
|
||||
|
||||
> 当前状态:单元测试 **165 passed / 0 failed**(`python tests/test_gateway.py`,不需要 pytest);冒烟 5/5 PASS;活体检查 14 PASS / 0 FAIL / 0 WARN。
|
||||
> 一行跑完所有门禁(单测 + i18n/SVG 文案体检 + 前端类型检查 + 语法编译):`bash scripts/ci_check.sh`
|
||||
|
||||
> 当前状态:单元测试 **179 passed / 0 failed**(`python tests/test_gateway.py`,不需要 pytest);冒烟 5/5 PASS;活体检查 14 PASS / 0 FAIL / 0 WARN。
|
||||
|
||||
## 备注
|
||||
|
||||
|
||||
@@ -205,6 +205,10 @@ class OpenAICompatAdapter(BaseAdapter):
|
||||
headers.pop("authorization", None)
|
||||
headers.pop("x-api-key", None)
|
||||
headers.update(self.auth_headers(protocol))
|
||||
# 第三十轮: 这里原来写「无 session → 每请求一个随机 UUID(仍能过上游强校验,只是没有缓存收益)」,
|
||||
# 那句话在第二十九轮之后**已经不对了** —— 网关三条协议线入口(chat 非流式/流式、batch、
|
||||
# 三线直传)现在都传 `session_id`,随机回退只在"适配器被直接调用且没给 session"时才可能命中。
|
||||
# 留 uuid4 是兜底(保证不缺头 → 不会 400 MissingSessionID),正常流量走不到这里。
|
||||
if self._requires_session:
|
||||
headers["x-opencode-session"] = session_id or uuid.uuid4().hex
|
||||
return headers
|
||||
@@ -222,6 +226,11 @@ class OpenAICompatAdapter(BaseAdapter):
|
||||
headers = dict(self._headers)
|
||||
if self._token:
|
||||
headers["Authorization"] = f"Bearer {self._token}"
|
||||
# 第三十轮: 这里的会话头**故意**保持每请求随机,不是漏改。
|
||||
# 媒体端点(图像/视频)是一次性任务,没有"同一会话复读同一大前缀"的场景,
|
||||
# 也就没有前缀缓存可吃;反过来,若给它一个跨请求固定的会话,反而会让上游把
|
||||
# 互不相关的图片/视频任务记到同一个会话名下,污染那边的会话视图。
|
||||
# 注意当前配了媒体能力的供应商都不是 opencode(opencode 无 media),这行实际走不到。
|
||||
if self._requires_session:
|
||||
headers["x-opencode-session"] = uuid.uuid4().hex
|
||||
return headers
|
||||
|
||||
+60
-14
@@ -54,6 +54,7 @@ from app.sessions import SessionStore
|
||||
from app.users import UsersStore, UserError, key_limit_for_role
|
||||
from app.history import HistoryStore, HistoryError, MAX_ITEMS as HISTORY_CAP
|
||||
from app.feedback import FeedbackStore, FeedbackError, MAX_ENTRIES as FEEDBACK_CAP
|
||||
from app.video_owners import VideoOwnerStore
|
||||
from app import settings as gw_settings
|
||||
|
||||
# 功能 8: 读取 .env(若存在),补充 token 等环境变量。
|
||||
@@ -105,6 +106,12 @@ _FEEDBACK_PATH = Path(os.environ.get("GATEWAY_FEEDBACK", str(_PROJECT_ROOT / "da
|
||||
_FEEDBACK_MEDIA = Path(os.environ.get("GATEWAY_FEEDBACK_MEDIA", str(_PROJECT_ROOT / "data" / "feedback_media")))
|
||||
_feedback = FeedbackStore(str(_FEEDBACK_PATH), str(_FEEDBACK_MEDIA))
|
||||
|
||||
# ── 视频任务归属(第三十轮) ──
|
||||
# 轮询端点 GET /v1/videos/{video_id} 原先不判归属(任何登录账号拿到 id 就能读别人任务)。
|
||||
# 现在创建成功时记一条 id→账号,轮询按它判;无记录的旧任务放行(见 app/video_owners.py 头部口径)。
|
||||
_OWNERS_PATH = Path(os.environ.get("GATEWAY_VIDEO_OWNERS", str(_PROJECT_ROOT / "data" / "video_owners.json")))
|
||||
_owners = VideoOwnerStore(str(_OWNERS_PATH))
|
||||
|
||||
# 请求级账号上下文(ContextVar 每 task 独立,异步并发安全;定义在 app/metrics.py,
|
||||
# 供访问日志/指标标记「归属账号」,从而实现所有人(含 admin)只看自己的调用日志;
|
||||
# admin 若要审计别人的活动,走用户管理页的 admin 专属端点 /auth/users/{name}/(logs|history/*))
|
||||
@@ -303,7 +310,7 @@ VERSION = "2.4.0"
|
||||
|
||||
app = FastAPI(
|
||||
title="API Gateway",
|
||||
description="统一多供应商 LLM 接入网关(Agnes / 火山方舟)",
|
||||
description="统一多供应商 LLM 接入网关(Agnes / 火山方舟 / OpenCode Go)",
|
||||
version=VERSION,
|
||||
lifespan=lifespan,
|
||||
default_response_class=UTF8JSONResponse,
|
||||
@@ -681,7 +688,11 @@ def _get_adapter(model_id: str, timeout: int | None = None, cfg: GatewayConfig |
|
||||
|
||||
# ── 鉴权 + 限流(全局 / 供应商级;路由级限流随路由功能一并移除) ──
|
||||
_bearer = HTTPBearer(auto_error=False)
|
||||
_sess = SessionStore() # 前端登录会话(/auth/login 换取 sess- token,见 app/sessions.py)
|
||||
# 前端登录会话(/auth/login 换取 sess- token,见 app/sessions.py)。
|
||||
# 第三十轮起落盘到 data/sessions.json(只存 token 的 sha256)→ 网关重启不再把所有人踢下线;
|
||||
# 测试用 GATEWAY_SESSIONS 指到独立文件,避免污染真实会话。
|
||||
_SESSIONS_PATH = Path(os.environ.get("GATEWAY_SESSIONS", str(_PROJECT_ROOT / "data" / "sessions.json")))
|
||||
_sess = SessionStore(path=_SESSIONS_PATH)
|
||||
|
||||
|
||||
def _effective_rps(cfg, pkey: str | None) -> float | None:
|
||||
@@ -1567,6 +1578,11 @@ async def models_speedtest(request: Request, _auth=Depends(require_auth)):
|
||||
try:
|
||||
# 直传原语:入站 body 原样上去、上游响应原样回来。探针只关心"通不通",
|
||||
# 所以不解析响应体,只看状态码(4xx/5xx 都算失败并带上游原文)。
|
||||
#
|
||||
# 第三十轮(注明有意,不是漏改):这里**故意不传 session_id** —— 探针要量的是
|
||||
# "这个模型现在真实响不响应、要多久",若复用真实对话用的固定会话值,
|
||||
# 上游前缀缓存会把结果拉成假快(命中缓存 → 延迟低得不像真调用),
|
||||
# 测速就失去意义。所以适配器回退到每请求随机值(对 opencode 即每次一个新会话)。
|
||||
status, data = await adapter.raw_json(protocol, _probe_payload(protocol, m["id"]))
|
||||
if 200 <= status < 300:
|
||||
ok = True
|
||||
@@ -2230,6 +2246,10 @@ async def videos_create(request: Request, req: VideoCreateRequestExtended, _auth
|
||||
mode=req.mode, aspect_ratio=req.aspect_ratio, size=req.size, extra=extra or None,
|
||||
)
|
||||
video_id = result.get("video_id")
|
||||
# 第三十轮: 登记视频归属 —— 轮询端点据此判权(见 app/video_owners.py 顶部的口径说明)。
|
||||
# 放在这里是因为这是"已知归属"的唯一时刻:上游刚把 video_id 交给我们,且 caller 明确。
|
||||
if video_id:
|
||||
await _offload(_owners.record, video_id, request.state.account, pkey)
|
||||
cb.record(True)
|
||||
_metrics.record_call(real_model, pkey, ok=True)
|
||||
_metrics.record_latency(real_model, time.time() - t0)
|
||||
@@ -2315,7 +2335,13 @@ async def videos_poll(request: Request, video_id: str, model: str = "", wait: bo
|
||||
cfg = _cfg()
|
||||
rid = getattr(request.state, "rid", "-")
|
||||
# 说明:轮询端点不再往 /logs 记访问行(第十轮起改为按 video_id 累积到「创建」那条),
|
||||
# 故这里不取 caller。
|
||||
# 故这里不取 caller 做日志归属。
|
||||
# 第三十轮: 但**归属校验**必须有 —— 此前任何登录账号拿到 video_id 就能读走别人视频的
|
||||
# 状态与产物 URL。创建时登记过归属的按登记判;无登记(本次改动前的老任务)放行,
|
||||
# 用 404 而不是 403 回绝,避免把 id 变成"存在性探针"。口径见 app/video_owners.py。
|
||||
if not await _offload(_owners.allows, video_id, request.state.account,
|
||||
request.state.role == "admin"):
|
||||
raise HTTPException(404, f"视频任务不存在: {_logsafe(video_id)}")
|
||||
|
||||
# 本轮重写:供应商定位不再"盲猜"。
|
||||
# 视频任务 ID 是**供应商私有**的,查错供应商必然 404/502,且静默误导。
|
||||
@@ -2801,8 +2827,11 @@ async def root(request: Request, _auth=Depends(require_auth_or_open)):
|
||||
"models": "GET /models 或 GET /v1/models",
|
||||
"metrics": "GET /metrics(JSON)/ GET /metrics/prometheus",
|
||||
"logs": "GET /logs?n=100",
|
||||
"health": "GET /health(运维看板)/ GET /health/{provider}",
|
||||
"docs": "GET /docs(Swagger UI)",
|
||||
"health": 'GET /health(运维看板;health_auth=false 时匿名只回 {"status":"ok"})'
|
||||
" / GET /health/{provider}(**始终需鉴权**)",
|
||||
# 第三十轮: /docs 只在 docs_enabled 打开时才存在(关掉时路由就没注册)——
|
||||
# 导航里还列着它,照着敲会吃 404。这里跟真实路由表对齐:关了就整条不列。
|
||||
**({"docs": "GET /docs(Swagger UI)"} if _docs_on else {}),
|
||||
},
|
||||
"providers": list(cfg.providers.keys()),
|
||||
}
|
||||
@@ -3046,7 +3075,8 @@ async def auth_user_history(username: str, kind: str, request: Request,
|
||||
kind = HistoryStore._check_kind(kind)
|
||||
except HistoryError as e:
|
||||
raise HTTPException(400, str(e))
|
||||
return {"account": username, "kind": kind, "items": _history.get(username, kind)}
|
||||
return {"account": username, "kind": kind,
|
||||
"items": await _offload(_history.get, username, kind)}
|
||||
|
||||
|
||||
def _require_session(request: Request) -> str:
|
||||
@@ -3102,8 +3132,11 @@ async def auth_delete_apikey(keyhint: str, request: Request, _auth=Depends(requi
|
||||
# 两台设备各生成一条也不会互相覆盖。读接口允许会话或 API Key;写接口只认会话。
|
||||
@app.get("/history/{kind}")
|
||||
async def history_list(request: Request, kind: str, _auth=Depends(require_auth)):
|
||||
# 第三十轮(性能): 历史落盘/读取整体挪到线程池 —— HistoryStore 每次都是**整份**读写
|
||||
# (上限 4MB),同步跑在 async handler 里会把事件循环按住,所有并发请求一起等。
|
||||
# users/feedback/config 早就走 _offload 了,这里此前是唯一漏网的。
|
||||
try:
|
||||
items = _history.get(request.state.account, kind)
|
||||
items = await _offload(_history.get, request.state.account, kind)
|
||||
except HistoryError as e:
|
||||
raise HTTPException(400, str(e))
|
||||
return {"kind": kind, "items": items, "cap": HISTORY_CAP}
|
||||
@@ -3122,7 +3155,7 @@ async def history_save(request: Request, kind: str, _auth=Depends(require_auth))
|
||||
if not isinstance(items, list):
|
||||
raise HTTPException(400, "items 必须是数组")
|
||||
try:
|
||||
merged = _history.upsert(request.state.account, kind, items)
|
||||
merged = await _offload(_history.upsert, request.state.account, kind, items)
|
||||
except HistoryError as e:
|
||||
raise HTTPException(400, str(e))
|
||||
return {"status": "ok", "count": len(merged), "cap": HISTORY_CAP}
|
||||
@@ -3132,7 +3165,7 @@ async def history_save(request: Request, kind: str, _auth=Depends(require_auth))
|
||||
async def history_clear(request: Request, kind: str, _auth=Depends(require_auth)):
|
||||
_require_session(request)
|
||||
try:
|
||||
n = _history.clear(request.state.account, kind)
|
||||
n = await _offload(_history.clear, request.state.account, kind)
|
||||
except HistoryError as e:
|
||||
raise HTTPException(400, str(e))
|
||||
return {"status": "ok", "cleared": n}
|
||||
@@ -3142,7 +3175,7 @@ async def history_clear(request: Request, kind: str, _auth=Depends(require_auth)
|
||||
async def history_delete_one(request: Request, kind: str, item_id: str, _auth=Depends(require_auth)):
|
||||
_require_session(request)
|
||||
try:
|
||||
ok = _history.delete_item(request.state.account, kind, item_id)
|
||||
ok = await _offload(_history.delete_item, request.state.account, kind, item_id)
|
||||
except HistoryError as e:
|
||||
raise HTTPException(400, str(e))
|
||||
if not ok:
|
||||
@@ -3259,7 +3292,9 @@ async def feedback_media(request: Request, fid: str, idx: int, _auth=Depends(req
|
||||
|
||||
# ── API Key 环境变量(data/.env)读取/写入(网关配置页「环境变量」卡)────────
|
||||
def _env_file() -> Path:
|
||||
return _PROJECT_ROOT / "data" / ".env"
|
||||
# 第三十轮: 路径可被 GATEWAY_ENV_FILE 覆盖 —— 与 users/history/feedback 同一套路,
|
||||
# 否则测试一旦覆盖到写路径就会**直接改掉生产 data/.env**(这是本轮补测试时发现的隐患)。
|
||||
return Path(os.environ.get("GATEWAY_ENV_FILE", str(_PROJECT_ROOT / "data" / ".env")))
|
||||
|
||||
def _env_snapshot() -> dict[str, dict]:
|
||||
"""当前用 token_env 的供应商 → 环境变量名 + 是否配置 + 运行时值(以 os.environ 为准)。"""
|
||||
@@ -3331,7 +3366,14 @@ async def config_env_post(request: Request, _auth=Depends(require_auth)):
|
||||
continue
|
||||
if name not in allowed:
|
||||
raise HTTPException(400, f"环境变量 {name} 未被任何供应商用作 API Key")
|
||||
updates[name] = v if isinstance(v, str) else ""
|
||||
val = v if isinstance(v, str) else ""
|
||||
# 第三十轮: 值必须先校验再落盘。写入是**逐行重建 .env**,一个带 \n 的值
|
||||
# (页面上粘贴多了个换行、或刻意构造)就能在文件里**凭空多出几行**,
|
||||
# 把同一份 .env 里的其它变量改掉/加进去;值里的换行同时会让"一行一变量"的文件
|
||||
# 在下次读取时被截断成错误的值。Key 也不该有控制字符与超长内容。
|
||||
if any(c in val for c in ("\n", "\r", "\x00")) or len(val) > 4096:
|
||||
raise HTTPException(400, f"环境变量 {name} 的值非法(不得含换行/控制字符,长度 ≤4096)")
|
||||
updates[name] = val
|
||||
if updates:
|
||||
await _offload(_write_env_values, updates)
|
||||
return {"status": "ok", "applied": len(updates), "envs": _env_snapshot()}
|
||||
@@ -3487,8 +3529,12 @@ async def health(request: Request, _auth=Depends(require_auth_or_open)):
|
||||
@app.get("/health/{provider_key}")
|
||||
async def provider_health(request: Request, provider_key: str, _auth=Depends(require_auth)):
|
||||
# 第六轮安全审计: 本端点会用**网关持有的上游 Key** 去 GET {base_url}/models,
|
||||
# 等同于"未授权者借网关的凭证触发上游请求并读回结果"。故与 /health 同受
|
||||
# health_auth 保护(此前它已经是 require_auth_or_open,这里补注释说明必要性)。
|
||||
# 等同于"未授权者借网关的凭证触发上游请求并读回结果"。
|
||||
# 第三十轮更正: 上面这行的注释此前写着"与 /health 同受 health_auth 保护(此前它已经是
|
||||
# require_auth_or_open)"—— 与代码不符:**它用的是 require_auth,恒定要鉴权**,
|
||||
# 并不随 health_auth 放宽。这个"更严"的行为是刻意的(理由就是上一段:它会花掉上游额度),
|
||||
# 所以保留代码、把注释改对:**本端点不受 health_auth 影响,永远需要凭证**;
|
||||
# 想让探活工具不带头也能用,用 /healthz 或 GET /health(匿名只回 {"status":"ok"})。
|
||||
cfg = _cfg()
|
||||
if provider_key not in cfg.providers:
|
||||
raise HTTPException(404, f"未知供应商: {provider_key}")
|
||||
|
||||
+99
-12
@@ -1,28 +1,99 @@
|
||||
"""前端登录会话(短时、内存态)。
|
||||
"""前端登录会话(短时;可落盘,默认内存)。
|
||||
|
||||
设计:前端用**账号 + 密码**调 POST /auth/login 换一个 short-lived 的 `sess-` token,
|
||||
后续请求带这个会话 token —— 密码只在登录那一刻提交一次,前端不长期持有;
|
||||
API Key 也不需要交给浏览器。会话存内存,单实例必需;
|
||||
多实例如需共享会话再换 Redis(当前网关单实例,足够)。
|
||||
API Key 也不需要交给浏览器。
|
||||
|
||||
吊销语义(第八轮审计补):账号被删除、改密或被管理员重置密码时,其名下**全部会话**
|
||||
立即失效 —— 否则「删号 / 重置密码」无法止损(旧 token 仍能调用到 TTL 结束)。
|
||||
|
||||
落盘(第三十轮补):此前是纯内存,进程一重启**所有人被踢下线**(每次上线/改配置都掉线,
|
||||
运维体感很差,也逼着"为了不掉线而不重启")。现在可选落盘 `data/sessions.json`:
|
||||
|
||||
· **盘上只存 token 的 sha256**(`_fp()`),不存 token 本身 —— 备份/误传该文件也无法
|
||||
直接拿来冒充登录;代价是吊销/校验都要现算一次哈希(可忽略)。
|
||||
· 原子写(临时文件 + os.replace)+ 权限 600;写失败只告警、不抛 —— 落盘是"少掉线一次"
|
||||
的体验优化,不能让它把登录本身弄挂(真失败就退化成原来的纯内存行为)。
|
||||
· 载入时直接丢掉已过期的会话(TTL 判定与运行期一致)。
|
||||
· 仍不解决**多实例共享**(要共享还是得换 Redis);当前网关单实例,够用。
|
||||
|
||||
path=None(默认)→ 纯内存,测试与库内直连构造维持原语义。
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import hashlib
|
||||
import json
|
||||
import logging
|
||||
import os
|
||||
import secrets
|
||||
import threading
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
log = logging.getLogger("api-gateway.sessions")
|
||||
|
||||
# 落盘文件名固定为 sessions.json;结构带 version,便于以后改格式时兼容读取。
|
||||
_FILE_VERSION = 1
|
||||
|
||||
|
||||
def _fp(token: str) -> str:
|
||||
"""token → 落盘用的指纹(sha256)。盘上永远不出现可直接使用的凭证。"""
|
||||
return hashlib.sha256(("sess:" + token).encode("utf-8")).hexdigest()
|
||||
|
||||
|
||||
class SessionStore:
|
||||
def __init__(self, ttl_seconds: int = 86400, max_tokens: int = 5000):
|
||||
def __init__(self, ttl_seconds: int = 86400, max_tokens: int = 5000,
|
||||
path: str | os.PathLike | None = None):
|
||||
self._ttl = ttl_seconds
|
||||
self._max = max_tokens
|
||||
self._path = Path(path) if path else None
|
||||
self._s: dict[str, dict] = {}
|
||||
self._lock = threading.Lock()
|
||||
self._load()
|
||||
|
||||
# ── 落盘 ─────────────────────────────────────────
|
||||
def _load(self) -> None:
|
||||
"""启动时载入;已过期的直接丢弃(不留到运行期再清)。"""
|
||||
if self._path is None or not self._path.exists():
|
||||
return
|
||||
try:
|
||||
raw = json.loads(self._path.read_text(encoding="utf-8"))
|
||||
entries = raw.get("sessions") if isinstance(raw, dict) else None
|
||||
except Exception as e: # 文件损坏/被手工改坏 → 当没有,别拦启动
|
||||
log.warning("会话文件读取失败(按空会话启动):%s", e)
|
||||
return
|
||||
now = time.time()
|
||||
kept = dropped = 0
|
||||
for k, v in (entries or {}).items():
|
||||
if not isinstance(v, dict):
|
||||
continue
|
||||
created = v.get("created")
|
||||
if not isinstance(created, (int, float)) or now - created > self._ttl:
|
||||
dropped += 1
|
||||
continue
|
||||
self._s[str(k)] = {"created": float(created), "ip": str(v.get("ip") or ""),
|
||||
"account": str(v.get("account") or "")}
|
||||
kept += 1
|
||||
if kept or dropped:
|
||||
log.info("已载入 %d 个会话(丢弃过期 %d 个)", kept, dropped)
|
||||
|
||||
def _save(self) -> None:
|
||||
"""整体重写(会话量小:上限 max_tokens 条)。写失败只告警。"""
|
||||
if self._path is None:
|
||||
return
|
||||
try:
|
||||
self._path.parent.mkdir(parents=True, exist_ok=True)
|
||||
text = json.dumps({"version": _FILE_VERSION, "sessions": self._s},
|
||||
ensure_ascii=False, separators=(",", ":"))
|
||||
tmp = self._path.with_name(self._path.name + ".tmp")
|
||||
tmp.write_text(text, encoding="utf-8")
|
||||
os.chmod(tmp, 0o600)
|
||||
os.replace(tmp, self._path)
|
||||
except Exception as e:
|
||||
log.warning("会话落盘失败(本次改动只在内存生效):%s", e)
|
||||
|
||||
# ── 基本属性 ─────────────────────────────────────
|
||||
def ttl(self) -> int:
|
||||
return self._ttl
|
||||
|
||||
@@ -32,9 +103,13 @@ class SessionStore:
|
||||
|
||||
def count(self) -> int:
|
||||
with self._lock:
|
||||
self._purge()
|
||||
return len(self._s)
|
||||
changed = self._purge()
|
||||
n = len(self._s)
|
||||
if changed:
|
||||
self._save()
|
||||
return n
|
||||
|
||||
# ── 增删查改 ─────────────────────────────────────
|
||||
def create(self, ip: str, account: str = "") -> str:
|
||||
with self._lock:
|
||||
self._purge()
|
||||
@@ -43,18 +118,20 @@ class SessionStore:
|
||||
del self._s[oldest]
|
||||
tok = "sess-" + secrets.token_hex(24)
|
||||
# ip 只做记录、不做绑定:移动网络/NAT 下换出口 IP 是常态,绑定会把人踢下线。
|
||||
self._s[tok] = {"created": time.time(), "ip": ip or "", "account": account or ""}
|
||||
self._s[_fp(tok)] = {"created": time.time(), "ip": ip or "", "account": account or ""}
|
||||
self._save()
|
||||
return tok
|
||||
|
||||
def validate(self, token: str, ip: str | None = None) -> bool:
|
||||
if not token:
|
||||
return False
|
||||
with self._lock:
|
||||
ent = self._s.get(token)
|
||||
ent = self._s.get(_fp(token))
|
||||
if not ent:
|
||||
return False
|
||||
if time.time() - ent["created"] > self._ttl:
|
||||
del self._s[token]
|
||||
del self._s[_fp(token)]
|
||||
self._save()
|
||||
return False
|
||||
return True
|
||||
|
||||
@@ -63,7 +140,7 @@ class SessionStore:
|
||||
if not token or not self.validate(token):
|
||||
return None
|
||||
with self._lock:
|
||||
ent = self._s.get(token)
|
||||
ent = self._s.get(_fp(token))
|
||||
return (ent or {}).get("account")
|
||||
|
||||
def is_session(self, token: str) -> bool:
|
||||
@@ -76,7 +153,8 @@ class SessionStore:
|
||||
|
||||
def revoke(self, token: str) -> None:
|
||||
with self._lock:
|
||||
self._s.pop(token, None)
|
||||
if self._s.pop(_fp(token), None) is not None:
|
||||
self._save()
|
||||
|
||||
def revoke_account(self, account: str) -> int:
|
||||
"""吊销某账号的全部会话,返回被踢掉的会话数(改密/重置密码/删号时调用)。"""
|
||||
@@ -86,14 +164,23 @@ class SessionStore:
|
||||
dead = [k for k, v in self._s.items() if v.get("account") == account]
|
||||
for k in dead:
|
||||
del self._s[k]
|
||||
if dead:
|
||||
self._save()
|
||||
return len(dead)
|
||||
|
||||
def clear(self) -> None:
|
||||
with self._lock:
|
||||
had = bool(self._s)
|
||||
self._s.clear()
|
||||
if had:
|
||||
self._save()
|
||||
|
||||
def _purge(self) -> None:
|
||||
def _purge(self) -> bool:
|
||||
"""清过期会话;返回是否有改动(有才值得落盘)。"""
|
||||
now = time.time()
|
||||
changed = False
|
||||
for k in list(self._s):
|
||||
if now - self._s[k]["created"] > self._ttl:
|
||||
del self._s[k]
|
||||
changed = True
|
||||
return changed
|
||||
@@ -506,6 +506,13 @@ def write_config(path: str | Path, text: str) -> dict[str, Any]:
|
||||
if path.exists():
|
||||
shutil.copy2(path, bak_path)
|
||||
shutil.copy2(path, stamp_path)
|
||||
# 第三十轮: copy2 是**照抄源文件权限**,源文件若是历史遗留的 644,备份也就 644。
|
||||
# 备份里同样可能有明文 token(正常应走 token_env),所以显式再钉一次 600。
|
||||
for p in (bak_path, stamp_path):
|
||||
try:
|
||||
os.chmod(p, 0o600)
|
||||
except OSError:
|
||||
pass
|
||||
_prune_backups(path)
|
||||
tmp = path.with_name(path.name + ".tmp")
|
||||
tmp.write_text(text, encoding="utf-8")
|
||||
|
||||
+4
-1
@@ -37,7 +37,10 @@ KEY_PREFIX = "wjd-" # 新建 API Key 的统一前缀(与对外品牌一
|
||||
LEGACY_KEY_PREFIXES: tuple[str, ...] = ("ak-",)
|
||||
_KEY_PREFIXES: tuple[str, ...] = (KEY_PREFIX,) + LEGACY_KEY_PREFIXES
|
||||
KEY_BYTES = 28 # token_urlsafe(28) ≈ 38 chars → 整把 key 42 字符
|
||||
MIN_PASSWORD = 4 # 显式设置/修改的密码下限(默认密码=账号名不受此限,按老板约定)
|
||||
MIN_PASSWORD = 8 # 显式设置/修改的密码下限(默认密码=账号名不受此限,按老板约定)
|
||||
# 第三十轮把下限从 4 提到 8:4 位口令在可离线爆破的空间里(1 万种)几乎等于没设。
|
||||
# 只对**新建时显式给密码 / 事后改密**生效 —— 登录校验不做长度判断,
|
||||
# 所以既有短口令账号(如 test)照常登录,只是不能再被改回短口令。
|
||||
MAX_KEYS_PER_MEMBER = 3 # 普通账号每人最多 3 把 API Key(防失控膨胀 / 泄漏后无限铸 Key)
|
||||
|
||||
|
||||
|
||||
@@ -0,0 +1,129 @@
|
||||
"""视频任务归属(第三十轮新增)。
|
||||
|
||||
**为什么需要**:`GET /v1/videos/{video_id}` 原先不做归属判断(第十轮的口径是"轮询端点不记
|
||||
访问行,故不取 caller")。结果是:任何**已登录账号**只要拿到 video_id,就能读到别人视频任务
|
||||
的状态与产物 URL。视频 id 是供应商私有的随机串、猜不到,但与 `/logs`、`/metrics`、`/history`
|
||||
那套「按账号隔离」的口径不一致 —— 一个账号能看到的、另一个账号也能看到的资源,就不该靠"猜不到"当防线。
|
||||
|
||||
**怎么做**:创建视频成功那一刻(`POST /v1/videos` 拿到上游 `video_id`)记一条
|
||||
`video_id → 账号`,轮询时按它判归属。
|
||||
|
||||
**口径(刻意选择)**:
|
||||
· 管理员放行一切(管理员本来就该能排障;且 admin 的历史/日志本就不隔离)。
|
||||
· 记录里**有**这个 id 且不是请求者 → 404「视频任务不存在」。用 404 而不是 403:
|
||||
403 等于确认"这个 id 存在",会把 id 变成可探测的。
|
||||
· 记录里**没有**这个 id(本次改动之前创建的视频、落盘文件丢失、超 TTL 被清)→ **放行**。
|
||||
这是刻意的渐进收紧:宁可对老任务宽松,也不要让正常流程在部署当天突然 404。
|
||||
新创建的任务一律有记录,所以保护是即时生效的。
|
||||
|
||||
**存储**:`data/video_owners.json`(600,原子写)。量小(只存 id/账号/时间),
|
||||
按 TTL(默认 7 天)与条数上限滚动清理 —— 视频产物本身也不会在历史里留太久。
|
||||
path=None → 纯内存(测试/库内直连构造用)。
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import logging
|
||||
import os
|
||||
import threading
|
||||
import time
|
||||
from pathlib import Path
|
||||
|
||||
log = logging.getLogger("api-gateway.video_owners")
|
||||
|
||||
_FILE_VERSION = 1
|
||||
|
||||
|
||||
class VideoOwnerStore:
|
||||
def __init__(self, path: str | os.PathLike | None = None,
|
||||
ttl_seconds: int = 7 * 86400, max_items: int = 2000):
|
||||
self._path = Path(path) if path else None
|
||||
self._ttl = int(ttl_seconds)
|
||||
self._max = int(max_items)
|
||||
self._m: dict[str, dict] = {}
|
||||
self._lock = threading.Lock()
|
||||
self._load()
|
||||
|
||||
# ── 落盘 ─────────────────────────────────────────
|
||||
def _load(self) -> None:
|
||||
if self._path is None or not self._path.exists():
|
||||
return
|
||||
try:
|
||||
raw = json.loads(self._path.read_text(encoding="utf-8"))
|
||||
items = raw.get("videos") if isinstance(raw, dict) else None
|
||||
except Exception as e:
|
||||
log.warning("视频归属文件读取失败(按空表启动):%s", e)
|
||||
return
|
||||
now = time.time()
|
||||
for k, v in (items or {}).items():
|
||||
if not isinstance(v, dict):
|
||||
continue
|
||||
created = v.get("created")
|
||||
if not isinstance(created, (int, float)) or now - created > self._ttl:
|
||||
continue
|
||||
self._m[str(k)] = {"account": str(v.get("account") or ""),
|
||||
"provider": str(v.get("provider") or ""),
|
||||
"created": float(created)}
|
||||
if self._m:
|
||||
log.info("已载入 %d 条视频归属记录", len(self._m))
|
||||
|
||||
def _save(self) -> None:
|
||||
if self._path is None:
|
||||
return
|
||||
try:
|
||||
self._path.parent.mkdir(parents=True, exist_ok=True)
|
||||
text = json.dumps({"version": _FILE_VERSION, "videos": self._m},
|
||||
ensure_ascii=False, separators=(",", ":"))
|
||||
tmp = self._path.with_name(self._path.name + ".tmp")
|
||||
tmp.write_text(text, encoding="utf-8")
|
||||
os.chmod(tmp, 0o600)
|
||||
os.replace(tmp, self._path)
|
||||
except Exception as e:
|
||||
# 落盘失败只影响"重启后还认不认归属"(会退化成放行),不该让创建视频这条主链路失败。
|
||||
log.warning("视频归属落盘失败:%s", e)
|
||||
|
||||
# ── 读写 ─────────────────────────────────────────
|
||||
def record(self, video_id: str, account: str, provider: str = "") -> None:
|
||||
"""创建视频成功后登记归属。video_id 为空则忽略(上游没回 id 时不记脏数据)。"""
|
||||
if not video_id:
|
||||
return
|
||||
with self._lock:
|
||||
now = time.time()
|
||||
self._m[video_id] = {"account": account or "", "provider": provider or "",
|
||||
"created": now}
|
||||
self._prune(now)
|
||||
self._save()
|
||||
|
||||
def owner(self, video_id: str) -> str | None:
|
||||
"""返回登记归属;没有记录返回 None(≠"不属于任何人",见模块头部的口径)。"""
|
||||
if not video_id:
|
||||
return None
|
||||
with self._lock:
|
||||
ent = self._m.get(video_id)
|
||||
if not ent:
|
||||
return None
|
||||
if time.time() - ent["created"] > self._ttl:
|
||||
del self._m[video_id]
|
||||
self._save()
|
||||
return None
|
||||
return ent.get("account") or None
|
||||
|
||||
def allows(self, video_id: str, account: str, is_admin: bool = False) -> bool:
|
||||
"""该账号能否访问这个视频任务。无记录 → 放行(渐进收紧,见模块头部)。"""
|
||||
if is_admin:
|
||||
return True
|
||||
who = self.owner(video_id)
|
||||
return who is None or who == (account or "")
|
||||
|
||||
def count(self) -> int:
|
||||
with self._lock:
|
||||
self._prune(time.time())
|
||||
return len(self._m)
|
||||
|
||||
def _prune(self, now: float) -> None:
|
||||
for k in [k for k, v in self._m.items() if now - v["created"] > self._ttl]:
|
||||
del self._m[k]
|
||||
while len(self._m) > self._max: # 超上限:先清最老的
|
||||
oldest = min(self._m, key=lambda k: self._m[k]["created"])
|
||||
del self._m[oldest]
|
||||
+5
-1
@@ -292,8 +292,12 @@ pricing:
|
||||
# 允许被代下载,且解析出来的 IP 必须是公网地址;列表为空 = 该功能整体关闭。
|
||||
# 换了供应商/换了 CDN 域名时,往这里加一条即可(如 volc 的 tos-*.volces.com)。
|
||||
download:
|
||||
# 维护提醒(第三十轮):这张表是**下载代理的出网白名单** —— /v1/media/download 只肯代抓这里列出的域名。
|
||||
# 供应商换 CDN、或同一供应商多套存储(普通版 / 水印版)时,**漏加就会让「下载」按钮 400**
|
||||
# (报「该地址不在允许下载的域名白名单内」)。新增前先确认域名确实属于该供应商的产物存储。
|
||||
allowed_hosts:
|
||||
- "cos-platform-outputs.agnes-ai.cn" # Agnes 图像/视频产物 CDN
|
||||
- "cos-platform-outputs.agnes-ai.cn" # Agnes 图像/视频产物 CDN(普通版)
|
||||
- "maas-watermark-prod-new.cn-wlcb.ufileos.com" # Agnes 水印版产物 CDN(UCloud ufileos)
|
||||
max_bytes: 67108864 # 单文件上限 64MB
|
||||
|
||||
# ── 网关入口鉴权 ─────────────────────────────────────
|
||||
|
||||
@@ -1,152 +0,0 @@
|
||||
# AI 网关配置文件(data/ 目录)
|
||||
# 供应商:Agnes / b.ai / 火山方舟 Coding
|
||||
# 密钥统一走 token_env 指向的环境变量(本机见 .env),不再在 yaml 存明文
|
||||
# 端口默认 8808
|
||||
#
|
||||
# 说明:本文件是项目的**唯一配置文件**(run.py 默认读取;GATEWAY_CONFIG 可覆盖)。
|
||||
|
||||
providers:
|
||||
agnes:
|
||||
name: "Agnes AI"
|
||||
base_url: "https://api.agnes-ai.cn/v1"
|
||||
auth:
|
||||
token_env: "AGNES_API_KEY"
|
||||
extra_headers: {}
|
||||
# 图像 / 视频端点(Agnes 非标准,走自有路径)
|
||||
media:
|
||||
image_endpoint: "/images/generations"
|
||||
image_default_size: "1K" # 图像默认档位(Agnes: 1K/2K/3K/4K)
|
||||
video_create_endpoint: "/videos"
|
||||
video_poll_base: "https://api.agnes-ai.cn"
|
||||
video_poll_path: "/agnesapi"
|
||||
video_model_name: "agnes-video-2.5-flash"
|
||||
models:
|
||||
- id: "agnes-3.0-flash"
|
||||
display_name: "Agnes 3.0 Flash"
|
||||
type: "text"
|
||||
# 第十三轮: Agnes 3.0 Flash 文档「输入模态:文本、图像 URL」→ 支持视觉(对话带图)。
|
||||
# 实测 data:image/png;base64,... 也能识别。带图请求走路由别名时会被排到链首。
|
||||
vision: true
|
||||
- id: "agnes-image-2.5-flash"
|
||||
display_name: "Agnes Image 2.5 Flash"
|
||||
type: "image"
|
||||
- id: "agnes-video-2.5-flash"
|
||||
display_name: "Agnes Video 2.5 Flash"
|
||||
type: "video"
|
||||
|
||||
b_ai:
|
||||
name: "b.ai"
|
||||
base_url: "https://api.b.ai/v1"
|
||||
auth:
|
||||
token_env: "B_AI_API_KEY"
|
||||
extra_headers: {}
|
||||
# b.ai 仅 OpenAI 兼容文本;图像/视频留空 = 不支持
|
||||
media: {}
|
||||
models:
|
||||
- id: "qwen3.8-flash"
|
||||
display_name: "b.ai qwen3.8-flash"
|
||||
type: "text"
|
||||
vision: true # 实测支持视觉(2026-09-15 红图探针→答"红色")
|
||||
- id: "mimo-v2.5"
|
||||
display_name: "b.ai mimo-v2.5"
|
||||
type: "text"
|
||||
- id: "hy3"
|
||||
display_name: "b.ai hy3"
|
||||
type: "text"
|
||||
|
||||
volc_engine:
|
||||
name: "火山方舟 Coding Plan"
|
||||
base_url: "https://ark.cn-beijing.volces.com/api/coding/v3"
|
||||
auth:
|
||||
token_env: "VOLC_API_KEY"
|
||||
extra_headers: {}
|
||||
media: {}
|
||||
models:
|
||||
- id: "ark-code-latest"
|
||||
display_name: "火山方舟 ark-code-latest"
|
||||
type: "text"
|
||||
|
||||
server:
|
||||
host: "127.0.0.1"
|
||||
port: 8808
|
||||
timeout: 120
|
||||
retry: 3 # 直接用模型 id(不走路由)时重试 3 次(含首次);路由别名用各自 route.retry(默认1)
|
||||
# ── 运维开关 ──
|
||||
health_auth: false # /health/* 是否也需鉴权(默认否,留给探活)
|
||||
hot_reload: true # 监听 gateway.yaml mtime 自动重载(改配置免重启)
|
||||
hot_reload_interval: 15 # 重载检查间隔(秒)
|
||||
metrics_enabled: true # 记录调用指标(/metrics)
|
||||
rate_limit_rps: null # 全局单 user QPS 上限(null=不限;供应商级用 provider.rate_limit_rps)
|
||||
max_body_size: 2000000 # 请求体字节上限(防 DDoS,约 2MB)
|
||||
cors_origins: ["*"] # CORS 允许来源(生产收紧为具体域名)
|
||||
graceful_shutdown: 30 # 优雅关闭等待在途请求的秒数
|
||||
# ── 防滥用 / 安全 ──
|
||||
batch_max_concurrency: 16 # /batch 并发上限(客户端 max_concurrency 会被钳到此值)
|
||||
batch_max_items: 64 # /batch 单次最大条目数(超出返回 400)
|
||||
webhook_allow_private: false # 视频 callback_url 是否允许指向内网/回环(SSRF 防护,默认禁)
|
||||
docs_enabled: false # FastAPI 文档(/docs、/openapi.json)是否开放(安全默认关)
|
||||
auth_fail_limit_per_min: 20 # 同一来源 IP 每分钟鉴权失败上限,超过 → 429(防暴力枚举)
|
||||
|
||||
# ── 供应商熔断(Circuit Breaker) ──────────────────────
|
||||
# 某供应商连续/滑动窗口失败达到 failure_threshold 就熔断 cooldown 秒,
|
||||
# 期间直接跳过(不再白等),让 fallback 快速切到健康供应商。
|
||||
circuit:
|
||||
enabled: true
|
||||
failure_threshold: 3 # 连续失败 3 次即熔断
|
||||
cooldown: 30 # 熔断持续 30 秒
|
||||
window: 10 # 滑动窗口
|
||||
|
||||
# ── 可观测性 ───────────────────────────────────────────
|
||||
observability:
|
||||
log_level: "INFO"
|
||||
log_json: false # true = 结构化 JSON 行日志(接 ELK/CloudWatch)
|
||||
access_log_maxlen: 500 # 访问日志环形缓冲长度
|
||||
|
||||
# ── 定价(用于 /v1 响应里估算成本,人民币/百万 token) ─
|
||||
# 不配则该模型 estimated_cost_cny 不返回(不影响调用)。
|
||||
pricing:
|
||||
per_model:
|
||||
agnes-3.0-flash: { input: 0.35, output: 1.00 }
|
||||
ark-code-latest: { input: 0.50, output: 2.00 }
|
||||
qwen3.8-flash: { input: 0.30, output: 0.60 }
|
||||
mimo-v2.5: { input: 0.30, output: 0.60 }
|
||||
hy3: { input: 0.30, output: 0.60 }
|
||||
|
||||
# ── 媒体下载代理白名单(第十七轮)────────────────────────
|
||||
# 生成的图片/视频挂在第三方 CDN 上且不带 CORS 头,浏览器里既 fetch 不到 blob、
|
||||
# 跨域 <a download> 也不生效(只会打开新标签页)。所以由网关代拉一次并加上
|
||||
# Content-Disposition: attachment,前端「下载」按钮才真的能存文件。
|
||||
# 安全:这是网关唯一一个服务端主动出网的接口 —— 只有这里列出的域名(含其子域)
|
||||
# 允许被代下载,且解析出来的 IP 必须是公网地址;列表为空 = 该功能整体关闭。
|
||||
# 换了供应商/换了 CDN 域名时,往这里加一条即可(如 volc 的 tos-*.volces.com)。
|
||||
download:
|
||||
allowed_hosts:
|
||||
- "cos-platform-outputs.agnes-ai.cn" # Agnes 图像/视频产物 CDN
|
||||
max_bytes: 67108864 # 单文件上限 64MB
|
||||
|
||||
# ── 网关入口鉴权 ─────────────────────────────────────
|
||||
# 账号与 API Key 全部由页面管理,存在 data/users.json(见 app/users.py):
|
||||
# 管理员在「用户管理」页建账号,各账号在「设置 → 我的 API Key」自助铸 Key。
|
||||
# 本文件里**不再有任何用户/密钥**,只有一个运维开关:
|
||||
# auth.session_ttl_minutes —— 网页登录签发的会话有效期(分钟,默认 1440 = 24h)
|
||||
# 第十八轮: 删掉了这里残留的旧 `auth.enabled/users/key` 死配置(含一把明文 wjd- Key)。
|
||||
# 那些键早已不再被 config.py 读取(只读 session_ttl_minutes),
|
||||
# 那把 Key 在 users.json 里也不存在 → 认不了任何入口,但会让"yaml 里没有明文凭证"的说法失真。
|
||||
auth:
|
||||
session_ttl_minutes: 1440
|
||||
|
||||
# ── 路由别名 + 按优先级 fallback ──────────────────────
|
||||
# model 填别名(如 wjd),按数组顺序逐个尝试:
|
||||
# 第 1 个失败/超时/重试耗尽 → 第 2 个 … 全失败才 502。
|
||||
# 每个路由可设 timeout(单模型超时秒)、retry(切下一个前该模型重试次数)。
|
||||
# 优先级从左到右(第一个最高)。已把全部 5 个文本模型配上。
|
||||
routes:
|
||||
wjd:
|
||||
timeout: 60 # 单模型 60s 没出结果就切下一个(避免 6×120s 挂死)
|
||||
retry: 1 # 每个模型只试 1 次,失败立即切下一个
|
||||
models:
|
||||
- "ark-code-latest" # 1) 火山方舟(最高优先级)
|
||||
- "agnes-3.0-flash" # 2) Agnes 兜底
|
||||
- "qwen3.8-flash" # 3) b.ai qwen 兜底
|
||||
- "mimo-v2.5" # 4) b.ai mimo 兜底
|
||||
- "hy3" # 5) b.ai hy3 兜底
|
||||
@@ -1,148 +0,0 @@
|
||||
# AI 网关配置文件(data/ 目录)
|
||||
# 供应商:Agnes / b.ai / 火山方舟 Coding
|
||||
# 密钥统一走 token_env 指向的环境变量(本机见 .env),不再在 yaml 存明文
|
||||
# 端口默认 8808
|
||||
#
|
||||
# 说明:本文件是项目的**唯一配置文件**(run.py 默认读取;GATEWAY_CONFIG 可覆盖)。
|
||||
|
||||
providers:
|
||||
agnes:
|
||||
name: "Agnes AI"
|
||||
base_url: "https://api.agnes-ai.cn/v1"
|
||||
auth:
|
||||
token_env: "AGNES_API_KEY"
|
||||
extra_headers: {}
|
||||
# 图像 / 视频端点(Agnes 非标准,走自有路径)
|
||||
media:
|
||||
image_endpoint: "/images/generations"
|
||||
image_default_size: "1K" # 图像默认档位(Agnes: 1K/2K/3K/4K)
|
||||
video_create_endpoint: "/videos"
|
||||
video_poll_base: "https://api.agnes-ai.cn"
|
||||
video_poll_path: "/agnesapi"
|
||||
video_model_name: "agnes-video-2.5-flash"
|
||||
models:
|
||||
- id: "agnes-3.0-flash"
|
||||
display_name: "Agnes 3.0 Flash"
|
||||
type: "text"
|
||||
# 第十三轮: Agnes 3.0 Flash 文档「输入模态:文本、图像 URL」→ 支持视觉(对话带图)。
|
||||
# 实测 data:image/png;base64,... 也能识别。带图请求走路由别名时会被排到链首。
|
||||
vision: true
|
||||
- id: "agnes-image-2.5-flash"
|
||||
display_name: "Agnes Image 2.5 Flash"
|
||||
type: "image"
|
||||
- id: "agnes-video-2.5-flash"
|
||||
display_name: "Agnes Video 2.5 Flash"
|
||||
type: "video"
|
||||
|
||||
b_ai:
|
||||
name: "b.ai"
|
||||
base_url: "https://api.b.ai/v1"
|
||||
auth:
|
||||
token_env: "B_AI_API_KEY"
|
||||
extra_headers: {}
|
||||
# b.ai 仅 OpenAI 兼容文本;图像/视频留空 = 不支持
|
||||
media: {}
|
||||
models:
|
||||
- id: "qwen3.8-flash"
|
||||
display_name: "b.ai qwen3.8-flash"
|
||||
type: "text"
|
||||
vision: true # 实测支持视觉(2026-09-15 红图探针→答"红色")
|
||||
- id: "mimo-v2.5"
|
||||
display_name: "b.ai mimo-v2.5"
|
||||
type: "text"
|
||||
- id: "hy3"
|
||||
display_name: "b.ai hy3"
|
||||
type: "text"
|
||||
|
||||
volc_engine:
|
||||
name: "火山方舟 Coding Plan"
|
||||
base_url: "https://ark.cn-beijing.volces.com/api/coding/v3"
|
||||
auth:
|
||||
token_env: "VOLC_API_KEY"
|
||||
extra_headers: {}
|
||||
media: {}
|
||||
models:
|
||||
- id: "ark-code-latest"
|
||||
display_name: "火山方舟 ark-code-latest"
|
||||
type: "text"
|
||||
|
||||
server:
|
||||
host: "127.0.0.1"
|
||||
port: 8808
|
||||
timeout: 120
|
||||
retry: 3 # 直接用模型 id(不走路由)时重试 3 次(含首次);路由别名用各自 route.retry(默认1)
|
||||
# ── 运维开关 ──
|
||||
health_auth: false # /health/* 是否也需鉴权(默认否,留给探活)
|
||||
hot_reload: true # 监听 gateway.yaml mtime 自动重载(改配置免重启)
|
||||
hot_reload_interval: 15 # 重载检查间隔(秒)
|
||||
metrics_enabled: true # 记录调用指标(/metrics)
|
||||
rate_limit_rps: null # 全局单 user QPS 上限(null=不限;供应商级用 provider.rate_limit_rps)
|
||||
max_body_size: 2000000 # 请求体字节上限(防 DDoS,约 2MB)
|
||||
cors_origins: ["*"] # CORS 允许来源(生产收紧为具体域名)
|
||||
graceful_shutdown: 30 # 优雅关闭等待在途请求的秒数
|
||||
# ── 防滥用 / 安全 ──
|
||||
batch_max_concurrency: 16 # /batch 并发上限(客户端 max_concurrency 会被钳到此值)
|
||||
batch_max_items: 64 # /batch 单次最大条目数(超出返回 400)
|
||||
webhook_allow_private: false # 视频 callback_url 是否允许指向内网/回环(SSRF 防护,默认禁)
|
||||
docs_enabled: false # FastAPI 文档(/docs、/openapi.json)是否开放(安全默认关)
|
||||
auth_fail_limit_per_min: 20 # 同一来源 IP 每分钟鉴权失败上限,超过 → 429(防暴力枚举)
|
||||
|
||||
# ── 供应商熔断(Circuit Breaker) ──────────────────────
|
||||
# 某供应商连续/滑动窗口失败达到 failure_threshold 就熔断 cooldown 秒,
|
||||
# 期间直接跳过(不再白等),让 fallback 快速切到健康供应商。
|
||||
circuit:
|
||||
enabled: true
|
||||
failure_threshold: 3 # 连续失败 3 次即熔断
|
||||
cooldown: 30 # 熔断持续 30 秒
|
||||
window: 10 # 滑动窗口
|
||||
|
||||
# ── 可观测性 ───────────────────────────────────────────
|
||||
observability:
|
||||
log_level: "INFO"
|
||||
log_json: false # true = 结构化 JSON 行日志(接 ELK/CloudWatch)
|
||||
access_log_maxlen: 500 # 访问日志环形缓冲长度
|
||||
|
||||
# ── 定价(用于 /v1 响应里估算成本,人民币/百万 token) ─
|
||||
# 不配则该模型 estimated_cost_cny 不返回(不影响调用)。
|
||||
pricing:
|
||||
per_model:
|
||||
agnes-3.0-flash: { input: 0.35, output: 1.00 }
|
||||
ark-code-latest: { input: 0.50, output: 2.00 }
|
||||
qwen3.8-flash: { input: 0.30, output: 0.60 }
|
||||
mimo-v2.5: { input: 0.30, output: 0.60 }
|
||||
hy3: { input: 0.30, output: 0.60 }
|
||||
|
||||
# ── 媒体下载代理白名单(第十七轮)────────────────────────
|
||||
# 生成的图片/视频挂在第三方 CDN 上且不带 CORS 头,浏览器里既 fetch 不到 blob、
|
||||
# 跨域 <a download> 也不生效(只会打开新标签页)。所以由网关代拉一次并加上
|
||||
# Content-Disposition: attachment,前端「下载」按钮才真的能存文件。
|
||||
# 安全:这是网关唯一一个服务端主动出网的接口 —— 只有这里列出的域名(含其子域)
|
||||
# 允许被代下载,且解析出来的 IP 必须是公网地址;列表为空 = 该功能整体关闭。
|
||||
# 换了供应商/换了 CDN 域名时,往这里加一条即可(如 volc 的 tos-*.volces.com)。
|
||||
download:
|
||||
allowed_hosts:
|
||||
- "cos-platform-outputs.agnes-ai.cn" # Agnes 图像/视频产物 CDN
|
||||
max_bytes: 67108864 # 单文件上限 64MB
|
||||
|
||||
# ── 网关入口鉴权 ─────────────────────────────────────
|
||||
# 账号与 API Key 全部由页面管理,存在 data/users.json(见 app/users.py):
|
||||
# 管理员在「用户管理」页建账号,各账号在「设置 → 我的 API Key」自助铸 Key。
|
||||
# 本文件里**不再有任何用户/密钥**,只有一个运维开关:
|
||||
# auth.session_ttl_minutes —— 网页登录签发的会话有效期(分钟,默认 1440 = 24h)
|
||||
# 第十八轮: 删掉了这里残留的旧 `auth.enabled/users/key` 死配置(含一把明文 wjd- Key)。
|
||||
# 那些键早已不再被 config.py 读取(只读 session_ttl_minutes),
|
||||
# 那把 Key 在 users.json 里也不存在 → 认不了任何入口,但会让"yaml 里没有明文凭证"的说法失真。
|
||||
auth:
|
||||
session_ttl_minutes: 1440
|
||||
|
||||
# ── 路由别名 + 按优先级 fallback ──────────────────────
|
||||
# model 填别名(如 wjd),按数组顺序逐个尝试:
|
||||
# 第 1 个失败/超时/重试耗尽 → 第 2 个 … 全失败才 502。
|
||||
# 每个路由可设 timeout(单模型超时秒)、retry(切下一个前该模型重试次数)。
|
||||
# 优先级从左到右(第一个最高)。已把全部 5 个文本模型配上。
|
||||
routes:
|
||||
wjd:
|
||||
timeout: 60 # 单模型 60s 没出结果就切下一个(避免 6×120s 挂死)
|
||||
retry: 1 # 每个模型只试 1 次,失败立即切下一个
|
||||
models:
|
||||
- "ark-code-latest" # 1) 火山方舟(最高优先级)
|
||||
@@ -1,148 +0,0 @@
|
||||
# AI 网关配置文件(data/ 目录)
|
||||
# 供应商:Agnes / b.ai / 火山方舟 Coding
|
||||
# 密钥统一走 token_env 指向的环境变量(本机见 .env),不再在 yaml 存明文
|
||||
# 端口默认 8808
|
||||
#
|
||||
# 说明:本文件是项目的**唯一配置文件**(run.py 默认读取;GATEWAY_CONFIG 可覆盖)。
|
||||
|
||||
providers:
|
||||
agnes:
|
||||
name: "Agnes AI"
|
||||
base_url: "https://api.agnes-ai.cn/v1"
|
||||
auth:
|
||||
token_env: "AGNES_API_KEY"
|
||||
extra_headers: {}
|
||||
# 图像 / 视频端点(Agnes 非标准,走自有路径)
|
||||
media:
|
||||
image_endpoint: "/images/generations"
|
||||
image_default_size: "1K" # 图像默认档位(Agnes: 1K/2K/3K/4K)
|
||||
video_create_endpoint: "/videos"
|
||||
video_poll_base: "https://api.agnes-ai.cn"
|
||||
video_poll_path: "/agnesapi"
|
||||
video_model_name: "agnes-video-2.5-flash"
|
||||
models:
|
||||
- id: "agnes-3.0-flash"
|
||||
display_name: "Agnes 3.0 Flash"
|
||||
type: "text"
|
||||
# 第十三轮: Agnes 3.0 Flash 文档「输入模态:文本、图像 URL」→ 支持视觉(对话带图)。
|
||||
# 实测 data:image/png;base64,... 也能识别。带图请求走路由别名时会被排到链首。
|
||||
vision: true
|
||||
- id: "agnes-image-2.5-flash"
|
||||
display_name: "Agnes Image 2.5 Flash"
|
||||
type: "image"
|
||||
- id: "agnes-video-2.5-flash"
|
||||
display_name: "Agnes Video 2.5 Flash"
|
||||
type: "video"
|
||||
|
||||
b_ai:
|
||||
name: "b.ai"
|
||||
base_url: "https://api.b.ai/v1"
|
||||
auth:
|
||||
token_env: "B_AI_API_KEY"
|
||||
extra_headers: {}
|
||||
# b.ai 仅 OpenAI 兼容文本;图像/视频留空 = 不支持
|
||||
media: {}
|
||||
models:
|
||||
- id: "qwen3.8-flash"
|
||||
display_name: "b.ai qwen3.8-flash"
|
||||
type: "text"
|
||||
vision: true # 实测支持视觉(2026-09-15 红图探针→答"红色")
|
||||
- id: "mimo-v2.5"
|
||||
display_name: "b.ai mimo-v2.5"
|
||||
type: "text"
|
||||
- id: "hy3"
|
||||
display_name: "b.ai hy3"
|
||||
type: "text"
|
||||
|
||||
volc_engine:
|
||||
name: "火山方舟 Coding Plan"
|
||||
base_url: "https://ark.cn-beijing.volces.com/api/coding/v3"
|
||||
auth:
|
||||
token_env: "VOLC_API_KEY"
|
||||
extra_headers: {}
|
||||
media: {}
|
||||
models:
|
||||
- id: "ark-code-latest"
|
||||
display_name: "火山方舟 ark-code-latest"
|
||||
type: "text"
|
||||
|
||||
server:
|
||||
host: "127.0.0.1"
|
||||
port: 8808
|
||||
timeout: 120
|
||||
retry: 3 # 直接用模型 id(不走路由)时重试 3 次(含首次);路由别名用各自 route.retry(默认1)
|
||||
# ── 运维开关 ──
|
||||
health_auth: false # /health/* 是否也需鉴权(默认否,留给探活)
|
||||
hot_reload: true # 监听 gateway.yaml mtime 自动重载(改配置免重启)
|
||||
hot_reload_interval: 15 # 重载检查间隔(秒)
|
||||
metrics_enabled: true # 记录调用指标(/metrics)
|
||||
rate_limit_rps: null # 全局单 user QPS 上限(null=不限;供应商级用 provider.rate_limit_rps)
|
||||
max_body_size: 2000000 # 请求体字节上限(防 DDoS,约 2MB)
|
||||
cors_origins: ["*"] # CORS 允许来源(生产收紧为具体域名)
|
||||
graceful_shutdown: 30 # 优雅关闭等待在途请求的秒数
|
||||
# ── 防滥用 / 安全 ──
|
||||
batch_max_concurrency: 16 # /batch 并发上限(客户端 max_concurrency 会被钳到此值)
|
||||
batch_max_items: 64 # /batch 单次最大条目数(超出返回 400)
|
||||
webhook_allow_private: false # 视频 callback_url 是否允许指向内网/回环(SSRF 防护,默认禁)
|
||||
docs_enabled: false # FastAPI 文档(/docs、/openapi.json)是否开放(安全默认关)
|
||||
auth_fail_limit_per_min: 20 # 同一来源 IP 每分钟鉴权失败上限,超过 → 429(防暴力枚举)
|
||||
|
||||
# ── 供应商熔断(Circuit Breaker) ──────────────────────
|
||||
# 某供应商连续/滑动窗口失败达到 failure_threshold 就熔断 cooldown 秒,
|
||||
# 期间直接跳过(不再白等),让 fallback 快速切到健康供应商。
|
||||
circuit:
|
||||
enabled: true
|
||||
failure_threshold: 3 # 连续失败 3 次即熔断
|
||||
cooldown: 30 # 熔断持续 30 秒
|
||||
window: 10 # 滑动窗口
|
||||
|
||||
# ── 可观测性 ───────────────────────────────────────────
|
||||
observability:
|
||||
log_level: "INFO"
|
||||
log_json: false # true = 结构化 JSON 行日志(接 ELK/CloudWatch)
|
||||
access_log_maxlen: 500 # 访问日志环形缓冲长度
|
||||
|
||||
# ── 定价(用于 /v1 响应里估算成本,人民币/百万 token) ─
|
||||
# 不配则该模型 estimated_cost_cny 不返回(不影响调用)。
|
||||
pricing:
|
||||
per_model:
|
||||
agnes-3.0-flash: { input: 0.35, output: 1.00 }
|
||||
ark-code-latest: { input: 0.50, output: 2.00 }
|
||||
qwen3.8-flash: { input: 0.30, output: 0.60 }
|
||||
mimo-v2.5: { input: 0.30, output: 0.60 }
|
||||
hy3: { input: 0.30, output: 0.60 }
|
||||
|
||||
# ── 媒体下载代理白名单(第十七轮)────────────────────────
|
||||
# 生成的图片/视频挂在第三方 CDN 上且不带 CORS 头,浏览器里既 fetch 不到 blob、
|
||||
# 跨域 <a download> 也不生效(只会打开新标签页)。所以由网关代拉一次并加上
|
||||
# Content-Disposition: attachment,前端「下载」按钮才真的能存文件。
|
||||
# 安全:这是网关唯一一个服务端主动出网的接口 —— 只有这里列出的域名(含其子域)
|
||||
# 允许被代下载,且解析出来的 IP 必须是公网地址;列表为空 = 该功能整体关闭。
|
||||
# 换了供应商/换了 CDN 域名时,往这里加一条即可(如 volc 的 tos-*.volces.com)。
|
||||
download:
|
||||
allowed_hosts:
|
||||
- "cos-platform-outputs.agnes-ai.cn" # Agnes 图像/视频产物 CDN
|
||||
max_bytes: 67108864 # 单文件上限 64MB
|
||||
|
||||
# ── 网关入口鉴权 ─────────────────────────────────────
|
||||
# 账号与 API Key 全部由页面管理,存在 data/users.json(见 app/users.py):
|
||||
# 管理员在「用户管理」页建账号,各账号在「设置 → 我的 API Key」自助铸 Key。
|
||||
# 本文件里**不再有任何用户/密钥**,只有一个运维开关:
|
||||
# auth.session_ttl_minutes —— 网页登录签发的会话有效期(分钟,默认 1440 = 24h)
|
||||
# 第十八轮: 删掉了这里残留的旧 `auth.enabled/users/key` 死配置(含一把明文 wjd- Key)。
|
||||
# 那些键早已不再被 config.py 读取(只读 session_ttl_minutes),
|
||||
# 那把 Key 在 users.json 里也不存在 → 认不了任何入口,但会让"yaml 里没有明文凭证"的说法失真。
|
||||
auth:
|
||||
session_ttl_minutes: 1440
|
||||
|
||||
# ── 路由别名 + 按优先级 fallback ──────────────────────
|
||||
# model 填别名(如 wjd),按数组顺序逐个尝试:
|
||||
# 第 1 个失败/超时/重试耗尽 → 第 2 个 … 全失败才 502。
|
||||
# 每个路由可设 timeout(单模型超时秒)、retry(切下一个前该模型重试次数)。
|
||||
# 优先级从左到右(第一个最高)。已把全部 5 个文本模型配上。
|
||||
routes:
|
||||
wjd:
|
||||
timeout: 60 # 单模型 60s 没出结果就切下一个(避免 6×120s 挂死)
|
||||
retry: 1 # 每个模型只试 1 次,失败立即切下一个
|
||||
models:
|
||||
- "ark-code-latest" # 1) 火山方舟(最高优先级)
|
||||
@@ -9,6 +9,13 @@
|
||||
// 另外顺手核三件小事(都是会出现"界面里冒出 nav.xxx 原始键名"的原因):
|
||||
// 1. 中英两份键完全对称;2. 同一个对象里没有重复键;3. 没有空文案。
|
||||
//
|
||||
// 第三十轮追加第四件:**源码里的硬编码中文**。
|
||||
// 体检的由头是 Videos.vue 的素材摘要(`首帧:xx.png`)和 lib/upload.ts 的一串报错,
|
||||
// 全都是写死的中文 —— 切到英文后这些地方照旧中文,肉眼很难在一个大页面里发现。
|
||||
// 规则:src 下(locales 除外)**字符串字面量**里出现中日韩统一表意文字就报错;
|
||||
// 注释里的中文不算(本项目注释大量中文,且注释本来就不该翻)、模板里的纯文字节点不算
|
||||
// (那是语言切换器自己要显示的「中文」,按惯例各语言写给自己的名字)。
|
||||
//
|
||||
// 只依赖 Node 内置模块:不引第三方解析器,规则显式写在下面,谁都能看懂。
|
||||
|
||||
import fs from 'node:fs'
|
||||
@@ -85,6 +92,53 @@ function checkBraces(value) {
|
||||
return bad
|
||||
}
|
||||
|
||||
// ── 硬编码中文扫描(第三十轮)──────────────────────────────
|
||||
const CJK = /[\u4e00-\u9fa5]/
|
||||
|
||||
/** 允许出现的硬编码中文(逐条写上理由,别用"通配"把整类放过) */
|
||||
const CJK_ALLOW = new Map([
|
||||
// 登录页右上角的语言切换:写的是**中文这门语言自己的名字**,切到英文界面也该显示「中文」
|
||||
['views/Login.vue::中', '语言切换按钮上的语言自称(各语言写自己的名字)'],
|
||||
])
|
||||
|
||||
function walk(dir) {
|
||||
return fs.readdirSync(dir, { withFileTypes: true }).flatMap((e) => {
|
||||
const p = path.join(dir, e.name)
|
||||
return e.isDirectory() ? walk(p) : [p]
|
||||
})
|
||||
}
|
||||
|
||||
/** 去掉注释(块注释 / HTML 注释 / 行注释 —— 行注释要避开 `https://` 里的两个斜杠) */
|
||||
function stripComments(code) {
|
||||
return code
|
||||
.replace(/\/\*[\s\S]*?\*\//g, ' ')
|
||||
.replace(/<!--[\s\S]*?-->/g, ' ')
|
||||
.split('\n')
|
||||
.map((l) => l.replace(/(^|[^:])\/\/.*$/, '$1'))
|
||||
.join('\n')
|
||||
}
|
||||
|
||||
function scanHardcodedChinese() {
|
||||
const found = []
|
||||
const files = walk(path.join(ROOT, 'src')).filter(
|
||||
(f) => /\.(vue|ts|mts|js|mjs)$/.test(f) && !f.includes(`${path.sep}locales${path.sep}`),
|
||||
)
|
||||
for (const abs of files) {
|
||||
const rel = path.relative(path.join(ROOT, 'src'), abs).split(path.sep).join('/')
|
||||
const lines = stripComments(fs.readFileSync(abs, 'utf8')).split('\n')
|
||||
lines.forEach((line, i) => {
|
||||
const lits = line.match(/'[^'\n]*'|"[^"\n]*"|`[^`\n]*`/g) || []
|
||||
for (const lit of lits) {
|
||||
const text = lit.slice(1, -1)
|
||||
if (!CJK.test(text)) continue
|
||||
if (CJK_ALLOW.has(`${rel}::${text}`)) continue
|
||||
found.push(`src/${rel}:${i + 1} 硬编码中文:${lit}(走 i18n:中文进 zh.ts、英文进 en.ts)`)
|
||||
}
|
||||
})
|
||||
}
|
||||
return found
|
||||
}
|
||||
|
||||
const problems = []
|
||||
const parsed = {}
|
||||
|
||||
@@ -104,6 +158,9 @@ const enKeys = new Set(parsed.en.keys())
|
||||
for (const k of zhKeys) if (!enKeys.has(k)) problems.push(`en 少了键:${k}(中文写好了英文没写 → 英文界面会显示这个原始键名)`)
|
||||
for (const k of enKeys) if (!zhKeys.has(k)) problems.push(`zh 少了键:${k}(英文写好了中文没写 → 中文界面会显示这个原始键名)`)
|
||||
|
||||
// 硬编码中文
|
||||
problems.push(...scanHardcodedChinese())
|
||||
|
||||
if (problems.length) {
|
||||
console.error(`\n✗ 文案体检不通过(${problems.length} 个问题):`)
|
||||
for (const p of problems) console.error(' - ' + p)
|
||||
|
||||
@@ -121,8 +121,10 @@ export function piePalette(n: number): string[] {
|
||||
}
|
||||
|
||||
/** 空数据时环形图也得画个灰圈,别留白块。
|
||||
* 空态那一项只报名字(「暂无数据」),别拼成「暂无数据: 1」这种看着像真数据的怪文案。 */
|
||||
export function pieData(items: { name: string; value: number }[], emptyLabel = '暂无数据') {
|
||||
* 空态那一项只报名字(「暂无数据」),别拼成「暂无数据: 1」这种看着像真数据的怪文案。
|
||||
* 第三十轮: 这个空态文案**必须由调用方传**(原来是默认值硬编码中文,切英文后图表里
|
||||
* 还是中文)。两个调用点都传 t(...),所以改成必填参数,别再留一个中文兜底。 */
|
||||
export function pieData(items: { name: string; value: number }[], emptyLabel: string) {
|
||||
if (items.length) {
|
||||
const colors = piePalette(items.length)
|
||||
return items.map((it, i) => ({ ...it, itemStyle: { color: colors[i] } }))
|
||||
|
||||
+29
-16
@@ -9,9 +9,16 @@
|
||||
// 而 base64 会把体积再放大 4/3。手机随手拍的 3~5MB 照片直接转 base64 只会换来一个 413。
|
||||
// 所以这里按用途分级压缩 + 逐级降档,并在提交前做「整包体积」预算检查。
|
||||
|
||||
import i18n from '../i18n'
|
||||
|
||||
/** 网关 Nginx / 应用层的请求体上限(字节),留一点余量给 prompt 与 JSON 结构。 */
|
||||
export const BODY_BUDGET = 1_700_000
|
||||
|
||||
// 第三十轮: 本模块抛出的错误是**直接给用户看**的(页面 catch 后 toast),原先全是硬编码中文 ——
|
||||
// 切英文后整片报错仍是中文。这里取全局 t(模块不是组件,用不了 useI18n):
|
||||
// i18n.global 是响应式实例,语言切换后这些文案立即跟着变。
|
||||
const tr = (key: string, args: Record<string, unknown> = {}) => i18n.global.t(key, args)
|
||||
|
||||
export interface MediaPreset {
|
||||
/** 长边上限(像素) */
|
||||
maxSide: number
|
||||
@@ -19,24 +26,25 @@ export interface MediaPreset {
|
||||
quality: number
|
||||
/** 单件 data URI 目标上限(字节) */
|
||||
maxBytes: number
|
||||
label: string
|
||||
/** 用途名(**i18n 键**,不是文案本身):只用在报错里告诉用户是哪一档超限了 */
|
||||
labelKey: string
|
||||
}
|
||||
|
||||
/** 各用途的压缩档位。数值来自实测:1024px/q0.82 的普通照片约 150~300KB(base64 后 ×1.37)。 */
|
||||
export const PRESETS: Record<string, MediaPreset> = {
|
||||
// 对话视觉:给模型看的,1024px 足够(再大也只会烧 token)
|
||||
chat: { maxSide: 1024, quality: 0.8, maxBytes: 500_000, label: '对话附图' },
|
||||
chat: { maxSide: 1024, quality: 0.8, maxBytes: 500_000, labelKey: 'upload.presetChat' },
|
||||
// 图生图 / 多图合成:保留构图细节
|
||||
ref: { maxSide: 1024, quality: 0.85, maxBytes: 500_000, label: '参考图' },
|
||||
ref: { maxSide: 1024, quality: 0.85, maxBytes: 500_000, labelKey: 'upload.presetRef' },
|
||||
// 视频首/尾帧:画面直接进视频,给到 1280px
|
||||
frame: { maxSide: 1280, quality: 0.85, maxBytes: 450_000, label: '首/尾帧' },
|
||||
frame: { maxSide: 1280, quality: 0.85, maxBytes: 450_000, labelKey: 'upload.presetFrame' },
|
||||
// 视频参考图:最多 5 张,单件必须小(5 × 300KB ≈ 1.5MB,逼近 2MB 上限)
|
||||
videoRef: { maxSide: 1024, quality: 0.8, maxBytes: 300_000, label: '视频参考图' },
|
||||
videoRef: { maxSide: 1024, quality: 0.8, maxBytes: 300_000, labelKey: 'upload.presetVideoRef' },
|
||||
// 视频参考音频:无浏览器端压缩手段,只能卡体积(最多 3 段)
|
||||
audio: { maxSide: 0, quality: 0, maxBytes: 420_000, label: '参考音频' },
|
||||
audio: { maxSide: 0, quality: 0, maxBytes: 420_000, labelKey: 'upload.presetAudio' },
|
||||
// 第二十二轮 意见反馈附图:一条最多 3 张,管理员要在电脑上看清细节,给到 1280px;
|
||||
// 但整包(3 张 + 缩略图)必须落在网关/Nginx 的 2MB 上限内,所以单张卡 400KB。
|
||||
feedback: { maxSide: 1280, quality: 0.8, maxBytes: 400_000, label: '反馈图片' },
|
||||
feedback: { maxSide: 1280, quality: 0.8, maxBytes: 400_000, labelKey: 'upload.presetFeedback' },
|
||||
}
|
||||
|
||||
export interface PickedMedia {
|
||||
@@ -89,7 +97,7 @@ export function isImageFile(f: File): boolean {
|
||||
function readAsDataUri(f: Blob): Promise<string> {
|
||||
return new Promise((resolve, reject) => {
|
||||
const fr = new FileReader()
|
||||
fr.onerror = () => reject(new Error('读取文件失败'))
|
||||
fr.onerror = () => reject(new Error(tr('upload.errRead')))
|
||||
fr.onload = () => resolve(String(fr.result || ''))
|
||||
fr.readAsDataURL(f)
|
||||
})
|
||||
@@ -108,7 +116,7 @@ async function loadBitmap(file: File): Promise<{ w: number; h: number; draw: Can
|
||||
const img = await new Promise<HTMLImageElement>((resolve, reject) => {
|
||||
const el = new Image()
|
||||
el.onload = () => resolve(el)
|
||||
el.onerror = () => reject(new Error('图片解码失败(格式不支持?)'))
|
||||
el.onerror = () => reject(new Error(tr('upload.errDecode')))
|
||||
el.src = url
|
||||
})
|
||||
return {
|
||||
@@ -133,7 +141,7 @@ async function encodeCanvas(file: File, maxSide: number, quality: number): Promi
|
||||
cv.width = w
|
||||
cv.height = h
|
||||
const ctx = cv.getContext('2d')
|
||||
if (!ctx) throw new Error('浏览器不支持 Canvas 2D,无法压缩图片')
|
||||
if (!ctx) throw new Error(tr('upload.errNoCanvas'))
|
||||
// 白底:PNG 透明区转 JPEG 会变黑,铺一层白更接近原图观感
|
||||
ctx.fillStyle = '#ffffff'
|
||||
ctx.fillRect(0, 0, w, h)
|
||||
@@ -162,7 +170,7 @@ export async function makeThumb(dataUri: string, maxSide = 256, quality = 0.6):
|
||||
* 「原档 → 0.75×边长 → 0.5×边长」逐级降档,直到落进 maxBytes 预算。
|
||||
*/
|
||||
export async function pickImage(file: File, preset: MediaPreset): Promise<PickedMedia> {
|
||||
if (!isImageFile(file)) throw new Error(`${file.name} 不是图片文件`)
|
||||
if (!isImageFile(file)) throw new Error(tr('upload.errNotImage', { name: file.name }))
|
||||
const raw = await readAsDataUri(file)
|
||||
// 小体积 PNG/WEBP 直接原样用(避免无谓的有损压缩,也保住透明通道)
|
||||
if (raw.length <= preset.maxBytes && /png|webp|gif|bmp/i.test(file.type || extOf(file.name))) {
|
||||
@@ -188,14 +196,19 @@ export async function pickImage(file: File, preset: MediaPreset): Promise<Picked
|
||||
}
|
||||
}
|
||||
}
|
||||
throw new Error(`${file.name} 压缩后仍有 ${formatBytes(dataUriBytes(last))},超过 ${preset.label} 单件上限 ${formatBytes(preset.maxBytes)}`)
|
||||
throw new Error(tr('upload.errTooBigAfterCompress', {
|
||||
name: file.name, size: formatBytes(dataUriBytes(last)),
|
||||
label: tr(preset.labelKey), max: formatBytes(preset.maxBytes),
|
||||
}))
|
||||
}
|
||||
|
||||
/** 音频 → data URI(浏览器端无法重编码,只做体积与格式校验)。 */
|
||||
export async function pickAudio(file: File, preset: MediaPreset = PRESETS.audio): Promise<PickedMedia> {
|
||||
if (!isAudioFile(file)) throw new Error(`${file.name} 不是音频文件(支持 ${AUDIO_EXT.join('/')})`)
|
||||
if (!isAudioFile(file)) throw new Error(tr('upload.errNotAudio', { name: file.name, ext: AUDIO_EXT.join('/') }))
|
||||
if (file.size > preset.maxBytes) {
|
||||
throw new Error(`${file.name} 有 ${formatBytes(file.size)},超过参考音频上限 ${formatBytes(preset.maxBytes)}(请裁剪或压缩后再传)`)
|
||||
throw new Error(tr('upload.errAudioTooBig', {
|
||||
name: file.name, size: formatBytes(file.size), max: formatBytes(preset.maxBytes),
|
||||
}))
|
||||
}
|
||||
const uri = await readAsDataUri(file)
|
||||
return { name: file.name, kind: 'audio', uri, thumb: '', bytes: uri.length, compressed: false }
|
||||
@@ -214,8 +227,8 @@ export function assertBodyBudget(parts: Array<string | undefined>, extraBytes =
|
||||
const total = parts.reduce((n, p) => n + (p ? p.length : 0), 0) + extraBytes
|
||||
if (total > BODY_BUDGET) {
|
||||
throw new Error(
|
||||
`本次请求体约 ${formatBytes(total)},超过网关上送上限(约 ${formatBytes(BODY_BUDGET)})。` +
|
||||
'请减少素材数量,或换体积更小的图片/音频。',
|
||||
tr('upload.errBodyBudget', { size: formatBytes(total), max: formatBytes(BODY_BUDGET) }) +
|
||||
tr('upload.errBodyBudgetTip'),
|
||||
)
|
||||
}
|
||||
}
|
||||
@@ -327,6 +327,12 @@ export default {
|
||||
placeholderRef: 'Describe the video and camera move (use <Picture 1> / <Audio 1> for reference materials)',
|
||||
needFrame: 'Keyframe mode needs at least one uploaded image or image URL',
|
||||
needRef: 'Reference mode needs at least one image or audio (upload or URL)',
|
||||
// Round 30: the material summary on the card (was hardcoded Chinese in mediaSummary())
|
||||
mediaFirst: 'first',
|
||||
mediaLast: 'last',
|
||||
mediaImg: 'img',
|
||||
mediaAud: 'audio',
|
||||
mediaUrl: 'URL',
|
||||
duration: 'Duration (s)',
|
||||
aspect: 'Aspect',
|
||||
quality: 'Quality',
|
||||
@@ -472,7 +478,7 @@ export default {
|
||||
userEnabledOk: 'Account {name} enabled — old password and API keys work again',
|
||||
namesRule: 'Username must be alphanumeric; default password = username',
|
||||
changePw: 'Change password',
|
||||
newPw: 'New password (min 4 chars)',
|
||||
newPw: 'New password (min 8 chars)',
|
||||
pwTip: 'You are signed in — just set a new password, no current password needed. All sessions are revoked and you will sign in again with the new one.',
|
||||
pwNeedNew: 'Please enter a new password',
|
||||
pwChanged: 'Password updated — please sign in again',
|
||||
@@ -486,7 +492,7 @@ export default {
|
||||
noKey: 'You have no API Key — create one to use as a Bearer credential externally',
|
||||
userMgmt: 'Account management (admin)',
|
||||
newUserName: 'New username (alphanumeric)',
|
||||
newUserTip: 'Create account; default password = username',
|
||||
newUserTip: 'Create account; default password = username (custom password ≥ 8 chars)',
|
||||
createUser: 'Create account',
|
||||
keyCount: 'Keys',
|
||||
resetPw: 'Reset password',
|
||||
@@ -774,4 +780,24 @@ export default {
|
||||
f_max_bytes: 'Max file size (bytes)',
|
||||
h_max_bytes: 'Default 67108864 = 64MB',
|
||||
},
|
||||
|
||||
// Round 30: user-visible errors from the frontend upload/compression helpers
|
||||
// (they used to be hardcoded Chinese, so English toasts still showed Chinese)
|
||||
upload: {
|
||||
presetChat: 'chat image',
|
||||
presetRef: 'reference image',
|
||||
presetFrame: 'first/last frame',
|
||||
presetVideoRef: 'video reference image',
|
||||
presetAudio: 'reference audio',
|
||||
presetFeedback: 'feedback image',
|
||||
errRead: 'Failed to read the file',
|
||||
errDecode: 'Could not decode the image (unsupported format?)',
|
||||
errNoCanvas: 'This browser has no Canvas 2D support, so the image cannot be compressed',
|
||||
errNotImage: '{name} is not an image file',
|
||||
errTooBigAfterCompress: '{name} is still {size} after compression, over the {label} per-item limit of {max}',
|
||||
errNotAudio: '{name} is not an audio file (supported: {ext})',
|
||||
errAudioTooBig: '{name} is {size}, over the reference-audio limit of {max} (please trim or compress it)',
|
||||
errBodyBudget: 'This request body is about {size}, over the gateway upload limit (~{max}).',
|
||||
errBodyBudgetTip: 'Please use fewer materials, or smaller images/audio files.',
|
||||
},
|
||||
}
|
||||
@@ -327,6 +327,12 @@ export default {
|
||||
placeholderRef: '描述要生成的视频画面与运镜(可用 <Picture 1> / <Audio 1> 指代第 1 个参考素材)',
|
||||
needFrame: '首尾帧模式需要至少上传一张图片或填一个图片 URL',
|
||||
needRef: '参考模式需要至少一张图片或一段音频(可上传或填 URL)',
|
||||
// 第三十轮: 卡片上的素材摘要(此前是 mediaSummary() 里硬编码的中文)
|
||||
mediaFirst: '首帧',
|
||||
mediaLast: '尾帧',
|
||||
mediaImg: '图',
|
||||
mediaAud: '音',
|
||||
mediaUrl: 'URL',
|
||||
duration: '时长(s)',
|
||||
aspect: '比例',
|
||||
quality: '清晰度',
|
||||
@@ -471,7 +477,7 @@ export default {
|
||||
userEnabledOk: '账号 {name} 已启用,可以用原密码登录、原 API Key 继续调用',
|
||||
namesRule: '账号名仅字母数字,默认密码=账号名',
|
||||
changePw: '修改密码',
|
||||
newPw: '新密码(至少 4 位)',
|
||||
newPw: '新密码(至少 8 位)',
|
||||
pwTip: '已登录状态直接设新密码,不用再输当前密码;改完所有会话失效,需用新密码重新登录。',
|
||||
pwNeedNew: '请输入新密码',
|
||||
pwChanged: '密码已更新,请用新密码重新登录',
|
||||
@@ -485,7 +491,7 @@ export default {
|
||||
noKey: '你还没有 API Key —— 创建后可当作外部调用的 Bearer 凭证',
|
||||
userMgmt: '账号管理(管理员)',
|
||||
newUserName: '新账号名(字母数字)',
|
||||
newUserTip: '创建账号,默认密码 = 账号名',
|
||||
newUserTip: '创建账号,默认密码 = 账号名(自设密码至少 8 位)',
|
||||
createUser: '创建账号',
|
||||
keyCount: 'Key 数',
|
||||
resetPw: '重置密码',
|
||||
@@ -778,4 +784,23 @@ export default {
|
||||
f_max_bytes: '单文件上限(字节)',
|
||||
h_max_bytes: '默认 67108864 = 64MB',
|
||||
},
|
||||
|
||||
// 第三十轮: 前端上传/压缩工具的用户可见报错(此前硬编码中文 —— 切英文后 toast 里还是中文)
|
||||
upload: {
|
||||
presetChat: '对话附图',
|
||||
presetRef: '参考图',
|
||||
presetFrame: '首/尾帧',
|
||||
presetVideoRef: '视频参考图',
|
||||
presetAudio: '参考音频',
|
||||
presetFeedback: '反馈图片',
|
||||
errRead: '读取文件失败',
|
||||
errDecode: '图片解码失败(格式不支持?)',
|
||||
errNoCanvas: '浏览器不支持 Canvas 2D,无法压缩图片',
|
||||
errNotImage: '{name} 不是图片文件',
|
||||
errTooBigAfterCompress: '{name} 压缩后仍有 {size},超过 {label} 单件上限 {max}',
|
||||
errNotAudio: '{name} 不是音频文件(支持 {ext})',
|
||||
errAudioTooBig: '{name} 有 {size},超过参考音频上限 {max}(请裁剪或压缩后再传)',
|
||||
errBodyBudget: '本次请求体约 {size},超过网关上送上限(约 {max})。',
|
||||
errBodyBudgetTip: '请减少素材数量,或换体积更小的图片/音频。',
|
||||
},
|
||||
}
|
||||
+16
-13
@@ -4,6 +4,9 @@ import { GATEWAY_CONFIG_ENABLED } from './lib/features'
|
||||
|
||||
const router = createRouter({
|
||||
history: createWebHashHistory(),
|
||||
// 第三十轮: 这里的 meta.title 已删除 —— 它是**没人读的死元数据**(全仓没有任何
|
||||
// ``document.title``/``route.meta.title`` 消费点),而且只有中文:切英文后一旦有人
|
||||
// 开始用它,界面就会冒出中文。菜单标题的唯一来源是 lib/nav.ts(键)+ i18n 文案。
|
||||
routes: [
|
||||
{ path: '/login', name: 'login', component: () => import('./views/Login.vue'), meta: { public: true } },
|
||||
{
|
||||
@@ -11,19 +14,19 @@ const router = createRouter({
|
||||
component: () => import('./layouts/MainLayout.vue'),
|
||||
children: [
|
||||
{ path: '', redirect: '/dashboard' },
|
||||
{ path: 'dashboard', name: 'dashboard', component: () => import('./views/Dashboard.vue'), meta: { title: '仪表盘' } },
|
||||
{ path: 'chat', name: 'chat', component: () => import('./views/Chat.vue'), meta: { title: '对话' } },
|
||||
{ path: 'images', name: 'images', component: () => import('./views/Images.vue'), meta: { title: '图像' } },
|
||||
{ path: 'videos', name: 'videos', component: () => import('./views/Videos.vue'), meta: { title: '视频' } },
|
||||
{ path: 'models', name: 'models', component: () => import('./views/Models.vue'), meta: { title: '模型与供应商' } },
|
||||
{ path: 'metrics', name: 'metrics', component: () => import('./views/Metrics.vue'), meta: { title: '指标' } },
|
||||
{ path: 'keys', name: 'keys', component: () => import('./views/ApiKeys.vue'), meta: { title: 'API 密钥' } },
|
||||
{ path: 'users', name: 'users', component: () => import('./views/Users.vue'), meta: { title: '用户管理', admin: true } },
|
||||
{ path: 'feedback-inbox', name: 'feedbackinbox', component: () => import('./views/FeedbackInbox.vue'), meta: { title: '用户反馈', admin: true } },
|
||||
{ path: 'feedback', name: 'feedback', component: () => import('./views/Feedback.vue'), meta: { title: '意见反馈', memberOnly: true } },
|
||||
{ path: 'gateway-config', name: 'gatewaycfg', component: () => import('./views/GatewayConfig.vue'), meta: { title: '网关配置', admin: true } },
|
||||
{ path: 'logs', name: 'logs', component: () => import('./views/Logs.vue'), meta: { title: '日志' } },
|
||||
{ path: 'settings', name: 'settings', component: () => import('./views/Settings.vue'), meta: { title: '设置' } },
|
||||
{ path: 'dashboard', name: 'dashboard', component: () => import('./views/Dashboard.vue') },
|
||||
{ path: 'chat', name: 'chat', component: () => import('./views/Chat.vue') },
|
||||
{ path: 'images', name: 'images', component: () => import('./views/Images.vue') },
|
||||
{ path: 'videos', name: 'videos', component: () => import('./views/Videos.vue') },
|
||||
{ path: 'models', name: 'models', component: () => import('./views/Models.vue') },
|
||||
{ path: 'metrics', name: 'metrics', component: () => import('./views/Metrics.vue') },
|
||||
{ path: 'keys', name: 'keys', component: () => import('./views/ApiKeys.vue') },
|
||||
{ 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', name: 'feedback', component: () => import('./views/Feedback.vue'), meta: { memberOnly: true } },
|
||||
{ path: 'gateway-config', name: 'gatewaycfg', component: () => import('./views/GatewayConfig.vue'), meta: { admin: true } },
|
||||
{ path: 'logs', name: 'logs', component: () => import('./views/Logs.vue') },
|
||||
{ path: 'settings', name: 'settings', component: () => import('./views/Settings.vue') },
|
||||
],
|
||||
},
|
||||
],
|
||||
|
||||
@@ -425,22 +425,25 @@ const firstFrame = computed(() => (firstSlot.value?.uri || firstUrl.value).trim(
|
||||
const lastFrame = computed(() => (lastSlot.value?.uri || lastUrl.value).trim())
|
||||
const imageList = computed(() => [...refImgs.value.map((r) => r.uri), ...toList(refImgUrls.value)])
|
||||
const audioList = computed(() => [...refAuds.value.map((r) => r.uri), ...toList(refAudUrls.value)])
|
||||
/** 卡片上展示的素材摘要(只存名字/数量,data URI 不进历史) */
|
||||
/** 卡片上展示的素材摘要(只存名字/数量,data URI 不进历史)
|
||||
* 第三十轮: 这里的标签原来是硬编码中文 —— 切英文后摘要仍是「首帧:xx.png」。
|
||||
* 全部走 i18n(videos.media*),中英各自成句。 */
|
||||
function mediaSummary(): string {
|
||||
const L = (key: string) => t(`videos.${key}`)
|
||||
if (mode.value === 'keyframe') {
|
||||
const names: string[] = []
|
||||
if (firstSlot.value) names.push(`首帧:${firstSlot.value.name}`)
|
||||
else if (firstUrl.value.trim()) names.push('首帧:URL')
|
||||
if (lastSlot.value) names.push(`尾帧:${lastSlot.value.name}`)
|
||||
else if (lastUrl.value.trim()) names.push('尾帧:URL')
|
||||
if (firstSlot.value) names.push(`${L('mediaFirst')}:${firstSlot.value.name}`)
|
||||
else if (firstUrl.value.trim()) names.push(`${L('mediaFirst')}:${L('mediaUrl')}`)
|
||||
if (lastSlot.value) names.push(`${L('mediaLast')}:${lastSlot.value.name}`)
|
||||
else if (lastUrl.value.trim()) names.push(`${L('mediaLast')}:${L('mediaUrl')}`)
|
||||
return names.join(' / ')
|
||||
}
|
||||
if (mode.value === 'reference') {
|
||||
const names: string[] = []
|
||||
refImgs.value.forEach((r, i) => names.push(`图${i + 1}:${r.name}`))
|
||||
if (toList(refImgUrls.value).length) names.push(`图URL×${toList(refImgUrls.value).length}`)
|
||||
refAuds.value.forEach((r, i) => names.push(`音${i + 1}:${r.name}`))
|
||||
if (toList(refAudUrls.value).length) names.push(`音URL×${toList(refAudUrls.value).length}`)
|
||||
refImgs.value.forEach((r, i) => names.push(`${L('mediaImg')}${i + 1}:${r.name}`))
|
||||
if (toList(refImgUrls.value).length) names.push(`${L('mediaImg')}${L('mediaUrl')}×${toList(refImgUrls.value).length}`)
|
||||
refAuds.value.forEach((r, i) => names.push(`${L('mediaAud')}${i + 1}:${r.name}`))
|
||||
if (toList(refAudUrls.value).length) names.push(`${L('mediaAud')}${L('mediaUrl')}×${toList(refAudUrls.value).length}`)
|
||||
return names.join(' / ')
|
||||
}
|
||||
return ''
|
||||
|
||||
Executable
+66
@@ -0,0 +1,66 @@
|
||||
#!/usr/bin/env bash
|
||||
# 一条命令跑完所有门禁(第三十轮新增)。
|
||||
#
|
||||
# 为什么要有它:这套检查原先散在几个地方(Makefile、frontend/package.json、README 的说明),
|
||||
# 提交前"该跑哪些"靠脑子记 —— 结果就是漏(本轮就补上了 make lint 少覆盖 6 个文件、
|
||||
# 测试污染真实 data/.env 这类问题)。这里把它们串成一条,本地和 CI 都能直接用。
|
||||
#
|
||||
# 用法:bash scripts/ci_check.sh # 全部跑
|
||||
# bash scripts/ci_check.sh --fast # 跳过前端 build(只做体检+类型检查)
|
||||
#
|
||||
# 退出码非 0 = 有门禁没过(CI 直接照这个判)。任何一步失败都继续跑完,最后汇总 ——
|
||||
# 一次把问题都暴露出来,而不是修一个跑一次。
|
||||
set -u
|
||||
|
||||
ROOT="$(cd "$(dirname "$0")/.." && pwd)"
|
||||
cd "$ROOT"
|
||||
|
||||
FAST=0
|
||||
[ "${1:-}" = "--fast" ] && FAST=1
|
||||
|
||||
PY="${PYTHON:-python3}"
|
||||
command -v "$PY" >/dev/null 2>&1 || PY=python
|
||||
|
||||
failed=0
|
||||
run() { # run <说明> <命令...>
|
||||
local name="$1"; shift
|
||||
echo ""
|
||||
echo "──────── $name ────────"
|
||||
if "$@"; then
|
||||
echo "✓ $name"
|
||||
else
|
||||
echo "✗ $name(退出码 $?)"
|
||||
failed=$((failed + 1))
|
||||
fi
|
||||
}
|
||||
|
||||
echo "api-gateway CI 门禁($(date '+%F %T'))"
|
||||
|
||||
# 1) 后端语法编译(覆盖整个 app 包 + run.py;不再维护手写文件清单)
|
||||
run "后端语法编译" "$PY" -m compileall -q app run.py
|
||||
|
||||
# 2) 单元测试(mock 上游,不依赖真实 key/网络)
|
||||
run "单元测试" "$PY" tests/test_gateway.py
|
||||
|
||||
# 3) 前端:SVG 注释 + i18n 文案体检(中英对称 / 无硬编码中文 / 占位符语法)
|
||||
if [ -d frontend/node_modules ]; then
|
||||
run "前端文案体检" npm --prefix frontend run check:i18n
|
||||
run "SVG 体检" npm --prefix frontend run check:svg
|
||||
# 4) 前端类型检查
|
||||
run "前端类型检查" npm --prefix frontend run typecheck
|
||||
# 5) 前端构建(已含上面两项体检作为前置;--fast 时跳过,省 ~20s)
|
||||
if [ "$FAST" = "0" ]; then
|
||||
run "前端构建" npm --prefix frontend run build
|
||||
fi
|
||||
else
|
||||
echo ""
|
||||
echo "! frontend/node_modules 不存在 —— 跳过前端三项(先 cd frontend && npm ci)"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
if [ "$failed" = "0" ]; then
|
||||
echo "全部通过 ✓"
|
||||
exit 0
|
||||
fi
|
||||
echo "$failed 项未通过 ✗"
|
||||
exit 1
|
||||
+163
-5
@@ -28,6 +28,10 @@ _os.environ.setdefault("GATEWAY_HISTORY", str(_ROOT / ".test_history.json"))
|
||||
# 第二十二轮 意见反馈:同理——反馈(含图片)必须落到临时路径,别污染真实 data/
|
||||
_os.environ.setdefault("GATEWAY_FEEDBACK", str(_ROOT / ".test_feedback.json"))
|
||||
_os.environ.setdefault("GATEWAY_FEEDBACK_MEDIA", str(_ROOT / ".test_feedback_media"))
|
||||
# 第三十轮 会话落盘 / 视频归属落盘:同样隔离,否则跑测试会把真实登录会话与视频归属写脏
|
||||
_os.environ.setdefault("GATEWAY_SESSIONS", str(_ROOT / ".test_sessions.json"))
|
||||
_os.environ.setdefault("GATEWAY_VIDEO_OWNERS", str(_ROOT / ".test_video_owners.json"))
|
||||
_os.environ.setdefault("GATEWAY_ENV_FILE", str(_ROOT / ".test_env"))
|
||||
|
||||
from app.config import load_config, validate_config, ConfigError
|
||||
from app.circuit import CircuitBreaker, CircuitBreakerRegistry
|
||||
@@ -3379,8 +3383,6 @@ def _write_tmp_yaml(obj) -> str:
|
||||
|
||||
def test_config_endpoints_permission_matrix():
|
||||
"""GET/PUT /config:只认管理员 + 网页会话(API Key 不行),普通账号 403。"""
|
||||
import tempfile
|
||||
from pathlib import Path as P
|
||||
from fastapi.testclient import TestClient
|
||||
import app.main as m
|
||||
client = TestClient(m.app)
|
||||
@@ -3411,7 +3413,6 @@ def test_config_save_applies_without_restart():
|
||||
from pathlib import Path as P
|
||||
from fastapi.testclient import TestClient
|
||||
import app.main as m
|
||||
from app.config import GatewayConfig
|
||||
|
||||
client = TestClient(m.app)
|
||||
ah = {"Authorization": f"Bearer {_login_admin_session(client)}"}
|
||||
@@ -3631,7 +3632,7 @@ def test_admin_disabled_flag_in_file_is_autohealed():
|
||||
from app.users import UsersStore
|
||||
with tempfile.TemporaryDirectory() as d:
|
||||
p = _P(d) / "users.json"
|
||||
store = UsersStore(str(p))
|
||||
UsersStore(str(p)) # 造出初始文件(下面直接改里面 admin 的 disabled 标记)
|
||||
data = _json.loads(p.read_text(encoding="utf-8"))
|
||||
data["users"]["admin"]["disabled"] = True
|
||||
data["users"]["admin"]["disabled_at"] = 1.0
|
||||
@@ -4336,7 +4337,6 @@ def test_prometheus_export_ok_and_dropped_metrics_removed():
|
||||
(或反之)都说明导出器接线断了,Grafana 会看到空图。
|
||||
"""
|
||||
from fastapi.testclient import TestClient
|
||||
import app.main as m
|
||||
|
||||
with _Isolated() as mm:
|
||||
r = TestClient(mm.app).get("/metrics/prometheus")
|
||||
@@ -4396,6 +4396,164 @@ def test_media_requests_carry_bearer_token():
|
||||
(req.url.path, dict(req.headers))
|
||||
|
||||
|
||||
# ── 第三十轮「全面体检」发现项:会话落盘 / 视频归属 / env 值校验 / 口令下限 ──────
|
||||
|
||||
def test_session_store_persists_across_restart_and_hides_raw_token():
|
||||
"""会话落盘:重启不掉线(本轮目的);但盘上只许有 token 的哈希,不能有可直接用的凭证。"""
|
||||
import tempfile, os
|
||||
from app.sessions import SessionStore
|
||||
d = tempfile.mkdtemp()
|
||||
p = os.path.join(d, "sessions.json")
|
||||
s1 = SessionStore(ttl_seconds=3600, path=p)
|
||||
tok = s1.create("1.2.3.4", "alice")
|
||||
assert s1.validate(tok)
|
||||
raw = open(p, encoding="utf-8").read()
|
||||
assert tok not in raw, "落盘文件里出现了明文会话 token"
|
||||
assert "alice" in raw, "账号名要留着(否则重启后没法按账号吊销)"
|
||||
s2 = SessionStore(ttl_seconds=3600, path=p) # 模拟进程重启
|
||||
assert s2.validate(tok), "重启后旧会话应仍然有效(本轮的改动目的)"
|
||||
assert s2.account_for(tok) == "alice"
|
||||
assert s2.revoke_account("alice") == 1
|
||||
s3 = SessionStore(ttl_seconds=3600, path=p)
|
||||
assert not s3.validate(tok), "吊销必须落盘,否则重启就把被吊销的会话放回来了"
|
||||
|
||||
|
||||
def test_session_store_drops_expired_entries_on_load():
|
||||
"""载入时直接丢掉过期会话 —— 别把已死亡会话带进运行期(否则 TTL 形同虚设一份)。"""
|
||||
import json, tempfile, os, time
|
||||
from app.sessions import SessionStore, _fp
|
||||
d = tempfile.mkdtemp()
|
||||
p = os.path.join(d, "sessions.json")
|
||||
live, dead = "sess-live-token", "sess-dead-token"
|
||||
json.dump({"version": 1, "sessions": {
|
||||
_fp(live): {"created": time.time(), "ip": "", "account": "a"},
|
||||
_fp(dead): {"created": time.time() - 10 * 86400, "ip": "", "account": "a"},
|
||||
}}, open(p, "w", encoding="utf-8"))
|
||||
s = SessionStore(ttl_seconds=3600, path=p)
|
||||
assert s.validate(live)
|
||||
assert not s.validate(dead), "过期会话不该被载入"
|
||||
|
||||
|
||||
def test_video_owner_store_semantics():
|
||||
"""视频归属:有登记按登记判、无登记放行、管理员放行;结论要能跨重启保持。"""
|
||||
import tempfile, os
|
||||
from app.video_owners import VideoOwnerStore
|
||||
d = tempfile.mkdtemp()
|
||||
p = os.path.join(d, "videos.json")
|
||||
v = VideoOwnerStore(path=p)
|
||||
v.record("vid-1", "alice", "agnes")
|
||||
assert v.owner("vid-1") == "alice"
|
||||
assert v.allows("vid-1", "alice") is True
|
||||
assert v.allows("vid-1", "bob") is False, "别人的视频不该能让另一个账号读到"
|
||||
assert v.allows("vid-1", "bob", is_admin=True) is True, "管理员要能排障"
|
||||
assert v.allows("vid-unknown", "bob") is True, "无登记的老任务放行(渐进收紧,不砸正常流程)"
|
||||
v2 = VideoOwnerStore(path=p) # 重启后归属仍在
|
||||
assert v2.allows("vid-1", "bob") is False
|
||||
v.record("vid-2", "alice")
|
||||
assert v.count() == 2
|
||||
|
||||
|
||||
def test_video_poll_denies_other_account_allows_owner_and_admin():
|
||||
"""端点级:别人 poll 我的视频 → 404(不是 403,避免把 id 变成存在性探针);本人与管理员正常。"""
|
||||
import uuid
|
||||
from fastapi.testclient import TestClient
|
||||
import app.main as m
|
||||
|
||||
vid = "vtest-owner-" + uuid.uuid4().hex[:8]
|
||||
|
||||
class Fake:
|
||||
async def create_video(self, **kw):
|
||||
return {"video_id": vid, "raw": {"status": "queued", "id": vid}}
|
||||
|
||||
async def poll_video(self, video_id, **kw):
|
||||
return {"raw": {"status": "completed", "progress": 100}}
|
||||
|
||||
real = m._get_adapter
|
||||
m._get_adapter = lambda model, t, cfg: (Fake(), {}, model)
|
||||
client = TestClient(m.app)
|
||||
ah = {"Authorization": f"Bearer {_login_admin_session(client)}"}
|
||||
names = []
|
||||
try:
|
||||
owner = _member(client, ah, "vowner"); names.append("vowner")
|
||||
other = _member(client, ah, "vother"); names.append("vother")
|
||||
r = client.post("/v1/videos", json={"model": "agnes-video-2.5-flash",
|
||||
"prompt": "x", "aspect_ratio": "16:9"}, headers=owner)
|
||||
assert r.status_code == 200, r.text
|
||||
assert r.json()["video_id"] == vid
|
||||
assert client.get(f"/v1/videos/{vid}", headers=other).status_code == 404, \
|
||||
"另一个账号不该能读走别人的视频任务"
|
||||
assert client.get(f"/v1/videos/{vid}", headers=owner).status_code == 200
|
||||
assert client.get(f"/v1/videos/{vid}", headers=ah).status_code == 200, "管理员放行"
|
||||
# 无登记(本次改动之前创建的老任务)→ 放行,不能砸掉正在轮询的老流程
|
||||
assert client.get("/v1/videos/never-recorded-xyz", headers=other).status_code == 200
|
||||
finally:
|
||||
m._get_adapter = real
|
||||
for n in names:
|
||||
client.delete(f"/auth/users/{n}", headers=ah)
|
||||
|
||||
|
||||
def test_config_env_rejects_multiline_value_and_writes_sandbox_file():
|
||||
"""env 值校验:换行/控制字符/超长一律 400(能凭空改掉 .env 里别的行);正常值才落盘。"""
|
||||
import os
|
||||
from fastapi.testclient import TestClient
|
||||
import app.main as m
|
||||
|
||||
client = TestClient(m.app)
|
||||
ah = {"Authorization": f"Bearer {_login_admin_session(client)}"}
|
||||
name = sorted(m._env_snapshot().keys())[0]
|
||||
env_path = m._env_file()
|
||||
assert str(env_path).endswith(".test_env"), f"测试必须写在沙箱 env 文件上:{env_path}"
|
||||
before = env_path.read_text(encoding="utf-8") if env_path.exists() else ""
|
||||
try:
|
||||
for bad in ("abc\ndef", "abc\rX=A", "A\x00B", "x" * 4097):
|
||||
r = client.post("/config/env", json={"envs": {name: bad}}, headers=ah)
|
||||
assert r.status_code == 400, (bad[:12], r.status_code, r.text)
|
||||
after = env_path.read_text(encoding="utf-8") if env_path.exists() else ""
|
||||
assert after == before, "被拒的值不该动到文件"
|
||||
old = os.environ.get(name)
|
||||
try:
|
||||
r = client.post("/config/env", json={"envs": {name: "sk-test-value-123"}}, headers=ah)
|
||||
assert r.status_code == 200, r.text
|
||||
assert os.environ.get(name) == "sk-test-value-123", "写盘后要立即在运行时生效"
|
||||
assert f"{name}=sk-test-value-123" in env_path.read_text(encoding="utf-8")
|
||||
finally:
|
||||
if old is None:
|
||||
os.environ.pop(name, None)
|
||||
else:
|
||||
os.environ[name] = old
|
||||
finally:
|
||||
if before:
|
||||
env_path.write_text(before, encoding="utf-8")
|
||||
|
||||
|
||||
def test_password_min_length_raised_to_8():
|
||||
"""口令下限 4→8:只作用于「显式给密码/改密」;登录不设下限(老短口令账号照常登录)。"""
|
||||
import tempfile, os
|
||||
from app.users import UsersStore, UserError
|
||||
p = tempfile.NamedTemporaryFile(suffix=".json", delete=False).name
|
||||
try:
|
||||
u = UsersStore(p)
|
||||
for bad in ("1234", "1234567", ""):
|
||||
try:
|
||||
u.create_user("shorty", password=bad)
|
||||
raise AssertionError(f"短口令 {bad!r} 不该被接受")
|
||||
except UserError as e:
|
||||
assert "8" in str(e), e
|
||||
u.create_user("shorty") # 默认密码=账号名,不受下限约束(老板约定)
|
||||
assert u.verify("shorty", "shorty") is True, "短默认口令仍要能登录"
|
||||
try:
|
||||
u.change_password("shorty", "1234567")
|
||||
raise AssertionError("改密到 7 位不该被接受")
|
||||
except UserError:
|
||||
pass
|
||||
u.change_password("shorty", "12345678")
|
||||
assert u.verify("shorty", "12345678") is True
|
||||
assert u.verify("shorty", "shorty") is False
|
||||
finally:
|
||||
try: os.unlink(p)
|
||||
except OSError: pass
|
||||
|
||||
|
||||
# 直接运行(非 pytest)—— 必须留在文件末尾,见上方 `test_image_request_goes_to_requested_model`
|
||||
# 之前的旁注:运行器只会收集执行到这一行时已经存在的 globals。
|
||||
if __name__ == "__main__":
|
||||
|
||||
Reference in new issue
Block a user