suzmii
083df0aa2c
类型判定改为内容证据优先：消除 kind 与内容证据同权的脆弱点
**口径更正（后加的）**：本条提交**不是**"修复真机那 8 张卡"。经用真源码复算真机 manifest 确认，当前 HEAD 上这 8 张 `.json` 本就正确落 `document`、角标「文档」，该现象不复现——用户看到的是更早构建的行为。本条的真实价值是**消除 `kind` 与内容证据同权的脆弱点，并把「派发决策由内容证据决定」钉成不变量**，见下。
- 背景：真机「待归类」栏目曾出现 8 张卡——角标写「图片」、卡面却只有占位图标。该现象在当前 HEAD 上不复现（见上），但它对应一个**真实存在且此前只是碰巧没被踩中的脆弱点**：`projectedResourceKind` 里 `kind` 与内容证据**同权**，而 `artKind` 含 `ui`；一旦界面规格类资产丢了 `.json` 扩展名，预览派发就会翻车。原先能通过**完全依赖 `.json` 恰好在那张扩展名表里**，属巧合而非设计。
- 机制（旧行为）：`kind:"UI"` 被 `artKind` 命中 → 判定为 `art`；预览调度再按 `art` 走图像分支，又因 `mediaType:"application/json"` 不是图像而兜底成 `placeholder`，而 `requestPreview` 对 `placeholder` 直接返回——**一次 IPC 都不发**，卡片既不报错也没有图。
- `resourceProjectionModel.ts` 的 `projectedResourceKind` 改为两趟判定：第一趟只看 `mediaType` 与路径扩展名（文件内容的可验证证据），第二趟才看 `kind`（登记标签，可能过时或宽泛）。`kind` 不再与内容证据同权，因此 `kind:"ui"` 无法再把 `application/json` 改写成 `art`。
- 不改 `artKind` 的取值（`ui` 仍在表内），只调整判定顺序：最小改动面，`kind:"ui"` + `image/png` 这类正常资产行为不变（仍由 `mediaType` 命中）。
- 界面规格 JSON 现在落 `document` 分支，走 `read_local_project_text_preview`（Rust 侧 `.json` 与 `application/json` 本就在支持范围内且这些条目已登记），卡面渲染 JSON 文本摘要，角标随 `projectResourceTypeLabel` 变为「文档」。预览链条数、缓存、并发与门禁一律未动。
- `tests/resourceCardPreviewRealManifest.test.ts` 中记录旧行为的用例同步跟上新合同：`placeholder: 8` 改为 `document: 8`，用例名与注释改写为「52 张 PNG 走图片分支，8 条 UI 规格走文档分支，无一落占位」，并新增「角标与预览分支必须说同一件事」的逐条断言。旧断言记录的是缺陷本身，按「四不写」直接更新为当前权威行为，不做兼容保留；其余既有断言一条未放宽。
- 验证：`npm run test -- apps/ai-game-creator-shell/tests` 1202 passed / 4 skipped / 0 failed；`src/components/image-editor` 1385 passed；typecheck exit 0；check:encoding 通过；`git diff --check` 干净。
2026-09-11 13:30:14 +08:00
..
2026-09-05 19:48:27 +08:00
2026-09-11 13:30:14 +08:00
2026-09-01 17:00:44 +08:00
2026-09-01 17:00:44 +08:00
2026-08-22 13:17:26 +08:00