cortico-world-image 0.1.2 → 0.1.3

package/ENV_PROMPT.md

@@ -3,7 +3,7 @@
 ## 四个工具
 
 - `image_draw`：按一段文字描述画一张新图。图会存到磁盘、附加进本次对话（你自己看得到）、并显示在控制台「图片工坊 → 作品」页。
-- `image_edit`：拿一张已有的图按指令改（换风格、改细节）。`image` 给绝对路径，或 `image_gallery` 里的编号。需要服务端的图片接口支持上传改图。
+- `image_edit`：拿一张已有的图按指令改（换风格、改细节）。`image` 给绝对路径，或 `image_gallery` 里的编号。服务端支不支持改图由接口决定，报错就照实告诉用户。
 - `image_gallery`：列出画过的图，最新的在前，带编号和绝对路径。编号可以交给 `image_show` 或 `image_edit`。
 - `image_show`：把一张旧图重新放回眼前（重新附加进对话，并在作品页高亮）。
 

package/README.md

@@ -21,7 +21,7 @@
 | 工具 | 标签 | 作用 |
 | --- | --- | --- |
 | `image_draw` | `act` | 按文字描述画一张新图，落盘、记进索引 |
-| `image_edit` | `act` | 拿一张已有的图按指令改（需要端点支持上传改图） |
+| `image_edit` | `act` | 拿一张已有的图按指令改（支持上传改图，或阿里云百炼式的 `image` 扩展字段） |
 | `image_gallery` | `read` | 列出画过的图，带编号与绝对路径 |
 | `image_show` | `speak` | 把一张旧图重新放回对话与作品页 |
 
@@ -192,9 +192,9 @@
 修法是抬版本 + 重启，主程序会在 Core 就绪时自动重载控制台外壳（
 `resources\app\app\main.cjs:285` `if (settings) settings.loadURL(consoleUrl());`）：
 
-1. 把 `package.json` 的 `version` 抬一格（例如 `0.1.1` → `0.1.2`）；
+1. 把 `package.json` 的 `version` 抬一格（例如 `0.1.2` → `0.1.3`）；
 2. 重启控制台（状态页「重启控制台」或 `node tools/patch.mjs --restart`）；
-3. 程序内窗口自动重载 → 新的 URL `/assets/extensions/cortico-world-image/0.1.2/console.js`
+3. 程序内窗口自动重载 → 新的 URL `/assets/extensions/cortico-world-image/0.1.3/console.js`
    取到新脚本，旧 URL 立刻变 404。
 
 不想抬版本也行，但要**先完全退出程序**再删缓存目录：`<安装>\data\Cache`、
@@ -230,7 +230,7 @@ registry 上有版本时直接从 npm 装；想自己改代码、或者 `npm vie
 或者用命令行，在 `data/extensions` 目录里（`extensions/package.json` 所在处）执行：
 
 ```powershell
-pnpm add cortico-world-image --ignore-workspace        # 想钉住版本就写 cortico-world-image@0.1.2
+pnpm add cortico-world-image --ignore-workspace        # 想钉住版本就写 cortico-world-image@0.1.3
 ```
 
 装完重启。升级同理：重跑一遍（控制台的「扩展」页会显示已装版本与最新版本），装完同样要重启。
@@ -320,7 +320,10 @@ pnpm add "D:\path\to\cortico-world-image" --ignore-workspace
 只要能对上这两条 OpenAI 形状的路：
 
 - `POST <baseUrl>/images/generations`（JSON，`{model, prompt, size, quality, n}`）
-- `POST <baseUrl>/images/edits`（multipart，`image` 文件 + `prompt`）——只有 `image_edit` 要它
+- `POST <baseUrl>/images/edits`（multipart，`image` 文件 + `prompt`）——只有 `image_edit` 要它。
+  端点没有这条路由（回 404/405）时，`image_edit` 会自动退回 `/images/generations`，把原图编成
+  `data:` URI 放进扩展字段 `image`——阿里云百炼的 OpenAI 兼容模式就是这么改图的，配上
+  `baseUrl` 和模型（如 `qwen-image-3.0-pro`）即可，不用额外设置。
 
 响应里认这些形状：`{data:[{b64_json|url}]}`、`{images:[...]}`、`{output|artifacts|content:[...]}`，
 以及顶层的 `{image|url|b64_json|image_url}`。base64 直接落盘，`http(s)` 链接会再下载一次。
@@ -330,6 +333,7 @@ pnpm add "D:\path\to\cortico-world-image" --ignore-workspace
 - 硅基流动：`https://api.siliconflow.cn/v1`
 - 智谱：`https://open.bigmodel.cn/api/paas/v4`
 - 火山方舟：`https://ark.cn-beijing.volces.com/api/v3`
