feat: VLM 配置测试入口（选图即测 + 排障报文）

[jarvislee90s-dot]

feat: VLM 配置测试入口（选图即测 + 排障报文）

---

PR 正文

背景

为纯文本模型配置 VLM 视觉辅助分析后，目前没有任何验证手段——只能等真实对话里发图，靠结果反推配置是否生效。常见遭遇：模型先说"不接受图片输入"，追问后却开始幻觉式描述图片，用户无法判断是 Key 错、Base URL 错、模型名错，还是 VLM 服务本身异常（#1599）。

本 PR 在 VLM 配置区（Vision Analysis Provider）增加「测试 VLM」入口：选一张图立刻验证配置，失败时给人话诊断与完整排障信息。

设计要点：与真实链路同源

测试请求与真实识图链路共享同一提示词常量、请求体构造与端点构造（call_vlm_batch 等价重构为共用原语，行为零变化，现有测试兜底），并共用全局并发信号量。测试通过即代表真实对话识图可用；一个形状钉子测试锁定提示词与请求体逐字一致。

交互

• 「测试 VLM」→ 就地内联展开面板；选图即自动发起，无二次点击
• 失败诊断按类型人话化：认证失败（API Key 或模型名）、接口不存在、限流、超时、网络、解析失败、无描述文本
• 一键复制完整排障信息（诊断 + 原始请求/响应报文）；报文永不包含 API Key，图片 base64 截断展示
• 图片 >10MB / 非图片文件拒绝；表单当前值即可测（无需先保存）；中英双语

测试

自动化（全绿）：

• codex-plus-core vision 68 例：11 例 wiremock 逐类失败口径（成功 / 401 / 404 / 429 / 502 HTML 错误页 / 超时 / 连接拒绝 / 非 JSON / 无描述文本）+ 请求体形状钉子 + 无 Key 泄漏钉子
• protocol_proxy 74 例；cargo build --workspace 干净
• 前端翻译纯函数 16 例（含逐字锁定）+ tsc --noEmit 零错误
• i18n：本 PR 新增 29 键零缺失零冗余（校验工具余下的缺失/冗余为上游既有词典漂移，与本 PR 无关）

手工验收（15 项全过）：

#	测试项	结果
1	勾选「视觉辅助分析」后 VLM 区出现「测试 VLM」	✅
2	面板就地内联展开 / 收起	✅
3	选图即测：自动发起 → ✅ 识别成功（耗时 11.8s）+ 描述原文	✅
4	错 API Key → ❌ 认证失败（HTTP 401）	✅
5	错 Base URL → ❌ 接口不存在（HTTP 404）	✅
6	未保存表单直接测 → 用当前输入值	✅
7	>10MB 图片 → 拒绝并提示	✅
8	非图片文件 → 拒绝并提示	✅
9	复制错误 → 诊断 + model + HTTP 码 + error + 原始报文两段，无 API Key	✅
10	原始报文折叠：base64 显示前 64 字符 +「已省略」	✅
11	重测：原图重跑，进行中防重复触发	✅
12	换图并测试：选完自动开跑	✅
13	收起 / 收起测试面板	✅
14	英文界面全翻译	✅
15	真实识图链路回归不变（同源重构零影响）	✅

验收反馈驱动的一处修正：部分网关对未知模型名也返回 401，认证失败文案归因已从单一"API Key"改为"API Key 或模型名可能不正确"。

说明

• i18n 校验工具（tools/i18n-verify.mjs）本 PR 扩展为识别注入式 tr 回调；存量词典漂移建议后续单独清理

[BigPizzaV3]

合并前请补两点：1. 后端 对 重新做类型和大小校验，不能只依赖前端；2. 和 展示前需要脱敏，避免上游回显 Authorization/API Key 时复制排障信息泄露凭据。请补充对应测试。

[BigPizzaV3]

更正：合并前请补两点：1. 后端 test_vlm 对 image_data_url 重新做类型和大小校验，不能只依赖前端；2. raw_response 和 error 展示前需要脱敏，避免上游回显 Authorization/API Key 时复制排障信息泄露凭据。请补充对应测试。

[jarvislee90s-dot]

两条已补（对应 更正版意见），涉及提交：b43149b（脱敏）、4cf4baf（输入校验）、f98b4dd（英文漏翻修复）。

