@coralai/sps-cli 0.65.74 → 0.65.76

package/dist/console/routes/art.js

@@ -0,0 +1,355 @@
+/**
+ * @module        console/routes/art
+ * @description   `/api/art/*` —— 美术算子 HTTP 面(路径进路径出)。契约见 docs/design/art-http-surface.md。
+ * @layer         console
+ *
+ * 🔴 **本文件是适配层,不是算法。** 算法在 `providers/art/{pixels,sheet,atlas,frames}.ts`,
+ * 由 coral-studio 整段移交,**按只读对待**。这里与 `commands/artCommand.ts` 是**并列的两个适配器**
+ * (CLI 面 / HTTP 面),共用同一批算子。
+ *
+ * 边界(约束来自 studio,见设计文档 §1):
+ * - **不认识"资源 id"**,只认路径;**不记计量**(算法调用不是模型调用);**无进程内状态**。
+ * - 台账(索引 / 缩略图 / DB / undo / 配额)全部留 studio。
+ *   ⚠️ 判别式:哪天有人提「让 sps 记住上次结果好做 undo」,就是这条线被破的信号。
+ *
+ * 🔴 **`in`/`out` 一律当不透明路径**:不解析、不从中推断产品/租户/用户、不 mkdir。
+ * 资源库根目前叫 `game-platform`(废弃的旧产品名),改名是排着的事 ——
+ * 只要这里不 `split('/')` 去认产品名,改名那天**一行都不用动**。
+ *
+ * 成功响应 = CLI stdout 的 JSON(含 `ok:true`),**错误走 problem-json**(附录 A.5)——
+ * 这是唯一一处故意不一致:sps 的 HTTP 契约只有一种错误形状,为 art 开第二种代价更大。
+ *
+ * ─────────────────────────────────────────────────────────────────────────
+ * ✅ **欠账 #31 已结清(2026-08-11,搭 1.4 的车)** —— 这段留着,因为**判据比结论有用**。
+ *
+ * 曾经:本文件 + `console/lib/artPaths` 共 **19 处同步 fs**(`readFileSync`/`writeFileSync`
+ * + 围栏的 `existsSync`/`statSync`/`realpathSync`),**阻塞 console 的事件循环** ——
+ * 拖慢同进程的**每一个** HTTP 请求(含 `/api/health` 探针与 SSE 心跳),并发调用串行化。
+ * 现在:两个文件的同步 fs **计数为 0**(`grep -c 'Sync('`)。
+ *
+ * 🔴 **为什么移交时那么写不是缺陷**:算法原本只在 CLI 里跑,同步 IO 只阻塞它自己。
+ * **换了宿主(CLI → console 进程)之后性质才变的。**
+ * ⇒ 所以只改**这个适配层**;`providers/art/*` 那些只读算法件**一行没动**(它们在 CLI 里同步是对的)。
+ * ⚠️ 还剩一处在算法件里:`atlas.logicalSize(mp)` 内部同步读 manifest(`/inspect` 会走到)。
+ *    **刻意不动** —— 动它就要动只读移交件,而它是一次几 KB 的读。记在这里,别当成漏了。
+ *
+ * ⚠️ 归因时态(值得留):这**从来不是"美术流水线迁移引入的风险"**,是 0.65.75 起就在生产上的性质。
+ * 写成迁移风险,它就会在排期时跟着迁移一起被延后 —— 而它跟迁移无关。
+ * (没有马上改的原因也留着:上次为发版重启生产打断了 **307 个在跑会话**,
+ *  几~几十 ms 的收益不值得单独发一版 ⇒ 决定搭下一次发版的车。**这次就是那次车。**)
+ * ─────────────────────────────────────────────────────────────────────────
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { basename, dirname, join, resolve } from 'node:path';
+import { Hono } from 'hono';
+import { domainError, toHttpStatus, toProblemJson } from '../../shared/errors.js';
+import { resolveInputPath, resolveManifestPath, resolveOutputDir, resolveOutputPath } from '../lib/artPaths.js';
+function isDomainError(e) {
+    return typeof e === 'object' && e !== null && 'kind' in e && 'code' in e && 'message' in e;
+}
+const invalid = (code, msg, details) => domainError('validation', code, msg, details ? { details } : {});
+function str(b, k) {
+    const v = b[k];
+    return typeof v === 'string' && v.trim() !== '' ? v.trim() : undefined;
+}
+function reqStr(b, k) {
+    const v = str(b, k);
+    if (!v)
+        throw invalid('FIELD_REQUIRED', `缺必填字段 ${k}`, { field: k });
+    return v;
+}
+function num(b, k) {
+    const v = b[k];
+    if (v === undefined || v === null)
+        return undefined;
+    const n = typeof v === 'number' ? v : Number(v);
+    if (!Number.isFinite(n))
+        throw invalid('FIELD_INVALID', `${k} 不是数字:${String(v)}`, { field: k });
+    return n;
+}
+function reqNum(b, k) {
+    const n = num(b, k);
+    if (n === undefined)
+        throw invalid('FIELD_REQUIRED', `缺必填字段 ${k}`, { field: k });
+    return n;
+}
+function bool(b, k) {
+    return b[k] === true || b[k] === 'true';
+}
+/** `out` 省略 = 原地覆盖 `in`(同 CLI)。**但仍要过写围栏** —— 原地覆盖也是写。 */
+async function outOf(b, inPath) {
+    const raw = str(b, 'out');
+    return await resolveOutputPath(raw ?? inPath, 'out');
+}
+/** 统一的 body 解析 + 错误翻译。算子异常按"输入的错 vs 我们的错"分流。 */
+async function run(c, fn) {
+    let body;
+    try {
+        body = (await c.req.json());
+        if (typeof body !== 'object' || body === null)
+            throw new Error('not an object');
+    }
+    catch {
+        return c.json(toProblemJson(invalid('BODY_INVALID', '请求体必须是 JSON 对象')), 422);
+    }
+    try {
+        return c.json({ ok: true, ...(await fn(body)) });
+    }
+    catch (e) {
+        if (isDomainError(e))
+            return c.json(toProblemJson(e), toHttpStatus(e));
+        const msg = e instanceof Error ? e.message : String(e);
+        // 🔴 EACCES 是 422 不是 500:可操作的修法在调用方那边(换一个共享树内的路径)。
+        //    回 500 会被读成「sps 坏了」—— 那正是我们要防的误归因。
+        const errno = e.code;
+        if (errno === 'EACCES' || errno === 'EPERM' || errno === 'EROFS') {
+            const de = domainError('validation', 'PATH_NOT_ACCESSIBLE', `路径不可写:${msg}`, {
+                details: { errno, syscall: e.syscall, path: e.path },
+            });
+            return c.json(toProblemJson(de), 422);
+        }
+        // rembg 是独立 HTTP 服务 → 它不通是 external(502),不是我们内部错。
+        if (/rembg/i.test(msg)) {
+            const de = domainError('external', 'REMBG_UNAVAILABLE', msg);
+            return c.json(toProblemJson(de), 502);
+        }
+        return c.json(toProblemJson(domainError('internal', 'ART_FAILED', msg)), 500);
+    }
+}
+export function createArtRoute() {
+    const app = new Hono();
+    app.post('/chroma-key', (c) => run(c, async (b) => {
+        const { chromaKey } = await import('../../providers/art/pixels.js');
+        const inPath = await resolveInputPath(reqStr(b, 'in'));
+        const out = await outOf(b, inPath);
+        const opts = {};
+        const t = num(b, 'tolerance');
+        const f = num(b, 'feather');
+        if (t !== undefined)
+            opts.tolerance = t;
+        if (f !== undefined)
+            opts.feather = f;
+        const buf = await chromaKey(await readFile(inPath), opts);
+        await writeFile(out, buf);
+        return { out, bytes: buf.length };
+    }));
+    app.post('/rembg', (c) => run(c, async (b) => {
+        const { rembgRemove } = await import('../../providers/art/pixels.js');
+        const inPath = await resolveInputPath(reqStr(b, 'in'));
+        const out = await outOf(b, inPath);
+        const buf = await rembgRemove(await readFile(inPath));
+        await writeFile(out, buf);
+        return { out, bytes: buf.length };
+    }));
+    app.post('/clean-alpha', (c) => run(c, async (b) => {
+        const { cleanAlpha } = await import('../../providers/art/pixels.js');
+        const inPath = await resolveInputPath(reqStr(b, 'in'));
+        const out = await outOf(b, inPath);
+        const buf = await cleanAlpha(await readFile(inPath), num(b, 'lo') ?? 30, num(b, 'hi') ?? 200);
+        await writeFile(out, buf);
+        return { out, bytes: buf.length };
+    }));
+    /** 只读判据:这张图值不值得交给模型(不是"抠得干不干净")。 */
+    app.post('/residue', (c) => run(c, async (b) => {
+        const { magentaResidue, alreadyTransparent } = await import('../../providers/art/pixels.js');
+        const buf = await readFile(await resolveInputPath(reqStr(b, 'in')));
+        const [residue, transparent] = await Promise.all([magentaResidue(buf), alreadyTransparent(buf)]);
+        // needsRembg 直接给结论,省得调用方自己比阈值比错。
+        return { residue, alreadyTransparent: transparent, threshold: 0.005, needsRembg: !transparent && residue > 0.005 };
+    }));
+    app.post('/inspect', (c) => run(c, async (b) => {
+        const sharp = (await import('sharp')).default;
+        const { alreadyTransparent } = await import('../../providers/art/pixels.js');
+        const { logicalSize } = await import('../../providers/art/atlas.js');
+        const buf = await readFile(await resolveInputPath(reqStr(b, 'in')));
+        const meta = await sharp(buf).metadata();
+        const width = meta.width ?? 0;
+        const height = meta.height ?? 0;
+        const out = {
+            width,
+            height,
+            channels: meta.channels ?? 0,
+            hasAlpha: meta.hasAlpha ?? false,
+            alreadyTransparent: await alreadyTransparent(buf),
+        };
+        // 🔴 「合法缺席」vs「故障」要分开(studio 修正的那条):
+        //    路径②(资源库)的图**压根不属于任何一局游戏**,没有 manifest 也不该有 ——
+        //    按"缺就抛"会让 inspect 在那条路上**永远抛**。
+        //    所以:不给 manifest = 合法缺席 → 占屏比**字段整个不出现**;
+        //          给了但读不到/缺字段 = 故障 → 抛。
+        //    ⚠️ 不返回 null 占位:「字段不存在」调用方拿不到会自己想办法,
+        //       「字段是 null」会被 `?? 0` / `< 50` 这类判断悄悄吃掉。
+        //       **不能提供的答案,不要给一个形状正确的占位。**
+        const manifest = str(b, 'manifest');
+        if (manifest) {
+            const mp = await resolveManifestPath(manifest);
+            let logical;
+            try {
+                logical = logicalSize(mp);
+            }
+            catch (e) {
+                // 🔴 **不透传原始异常消息**:JSON.parse 失败的消息会带文件原文片段。
+                //    manifest 是唯一按非图片解析的入参,这是它单独需要处理的原因。
+                throw invalid('MANIFEST_INVALID', `manifest 无法解析或缺 width/height:${mp}`, {
+                    field: 'manifest',
+                    path: mp,
+                    reason: e instanceof Error && /缺 width\/height/.test(e.message) ? 'missing-fields' : 'unreadable',
+                });
+            }
+            out.logicalWidth = logical.width;
+            out.logicalHeight = logical.height;
+            out.widthPctOfScreen = logical.width ? +((width / logical.width) * 100).toFixed(1) : null;
+            out.heightPctOfScreen = logical.height ? +((height / logical.height) * 100).toFixed(1) : null;
+        }
+        return out;
+    }));
+    app.post('/slice-sheet', (c) => run(c, async (b) => {
+        const { sliceSheet } = await import('../../providers/art/sheet.js');
+        const inPath = await resolveInputPath(reqStr(b, 'in'));
+        const cols = reqNum(b, 'cols');
+        const rows = reqNum(b, 'rows');
+        const r = await sliceSheet(await readFile(inPath), cols, rows, { grid: bool(b, 'grid') });
+        const outDirRaw = str(b, 'outDir');
+        const stem = str(b, 'name') ?? 'frame';
+        const outDir = outDirRaw ? await resolveOutputDir(outDirRaw) : undefined;
+        // 🔴 清单:**次序是数据,不是排序约定**。`frame_10.png` 字典序排在 `frame_2.png` 前面 ——
+        //    调用方靠文件名排 = 帧序乱、而每张图都对(最难看出的那种错)。
+        // 🔴 **空格占一个 index 并出现在清单里**(w/h 为 0 + empty:true)。跳过 = 其后所有帧索引前移,
+        //    而游戏按 `<id>_0/_1` 引用 —— 一个空格错位整套动画。
+        //    ⚠️ 这条在 packSheet 内部保住过一次,**清单是新面,同一个坑要再堵一次**:
+        //       移交时保住的不变量不会自动跟到 HTTP 面上。
+        // Promise.all 保序 —— 见上:**次序是数据**,不是排序约定。
+        const items = await Promise.all(r.frames.map(async (buf, i) => {
+            const size = r.sizes[i] ?? { w: 0, h: 0 };
+            const file = `${stem}_${i}.png`;
+            if (outDir)
+                await writeFile(join(outDir, file), buf);
+            return {
+                index: i,
+                ...(outDir ? { file } : {}),
+                w: size.w,
+                h: size.h,
+                ...(size.w === 0 && size.h === 0 ? { empty: true } : {}),
+            };
+        }));
+        // ⚠️ `detected:true`(内容感知切)时 index 是**连通域顺序**,不是网格格位:
+        //    空区域根本不产生 cell,所以那条路上空格是**缺席**而非占位,frames 可能 ≠ cols×rows。
+        //    这正是 frames vs expectedFrames 要给出来的原因 —— 它是"要不要 grid:true 重来"的信号。
+        return {
+            frames: r.frames.length,
+            expectedFrames: cols * rows,
+            detected: r.detected,
+            sizes: r.sizes,
+            items,
+            ...(outDir ? { outDir } : {}),
+        };
+    }));
+    app.post('/pack-atlas', (c) => run(c, async (b) => {
+        const { packSheet } = await import('../../providers/art/sheet.js');
+        const { writeAtlasJson } = await import('../../providers/art/atlas.js');
+        const inPath = await resolveInputPath(reqStr(b, 'in'));
+        const cols = reqNum(b, 'cols');
+        const rows = reqNum(b, 'rows');
+        const opts = { grid: bool(b, 'grid') };
+        // 🔴 限制帧高**只能**走这里(切分后逐帧缩)。事后 resize 整张图集会把
+        //    「单帧上限」误当整图上限 —— 8 帧图集每帧变 1/8,而一切看起来都自洽。
+        const fmh = num(b, 'frameMaxHeight');
+        if (fmh !== undefined)
+            opts.frameMaxHeight = fmh;
+        const packed = await packSheet(await readFile(inPath), cols, rows, opts);
+        const out = await outOf(b, inPath);
+        const id = str(b, 'id');
+        const dir = id ? await resolveOutputDir(str(b, 'assetsDir') ?? dirname(out), 'assetsDir') : undefined;
+        // 🔴 与 CLI 面同一道断言(cbc3454):atlas 的 `meta.image` 由 `id` 推出(`${id}.png`),
+        //    而图落在 `out`。不自洽时 atlas 结构合法、坐标自洽,只有引擎加载时报「找不到图」。
+        //    **先断言再落盘** —— 宁可什么都不写,也不写出一个指向空气的 atlas。
+        if (id && dir && resolve(dir, `${id}.png`) !== out) {
+            throw invalid('ATLAS_ID_OUT_MISMATCH', `out 与 id 不自洽:图落在 ${out},而 atlas 的 meta.image 会写 ${resolve(dir, `${id}.png`)}`, {
+                out,
+                expectedImage: resolve(dir, `${id}.png`),
+            });
+        }
+        await writeFile(out, packed.buf);
+        let atlas;
+        if (id && dir) {
+            writeAtlasJson(dir, id, packed);
+            atlas = resolve(dir, `${id}.json`);
+        }
+        return {
+            out,
+            width: packed.width,
+            height: packed.height,
+            frames: packed.frames.length,
+            expectedFrames: cols * rows,
+            detected: packed.detected,
+            ...(atlas ? { atlas } : {}),
+        };
+    }));
+    // 🔴 两种 normalize 拆成两个端点(CLI 是 `--mode`):
+    //    sheet 收单个 `in`,frames 收 `in: string[]` —— 同名字段两种类型正是我们刚在
+    //    `pack-atlas` 的 `id` 上踩过的那类坑,分开就不存在。
+    app.post('/normalize-sheet', (c) => run(c, async (b) => {
+        const { normalizeSheet } = await import('../../providers/art/sheet.js');
+        const inPath = await resolveInputPath(reqStr(b, 'in'));
+        const out = await outOf(b, inPath);
+        const r = await normalizeSheet(await readFile(inPath), reqNum(b, 'cols'), reqNum(b, 'rows'));
+        await writeFile(out, r.buf);
+        return {
+            out,
+            mode: 'sheet',
+            frames: r.frames,
+            cols: r.cols,
+            rows: r.rows,
+            cellWidth: r.cellWidth,
+            cellHeight: r.cellHeight,
+            detected: r.detected,
+        };
+    }));
+    app.post('/normalize-frames', (c) => run(c, async (b) => {
+        const { normalizeFrames } = await import('../../providers/art/frames.js');
+        const raw = b.in;
+        if (!Array.isArray(raw) || raw.length === 0) {
+            throw invalid('FIELD_REQUIRED', 'in 必须是非空的绝对路径数组', { field: 'in' });
+        }
+        const inputs = await Promise.all(raw.map((p, i) => resolveInputPath(String(p), `in[${i}]`)));
+        const opts = {};
+        const tw = num(b, 'targetWidth');
+        const th = num(b, 'targetHeight');
+        const pd = num(b, 'pad');
+        if (tw !== undefined)
+            opts.targetWidth = tw;
+        if (th !== undefined)
+            opts.targetHeight = th;
+        if (pd !== undefined)
+            opts.pad = pd;
+        const outDirRaw = str(b, 'outDir');
+        const outDir = outDirRaw ? await resolveOutputDir(outDirRaw) : undefined;
+        // outDir 省略 = 原地覆盖各输入 —— 逐个过写围栏(资源库可读不可写,原地覆盖会在那里被挡住,
+        // 这正是我们要的:studio 该把结果写进共享树再自己搬回资源库)。
+        const targets = await Promise.all(inputs.map((p, i) => outDir ? Promise.resolve(join(outDir, `frame_${i}.png`)) : resolveOutputPath(p, `in[${i}]`)));
+        const r = await normalizeFrames(await Promise.all(inputs.map((p) => readFile(p))), opts);
+        // 逐帧目标先按 index 定好再并发写 —— written 的**次序是数据**(调用方按它对帧)。
+        const written = r.frames.map((_, i) => targets[i] ?? join(outDir ?? dirname(inputs[0]), `frame_${i}.png`));
+        await Promise.all(r.frames.map((buf, i) => writeFile(written[i], buf)));
+        return {
+            mode: 'frames',
+            width: r.width,
+            height: r.height,
+            frames: r.frames.length,
+            written,
+            items: written.map((p, i) => ({ index: i, file: basename(p) })),
+        };
+    }));
+    // 🔴 不适用于图集!图集必须走 pack-atlas 的 frameMaxHeight(见上)。
+    app.post('/resize', (c) => run(c, async (b) => {
+        const { resizeToFit } = await import('../../providers/art/frames.js');
+        const inPath = await resolveInputPath(reqStr(b, 'in'));
+        const out = await outOf(b, inPath);
+        const r = await resizeToFit(await readFile(inPath), reqNum(b, 'maxWidth'), reqNum(b, 'maxHeight'));
+        if (r.changed)
+            await writeFile(out, r.buf);
+        return { out, changed: r.changed, width: r.width, height: r.height };
+    }));
+    return app;
+}
+//# sourceMappingURL=art.js.map

