# 01 — CLI 范围选择：裸 id、`single`、`collect`、`sim`

Status: resolved
Type: task

## 问题

ADR 0005 写的是 `pnpm build name` / `pnpm build single` / `pnpm build collect`，但 `tools/build.ts` 只认 `--single` / `--collect`；`package.json` 的 `build:all` 跑的是不存在的 `--all`。

## 答案

`parseArgs` 改成"先摘子命令、再解析 flag"：

| 输入 | 范围 |
| --- | --- |
| `pnpm build` | 全编（2 单档 + 1 游戏合集 + 全部合集） |
| `pnpm build kv37` / `pnpm build kv37 xilian` | 指定壁纸 |
| `pnpm build single` | 只编全部单档 |
| `pnpm build single kv37` | 指定单档 |
| `pnpm build collect` | 全部合集（`collection-hsr` + `collection-all`） |
| `pnpm build collect hsr` | 指定游戏合集 |
| `pnpm build sim …` | 同 `pnpm build` 的范围，但每档都产出自包含包 |

子命令与壁纸 id 共用同一段位置，靠词表区分（`single`/`collect`/`sim` 是保留字，其余裸词是 id）。

**两个坑**：

- `pnpm build collect`（无参）不能用 `collect: "all"` 表示——那个值只加「全部壁纸合集」一项，会把 `collection-hsr` 漏掉。改用显式标记 `allCollections`。
- "不给 id" 与 "没选任何范围" 必须分开：`single` 无参 = 只编单档，无参 = 全编。靠 `onlySingles` / `allCollections` 显式标记，不靠"数组为空"推断。

`build:all` 改成 `pnpm build`（它就是全编，不需要额外 flag）。