1. 后端输入校验（4cf4baf）

test_vlm 命令层新增第二道门 validate_image_data_url：data:image/* 类型 + base64 编码段 + 解码后字节 ≤ 10MB（与前端口径对齐；量解码后字节而非字符串长度，避免 base64 膨胀把前端合法放行的图误拒）。非法输入不发起网络请求，新增失败分类 invalid_image（中英文案 + 翻译测试）。正常 UI 路径零感知（前端第一道门不变），此门仅拦绕过前端的 IPC 直调。

2. 排障输出脱敏（b43149b）

raw_response 与 error 的全部构造路径（http_error / json_error / timeout / send_error / 命令层 client_error）统一经 redact_secrets 脱敏：已配置 Key 精确替换 + Authorization: / Bearer 头形态掩码（不区分大小写、兼容 JSON 形态；Key 为空时跳过精确替换）。脱敏在截断之前完成——先截断会把跨界 Key 截成半截，精确替换就失配了。

范围说明：脱敏针对的是「上游回显的凭据」；description（OCR 识别结果）不在脱敏范围——它是功能本体、仅本地展示，且「复制错误」拼装的内容不含该字段，无外贴通道；用户拿印着 Key 的图测试，OCR 仍逐字可见。

测试

• 校验：纯函数单测逐类覆盖——非图片、非 data URL、非 base64、超限、恰好 10MB 边界放行、合法放行；
• 脱敏：wiremock 构造上游回显 Authorization 头与 Key → 断言 error 与 raw_response 含 *** 且不含 Key 原文；原只钉 raw_request 的泄漏钉子已扩展为同时钉 raw_response；description 逐字可见有专项测试双向钉住（desc 含 Key 原文、raw_response 反之）；
• codex-plus-core vision 80 例全绿；前端 135 例全绿 + tsc 零错误；i18n 新增键零缺失零冗余。

手工验收

正常流程回归、前端第一道门（>10MB / 非图片文案）、devtools 直调 IPC 验证后端拒绝（返回 invalid_image 且无网络请求发出）、真实网关 401 复制排障信息无 Key、印 Key 图片测试 description 逐字可见、英文界面回归。期间发现 VLM 区「图片处理方式」下拉两个标签英文漏翻（上游存量词典漂移），已顺手修复（f98b4dd）。

一个已知现象（非 bug）

无论界面语言，测试返回的图片描述均为中文——识别提示词是与真实识图链路共享的中文常量（同源契约），真实对话中的识图描述本来就是中文，测试面板如实反映真实链路行为。若需按界面语言输出描述，需要将共享提示词本地化并让真实链路同步调整（否则破坏「测试通过即代表真实识图可用」的同源主张），属独立需求，不在本 PR 范围。

[jarvislee90s-dot]

补充两张截图（对应上文「英文漏翻修复 f98b4dd」与「一个已知现象」两节）：

英文界面下「Image handling」两个选项仍为中文（已在 f98b4dd 修复）	英文界面下测试返回的描述仍为中文（非 bug，见「已知现象」节）

[BigPizzaV3]

当前 macOS x64 workflow 在 hdiutil eject 阶段因 Resource busy 失败，编译本身已完成。请重新运行干净的三平台 workflow，确认 DMG 打包/卸载失败不再出现，并保留后端图片类型、大小校验和排障报文脱敏测试。

[jarvislee90s-dot]

三平台 workflow 已全绿（run 33620522493，head 22d109b）：Windows artifacts / macOS DMG x64 / macOS DMG arm64 均 success。

DMG 打包/卸载失败的根因是打包脚本对 macOS 延迟弹出的等待不足：Finder 释放卷后，卷目录先消失、磁盘镜像随后才完成弹出，原脚本在 detach 与 convert 两处的退避都不够长。已在 1335f5d + 22d109b 就地加固（detach 退避重试并把「卷已消失」视为成功；convert 重试加长到 5 次/30s 退避），两处均只改 scripts/installer/macos/package-dmg.sh，不涉及功能代码。

后端图片类型/大小校验与排障报文脱敏测试均保留在 b43149b / 4cf4baf（校验逐类单测 + wiremock 回显脱敏断言 + 泄漏钉子扩展）。