package/dist/console/routes/art.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"art.js","sourceRoot":"","sources":["../../../src/console/routes/art.ts"],"names":[],"mappings":"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"}

package/dist/console/routes/artPipeline.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @module        console/routes/artPipeline
+ * @description   `/api/art/pipeline/runs` —— 美术流水线的 run 面(1.7 契约 + 1.8 并发闸)。
+ * @layer         console
+ *
+ * 🔴 **这一层不干活**:校验 → 交给 `ArtRunService`(它把活丢进子进程)→ 立刻 202。
+ * 路由里**一次同步 fs 都没有**,也不等图跑完 —— 事件循环是所有请求共用的。
+ *
+ * 三条来自 1.7、写死在这里不许被"顺手优化"的:
+ * `verify` 缺省显式 false · `jobId` 禁 `:` · **拒收一切路径字段** —— 见 `artRunRequest`。
+ */
+import { Hono } from 'hono';
+import type { ArtRunService } from '../../core/art/artRunService.js';
+export declare function createArtPipelineRoute(runs: ArtRunService): Hono;
+//# sourceMappingURL=artPipeline.d.ts.map

package/dist/console/routes/artPipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artPipeline.d.ts","sourceRoot":"","sources":["../../../src/console/routes/artPipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAMrE,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAoEhE"}

