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 处引用自包含。
40 lines
1.6 KiB
TypeScript
40 lines
1.6 KiB
TypeScript
// `tools/cdp.mjs` 的类型声明。
|
|
//
|
|
// 它是纯 JS，以前没有任何声明——于是每个 import 它的验收脚本都退化成 `any`，
|
|
// 连带 `withPage(..., ({ send, evaluate }) => ...)` 的解构参数全部是隐式 any。
|
|
// 一个 20 行的声明就能把那一整类错误消掉（实测 180 处里占 41 处）。
|
|
//
|
|
// 这里刻意用 `any` 而不是 `unknown` 作为 evaluate/send 的返回值：它们直通 CDP，
|
|
// 返回什么完全取决于传进去的表达式字符串，静态上无从约束——写成 `unknown` 只会逼每个
|
|
// 调用点加断言，反而把噪音搬了个地方。
|
|
|
|
export interface PageOptions {
|
|
width?: number;
|
|
height?: number;
|
|
/** Edge 的 user-data-dir；给不同脚本各用一个，免得并发时互相踢掉。 */
|
|
profile?: string;
|
|
extraArgs?: string[];
|
|
}
|
|
|
|
/** 一个已连上的页面。 */
|
|
export interface Page {
|
|
/** 发一条 CDP 命令。 */
|
|
send(method: string, params?: Record<string, unknown>): Promise<any>;
|
|
/** 在页面里求值并取回值。表达式里的异常会抛出来。 */
|
|
evaluate(expression: string): Promise<any>;
|
|
/** 页面控制台输出（含 Log.entryAdded 的 error）。 */
|
|
consoleLines: string[];
|
|
/** 未捕获异常。 */
|
|
exceptions: string[];
|
|
/** Edge 的 stderr，排查启动失败时用。 */
|
|
stderr(): string;
|
|
}
|
|
|
|
/**
|
|
* 起一个无头 Edge、连上它、执行 `fn`，结束后收掉浏览器。
|
|
* `fn` 的返回值原样返回。
|
|
*/
|
|
export function withPage<T>(opts: PageOptions, fn: (page: Page) => Promise<T>): Promise<T>;
|
|
|
|
export function sleep(ms: number): Promise<void>;
|