diff --git a/.env.example b/.env.example
index 4f6c4a2..4712807 100644
--- a/.env.example
+++ b/.env.example
@@ -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 # 配置页「环境变量」那张卡写哪个文件
diff --git a/.gitignore b/.gitignore
index 5c339ab..2a218fe 100644
--- a/.gitignore
+++ b/.gitignore
@@ -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 不提交,密钥就不会进版本库。
diff --git a/CHANGELOG.md b/CHANGELOG.md
index a13c444..ee74f7f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -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`,网关此前
diff --git a/Makefile b/Makefile
index 5edb1c5..2dca63a 100644
--- a/Makefile
+++ b/Makefile
@@ -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: ## 清理
diff --git a/README.md b/README.md
index 54c1bd1..cd74b1d 100644
--- a/README.md
+++ b/README.md
@@ -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。
## 备注
diff --git a/app/adapters/openai_compat.py b/app/adapters/openai_compat.py
index 260bdcd..668e428 100644
--- a/app/adapters/openai_compat.py
+++ b/app/adapters/openai_compat.py
@@ -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
diff --git a/app/main.py b/app/main.py
index e47c03b..9346c0f 100644
--- a/app/main.py
+++ b/app/main.py
@@ -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}")
diff --git a/app/sessions.py b/app/sessions.py
index 46ffd93..7e566d3 100644
--- a/app/sessions.py
+++ b/app/sessions.py
@@ -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
diff --git a/app/settings.py b/app/settings.py
index f10a84c..918d92e 100644
--- a/app/settings.py
+++ b/app/settings.py
@@ -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")
diff --git a/app/users.py b/app/users.py
index aeaab12..d442f2c 100644
--- a/app/users.py
+++ b/app/users.py
@@ -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)
diff --git a/app/video_owners.py b/app/video_owners.py
new file mode 100644
index 0000000..e62d7c1
--- /dev/null
+++ b/app/video_owners.py
@@ -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]
diff --git a/data/gateway.yaml b/data/gateway.yaml
index 2f01946..5f79ca1 100644
--- a/data/gateway.yaml
+++ b/data/gateway.yaml
@@ -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
# ── 网关入口鉴权 ─────────────────────────────────────
diff --git a/data/gateway.yaml.20260915-104301.bak b/data/gateway.yaml.20260915-104301.bak
deleted file mode 100644
index d816528..0000000
--- a/data/gateway.yaml.20260915-104301.bak
+++ /dev/null
@@ -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、
-# 跨域 也不生效(只会打开新标签页)。所以由网关代拉一次并加上
-# 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 兜底
diff --git a/data/gateway.yaml.20260915-104324.bak b/data/gateway.yaml.20260915-104324.bak
deleted file mode 100644
index 2f9d9d4..0000000
--- a/data/gateway.yaml.20260915-104324.bak
+++ /dev/null
@@ -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、
-# 跨域 也不生效(只会打开新标签页)。所以由网关代拉一次并加上
-# 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) 火山方舟(最高优先级)
diff --git a/data/gateway.yaml.bak b/data/gateway.yaml.bak
deleted file mode 100644
index 2f9d9d4..0000000
--- a/data/gateway.yaml.bak
+++ /dev/null
@@ -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、
-# 跨域 也不生效(只会打开新标签页)。所以由网关代拉一次并加上
-# 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) 火山方舟(最高优先级)
diff --git a/frontend/scripts/check-i18n.mjs b/frontend/scripts/check-i18n.mjs
index f736f7a..56a4cb5 100644
--- a/frontend/scripts/check-i18n.mjs
+++ b/frontend/scripts/check-i18n.mjs
@@ -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(//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)
diff --git a/frontend/src/lib/charts.ts b/frontend/src/lib/charts.ts
index 3b2bc11..bbc02c6 100644
--- a/frontend/src/lib/charts.ts
+++ b/frontend/src/lib/charts.ts
@@ -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] } }))
diff --git a/frontend/src/lib/upload.ts b/frontend/src/lib/upload.ts
index fb04551..9ec5219 100644
--- a/frontend/src/lib/upload.ts
+++ b/frontend/src/lib/upload.ts
@@ -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 = {}) => 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 = {
// 对话视觉:给模型看的,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 {
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((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 {
- 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 {
- 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, 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'),
)
}
}
diff --git a/frontend/src/locales/en.ts b/frontend/src/locales/en.ts
index 88686cb..70a15cd 100644
--- a/frontend/src/locales/en.ts
+++ b/frontend/src/locales/en.ts
@@ -327,6 +327,12 @@ export default {
placeholderRef: 'Describe the video and camera move (use /