package/dist/console/routes/artPipeline.js

@@ -0,0 +1,83 @@
+/**
+ * @module        console/routes/artPipeline
+ * @description   `/api/art/pipeline/runs` —— 美术流水线的 run 面(1.7 契约 + 1.8 并发闸)。
+ * @layer         console
+ *
+ * 🔴 **这一层不干活**:校验 → 交给 `ArtRunService`(它把活丢进子进程)→ 立刻 202。
+ * 路由里**一次同步 fs 都没有**,也不等图跑完 —— 事件循环是所有请求共用的。
+ *
+ * 三条来自 1.7、写死在这里不许被"顺手优化"的:
+ * `verify` 缺省显式 false · `jobId` 禁 `:` · **拒收一切路径字段** —— 见 `artRunRequest`。
+ */
+import { Hono } from 'hono';
+import { domainError, toHttpStatus, toProblemJson } from '../../shared/errors.js';
+import { parseArtRunRequest } from '../lib/artRunRequest.js';
+function isDomainError(e) {
+    return typeof e === 'object' && e !== null && 'kind' in e && 'code' in e && 'message' in e;
+}
+export function createArtPipelineRoute(runs) {
+    const app = new Hono();
+    app.post('/runs', async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json(toProblemJson(domainError('validation', 'BODY_INVALID', '请求体必须是 JSON 对象')), 422);
+        }
+        let req;
+        try {
+            req = parseArtRunRequest(body);
+        }
+        catch (e) {
+            if (isDomainError(e))
+                return c.json(toProblemJson(e), toHttpStatus(e));
+            throw e;
+        }
+        // 🔴 `verify:true` **当场拒绝,不是静默忽略**:验证棒(评委→docs/asset-issues.json)
+        //    还留在 studio 的 artPipeline 里,没搬。静默忽略的话调用方会以为它跑了 ——
+        //    而"没验证"这件事**不会有任何症状**,只会在某天被当成"验证没抓到"。
+        if (req.verify) {
+            return c.json(toProblemJson(domainError('validation', 'VERIFY_NOT_SUPPORTED', 'sps 本版不支持 verify:true(验证棒尚未迁移)——请显式传 false', { details: { field: 'verify' } })), 422);
+        }
+        // 🔴 凭据必须一路带到子进程(1.7b)。曾经这里只传前四个字段,
+        //    `gatewayToken`/`gatewayBaseUrl` 校验完就没人要了 —— 子进程回落全局 provider,
+        //    归因落平台账、**不报错**。别再"精简"这个对象。
+        const r = runs.start({
+            locator: req.locator,
+            jobId: req.jobId,
+            manifestFile: req.manifestFile,
+            artPrompts: req.artPrompts,
+            gatewayToken: req.gatewayToken,
+            gatewayBaseUrl: req.gatewayBaseUrl,
+            ...(req.imageModel ? { imageModel: req.imageModel } : {}),
+        });
+        if (!r.ok) {
+            // 🔴 429 直接写在这里,**不给共享错误模型加一种 kind**:`toHttpStatus` 是全仓公用的,
+            //    为一条路径改它会波及所有消费方的分流。Retry-After 是"什么时候再来问"的建议,不是 ETA。
+            const de = domainError('precondition', 'ART_RUNS_BUSY', `美术并发已满(在跑 ${r.running},排队 ${r.queued})——请稍后重试`, {
+                details: { running: r.running, queued: r.queued, retryAfterS: r.retryAfterS },
+            });
+            c.header('Retry-After', String(r.retryAfterS));
+            return c.json(toProblemJson(de), 429);
+        }
+        // 202:活已收下、还没做完(排队与在跑都是 202 —— 调用方该做的事一样:去查状态)。
+        return c.json({ runId: r.runId, status: r.status }, 202);
+    });
+    app.get('/runs/:id', (c) => {
+        const v = runs.get(c.req.param('id'));
+        if (!v)
+            return c.json(toProblemJson(domainError('not-found', 'RUN_NOT_FOUND', 'run 不存在(注册表是内存的:console 重启后旧 run 查不到)')), 404);
+        return c.json(v);
+    });
+    app.post('/runs/:id/cancel', (c) => {
+        const v = runs.cancel(c.req.param('id'));
+        if (!v)
+            return c.json(toProblemJson(domainError('not-found', 'RUN_NOT_FOUND', 'run 不存在')), 404);
+        // 🔴 **202 不是 204**(1.7 写死):取消是"已受理",不是"已取消" ——
+        //    真正停下要等子进程走到下一个资产边界。204 会被读成"停了",而它可能还在画最后一张。
+        return c.json(v, 202);
+    });
+    return app;
+}
+//# sourceMappingURL=artPipeline.js.map

