cortico-world-image 0.5.4 → 0.5.5

package/README.md

@@ -381,7 +381,8 @@ pnpm add "D:\path\to\cortico-world-image" --ignore-workspace
 
 控制台「图片工坊 → 作品」有个 **插入自检样图** 按钮：它会用手写的极简 PNG 编码器造一张图，
 走完「落盘 → 索引 → 面板取图 → 缩略图显示」整条路。看不到这张图，说明是扩展或面板的问题，
-不是图片接口的问题。
+不是图片接口的问题。「状态」页也有同一个按钮，两边都能用（`status.selftest` 与 `gallery.selftest`
+都认；0.5.5 前只有后者，从状态页点会报 `未知面板方法：status.selftest`，issue #3 一起修了）。
 
 开发侧一共有五份检查脚本，外加一份发布前自检。
 
@@ -489,6 +490,10 @@ cortico-world-image/
 - 尺寸：`size` 能写 `1024x1536`、比例 `16:9` / `4:3`、或 `square` / `portrait` / `landscape`（中文
   `竖图` / `横图` / `方图` 也认），比例会换成一套对齐好的尺寸（16:9 → 1344×768，4:3 → 1152×864）；
   写死的数字只按 latent 要求对齐到 8，不动你写的整数。
+- 云端那档（OpenAI 兼容端点）**只认 `宽x高`**：别名和比例会先换成它认的三档之一
+  （`1024x1024` / `1536x1024` / `1024x1536`），认不出来的值就不发这个字段、让服务端用自己的默认，
+  并在回执里说明一句。以前是原样透传，`square` 这种会让上游直接失败（报成 503「无返回结果」，
+  很难联想到 size），issue #3 修的就是这个。
 - 改图的尺寸：ComfyUI 那档**不传 `size`、或写 `auto`，就照参考图的比例**出图（最长边压到 1536、对齐
   16），传了 `size` 就按给的；云端那档走接口自己的默认（一般不传尺寸）。所以改一张 1600×1200 的图
   会出 1536×1152，不会变成方图。图生图的回执/作品页记的是**实际出的尺寸**，不再是 `auto`。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-image",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "type": "module",
   "description": "Image Studio（图片工坊）—— 给 Coopanion 桌宠的 cortico World 扩展：用任意 OpenAI 兼容的图片接口画图/改图、落盘成作品库、把图贴进控制台「对话」页，并自带一套自动重打的自愈补丁。 / A cortico World extension that draws through any OpenAI-compatible image API, keeps pictures on disk and shows them in the console.",
   "license": "MIT",

package/src/api.js

