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 2ad98e2..e145b12 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 1a85139..e458b02 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 54ea049..149fa31 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 /