package/dist/console/routes/artPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artPipeline.js","sourceRoot":"","sources":["../../../src/console/routes/artPipeline.ts"],"names":[],"mappings":"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"}

package/dist/core/art/artConcurrency.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @module        core/art/artConcurrency
+ * @description   美术流水线的**两个并发数**,以及它们为什么必须写在一起(1.5 / 1.8)。
+ * @layer         core
+ * @boundedContext art
+ *
+ * ══════════════════════════════════════════════════════════════════════════
+ * 🔴 **瓶颈是 libuv 线程池,不是内存。**
+ *
+ * 每张图都要过 sharp(解码/抠图/缩放/编码),而 sharp 的活落在 **libuv 线程池**上,
+ * 池是**全进程共享**的。gameforge 并行生 8 张就能吃满它 —— 症状是
+ * **"sps 整体变慢"而不是"美术慢"**(同进程的每个 HTTP 请求、SSE 心跳一起卡),
+ * 归因会指向完全错的地方。
+ *
+ * ⚠️ 所以**不要复用 `RunGovernor` 的数字**:它是**内存刻度**(≈400MB/run),
+ * 按它算美术并发会得到"没满"的**假信号** —— 内存确实没满,卡住的是线程池。
+ * **两个闸量的是不同的东西,数字不可互借。**
+ *
+ * 🔴 **`UV_THREADPOOL_SIZE` 只在进程启动、线程池首次使用【之前】设才有效。**
+ * 池是懒初始化的:**定型之后改 `process.env` 静默无效**(没有报错,只是不生效)。
+ * ⇒ 唯一可靠的设法是 **spawn 子进程时放进它的 env**,
+ *    而不是写进 systemd(那会"影响无关的一切,且读代码的人看不见")。
+ *
+ * 所以这两个数**必须在同一处定义**:池的大小和"同时有几张图在处理"是同一个数的两面,
+ * 分开写的话它们会各自漂,而漂了之后**没有任何报错** —— 只是变慢或线程饿死。
+ * ══════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * 一个 run 内同时处理的资产数**上限**(= 子进程的 `UV_THREADPOOL_SIZE`)。
+ *
+ * 两个使用点,改一个必须改另一个(它们 import 的是同一个常量,所以改不散):
+ * ```
+ * providers/art/artGen        manifest.concurrency 的封顶
+ * core/art/artRunLauncher     spawn 子进程时的 UV_THREADPOOL_SIZE
+ * ```
+ * 8 是 studio 侧既有的封顶值(`Math.min(8, manifest.concurrency ?? 4)`),原样搬 ——
+ * **不是新调的参数**。真要调,判据在 1.11 的实测,不在这里拍脑袋。
+ */
+export declare const ART_ASSET_CONCURRENCY_MAX = 8;
+/**
+ * 并发闸的缺省值(1.8)。全局总闸 + 租户配额,**不做项目级**。
+ *
+ * ⚠️ 这三个数今天是**保守的猜测,不是测量结果** —— 唯一有把握的是"它们与
+ * RunGovernor 的内存刻度无关"。1.11 实测之后按线程池/CPU 的真实表现调,
+ * 调之前它们至少保证:**一台机器上不会同时跑起十几个吃满线程池的子进程**。
+ */
+export declare const ART_RUN_LIMITS: {
+    /** 全机同时在跑的 run 数。 */
+    readonly maxRuns: 2;
+    /** 同一租户同时在跑的 run 数(**不做项目级**:项目级配额是产品策略,不是资源保护)。 */
+    readonly maxRunsPerTenant: 1;
+    /** 排队深度(全局)。**超了就 429 + Retry-After,不无限积压** —— 无限队列
+     *  只是把"现在失败"变成"过很久之后失败",而调用方拿不到任何可操作的信号。 */
+    readonly maxQueued: 8;
+    /**
+     * `Retry-After` 的秒数。
+     *
+     * 🔴 **是"什么时候再来问"的建议,不是承诺**。刻意不按"队列深度 × 平均时长"估:
+     * 那个平均时长今天**没有测量过**,估出来的数会被调用方当成 ETA 用。
+     */
+    readonly retryAfterS: 30;
+};
+//# sourceMappingURL=artConcurrency.d.ts.map

