zijunchiang
a78a536476
feat(integration): 跨端集成验收（包内客户端 × 真实 Web 服务端）+ 修两个真实缺陷（v0.2.3）
单测打的是假 HTTP 夹具，Web 端测试只验自己那一侧 —— 两端各自绿灯不代表契约字段
真的对得上。本版加了跨端集成验收，并在首次运行就抓到两个真实缺陷。
一、跨端集成验收（T-WIN-019）
* build/integration/probe-integration.gd：只加载**包内**代码
（`godot --main-pack <pck> --script <探针>` + res://），打真实服务端并逐项断言：
/health 六个契约版本、catalog/version 指纹、catalog/export 解析出的四类资源与
defaultModelId；**场景物理参数逐项比对**（重力/基础风/阵风/风坐标系/地面摩擦坡度/
碰撞体/出生点/相机/环境）+ Wind.sample(0) + 场景 GLB 可下载；
动作 NDJSON → 客户端解析帧数 == 服务端帧数、33 点、每帧服务端关节角、
推导帧率 30 fps、时长 96.67 s；缩略图 PNG；模型 VRM 可下载。
* build/integration/seed-catalog.mjs：用**真实素材**播种目录
（示例文件/ 下的真 VMD → 内部标准 33 点；真 PMX → VRM；场景 GLB + 物理参数），
并把期望值（含从 /health 取的契约版本）写成 JSON。
* build/accept-integration.sh：编排「服务端可达 → 播种 → 包内探针 → 汇报」。
实测（v0.2.3 包内 pck × 真实 Web v0.7.4 + 真实 MySQL）：全部通过。
二、探针抓到的两个真实缺陷
1. `CatalogTypes.Motion` 缺 `thumbnail_url`：服务端 catalog/export 从
data-models 0.6.0 起一直在发 thumbnailUrl（Model/Scene 都有），客户端默默丢掉。
已补字段与解析（缺失为 ""），新增 tests/test_catalog_types.gd（4 项 20 断言）
用**服务端真实报文形状**锁住三个资源类型的覆盖，并显式记录一处刻意不消费的差异
（Model.usable/unusableReason —— 目录只下发可用模型，恒为 true）。
2. `ApiClient._request()` 对**所有**响应无条件 `raw.get_string_from_utf8()`：
数据本身没错（二进制路径返回原始字节），但每下载一个文件都会打印
「Unicode parsing error … Invalid UTF-8 leading byte (N)」噪声，并把整个文件
（模型可达数十 MB）解码成 String 拷贝后丢弃。改为只在需要文本时解码。
三、顺带修掉测试里的写死契约版本
tests/test_api_integration.gd 断言 rest-api/websocket-keypoints/skeleton-topology
均为 "0.1.0"。该用例只在服务端可达时才跑，平时一直 skip，所以契约升到 0.5.0 后
没有任何地方发现它。改为从仓库 contracts/VERSION 读期望值并与 /health 比对
（顺带成为「客户端契约快照 vs 服务端」的跨端校验）。
证据：verify.sh 全绿（820 通过 / 0 失败，比上版 +46，因为服务端在线时 API 集成组
真的跑了）；包内 pck 跨端集成探针全部通过；check-version/PE 版本资源 = 0.2.3。
2026-09-17 05:18:03 +08:00
..
2026-09-14 20:04:54 +08:00
2026-09-14 20:05:04 +08:00
2026-09-17 04:22:57 +08:00
2026-09-17 00:45:23 +08:00
2026-09-17 05:18:03 +08:00
2026-09-14 20:05:04 +08:00
2026-09-14 20:04:54 +08:00
2026-09-14 20:05:04 +08:00
2026-09-17 05:18:03 +08:00
2026-09-17 05:18:03 +08:00
2026-09-17 00:45:23 +08:00
2026-09-14 20:05:04 +08:00
2026-09-14 20:04:54 +08:00
2026-09-14 20:05:04 +08:00
2026-09-14 20:04:54 +08:00
2026-09-14 20:05:04 +08:00
2026-09-14 20:04:54 +08:00
2026-09-14 20:05:04 +08:00
2026-09-17 03:59:29 +08:00
2026-09-14 20:05:04 +08:00
2026-09-14 20:04:54 +08:00
2026-09-14 20:05:04 +08:00
2026-09-17 03:59:29 +08:00
2026-09-17 00:45:23 +08:00
2026-09-14 20:04:54 +08:00
2026-09-14 20:05:04 +08:00