cortico-world-image 0.1.3 → 0.1.4

package/README.md

@@ -192,9 +192,9 @@
 修法是抬版本 + 重启，主程序会在 Core 就绪时自动重载控制台外壳（
 `resources\app\app\main.cjs:285` `if (settings) settings.loadURL(consoleUrl());`）：
 
-1. 把 `package.json` 的 `version` 抬一格（例如 `0.1.2` → `0.1.3`）；
+1. 把 `package.json` 的 `version` 抬一格（例如 `0.1.3` → `0.1.4`）；
 2. 重启控制台（状态页「重启控制台」或 `node tools/patch.mjs --restart`）；
-3. 程序内窗口自动重载 → 新的 URL `/assets/extensions/cortico-world-image/0.1.3/console.js`
+3. 程序内窗口自动重载 → 新的 URL `/assets/extensions/cortico-world-image/0.1.4/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.3
+pnpm add cortico-world-image --ignore-workspace        # 想钉住版本就写 cortico-world-image@0.1.4
 ```
 
 装完重启。升级同理：重跑一遍（控制台的「扩展」页会显示已装版本与最新版本），装完同样要重启。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cortico-world-image",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "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/chat-image-patch.js

@@ -320,22 +320,32 @@ const QQ_SEND_NEW = 'const p = resolveLocalImagePath(image, this.config.memoryDi
 const QQ_VIEW_OLD = "const p = isAbsolute(url) ? url : join(this.packageDir || '.', url);";
 const QQ_VIEW_NEW = 'const p = resolveLocalImagePath(url, this.config.memoryDir, this.packageDir);';
 
-/** 工具说明里那三处「相对扩展目录」要跟着改成「相对桌宠工作区」——模型只看得到说明。 */
+/**
+ * 工具说明里那三处要跟着改成「相对桌宠工作区」——模型只看得到说明。
+ * 上游爱改措辞（0.1.16 就把 image 那句换成了「如 /home/user/pics/a.png」），所以每条列出
+ * 见过的旧写法：一条都对不上只跳过、不判失败；整条补丁一句都认不出来才算版本变了。
+ */
 const QQ_HINTS = [
   {
-    from: "description: '本地文件路径（绝对路径，或相对扩展目录）或 http(s) 链接。'",
+    from: [
+      "description: '本地文件路径（绝对路径，或相对扩展目录）或 http(s) 链接。'",
+      "description: '本地文件路径（如 /home/user/pics/a.png）或 http(s) 链接。'",
+    ],
     to: "description: '本地文件路径（绝对路径，或相对桌宠工作区的路径，如 blobs/xx.jpg）或 http(s) 链接。'",
   },
   {
-    from: '或本地文件路径；给了就不再翻缓冲。',
+    from: ['或本地文件路径；给了就不再翻缓冲。'],
     to: '或本地文件路径（绝对路径，或相对桌宠工作区的路径，如 blobs/xx.jpg）；给了就不再翻缓冲。',
   },
   {
-    from: '给某个会话发一张图。`image` 给本地文件路径或 http(s) 链接（本机下载后再发），二者挑一个。',
+    from: ['给某个会话发一张图。`image` 给本地文件路径或 http(s) 链接（本机下载后再发），二者挑一个。'],
     to: '给某个会话发一张图。`image` 给本地文件路径（绝对路径，或相对桌宠工作区的路径，如 blobs/xx.jpg）或 http(s) 链接（本机下载后再发），二者挑一个。',
   },
 ];
 