package/dist/core/art/artConcurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artConcurrency.d.ts","sourceRoot":"","sources":["../../../src/core/art/artConcurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;IACzB,qBAAqB;;IAErB,oDAAoD;;IAEpD;gDAC4C;;IAE5C;;;;;OAKG;;CAEK,CAAC"}

package/dist/core/art/artConcurrency.js

@@ -0,0 +1,63 @@
+/**
+ * @module        core/art/artConcurrency
+ * @description   美术流水线的**两个并发数**,以及它们为什么必须写在一起(1.5 / 1.8)。
+ * @layer         core
+ * @boundedContext art
+ *
+ * ══════════════════════════════════════════════════════════════════════════
+ * 🔴 **瓶颈是 libuv 线程池,不是内存。**
+ *
+ * 每张图都要过 sharp(解码/抠图/缩放/编码),而 sharp 的活落在 **libuv 线程池**上,
+ * 池是**全进程共享**的。gameforge 并行生 8 张就能吃满它 —— 症状是
+ * **"sps 整体变慢"而不是"美术慢"**(同进程的每个 HTTP 请求、SSE 心跳一起卡),
+ * 归因会指向完全错的地方。
+ *
+ * ⚠️ 所以**不要复用 `RunGovernor` 的数字**:它是**内存刻度**(≈400MB/run),
+ * 按它算美术并发会得到"没满"的**假信号** —— 内存确实没满,卡住的是线程池。
+ * **两个闸量的是不同的东西,数字不可互借。**
+ *
+ * 🔴 **`UV_THREADPOOL_SIZE` 只在进程启动、线程池首次使用【之前】设才有效。**
+ * 池是懒初始化的:**定型之后改 `process.env` 静默无效**(没有报错,只是不生效)。
+ * ⇒ 唯一可靠的设法是 **spawn 子进程时放进它的 env**,
+ *    而不是写进 systemd(那会"影响无关的一切,且读代码的人看不见")。
+ *
+ * 所以这两个数**必须在同一处定义**:池的大小和"同时有几张图在处理"是同一个数的两面,
+ * 分开写的话它们会各自漂,而漂了之后**没有任何报错** —— 只是变慢或线程饿死。
+ * ══════════════════════════════════════════════════════════════════════════
+ */
+/**
+ * 一个 run 内同时处理的资产数**上限**(= 子进程的 `UV_THREADPOOL_SIZE`)。
+ *
+ * 两个使用点,改一个必须改另一个(它们 import 的是同一个常量,所以改不散):
+ * ```
+ * providers/art/artGen        manifest.concurrency 的封顶
+ * core/art/artRunLauncher     spawn 子进程时的 UV_THREADPOOL_SIZE
+ * ```
+ * 8 是 studio 侧既有的封顶值(`Math.min(8, manifest.concurrency ?? 4)`),原样搬 ——
+ * **不是新调的参数**。真要调,判据在 1.11 的实测,不在这里拍脑袋。
+ */
+export const ART_ASSET_CONCURRENCY_MAX = 8;
+/**
+ * 并发闸的缺省值(1.8)。全局总闸 + 租户配额,**不做项目级**。
+ *
+ * ⚠️ 这三个数今天是**保守的猜测,不是测量结果** —— 唯一有把握的是"它们与
+ * RunGovernor 的内存刻度无关"。1.11 实测之后按线程池/CPU 的真实表现调,
+ * 调之前它们至少保证:**一台机器上不会同时跑起十几个吃满线程池的子进程**。
+ */
+export const ART_RUN_LIMITS = {
+    /** 全机同时在跑的 run 数。 */
+    maxRuns: 2,
+    /** 同一租户同时在跑的 run 数(**不做项目级**:项目级配额是产品策略,不是资源保护)。 */
+    maxRunsPerTenant: 1,
+    /** 排队深度(全局)。**超了就 429 + Retry-After,不无限积压** —— 无限队列
+     *  只是把"现在失败"变成"过很久之后失败",而调用方拿不到任何可操作的信号。 */
+    maxQueued: 8,
+    /**
+     * `Retry-After` 的秒数。
+     *
+     * 🔴 **是"什么时候再来问"的建议,不是承诺**。刻意不按"队列深度 × 平均时长"估:
+     * 那个平均时长今天**没有测量过**,估出来的数会被调用方当成 ETA 用。
+     */
+    retryAfterS: 30,
+};
+//# sourceMappingURL=artConcurrency.js.map

package/dist/core/art/artConcurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artConcurrency.js","sourceRoot":"","sources":["../../../src/core/art/artConcurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,qBAAqB;IACrB,OAAO,EAAE,CAAC;IACV,oDAAoD;IACpD,gBAAgB,EAAE,CAAC;IACnB;gDAC4C;IAC5C,SAAS,EAAE,CAAC;IACZ;;;;;OAKG;IACH,WAAW,EAAE,EAAE;CACP,CAAC"}

package/dist/core/art/artRunLauncher.d.ts

@@ -0,0 +1,6 @@
+import type { ArtRunLauncher } from './artRunService.js';
+/** 结果行前缀 —— 子进程的 stdout 上可能还有别的输出(算子的 warn 等),靠它挑出结果。 */
+export declare const ART_RESULT_PREFIX = "SPS_ART_RESULT ";
+/** 生产用 launcher。测试注入自己的(见 artRunService.test)。 */
+export declare const spawnArtRun: ArtRunLauncher;
+//# sourceMappingURL=artRunLauncher.d.ts.map