@@ -18,6 +18,39 @@ export class ImageApiError extends Error {
 
 const DEFAULT_TIMEOUT = 180000;
 
+/**
+ * 云端端点只认 `宽x高` 这种字面尺寸：把 `square` 这类别名原样发过去，
+ * 上游会以「无返回」包装成 503（issue #3）。这里先归一化，认不出来就干脆不发。
+ * 键都是小写、去掉空格之后的写法。
+ */
+const CLOUD_SIZE_ALIASES = {
+  square: '1024x1024', '1:1': '1024x1024', '方图': '1024x1024', '方形': '1024x1024', '正方形': '1024x1024',
+  portrait: '1024x1536', '3:4': '1024x1536', '9:16': '1024x1536', '竖图': '1024x1536', '竖屏': '1024x1536', '竖版': '1024x1536',
+  landscape: '1536x1024', '4:3': '1536x1024', '3:2': '1536x1024', '16:9': '1536x1024', '横图': '1536x1024', '横屏': '1536x1024', '横版': '1536x1024',
+};
+
+/**
+ * 云端那档的 `size` 归一化：返回合法的 `宽x高`，`auto`/空/认不出来返回 ''（调用方就别发这个字段）。
+ * 字面尺寸原样保留（`1792x1024` 这类也认），只把 `×`/`*` 统一成 `x`。
+ */
+export function normalizeCloudSize(size) {
+  const raw = String(size ?? '').trim().toLowerCase().replace(/\s+/g, '');
+  if (!raw || raw === 'auto') return '';
+  const wh = /^(\d{2,5})[x×*](\d{2,5})$/.exec(raw);
+  if (wh) return `${Number(wh[1])}x${Number(wh[2])}`;
+  const alias = CLOUD_SIZE_ALIASES[raw];
+  if (alias) return alias;
+  // 任意 a:b：按横竖落到云端那三档上（方/横/竖）。
+  const ratio = /^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?)$/.exec(raw);
+  if (ratio) {
+    const a = Number(ratio[1]);
+    const b = Number(ratio[2]);
+    if (a > 0 && b > 0) return a === b ? '1024x1024' : (a > b ? '1536x1024' : '1024x1536');
+  }
+  return '';
+}
+
+
 function joinUrl(baseUrl, path) {
   const base = String(baseUrl ?? '').trim().replace(/[/\s]+$/, '');
   if (!base) throw new ImageApiError('没有配置接口地址');
@@ -175,11 +208,11 @@ async function materialize(json, { timeoutMs, format }) {
   throw new ImageApiError('接口返回里既没有 base64 也没有图片地址');
 }
 
-/** 画图请求体：`n` 固定 1，size / quality 是 auto 就不发。 */
+/** 画图请求体：`n` 固定 1；size 归一化成 `宽x高`（别名云端不认），认不出来就不发；quality 是 auto 也不发。 */
 function generationBody(opts) {
   const body = { model: opts.model, prompt: opts.prompt, n: 1 };
-  const size = String(opts.size ?? '').trim();
-  if (size && size.toLowerCase() !== 'auto') body.size = size;
+  const size = normalizeCloudSize(opts.size);
+  if (size) body.size = size;
   const quality = String(opts.quality ?? '').trim();
   if (quality && quality.toLowerCase() !== 'auto') body.quality = quality;
   return body;
@@ -233,8 +266,8 @@ export async function editImage(opts = {}) {
   form.set('model', String(opts.model ?? ''));
   form.set('prompt', String(opts.prompt ?? ''));
   form.set('n', '1');
-  const size = String(opts.size ?? '').trim();
-  if (size && size.toLowerCase() !== 'auto') form.set('size', size);
+  const size = normalizeCloudSize(opts.size);
+  if (size) form.set('size', size);
   const quality = String(opts.quality ?? '').trim();
   if (quality && quality.toLowerCase() !== 'auto') form.set('quality', quality);
   form.set('image', new Blob([opts.image], { type: opts.mime ?? 'image/png' }), opts.name ?? 'image.png');

package/src/world.js

@@ -13,7 +13,7 @@ import { existsSync, mkdirSync, readFileSync, readdirSync, statSync } from 'node
 import { extname, isAbsolute, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
-import { ImageApiError, editImage, generateImage } from './api.js';
+import { ImageApiError, editImage, generateImage, normalizeCloudSize } from './api.js';
 import { ChainError, chainSnapshot, entryLabel, entryState, parseChainEntries, runChain } from './chain.js';
 import { applyChatImagePatches, consolePort, patchBackupStatus, requestConsoleRestart, resolveAppRoot, restoreChatImagePatches } from './chat-image-patch.js';
 import { comfyDraw, comfyEdit, listModels, probe as probeComfy } from './comfyui.js';
@@ -360,7 +360,8 @@ export class ImageWorld {
       const label = entryLabel(used);
       const shown = res.revisedPrompt ? String(res.revisedPrompt) : prompt;
       const note = asText(args.note);
-      const dims = res.size || size || used.size || 'auto';
+      const sentSize = used.preset === 'openai' ? normalizeCloudSize(size || used.size) : '';
+      const dims = res.size || sentSize || size || used.size || 'auto';
       const { item, warning } = this.#saveSafe({
         bytes: res.bytes,
         mime: res.mime,
@@ -381,6 +382,7 @@ export class ImageWorld {
         item,
         warning,
         attempts: res.attempts,
+        hint: this.#sizeHint(used, size),
       });
     } catch (err) {
       return this.#failure('image_draw', err);
@@ -413,7 +415,8 @@ export class ImageWorld {
       const label = entryLabel(used);
       const shown = res.revisedPrompt ? String(res.revisedPrompt) : prompt;
       const note = asText(args.note);
-      const dims = res.size || size || used.size || 'auto';
+      const sentSize = used.preset === 'openai' ? normalizeCloudSize(size || used.size) : '';
+      const dims = res.size || sentSize || size || used.size || 'auto';
       const { item, warning } = this.#saveSafe({
         bytes: res.bytes,
         mime: res.mime,
@@ -434,6 +437,7 @@ export class ImageWorld {
         item,
         warning,
         attempts: res.attempts,
+        hint: this.#sizeHint(used, size),
       });
     } catch (err) {
       return this.#failure('image_edit', err);
@@ -593,6 +597,17 @@ export class ImageWorld {
     return item;
   }
 
+  /**
+   * 云端那档只认「宽x高」：别名会被换成三档之一，认不出来的干脆不发。
+   * 换掉的不吭声（结果就是你要的方向），**没发**的必须在回执里说一句，否则用户会以为尺寸生效了。
+   */
+  #sizeHint(entry, sizeArg) {
+    if (entry?.preset !== 'openai') return '';
+    const asked = asText(sizeArg) || asText(entry.size);
+    if (!asked || normalizeCloudSize(asked)) return '';
+    return `提示：云端这档不认 size「${asked}」，这次没带 size、按它的默认尺寸出图；要指定就写「1024x1536」或「16:9」。`;
+  }
+
   /** 工具回执：文本给模型读，blob 交给 Core 进上下文。 */
   #outcome(spec) {
     const bytes = spec.bytes;
@@ -601,6 +616,7 @@ export class ImageWorld {
     const lines = [spec.verb];
     if (spec.item) lines.push(`文件：${spec.item.path}`);
     lines.push(`参数：${spec.size || '默认尺寸'} · ${spec.model || '默认模型'} · ${kb} KB`);
+    if (spec.hint) lines.push(spec.hint);
     if (Array.isArray(spec.attempts) && spec.attempts.length) {
       lines.push(`前几档没成：${spec.attempts.map((it) => `${it.name}（${it.message}）`).join('；')}`);
     }
@@ -674,7 +690,7 @@ export class ImageWorld {
       ],
       panels: [
         { id: 'gallery', title: t.panelGalleryTitle, description: t.panelGalleryDesc, getMethods: ['list'] },
-        { id: 'status', title: t.panelStatusTitle, description: t.panelStatusDesc, getMethods: ['state'] },
+        { id: 'status', title: t.panelStatusTitle, description: t.panelStatusDesc, getMethods: ['state', 'selftest'] },
       ],
       config: [configGroup(this.language)],
       promptDocs: [{
@@ -715,6 +731,8 @@ export class ImageWorld {
         case 'restart': return this.#askRestart('控制台手动请求');
         case 'setKey': return this.#setKey(list[0]);
         case 'clearKey': return this.#setKey('');
+        // 面板「自检」按钮发的是 status.selftest（旧版挂在 gallery 上），两处都认。
+        case 'selftest': return this.#selfTest();
         default: throw new Error(`未知面板方法：status.${method}`);
       }
     }

package/tools/check.mjs

@@ -541,6 +541,65 @@ try {
     calls = stubFetch([['/images/generations', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })]]);
     await api.generateImage({ ...editOpts, image: undefined });
     check(!('image' in JSON.parse(String(calls[0].init.body))), 'image_draw 的请求体里没有 image 字段');
+
+    // 6. size 别名（issue #3）：云端只吃「宽x高」，别名必须换掉；认不出来的干脆不发。
+    const cloudSizeCases = [
+      ['square', '1024x1024'],
+      ['1:1', '1024x1024'],
+      ['方图', '1024x1024'],
+      ['portrait', '1024x1536'],
+      ['9:16', '1024x1536'],
+      ['landscape', '1536x1024'],
+      ['16:9', '1536x1024'],
+      ['4:3', '1536x1024'],
+      ['21:9', '1536x1024'],
+      ['1024x1536', '1024x1536'],
+      ['1792x1024', '1792x1024'],
+      ['1024×1024', '1024x1024'],
+      ['auto', ''],
+      ['', ''],
+      ['超大图', ''],
+    ];
+    let badSize = null;
+    for (const [input, want] of cloudSizeCases) {
+      const got = api.normalizeCloudSize(input);
+      if (got !== want) badSize = `${input} → ${got || '(空)'}，期望 ${want || '(空)'}`;
+    }
+    check(!badSize, '云端尺寸归一化：别名换成宽x高、字面尺寸原样、认不出来不发', badSize ?? '');
+
+    calls = stubFetch([['/images/generations', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })]]);
+    await api.generateImage({ ...editOpts, image: undefined, size: 'square' });
+    check(JSON.parse(String(calls[0].init.body)).size === '1024x1024', 'size=square 发给云端前换成 1024x1024（以前原样发、必 503）', String(JSON.parse(String(calls[0].init.body)).size));
+
+    calls = stubFetch([['/images/generations', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })]]);
+    await api.generateImage({ ...editOpts, image: undefined, size: '16:9' });
+    check(JSON.parse(String(calls[0].init.body)).size === '1536x1024', 'size=16:9 换成 1536x1024');
+
+    calls = stubFetch([['/images/generations', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })]]);
+    await api.generateImage({ ...editOpts, image: undefined, size: '怪尺寸' });
+    check(!('size' in JSON.parse(String(calls[0].init.body))), '认不出的 size 不发，交给服务端默认（不再 503）');
+
+    calls = stubFetch([['/images/edits', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })]]);
+    await api.editImage({ ...editOpts, size: 'portrait' });
+    check(calls[0].init.body.get('size') === '1024x1536', 'multipart 那条路的 size 也换成长宽', String(calls[0].init.body.get('size')));
+
+    // 7. 世界层：云端那档 + 认不出的 size，回执照实说一句（以前是静默按默认尺寸出图）。
+    const cloudWorld = definition.create({
+      cfg: {
+        ...definition.defaults(),
+        enabled: true,
+        models: JSON.stringify([{ name: 'cloud', preset: 'openai', baseUrl: 'https://api.test/v1', model: 'gpt-image-1', apiKeySecret: 'IMAGE_API_KEY' }]),
+      },
+      dataDir,
+      botDir,
+      packageDir: pkgDir,
+      secret: (name) => (name === 'IMAGE_API_KEY' ? 'sk-x' : ''),
+      storeSecret: () => {},
+    });
+    calls = stubFetch([['/images/generations', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })]]);
+    const drewOdd = await cloudWorld.tools().find((t) => t.name === 'image_draw').handler({ prompt: '猫', size: '怪尺寸' });
+    check(drewOdd && !drewOdd.failed, '云端那档能出图', JSON.stringify(drewOdd).slice(0, 100));
+    check(String(drewOdd.text).includes('不认 size'), '认不出的 size 在回执里说了一句，不是静默', String(drewOdd.text).split('\n')[2]);
   } finally {
     globalThis.fetch = realFetch;
   }
@@ -548,6 +607,11 @@ try {
   section('离线自检样图（落盘 → 索引 → 取图）');
   const self = await world.invoke('gallery', 'selftest', []);
   check(self?.ok === true && self.item?.id, 'selftest 返回条目');
+  // 面板「自检」按钮发的是 status.selftest（issue #3：以前只挂在 gallery 上，点了必报未知方法）。
+  const selfStatus = await world.invoke('status', 'selftest', []);
+  check(selfStatus?.ok === true && selfStatus.item?.id, 'status 面板也能自检（面板按钮走的就是这条）');
+  check(existsSync(selfStatus.item.path), 'status 自检的图也真落盘了', String(selfStatus.item?.path));
+  await world.invoke('gallery', 'remove', [selfStatus.item.id]); // 别影响后面「只有一张」的断言
   check(existsSync(self.item.path), '图片真的落盘了', String(self.item?.path));
   const bytes = readFileSync(self.item.path);
   check(bytes.subarray(0, 8).equals(Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a])), 'PNG 魔术字节正确');