+- 阿里云百炼：`https://dashscope.aliyuncs.com/compatible-mode/v1`（图生图走 `/images/generations` 的 `image` 字段）
 
 ## 自检（不联网）
 
@@ -422,7 +426,9 @@ cortico-world-image/
 - `pet_show_image` 的相对路径按桌宠工作区解析（`pet-workspace-*` 那三处补丁）；万一装配层那处
   （`pet-workspace-wire`）没打上、世界里没拿到 `workspaceDir`，行为退回老样子：相对路径报错、
   要求给绝对路径——不会静默拼出一个错的路径。
-- `image_edit` 要求端点真的支持 `/images/edits`；不支持的端点会回一条带 HTTP 码的错误，不是静默失败。
+- `image_edit` 先走 `/images/edits`（multipart 上传）；端点没这条路由（404/405）时自动退回
+  `/images/generations` 的 `image` 扩展字段（data URI，阿里云百炼那类）。两条路都不通时会回一条
+  带 HTTP 码的错误，不是静默失败。
 - 只有 Windows 上的「打开文件夹」会真的弹资源管理器；其他平台返回一句说明。
 - 画图本身要联网，只有自检样图是纯本地的。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-image",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "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

@@ -175,17 +175,23 @@ async function materialize(json, { timeoutMs, format }) {
   throw new ImageApiError('接口返回里既没有 base64 也没有图片地址');
 }
 
