[std-external]

问题

今天镜像的 Mod 目录接口在 HTTP 200、结构正常、只是数据变少/字段变化时，客户端表现得和「目录里真的没有 Mod」完全一样：筛选空、没有报错、日志里也查不到任何东西。

代码里的兜底就是这一行（src/celemod-ui/src/api/modCatalog.ts）：

const nextCatalog = Array.isArray(parsed.data) ? parsed.data : [];

只要上游把返回体的 data（或整体 JSON 形状）改掉，前端就静默当成空目录，用户和排查的人都拿不到任何线索——今天排查时只能靠逐层手抓接口才定位到是上游数据的问题。

改动

把返回体解析抽到 src/api/catalogResponse.ts 的 parseCatalogResponse：

• data 不是数组 → 抛错并带上 code / message；
• code 存在且不是 200 → 抛错并带上理由；
• 返回体不是 JSON（比如网关 502 的 HTML）→ 抛错。

界面会走现有的「加载失败，请重试」，错误也会经前端日志（logging.ts 的 console 转发）落盘，能直接看出是哪一侧的问题。

验证

• 新增 src/api/catalogResponse.test.ts（5 个用例：正常、空目录、缺 data、code 非 200、非 JSON），node --import tsx --test src/api/catalogResponse.test.ts 全过；
• tsc --noEmit 通过；
• 行为变化只在「响应形状不对」这一条路径上：正常响应（含空数组）解析结果与之前完全一致。

说明

这次事故本身是上游数据问题（镜像那边已确认是上游字段改名，客户端不需要跟着改）；这个 PR 只是把「同样的上游变化下次发生时能报出来」，不改变目录接口的语义。