+/** 这条说明还没改成我们的说法、而且上游还有它认得的旧写法 → 需要动手。 */
+const hintNeedsWork = (text, h) => !text.includes(h.to) && [].concat(h.from).some((from) => text.includes(from));
+
 /**
  * 每个补丁：`file` 是绝对路径，`done` 说这段原文是不是已经改过了，
  * `apply` 返回新文本或 `{ error }`。全部按顺序跑，互不依赖。
@@ -467,14 +477,26 @@ export function rulesFor(id) {
       };
     case 'qq-image-hints':
       return {
-        done: (text) => QQ_HINTS.every((h) => text.includes(h.to)),
+        // 已经有一处是我们的说法，且没有哪处还留着认得的旧写法 → 不用再管（上游换掉的措辞不再拖住这条）。
+        done: (text) => QQ_HINTS.some((h) => text.includes(h.to)) && QQ_HINTS.every((h) => !hintNeedsWork(text, h)),
         apply: (text) => {
           let work = text;
+          let recognized = 0;
           for (const h of QQ_HINTS) {
-            const out = swap(work, h.from, h.to);
-            if (out === null) return { error: `工具说明对不上：${h.from.slice(0, 40)}` };
-            work = out;
+            if (work.includes(h.to)) {
+              recognized += 1;
+              continue;
+            }
+            for (const from of [].concat(h.from)) {
+              const out = swap(work, from, h.to);
+              if (out !== null) {
+                work = out;
+                recognized += 1;
+                break;
+              }
+            }
           }
+          if (recognized === 0) return { error: `工具说明已大改，一句都认不出来：${[].concat(QQ_HINTS[0].from)[0].slice(0, 40)}` };
           return { text: work };
         },
       };

package/tools/check.mjs

@@ -746,6 +746,28 @@ try {
   check(qqRules.done(qqPatched?.text ?? ''), '改完认成「已打过」（幂等）');
   check(qqPatched.text.includes("import { existsSync } from 'node:fs';"), '导入本来就够时不多改一行');
 
+  // 上游爱改工具说明的措辞（0.1.16 就把 image 那句换成了「如 /home/user/pics/a.png」）：
+  // 一条对不上不该让整条补丁失败；但一句都认不出来仍然要报。
+  const hintRules = patchMod.rulesFor('qq-image-hints');
+  check(typeof hintRules?.done === 'function' && typeof hintRules?.apply === 'function', 'QQ 说明补丁有 done/apply');
+  const hintFixture = [
+    "  parameters: [{ name: 'url', description: '可选：直接给图片链接（事件里带的图）或本地文件路径；给了就不再翻缓冲。' }],",
+    "  description: '给某个会话发一张图。`image` 给本地文件路径或 http(s) 链接（本机下载后再发），二者挑一个。',",
+    "  parameters: [{ name: 'image', description: '本地文件路径（如 /home/user/pics/a.png）或 http(s) 链接。' }],",
+    '',
+  ].join('\n');
+  check(!hintRules.done(hintFixture), '夹具还是「只认绝对路径」的说明（有东西可改）');
+  const hinted = hintRules.apply(hintFixture);
+  check(!hinted?.error, '上游换了说明措辞也照改，不报失败', String(hinted?.error ?? 'ok'));
+  check((hinted?.text ?? '').includes('或本地文件路径（绝对路径，或相对桌宠工作区的路径，如 blobs/xx.jpg）；给了就不再翻缓冲。'), '认得出的那两处照改');
+  check(!(hinted?.text ?? '').includes('相对扩展目录'), '旧说法不再残留在说明里');
+  check(hintRules.done(hinted?.text ?? ''), '改完认成「已打过」（幂等）');
+  const reworded = hintFixture.replace("'本地文件路径（如 /home/user/pics/a.png）或 http(s) 链接。'", "'图片本地路径或链接。'");
+  const rewordedOut = hintRules.apply(reworded);
+  check(!rewordedOut?.error && hintRules.done(rewordedOut?.text ?? ''), '上游整句换掉时跳过那一处，不算失败也不算没打', String(rewordedOut?.error ?? 'ok'));
+  check(Boolean(hintRules.apply('export const nope = 1;\n')?.error), '一句都认不出来时仍然报失败');
+  check(!hintRules.done('export const nope = 1;\n'), '文件整个换了写法时不谎报「已打过」');
+
   // pet_show_image 也要能认相对路径（按桌宠工作区解析）。
   const petSpecs = specs.filter((s) => s.id.startsWith('pet-workspace-'));
   check(petSpecs.length === 3 && petSpecs.every((s) => s.optional !== true), '桌宠工作区相对路径那 3 处是必备补丁', JSON.stringify(petSpecs.map((s) => s.id)));

package/tools/patch.mjs

@@ -142,7 +142,7 @@ const QQ_FIXTURE_TS = [
   'export const qqSendImage = {',
   "  name: 'qq_send_image',",
   "  description: '给某个会话发一张图。`image` 给本地文件路径或 http(s) 链接（本机下载后再发），二者挑一个。',",
-  "  parameters: [{ name: 'image', description: '本地文件路径（绝对路径，或相对扩展目录）或 http(s) 链接。' }],",
+  "  parameters: [{ name: 'image', description: '本地文件路径（如 /home/user/pics/a.png）或 http(s) 链接。' }],",
   '};',
   'export class QQWorld implements World {',
   "  private packageDir = '.';",