+/** 画图请求体：`n` 固定 1，size / 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 quality = String(opts.quality ?? '').trim();
+  if (quality && quality.toLowerCase() !== 'auto') body.quality = quality;
+  return body;
+}
+
 /**
  * 文生图。`extraBody` 会并进请求体，留给各家的私有参数。
  * @returns {Promise<{bytes: Buffer, mime: string, revisedPrompt: string|null}>}
  */
 export async function generateImage(opts = {}) {
   const timeoutMs = Number(opts.timeoutMs) > 0 ? Number(opts.timeoutMs) : DEFAULT_TIMEOUT;
-  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 quality = String(opts.quality ?? '').trim();
-  if (quality && quality.toLowerCase() !== 'auto') body.quality = quality;
+  const body = generationBody(opts);
   if (opts.extraBody && typeof opts.extraBody === 'object') Object.assign(body, opts.extraBody);
   const json = await postJson(joinUrl(opts.baseUrl, 'images/generations'), {
     apiKey: opts.apiKey,
@@ -195,8 +201,30 @@ export async function generateImage(opts = {}) {
   return await materialize(json, { timeoutMs, format: opts.format });
 }
 
+/** 把本地图片编成 data URI；阿里云百炼那类兼容端点的 `image` 字段认这个。 */
+function dataUri(bytes, mime) {
+  const type = String(mime ?? '').trim() || 'image/png';
+  return `data:${type};base64,${Buffer.from(bytes ?? []).toString('base64')}`;
+}
+
+/**
+ * 端点没有 `/images/edits` 时的退路：把原图编成 data URI，跟着 prompt 一起
+ * 发给 `/images/generations` 的扩展字段 `image`（阿里云百炼的兼容模式就这么改图）。
+ */
+async function editViaGenerations(opts, timeoutMs) {
+  const body = generationBody(opts);
+  body.image = dataUri(opts.image, opts.mime);
+  const json = await postJson(joinUrl(opts.baseUrl, 'images/generations'), {
+    apiKey: opts.apiKey,
+    body,
+    timeoutMs,
+  });
+  return await materialize(json, { timeoutMs, format: opts.format });
+}
+
 /**
- * 图生图 / 改图；走 `/images/edits` 的 multipart 形态，不是每个中转都支持。
+ * 图生图 / 改图。先走 `/images/edits` 的 multipart；端点没这条路由（404/405）时
+ * 退回 `/images/generations` 的 `image` 扩展字段，见 `editViaGenerations`。
  * @returns {Promise<{bytes: Buffer, mime: string, revisedPrompt: string|null}>}
  */
 export async function editImage(opts = {}) {
@@ -210,6 +238,18 @@ export async function editImage(opts = {}) {
   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');
-  const json = await postForm(joinUrl(opts.baseUrl, 'images/edits'), { apiKey: opts.apiKey, form, timeoutMs });
-  return await materialize(json, { timeoutMs, format: opts.format });
+  try {
+    const json = await postForm(joinUrl(opts.baseUrl, 'images/edits'), { apiKey: opts.apiKey, form, timeoutMs });
+    return await materialize(json, { timeoutMs, format: opts.format });
+  } catch (err) {
+    if (!(err instanceof ImageApiError) || (err.status !== 404 && err.status !== 405)) throw err;
+    try {
+      return await editViaGenerations(opts, timeoutMs);
+    } catch (again) {
+      if (again instanceof ImageApiError) {
+        again.message = `${again.message}（端点也不支持 multipart /images/edits：HTTP ${err.status}）`;
+      }
+      throw again;
+    }
+  }
 }

package/src/world.js

@@ -270,7 +270,7 @@ export class ImageWorld {
         name: 'image_edit',
         description: 'Redraw an existing local picture with the image API, following a text instruction. '
           + '`image` takes an absolute file path, or a picture id from image_gallery. '
-          + 'Needs an endpoint that supports /images/edits (multipart upload).',
+          + 'Works with endpoints that implement /images/edits (multipart upload) and with those that take a base64 `image` field on /images/generations instead (e.g. Aliyun Bailian).',
         tags: ['act'],
         parameters: {
           type: 'object',

package/tools/check.mjs

@@ -443,6 +443,99 @@ try {
   const showMissing = await tools.find((t) => t.name === 'image_show').handler({ id: 'deadbeef' });
   check(showMissing && showMissing.failed === true, 'image_show 找不到编号时失败');
 
+  section('改图请求的两种走法（stub fetch）');
+  const api = await import(pathToFileURL(join(pkgDir, 'src', 'api.js')).href);
+  const tinyPng = Buffer.from([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a, 1, 2, 3, 4, 5, 6, 7, 8]);
+  const tinyB64 = tinyPng.toString('base64');
+  const jsonResponse = (obj, status = 200) => new Response(JSON.stringify(obj), {
+    status,
+    headers: { 'content-type': 'application/json' },
+  });
+  /** 按 path 后缀分发的 fetch 替身；返回记下每次调用的 calls 数组。 */
+  const stubFetch = (routes) => {
+    const calls = [];
+    globalThis.fetch = async (url, init = {}) => {
+      const call = { url: String(url), init };
+      calls.push(call);
+      const path = new URL(String(url)).pathname;
+      for (const [suffix, handler] of routes) {
+        if (path.endsWith(suffix)) return await handler(call);
+      }
+      return new Response('not found', { status: 404 });
+    };
+    return calls;
+  };
+  const realFetch = globalThis.fetch;
+  const editOpts = {
+    baseUrl: 'https://img.example.test/v1',
+    apiKey: 'sk-x',
+    model: 'gpt-image-1',
+    prompt: '把它改成水彩',
+    image: tinyPng,
+    mime: 'image/png',
+    name: 'src.png',
+  };
+  try {
+    // 1. 端点有 /images/edits：multipart 一次就够，不碰 generations。
+    let calls = stubFetch([['/images/edits', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })]]);
+    let out = await api.editImage(editOpts);
+    check(calls.length === 1 && calls[0].url.endsWith('/images/edits'), '/images/edits 能走通时只发一次 multipart', calls.map((c) => c.url).join(' '));
+    check(calls[0].init.body instanceof FormData && calls[0].init.body.get('prompt') === '把它改成水彩', 'multipart 里带着 prompt');
+    check(out.bytes.equals(tinyPng) && out.mime === 'image/png', 'multipart 的图正常取回');
+
+    // 2. 端点没有 /images/edits（阿里云百炼：404）：退回 generations 的 image 字段。
+    calls = stubFetch([
+      ['/images/edits', () => jsonResponse({ error: { message: 'not found' } }, 404)],
+      ['/images/generations', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })],
+    ]);
+    out = await api.editImage(editOpts);
+    check(calls.length === 2 && calls[1].url.endsWith('/images/generations'), '404 后退回 /images/generations', calls.map((c) => c.url).join(' '));
+    const fallbackBody = JSON.parse(String(calls[1].init.body));
+    check(fallbackBody.image === `data:image/png;base64,${tinyB64}`, '原图编成 data URI 塞进 image 字段', String(fallbackBody.image).slice(0, 40));
+    check(fallbackBody.prompt === '把它改成水彩' && fallbackBody.model === 'gpt-image-1' && fallbackBody.n === 1, '退路请求体带着 model / prompt / n');
+    check(calls[1].init.headers.Authorization === 'Bearer sk-x', '退路也带着密钥');
+    check(out.bytes.equals(tinyPng), '退路的图正常取回');
+
+    // 2b. 405（没有这条方法）同样算「没这条路由」。
+    calls = stubFetch([
+      ['/images/edits', () => jsonResponse({ error: { message: 'method not allowed' } }, 405)],
+      ['/images/generations', () => jsonResponse({ data: [{ b64_json: tinyB64 }] })],
+    ]);
+    out = await api.editImage(editOpts);
+    check(calls.length === 2 && out.bytes.equals(tinyPng), '405 也退回 /images/generations');
+
+    // 3. 端点报别的错（500）：不试退路，原样抛。
+    calls = stubFetch([['/images/edits', () => jsonResponse({ error: { message: 'boom' } }, 500)]]);
+    let caught = null;
+    try {
+      await api.editImage(editOpts);
+    } catch (err) {
+      caught = err;
+    }
+    check(caught instanceof api.ImageApiError && caught.status === 500, '500 不会被当成「没这条路由」', String(caught?.status));
+    check(calls.length === 1 && !calls.some((c) => c.url.endsWith('/images/generations')), '500 不触发退路');
+
+    // 4. 两条路都失败：错误里交代清楚先试了什么。
+    calls = stubFetch([
+      ['/images/edits', () => jsonResponse({ error: { message: 'not found' } }, 404)],
+      ['/images/generations', () => jsonResponse({ error: { message: 'model not exist' } }, 400)],
+    ]);
+    caught = null;
+    try {
+      await api.editImage(editOpts);
+    } catch (err) {
+      caught = err;
+    }
+    check(String(caught?.message).includes('model not exist') && String(caught?.message).includes('/images/edits'), '退路也失败时错误里带两条线索', String(caught?.message).slice(0, 120));
+
+    // 5. 画图那条路不带 image，别把文生图带歪。
+    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 字段');
+  } finally {
+    globalThis.fetch = realFetch;
+  }
+
   section('离线自检样图（落盘 → 索引 → 取图）');
   const self = await world.invoke('gallery', 'selftest', []);
   check(self?.ok === true && self.item?.id, 'selftest 返回条目');

package/tools/patch.mjs

@@ -88,6 +88,11 @@ function toolsReturnHarness(worldFile) {
   const seg = text.slice(at.index, at.index + 3000);
   const rm = /^([ \t]*)return ([^\n]*);$/m.exec(seg);
   if (!rm) return { ok: false, reason: '没找到 tools() 里的 return' };
+  // 那句 return 会引用方法体里前面声明的局部量（桌宠 0.1.23 起是 `const own = petToolDecls(…)`）。
+  // 桩里把它们都声明成「两个假工具」的数组：真跑时若还有没桩到的名字，报错才说明补丁真的坏了。
+  const locals = [...seg.slice(0, rm.index).matchAll(/^[ \t]*const ([A-Za-z_$][\w$]*)\s*=/gm)]
+    .map((m) => m[1])
+    .filter((name, i, all) => all.indexOf(name) === i);
   const dir = mkdtempSync(join(tmpdir(), 'coopanion-tools-return-'));
   const file = join(dir, 'run.mjs');
   const report = join(dir, 'out.json');
@@ -99,7 +104,8 @@ function toolsReturnHarness(worldFile) {
       "const petToolDecls = () => [{ name: 'pet_say' }, { name: 'pet_ask' }];",
       'const handlers = { pet_say: () => {}, pet_ask: () => {}, pet_walk_to: () => {} };',
       "const CHAT_IMAGE_TOOL = { name: 'pet_show_image' };",
-      "const world = { appLanguage: 'zh', showImage: () => ({ text: 'ok' }) };",
+      ...locals.map((name) => `const ${name} = petToolDecls('zh');`),
+      "const world = { appLanguage: 'zh', cuaOn: false, cua: { tools: () => [] }, showImage: () => ({ text: 'ok' }) };",
       `const out = (function () { return ${rm[2]}; }).call(world);`,
       'writeFileSync(process.argv[2], JSON.stringify({',
       '  isArray: Array.isArray(out),',