# 20 — 游戏合集的文案取了全局 meta（collection-ys 顶着星穹铁道的标题）

Status: resolved
Type: bug

## 现象

`dist/releases/collection-ys/project.json` 的 `title` 是「【崩坏：星穹铁道】昔涟」，
而这一档收的是原神的《魔女尼可的茶会》。同批还发现 `collection-hsr` 也在用全局标题
（只是它恰好含「崩坏：星穹铁道」，所以肉眼看不出来）。

## 根因

`tools/build.ts` 的 `addGame()`：

```ts
meta: { title: vault.global.title, ... }
```

全局 `wallpapers/meta.json` 那层是给「**全部**合集」（`collection-all`）写的，
而 `wallpapers/README.md` 的三层分工写的是「**游戏**给「该游戏合集」写文案」——
**代码与规范不一致**，规范是对的。

顺带记一条同批发现、但本次没动的：`ys` 目前只有 1 档壁纸，`generateProjectJson`
按 `wallpapers.length > 1` 决定要不要 `preset`，所以 `collection-ys` 是一个**没有预设下拉的合集**，
产物行为与 `single-ys-nico-tea` 相同。

## 改动

| 文件 | 改动 |
| --- | --- |
| `tools/lib/types.ts` | `GameMeta` 增加**必填** `title` 与可选 `description` |
| `tools/lib/vault.ts` | 校验 `title` 非空；`description` 要么不写、要么非空 |
| `tools/build.ts` | `addGame()` 的文案取自**游戏级** meta，不回落全局；`description` 缺省仍按「共 N 档」生成 |
| `tools/build.ts` | 新增警告：`scope: "game"` 且 <2 档的合集（"合集"名不副实） |
| `wallpapers/hsr/meta.json`、`wallpapers/ys/meta.json` | 补 `title` |
| `wallpapers/README.md` | 游戏 meta 字段表补 `title`（必填）/ `description` |
| `tools/checks/check-collection-copy.mts` | 新门禁：游戏合集的标题必须是"它自己那个游戏"的 |

## 没做（留给发布决策）

**一档的合集发不发。** `collection-ys` 现在会打警告但仍会产出。要不要在构建里跳过它
（或要求游戏 ≥2 档才生成合集），是发布范围的决定，没有替用户定；`--strict` 下这条警告会
让构建失败，需要时用它兜住。

## 验证

**先证明两条新门禁都会红。**

① 产物门禁（改动前的产物）：

    node tools/checks/check-collection-copy.mts
      ✓ collection-all 的 title 来自全局 meta  → 【崩坏：星穹铁道】昔涟
      ✗ collection-hsr 的 title 逐字等于它自己游戏的 title  → 产物 【崩坏：星穹铁道】昔涟 / 源 (未声明)
      ✗ collection-ys 的 title 提到了本游戏「原神」  → 【崩坏：星穹铁道】昔涟
      游戏合集文案归属：失败 3 处

② 源数据门禁（临时摘掉 `wallpapers/ys/meta.json` 的 `title`，已按原字节还原）：

    node tools/build.ts --dry-run
      构建失败：wallpapers/ys: 缺少 title（游戏合集的创意工坊标题）

**改完之后**：门禁 `通过`；`pnpm check` 全绿（typecheck / build / syntax / paths / dist 自包含）；
`diff-project` 仍是那 15 处工作区演进差异，**没有一处与 title/description 有关**——
`collection-all` 的已发布文案逐字段未动。