模型转换服务测试环境发布验收

2026-10-04，https://demo.51easyai.com，主机 8.218.158.189，部署目录 /root/easyai。测试环境已发布并完成以下验收；生产未部署，本次仅推送固定版本镜像，没有推送 latest。

发布和兼容升级

部署实现：2a1192eb7ec822773f55af96fa12e06bf96774a8。后端补丁：be56a7e0ec79d1a1e7420d870709014ed4bf010a。
初次从旧部署 f04bb5e 更新，实际复现了定制 Compose 和未跟踪配置阻断旧脚本拉取，以及 updater 占用 API 固定地址的问题。首次使用新版 update.sh 的旧配置迁移入口完成备份、语义合并和更新，再由同一脚本部署服务；没有手动修改数据库或替代脚本启动业务容器。
最终更新命令：UPDATE_MODE=image UPDATE_NON_INTERACTIVE=1 UPDATE_RELEASE_VERSION=3.23.0.20261003.1 UPDATE_SERVICES='easyai-server easyai-web model-conversion-worker' bash /root/easyai/update.sh。
API 镜像重新构建。前端 SSR、no-SSR 和 Worker 发布 .1 版本别名，镜像摘要与原版本相同，其 OCI 构建版本仍为 3.23.0.20261003；测试主机运行 SSR。完整摘要见上级发布记录及 patch-deployment.json。
API、前端、Worker、updater 均健康；版本接口为 3.23.0.20261003.1，主页、健康及更新就绪接口均 HTTP 200。补丁更新中的 13 个非目标容器保留容器 ID 和启动时间，Nginx 及原鉴权、Mongo、Redis配置已核验保留。
旧配置备份保存在主机受限目录 data/deployment-backups/legacy-update-20261003-075918-g3q8cib5；本机记录不含配置密钥。后续固定版本更新直接使用部署目录的 update.sh。

浏览器上传问题的复现和修复

实际进入普通 /ai/canvas/:projectId，从文件输入选择 OBJ，确认米、默认轻量副本和性能优先。修复前，上传计划返回 HTTP 201，但本地存储合法地省略了 headers；浏览器在 Object.entries(upload.headers) 抛出 TypeError: Cannot convert undefined or null to object，未发送文件 PUT，未进入转换。

修复仅在模型转换接口把省略的请求头变为 {}，保留云存储提供的签名头，通用存储行为不变。真实服务回归测试修复前 1 失败、1 通过；修复后转换协议 13 项和存储既有行为 27 项全部通过。证据为 browser/upload-regression.json，失败截图为 browser/import-failed.png。

修复后真实 Chrome 通过普通画布执行了文件 PUT、资源完成、CanvasTask、独立 Worker 转换及 WebGL 加载，原始网络证据保存在 browser/uncached-import.json。没有隐藏界面、替换真实加载器或强制点击。

实际结果

验收	结果	原始记录
默认素体	站立身高 1.72 米	`browser/results.json`
OBJ 导入	20 × 0.2 × 20 米，默认轻量副本、性能优先	`browser/uncached-import.json`、`browser/import.png`
实际缩放	0.05 → 1 × 0.01 × 1；10 → 200 × 2 × 200；20 → 400 × 4 × 400；恢复 1 → 20 × 0.2 × 20 米	`browser/transform-save.json`，数值来自实际控件读数
保存与全新浏览器重开	米制 `sceneState` 保留轻量版本、倍率 1、资源 ID；尺寸 20 × 0.2 × 20 米；场景 JSON 3239 字节，没有 Base64；页面无异常	`browser/results.json`、`browser/saved-reopened.png`
约 80 万面 GLB，补丁环境重测	798848 → 100000 三角面；19203544 → 714896 字节；20 × 0.200000003 × 20 → 20 × 0.199977756 × 20 米；高度误差约 0.022 毫米；产物 SHA 校验通过	`patch-conversion/results.json`
4K 贴图	4096² → 1024²；生成 KTX2 和 PNG 兼容产物；保留尺寸	`texture-4096/results.json`，原版本实测，补丁复用同一 Worker 镜像
骨骼和动画	100001 三角面不减面；3 个节点、1 套骨骼、1 个动画保留；尺寸保留	`skin-animation/results.json`，原版本实测，补丁复用同一 Worker 镜像
Worker 专属接口与付费通道	匿名和普通登录 token 都不能调用产物管理接口，均 HTTP 403；混元通道关闭	`patch-worker-access.json`

验收分阶段执行：先完成真实导入、变换和普通保存，再以全新 Chrome 会话重开并检查。保存会自动关闭编辑器；已有图片输出的节点通过编辑按钮重开，双击图片按原契约打开图片预览。米制 fixture 使用正式 sceneState 字段。早期脚本对这些入口的错误假设已纠正，不计作业务失败或成功证据。

耗时和资源边界

转换协议定向 Nx：2.38 秒（13 项，Jest 0.84 秒）；存储定向 Nx：1.87 秒（27 项，Jest 0.638 秒）。
Shared 构建 0.66 秒，API 定向 Nx 构建 20.83 秒。正式 Linux amd64 Dockerfile 构建、固定版本推送及实际部署均已完成；未记录本次 Docker 构建和浏览器全链路的完整墙钟耗时。
最后一次 GLB 链路共 71.932 秒：上传 18.502 秒，转换、任务等待和产物下载共 52.444 秒。该数值包含网络与存储开销，是一次功能复验，不是受控 A/B/C benchmark，也不能单独解读为减面计算耗时。
转换及下载期间的 12 个本机 API 可用性采样全部 HTTP 200，中位数约 2.17 毫秒，最大约 6.17 毫秒。见 patch-runtime-samples.json；这不能证明满载 P95 退化目标。
Worker 实际限制：2 CPU、4 GiB、并发 1、PID 64、只读根文件系统、无主机端口；共享内部鉴权配置匹配。见 patch-deployment.json。测试主机仅 2 CPU、3.576 GiB 实际内存、没有 swap，不能把本轮小规模通过当作生产容量结论。
旧配置迁移、固定版本及 Bash/PowerShell 更新定向测试通过，分别约 1.28 秒、21.045 秒；测试主机的旧脚本冲突和新版脚本更新另外经过真实执行。没有用命令 mock 替代真实发布验收。

尚未覆盖

客户原始 GLB、其他实际硬件、Worker 满载时的 API 基线对照、20 次循环内存趋势，仍需独立验收。测试主机没有重新执行全部旧场景/模板交互，也没有完成编辑器、机位预览、图片与视频的逐像素对应点检查；先前定向/本地记录仅代表其原环境。不得据此声称视觉无损、全部性能目标或生产验收已通过。原质量记录中的国际化历史缺失项仍未改动。

6.3 KiB Raw Blame History Unescape Escape