Shuery
3f11426964
把项目从「手写 dist/」改成「wallpapers/ 是唯一真相来源，dist/ 由 pnpm build 生成」，
并补上配套的类型、门禁与抓取器。一次提交落地整条管线，因为拆开会留下不能构建的中间态。
- src/：运行时与模拟器源码（TS，strict），编译到 build/ 再拷进各分发
- tools/：build / dev / check-{syntax,paths,dist}，以及抓取器与回归门禁 tools/checks/
（.scratch/ 下那批一次性脚本移入 tools/checks/ 并入库为长期门禁）
- wallpapers/：七档壁纸的源数据 + README.md（id/音频/预设的完整规范）
- docs/adr/0005-0008：构建管线与分发拓扑、模拟器契约、自包含 sim、每骨架资源布局
- .gitignore：排除 .scratch/ 的参考资料副本（上游 spine 整仓克隆 ~1.2 GB、
抓取侦查数据 ~680 MB）与调试转储；这些是本地调查材料，补偿会让仓库无法克隆
- 归一化 .gitignore/CONTEXT.md 行尾（工作区 CRLF、索引 LF 造成的整文件假 diff）
同时修掉三档卡住构建的未完工壁纸：
- kv45 的 meta.json 里 id 还是抓取期场景名 scene_main，经 downloader promote 正名为 kv45
- shajin / zhigengniao_juheye 的 meta.json 误用了骨架描述文件（name/spine/animations/pages）、
且都缺 preset.template.json；现按规范重建：骨架沉到 spines/<名>/（spine-ts 按 atlas 所在
目录解析贴图页）、补上元数据与单骨架预设，并清掉 zhigengniao 骨架里指向作者机的绝对路径
- 顺带 promote 已在 sources.yml 里的 kv46（月升之前，与兽共舞）
pnpm check 五道门全绿：10 个分发 / 7 档壁纸 / 141 处引用自包含。
32 lines
1.4 KiB
Markdown
32 lines
1.4 KiB
Markdown
# 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）。
|