cortico-world-image 0.2.0 → 0.5.4

package/ENV_PROMPT.md

@@ -3,7 +3,7 @@
 ## 四个工具
 
 - `image_draw`：按一段文字描述画一张新图。图会存到磁盘、附加进本次对话（你自己看得到）、并显示在控制台「图片工坊 → 作品」页。
-- `image_edit`：拿一张已有的图按指令改（换风格、改细节）。`image` 给绝对路径，或 `image_gallery` 里的编号。服务端支不支持改图由接口决定，报错就照实告诉用户。
+- `image_edit`：拿一张已有的图按指令改（换风格、改细节）。`image` 给绝对路径，或 `image_gallery` 里的编号。`size` 一般不传（本地 ComfyUI 那档会照参考图的比例出图）；要固定尺寸就写 `宽x高`。服务端支不支持改图由接口决定，报错就照实告诉用户。
 - `image_gallery`：列出画过的图，最新的在前，带编号和绝对路径。编号可以交给 `image_show` 或 `image_edit`。
 - `image_show`：把一张旧图重新放回眼前（重新附加进对话，并在作品页高亮）。
 
@@ -11,6 +11,11 @@
 
 当前接口状态：`{{image.ready | 未知。不确定就别调用，先告诉用户去控制台「图片工坊 → 状态」看看。}}`
 
+## 模型链
+
+后台可能配了一串模型（「图片工坊 → 状态 → 模型链」），本地 ComfyUI 和云端接口都在里面，按顺序试：
+前一档连不上、超时、额度用完、模型没装，就自动换下一档；回执里会写「前几档没成」和最后用的是哪一档。
+
 ## 规矩
 
 1. **别每轮都画。** 用户明确想看/想让你画，或者确实需要一张图来解释、来送人，才调用。闲聊、讨论、解释概念都不需要配图。
@@ -18,7 +23,7 @@
 3. **描述要具体。** 主体、画风、构图、光线、色调、背景，一句到位；别只给两三个词，也别把整段聊天记录塞进去。
 4. **说人话，不念路径。** 回执里的绝对路径是给工具用的，不是给用户看的。画完就用一句自然的话告诉用户画了什么，像 `pet_say` 那样说话。不要把路径、编号、`blobs`、JSON 念出来，也不要贴 Markdown 图片语法。
 5. **发到别处要另走一步。** 图默认只在你自己的界面里。
-   - 想让主人在控制台的「对话」页看到它，画完之后再调 `pet_show_image`：`path` 填 `image_draw` 回执里的绝对路径，`caption` 可选（一句配文）。它只贴图、不出声，也不会引发语音。
-   - 要发到 QQ 会话，画完之后再调 `qq_send_image`，`image` 参数填 `image_draw` 回执里那个绝对路径。
+   - 想让主人在控制台的「对话」页看到它，画完之后调桌宠的 `pet_say`，`images` 填回执里 `[blob …]` 行的句柄（就是 `[blob ` 后面那一串），`script` 给空串就只贴图不出声；想配一句话就写进 `script`（那句话会在气泡里说出来）。图只进「对话」页，不进气泡。
+   - 要发到 QQ 会话：把回执里 `[blob …]` 行的句柄交给 QQ 世界的发图工具。官方 QQ 扩展用 `qq_draft`（`image` 填句柄，`to` 填 `group:<群号>` 或 `private:<QQ号>`，再用 `qq_confirm` 确认发送）；旧版 QQ 扩展（`qqbot`）用 `qq_send_image`，`image` 填回执里的绝对路径。
 6. **失败就停。** 如果回执说没配密钥、接口报错、超时，不要换个说法反复重试。把情况告诉用户，让他去控制台「图片工坊 → 状态」里填密钥或改接口地址。
 7. **别凭空说画好了。** 只有工具回执真的带着图回来，才算画好了。

package/README.md

@@ -1,16 +1,18 @@
 # 图片工坊 · cortico-world-image
 
-给 Coopanion 桌宠加两件事：**调用图片生成 API 画图，并把图交回对话**；以及**把本地任意一张图贴进控制台的「对话」页**——后者靠一套自愈补丁给桌宠加一个 `pet_show_image` 工具，程序自动更新把这些文件覆写回原样之后，扩展下次启动会自己补回来。
+给 Coopanion 桌宠加两件事：**调用图片生成 API 画图，并把图交回对话**；以及**把图贴进控制台的「对话」页**——后者用桌宠包自带的 `pet_say.images`（本扩展的工具回执里带着附件句柄），不再给桌宠打补丁。唯一还会被改写的是**第三方 QQ 扩展**里的两处路径解析（可选补丁，程序自动更新覆写回去之后，扩展下次启动会自己补回来）。
 
 这是一个 `cortico` 的 **World 扩展**（`kind: world`，`api: 6`），只补一个 `image` 世界，
 不依赖任何第三方 npm 包（纯 ESM JS + Node 内置模块）。
 
 > **性质说明**：这是给 Coopanion 写的**非官方**扩展，走的是框架公开的扩展接口
-> （`kind: world` + `webUiClient` 面板 + 必需的 `describe.json` 自描述）。唯一伸手动别人的地方是「对话页发图」那一节的
-> 自愈补丁——它按锚点改写安装目录下的几个文件（`resources/app` 里的浏览器 bundle、桌宠包
-> 的 `src/*.ts`，以及可选的第三方 QQ 扩展），改之前一律留 `.coopanion-orig` 备份，
-> 程序自动更新覆写后会自己补回来，细节与还原方式都在那一节里。不愿意让脚本动这些文件，
-> 就只用 `image_*` 四个工具，别装那份补丁（补丁是懒触发的，只在扩展启动时检查）。
+> （`kind: world` + `webUiClient` 面板 + 必需的 `describe.json` 自描述）。唯一伸手动别人的地方是「QQ 发图路径」
+> 那两处可选补丁——它按锚点改写**第三方 QQ 扩展**（`cortico-world-qq-better-alont1`）的 `src/world.ts`，改之前留一份
+> `.coopanion-orig` 备份，程序自动更新覆写后会自己补回来（细节与还原方式见那一节）。
+> 补丁只给**正在用的那个 QQ 扩展**打：读 `<安装>\data\home\companion\config.json`，
+> `worlds.qqbot.enabled` 不是 `true`（比如已经切到官方 `cortico-world-qq`）就整段跳过，一个字节都不碰。
+> **桌宠包本身完全不碰**：0.3.0 起改用官方的 `pet_say.images`，早先版本打进去的旧补丁会被自动还原。
+> 不愿意让脚本动那个第三方包，就把 QQ 扩展的补丁关掉（它认不出原文只会记一条失败，不会硬改）。
 >
 > MIT 许可，见 [LICENSE](LICENSE)。
 
@@ -20,8 +22,8 @@
 
 | 工具 | 标签 | 作用 |
 | --- | --- | --- |
-| `image_draw` | `act` | 按文字描述画一张新图，落盘、记进索引 |
-| `image_edit` | `act` | 拿一张已有的图按指令改（支持上传改图，或阿里云百炼式的 `image` 扩展字段） |
+| `image_draw` | `act` | 按文字描述画一张新图，落盘、记进索引（可带 `model` 点名用哪一档） |
+| `image_edit` | `act` | 拿一张已有的图按指令改（支持上传改图，或阿里云百炼式的 `image` 扩展字段；同样能带 `model`） |
 | `image_gallery` | `read` | 列出画过的图，带编号与绝对路径 |
 | `image_show` | `speak` | 把一张旧图重新放回对话与作品页 |
 
@@ -36,72 +38,49 @@
 > 桌宠窗口的说话气泡也只会渲染纯文本——只有选项卡片的图片位认 `data:image/`。
 > 硬往气泡里塞图会改框架，不是扩展该做的事。所以本扩展走「工具回执 blob + 自己的控制台页」这条正规通道。
 >
-> 例外是**控制台的「对话」页**：那里现在是打补丁支持了桌宠侧的图片（见下一节），
+> 例外是**控制台的「对话」页**：那里用桌宠包自带的 `pet_say.images` 就能显示图（见下一节），
 > 但桌宠**头顶气泡**仍然只画文字。
 
-## 对话页发图：`pet_show_image` + 自愈补丁
+## 把图贴到「对话」页：官方 `pet_say` 的 `images`
 
-桌宠多出一个工具：
+桌宠包从 **0.2.0** 起，`pet_say` 自带 `images` 参数，所以本扩展**不再给桌宠打任何补丁**：
 
-| 工具 | 标签 | 作用 |
-| --- | --- | --- |
-| `pet_show_image` | `act` | 把一个**本地图片路径**（绝对路径，或相对桌宠工作区，如 `blobs/xx.jpg`）贴到控制台「对话」页，可选一句配文 |
-
-- 认 PNG / JPEG / WebP / GIF（先嗅文件头，认不出才看后缀），单张上限 8 MB；
-- 标签是 `act` 不是 `speak`，**名字也不是 `pet_say`**，所以 CosyVoice TTS 那类只监听 `pet_say`
-  的扩展不会把它念出来；
-- 图片随事件存成附件（`log:` 句柄），对话页通过面板的 `blob` 方法取图；对话记录里翻回旧消息也还在。
-
-### 为什么要打补丁
-
-对话页的时间线是**桌宠世界自己**推的流：只有它能写 `source: 'desktop-pet'` 的事件。0.1.22 及更早的框架里：
+```js
+pet_say({ script: '', images: ['<句柄>'] })            // 只贴图、不说话
+pet_say({ script: '看，画好了。', images: ['<句柄>'] })  // 气泡里说一句，图贴到对话页
+```
 
-- `node_modules/cortico-world-desktop-pet/src/chat.ts` 的 `chatItem()` 在 `kind: 'say'` 分支只取
-  `meta.beats`，把事件上的 `blobs` 丢掉；
-- 浏览器侧 bundle 里 say 那一段只画 `pet-bubble`/`mood`，没有图片槽位（只有用户侧消息有）。
+- 参数收的是**附件句柄**：就是工具回执里 `[blob <handle> <mime> <name>]` 那一行的 `<handle>`。
+  本扩展的 `image_draw` / `image_edit` / `image_show` 回执本来就带附件，框架会把它渲染成这样一行交给模型。
+- `script` 空串 = 只有图、没台词；图只进控制台「对话」页，**不进气泡**。写一句话就同时说、同时贴。
+- **任意本地文件要两步**：先 `image_show({ path })` 把文件读成附件、拿到句柄，再 `pet_say`。
+  多一次工具调用，并且那张图会被渲染给模型看（约 1k+ token/张，一次性）；对话里刚画好的图
+  直接用 `image_draw` 回执里的句柄，不额外花。
+- 0.3.0 起**没有 `pet_show_image` 这个工具了**。
 
-所以「另写一个扩展往对话页推图」是走不通的（别的世界推的事件不会经过桌宠的
-`chat.broadcast`，`chatPage()` 也只读 `source === 'desktop-pet'`）。0.1.23 之前靠补丁把这两段补上；
-**0.1.23 框架自己已经内置，那 4 处补丁已经删掉**（见下一节）。现在补丁一共 8 处：
-前 6 处是你这份安装里本来就有的文件（`world.ts` 5 处 + `definition.ts` 1 处，最后 3 处让
-`pet_show_image` 也认相对路径），后 2 处（`optional`）落在**第三方 QQ 扩展**上，没装那个扩展就记
-`absent`——不算失败、也不进状态页的总数：
+### 0.3.0 删掉的桌宠补丁（7 处）
 
-| 补丁 id | 文件 | 做什么 |
+| 原来的补丁 id | 文件 | 原本做什么 |
 | --- | --- | --- |
-| `pet-fs-import` | 桌宠 `src/world.ts` | `node:fs` 导入加 `readFileSync`（`{ statSync }` 与 `{ existsSync, statSync }` 两种写法都认） |
+| `pet-fs-import` | 桌宠 `src/world.ts` | `node:fs` 导入加 `readFileSync` |
 | `pet-path-import` | 桌宠 `src/world.ts` | `node:path` 导入加 `basename/extname/isAbsolute` |
 | `pet-show-image-tool` | 桌宠 `src/world.ts` | `CHAT_IMAGE_TOOL` 常量、`sniffImageMime()`、`showImage()`、挂进 `tools()` |
-| `pet-workspace-option` | 桌宠 `src/world.ts` | 世界选项加 `workspaceDir?: () => string`（装配层注入桌宠工作区） |
-| `pet-workspace-relpaths` | 桌宠 `src/world.ts` | `pet_show_image` 的相对路径按 `workspaceDir()` 拼，说明也改成「绝对路径或相对工作区」 |
+| `pet-workspace-option` | 桌宠 `src/world.ts` | 世界选项加 `workspaceDir?: () => string` |
+| `pet-workspace-relpaths` | 桌宠 `src/world.ts` | `pet_show_image` 的相对路径按 `workspaceDir()` 拼，说明同步 |
 | `pet-workspace-wire` | 桌宠 `src/definition.ts` | 装配层把 `join(ctx.botDir, 'workspace')` 传进世界 |
-| `qq-image-relpaths`（可选） | `<安装>\data\extensions\node_modules\cortico-world-qq-better-alont1\src\world.ts` | `qq_send_image` / `qq_view_image` 认「相对桌宠工作区」的路径（见下） |
-| `qq-image-hints`（可选） | 同上 | 那两个工具的参数说明也改成「相对桌宠工作区的路径，如 `blobs/xx.jpg`」 |
-
-改法一律是**精确锚点 + 幂等标记**（`coopanion-chat-image`）：
-认不出锚点就记一条失败并**不动那个文件**，绝不硬猜。第一次改写前会把原文留一份
-`<文件>.coopanion-orig`。
-
-补丁器不写死源码里的变量名：`tools()` 那处不写死
-`DESKTOP_PET_TOOL_DECLS.map(...)`，而是包住 `tools()` 里现有的 `return ...;`。
-所以升级换了写法之后照样能打上。
-
-### 框架 0.1.23 之后为什么少了 4 处补丁
-
-0.1.23 起「把图发到对话页」是框架原生能力，不再是这个扩展要补的洞：
-
-- 桌宠 `pet_say` 工具原生就有 `images` 参数（给 `[blob …]` 句柄），`world.ts` 的
-  `record(meta, text, blobs = [])` 原生把图片附件写进事件；
-- `chat.ts` 原生有 `wireImages()`：把事件 `blobs` 里 `image/*` 的映射成 `WireImage`，`ChatItem` 的
-  say 变体本身带 `images?: WireImage[]`；
-- 客户端 bundle 的 say 一段原生就画 `chat-thumb` 缩略图并挂 lightbox。
+| `pet-show-image-describe` | 桌宠 `src/definition.ts` | 把 `pet_show_image` 补进 `describe.tools`（框架 0.2 会核对，缺了记「工具不在 describe.tools 里」） |
 
-原先为此打的 4 处——`client-say-images`（改客户端 bundle）、`pet-say-images`、`pet-say-type`
-（都改 `chat.ts`）、`pet-record-blobs`（改 `world.ts` 的 `record()`）——已经删掉。留着不只是多余：
-0.1.23 的 bundle 与新 `chat.ts` 已经换了写法，那几条锚点认不出来，每次启动都会白记三条失败。
+**为什么能全删**：0.1.23 起原生就有 `pet_say.images` 与「事件 `blobs` → 对话页缩略图」，
+0.2.0 起桌宠包的 `pet_say` 会 `host.blob()` 取句柄里的字节、写进事件（`deliver: false`，
+不会再把图投回模型）；而本扩展四个工具的回执本来就带 `blobs`，框架会把它们渲染成 `[blob …]` 句柄。
+`pet_show_image` 当年是唯一「按路径贴图」的入口，现在 `image_show` + `pet_say` 覆盖同一场景——
+注入的工具、它的相对路径、工作区接线、自描述四处都不再需要，一并删掉。
 
-**但 `pet_show_image` 仍然保留**：原生的 `pet_say.images` 只认 `[blob …]` 句柄，不认文件路径，而
-`pet_show_image` 正是唯一「按路径贴图」的入口——它的实现与「相对桌宠工作区」那几处补丁照样必需。
+**旧安装怎么收尾**：`revertObsoletePetPatches()` 在每次启动时检查桌宠包的
+`src/world.ts` / `src/definition.ts`——只要文件里还有我们的标记（`coopanion-chat-image` /
+`COOPANION_CHAT_IMAGE_TOOL` / `name: 'pet_show_image'`）且有 `.coopanion-orig` 备份，
+就用备份覆盖回原文（等于把桌宠包恢复成上游原样），并在「状态」页记一笔。
+桌宠包自己升级过（标记没了）就一律不动。
 
 ### 为什么顺手改了 QQ 扩展（`optional` 那两处）
 
@@ -110,51 +89,47 @@
 桌宠手里只有 `blobs/qq-test.jpg` 这种相对工作区的路径，工具先去扩展目录里找，找不到就回一句
 「本地没有这个文件：…」，图发不出去。
 
-补上的这一处只做一件事——`resolveLocalImagePath()`：相对路径**先按桌宠工作区
+| 补丁 id | 文件 | 做什么 |
+| --- | --- | --- |
+| `qq-image-relpaths`（可选） | `<安装>\data\extensions\node_modules\cortico-world-qq-better-alont1\src\world.ts` | `qq_send_image` / `qq_view_image` 认「相对桌宠工作区」的路径 |
+| `qq-image-hints`（可选） | 同上 | 那两个工具的参数说明改成「相对桌宠工作区的路径，如 `blobs/xx.jpg`」 |
+
+补上的这处只做一件事——`resolveLocalImagePath()`：相对路径**先按桌宠工作区
 （`this.config.memoryDir`，装配层给的 `<botDir>/workspace`）解析，工作区没有才退回扩展目录**
-（装配层没给工作区时退回老行为）；绝对路径原样返回。工具的参数说明也跟着改成
-「绝对路径，或相对桌宠工作区的路径，如 `blobs/xx.jpg`」——模型只看得到说明，说明不改它不敢写短路径。
+（装配层没给工作区时退回老行为）；绝对路径原样返回。工具的参数说明也跟着改成同一口径——
+模型只看得到说明，说明不改它不敢写短路径。
 
-这个包是 `.pnpm` 装的第三方扩展，升级会换目录、文件也会被覆写，所以走同一套自愈：找不到那份
+这个包是第三方的，升级会换目录、文件也会被覆写，所以走同一套自愈：找不到那份
 `world.ts` 记 `absent`（没装这个扩展不算失败、不进总数），认不出它原来的写法记 `failed` 并且
 **不动那个文件**，原文备份同样是 `world.ts.coopanion-orig`。改的是 TS 源码，**要重启才生效**。
 
-### `pet_show_image` 的相对路径（`pet-workspace-*` 那三处）
-
-同样的毛病在桌宠自己身上（`pet_show_image` 也只认绝对路径，所以「记一句、再发回来」这条最自然的
-用法反而要桌宠去背一长串绝对路径）。桌宠那份世界和 QQ 扩展不一样：它的选项里**没有**工作区字段，
-所以得三处一起改——世界选项加一个可选的 `workspaceDir?: () => string`（`pet-workspace-option`），
-`showImage()` 里那行 `const raw = …` 改成 `let` 并加一段「相对路径就拼工作区，没给工作区仍然报错、
-只认绝对路径」（`pet-workspace-relpaths`，同时改工具说明），最后在装配层
-`cortico-world-desktop-pet/src/definition.ts` 里把 `join(ctx.botDir, 'workspace')` 传进去
-（`pet-workspace-wire`）。
-
-三处都是**精确锚点**，认不出原文就记 `failed` 且不动文件；`pet-workspace-relpaths` 的 `done` 判据是
-「真的拼上了工作区」（`raw = join(ws, raw);`），光有工具说明不算打过。装配层没给 `workspaceDir`
-（比如桌宠包又改了装配代码、只有前两处打上）时，行为退回老样子：相对路径报错、要求绝对路径——
-不会静默拿到错的路径。
+**切到别的 QQ 扩展就自动让路**：每个补丁都标了它服务的世界 id（`worldId: 'qqbot'`），
+应用时会读 `<安装>\data\home\companion\config.json` 的 `worlds.qqbot.enabled`——
+不是 `true`（例如官方 `cortico-world-qq` 顶替了它）就整段跳过，两处都记 `absent`、文件一个字节不动、
+不请求重启，状态页这张卡片也不显示备份行（0.3.1 起）。读不到配置时**不猜**，照旧检查并打补丁。
 
 ### 自愈怎么工作
 
 扩展模块的顶层代码**每次启动都会跑**（`loadExtensions()` 无差别 import 所有已装扩展，与
 `worlds.<id>.enabled` 无关），所以这里不用等用户做任何事：
 
-1. 启动时打一遍补丁 → 如果这次真的改了文件，状态文件里记 `requested: true`，并在 4 秒后
-   `POST http://127.0.0.1:<web.port>/api/run/restart` 请控制台重启一次（桌宠侧的 TS 源码要重启才装载）；
-2. 重启后再跑：文件已经是打过补丁的样子 → 8 处全部 `done`（没装 QQ 扩展的那 2 处是 `absent`）→ 不再请求重启（**不会反复重启**）；
-3. 程序自动更新把文件覆写回原样 → 下一轮启动又补上，再重启一次，回到第 2 步；
+1. 启动时先**还原**桌宠包上早先版本留下的旧补丁（0.3.0 起不再注入），再检查 QQ 扩展那两处；
+   如果这次真的改了文件，状态文件里记 `requested: true`，并在 4 秒后
+   `POST http://127.0.0.1:<web.port>/api/run/restart` 请控制台重启一次（QQ 扩展的 TS 源码要重启才装载）；
+2. 重启后再跑：文件已经是对的样子 → 2 处全部 `done`（没装 QQ 扩展、或 `worlds.qqbot` 没启用时两处都是 `absent`）→ 不再请求重启（**不会反复重启**）；
+3. 程序自动更新（或 QQ 扩展升级）把文件覆写回原样 → 下一轮启动又补上，再重启一次，回到第 2 步；
 4. 万一「已经请求过重启，这次还是缺」——说明补丁根本落不到进程真正加载的那份文件上，
    这时记 `stuck`，**故意不再重启**（防死循环），并在「状态」页把 `id — 原因` 列出来给人看。
 
-状态文件是扩展目录下的 `.chat-image-patch.json`（`{at, appRoot, patched, failed, requested}`）。
+状态文件是扩展目录下的 `.chat-image-patch.json`（`{at, appRoot, patched, failed, reverted, requested}`）。
 想彻底关掉这套自愈（比如做回归测试），设环境变量 `COOPANION_CHAT_IMAGE_PATCH=0`。
 
-控制台「图片工坊 → 状态」页多出一张**发图补丁**卡片：装没装上、8 处在不在、上次检查时间、
+控制台「图片工坊 → 状态」页有一张**补丁卡片**：QQ 两处打没打上、上次检查时间、
 每一处的备份（`<文件>.coopanion-orig` 在不在、与当前文件是否一致）、上次还原记录、
 上次重启请求的结果，外加三个按钮：
 
 - **重打补丁**——立刻再对一遍（不改就不请求重启）；
-- **还原备份**——用更新下发的原文把改动过的文件覆盖回去（可逆，备份不删，随时能再打回来）；
+- **还原备份**——用更新下发的原文把改过的文件覆盖回去（可逆，备份不删，随时能再打回来）；
 - **重启控制台**——等价于点菜单里的重启。
 
 ### 备份与还原
@@ -168,7 +143,7 @@
 备份是**每份目标文件旁边的 `<文件>.coopanion-orig`**，第一次改写前拷一次，之后一直留着
 （再打补丁不会覆盖它——它永远是「更新下发的原文」）。还原 = 拿它覆盖回去，所以：
 
-- 还原后桌宠那一侧要**重启控制台**才回到「没有发图功能」；面板上的「还原备份」故意不自动重启；
+- 还原后 QQ 发图回到「只认扩展目录的相对路径」，要**重启控制台**才生效；面板上的「还原备份」故意不自动重启；
 - 还原不是终点：下次启动（或再点**重打补丁**）会自动补回来，所以试错很安全。
 
 ### 页面陈旧与浏览器缓存
@@ -192,9 +167,9 @@
 修法是抬版本 + 重启，主程序会在 Core 就绪时自动重载控制台外壳（
 `resources\app\app\main.cjs:285` `if (settings) settings.loadURL(consoleUrl());`）：
 
-1. 把 `package.json` 的 `version` 抬一格（例如 `0.1.3` → `0.1.4`）；
+1. 把 `package.json` 的 `version` 抬一格（例如 `0.5.0` → `0.5.1`）；
 2. 重启控制台（状态页「重启控制台」或 `node tools/patch.mjs --restart`）；
-3. 程序内窗口自动重载 → 新的 URL `/assets/extensions/cortico-world-image/0.2.0/webui.js`
+3. 程序内窗口自动重载 → 新的 URL `/assets/extensions/cortico-world-image/0.5.1/webui.js`
    取到新脚本，旧 URL 立刻变 404。
 
 不想抬版本也行，但要**先完全退出程序**再删缓存目录：`<安装>\data\Cache`、
@@ -230,7 +205,7 @@ registry 上有版本时直接从 npm 装；想自己改代码、或者 `npm vie
 或者用命令行，在 `data/extensions` 目录里（`extensions/package.json` 所在处）执行：
 
 ```powershell
-pnpm add cortico-world-image --ignore-workspace        # 想钉住版本就写 cortico-world-image@0.1.4
+pnpm add cortico-world-image --ignore-workspace        # 想钉住版本就写 cortico-world-image@0.5.1
 ```
 
 装完重启。升级同理：重跑一遍（控制台的「扩展」页会显示已装版本与最新版本），装完同样要重启。
@@ -256,7 +231,8 @@ pnpm add "D:\path\to\cortico-world-image" --ignore-workspace
 
 **装完必须重启 Coopanion**：扩展是 ESM 模块，进程内不会重新加载。重启后在
 `config.json` 的 `worlds.image.enabled` 上打开（控制台里也有这个开关），四个工具才会挂给桌宠。
-同一轮启动里，扩展还会把「对话页发图」那 8 处补丁检查一遍（其中 2 处是 QQ 扩展的可选补丁，没装就跳过），缺了就补、并自己请控制台重启一次
+同一轮启动里，扩展还会把 QQ 发图路径那 2 处补丁检查一遍（没装 QQ 扩展、或已切到别的 QQ 扩展就跳过），缺了就补、并自己请控制台重启一次；
+桌宠包上早先版本留下的旧补丁会在同一轮里被还原成上游原样
 （详见上一节）。
 
 ### 一份能用的 `worlds.image` 长什么样
@@ -290,10 +266,11 @@ pnpm add "D:\path\to\cortico-world-image" --ignore-workspace
 | 键 | 默认 | 说明 |
 | --- | --- | --- |
 | `enabled` | `false` | 是否把四个工具挂给桌宠 |
-| `baseUrl` | `https://api.openai.com/v1` | OpenAI 兼容的图片接口根地址 |
+| `baseUrl` | `https://api.openai.com/v1` | OpenAI 兼容的图片接口根地址（没配 `models` 时用它） |
 | `apiKeySecret` | `IMAGE_API_KEY` | 密钥的**变量名**：先看部署 `.env`，再退到同级的端点 `.env` |
-| `model` | `gpt-image-1` | 模型名 |
-| `size` | `1024x1024` | 尺寸，`auto` 或留空就不发这个参数 |
+| `model` | `gpt-image-1` | 模型名（没配 `models` 时用它） |
+| `models` | 空 | 模型链：一串后端按优先级顺序试，见下面「模型链」（0.4.0 起） |
+| `size` | `1024x1024` | 尺寸：`1024x1536`、比例 `16:9`/`4:3`、或 `square`/`portrait`/`landscape`；`auto` 或留空＝不指定（云端不发这个参数，本地按图生图规则处理） |
 | `quality` | `auto` | `low`/`medium`/`high` 或 `standard`/`hd`；`auto` 不发 |
 | `format` | `png` | 接口没给格式时按这个存盘（`png`/`jpeg`/`webp`） |
 | `timeoutMs` | `180000` | 单次画图等待上限 |
@@ -301,6 +278,71 @@ pnpm add "D:\path\to\cortico-world-image" --ignore-workspace
 | `keep` | `200` | 超出后自动删最旧的，`0` = 不清理 |
 | `pushToConsole` | `true` | 画完实时推给「作品」页 |
 
+### 模型链：一串后端按顺序试（0.4.0）
+
+`worlds.image.models` 是一份 JSON 数组，**数组顺序就是优先级**。前档连不上、超时、额度用完、
+模型没装、参数不支持时自动换下一档；只有「内容审核拦了提示词」这类换谁都一样的错才不换。
+状态页的「模型链」卡片里它就是**一串小卡片**（见下），不用手写 JSON。
+
+```json
+[
+  { "name": "local", "preset": "comfyui", "baseUrl": "http://127.0.0.1:8188", "ckpt": "sd_xl_base_1.0.safetensors" },
+  { "name": "cloud", "preset": "openai", "baseUrl": "https://api.openai.com/v1", "model": "gpt-image-1" }
+]
+```
+
+留空 = 用上面那套单档 `baseUrl` + `model`。两种 `preset`：
+
+- `openai`：原有的 OpenAI 兼容接口（`/images/generations`、`/images/edits`），要密钥。
+- `comfyui`：本地 ComfyUI（默认 `http://127.0.0.1:8188`），**不要密钥**，但要写模型文件：
+  `ckpt`（checkpoint 文件名，就是 `ComfyUI/models/checkpoints/` 里那个），或者 **裸 UNet 三件套**
+  `unet` + `textEncoder` + `vaeName`（Anima、Flux 这类不是 all-in-one 的模型；填了 `unet` 就不看 `ckpt`）。
+
+每档都能写这些。`baseUrl` / `model` / `apiKeySecret` / `size` / `quality` / `format` / `timeoutMs` 不写就继承
+`worlds.image` 的单档设置；其余（`ckpt`、`loras`、采样参数等）只有链里的档才有，按下面的默认值走：
+
+| 键 | 说明 |
+| --- | --- |
+| `name` | 这一档的名字；面板与报错里用它，工具参数 `model` 也按它点名 |
+| `preset` | `openai` / `comfyui` |
+| `baseUrl` / `model` / `apiKeySecret` / `size` / `quality` / `format` / `timeoutMs` | 同上面那张表 |
+| `ckpt` | ComfyUI 的 checkpoint 文件名（`comfyui` 必填，除非写了 `unet`） |
+| `unet` / `textEncoder` / `vaeName` | 裸 UNet 三件套：`ComfyUI/models/diffusion_models`、`text_encoders`、`vae` 里的文件名。**填了 `unet` 就顶掉 `ckpt`**，只出裸 UNet 那份工作流 |
+| `textEncoderType` | `unet` 的文本编码器类型，默认 `stable_diffusion`；Qwen 系编码器填 `qwen_image`（还认 `sd3` / `flux` / `cosmos` / `lumina2`） |
+| `loras` | ComfyUI 的 LoRA：`["add_detail.safetensors:0.6", {"name":"x.safetensors","strength":0.4,"clipStrength":0.25}]`（名字带扩展名，文件得先在 ComfyUI 的 `models/loras` 里） |
+| `steps` / `cfg` / `sampler` / `scheduler` / `denoise` / `negative` | ComfyUI 采样参数（默认 25 / 7 / euler / normal / 0.6）。`denoise` 在改图时就是改动幅度：0.6 起改得明显，只微调用 0.2~0.35 |
+| `workflow` | 自定义 ComfyUI API 工作流（对象）。给了就整份替换内置模板，占位符见下 |
+| `edit` | `false` = 这一档只用来画、不接改图（改图会跳到下一档） |
+| `enabled` | `false` = 跳过这一档 |
+
+工具参数 `model` 可以点名某一档（`name`、`ckpt` 或 `model` 三者之一）：点了名就**只用那一档**，
+失败了直接报错、不偷偷换——想让它自己挑就别传 `model`。
+
+状态页的「模型链」卡片默认就是友好编辑：一档一张小卡片，填「名称 / 类型 / 地址 / 模型或 ckpt」，
+用「上移 / 下移」调优先级、「删除」去掉一档，「＋ 本地 ComfyUI」「＋ 云端接口」加档。
+本地 ComfyUI 那档还多一个「高级参数」按钮：能加**多行 LoRA**（文件名 / 强度 / CLIP 强度，文件名要带
+扩展名、可带子目录），也能改 `negative`、`steps`、`cfg`、`sampler`、`scheduler`、`denoise`，
+以及**裸 UNet 三件套**（`unet` / `textEncoder` / `textEncoderType` / `vaeName`；填了它就忽略这一档的 `ckpt`）
+——存的就是该档的 `loras`、`negative`、`steps`、`unet` 这些字段，等于面板版的「高级：JSON」。
+保存就是写 `worlds.image.models`；`workflow` 这类只能手写的字段仍点「高级：JSON」改原文——**链还空着时它自带一份现成范例**
+（一档本地 ComfyUI，带 `ckpt`、两条 LoRA、采样参数与负面提示；一档云端），
+把 `ckpt` / `loras` 换成自己 `models` 里的文件名，「应用 JSON」再「保存模型链」就能用。
+「测试模型链」会挨档探活：ComfyUI 看 `/system_stats`，再用 `/object_info` 一次性核对 `ckpt`（或
+`unet` / `textEncoder` / `vaeName`）在不在；OpenAI 兼容看 `/models`（端点没这条路由也算在线）。
+探活每档最多等 6 秒；链上有没保存的改动时会先拦住。
+
+#### ComfyUI 这档会调哪些路
+
+`POST /prompt`（提交工作流）、`GET /history/<prompt_id>`（轮询等结果）、`GET /view?filename=…`
+（取成品图）、`POST /upload/image`（改图时把参考图放进 `input/`）、`POST /interrupt`（超时收尾）、
+`GET /system_stats`、`GET /object_info`（核对模型文件名，拿不到就跳过核对）。
+
+不会替你去下模型：checkpoint 与 LoRA 得先放进 ComfyUI 的 `models/checkpoints` 与 `models/loras`，
+`ckpt` 写文件名（在子目录里就写相对路径）；裸 UNet 的三个文件放进 `models/diffusion_models`、
+`models/text_encoders`、`models/vae`。自定义 `workflow` 里可用的占位符：
+`prompt`、`negative`、`ckpt`、`width`、`height`、`size`、`steps`、`cfg`、`sampler`、`scheduler`、
+`seed`、`denoise`、`image`、`loras`、`prefix`、`filename`（写成 `{{prompt}}` 这样，认不出的原样留着）。
+
 ### 密钥
 
 密钥**不写进 `config.json`**。两种填法：
@@ -381,9 +423,9 @@ node tools/live.mjs                                       # 可加 LIVE_BASE_URL
 
 跑一次视端点而定，通常 20–60 秒（一张 1024×1024）。没有配好密钥的端点就别跑这一份。
 
-第四份管「对话页发图」那套补丁：默认在临时副本上自测（认锚点、幂等、留备份、还原、esbuild 语法、
-上游改过锚点时必须报失败、自动更新覆写后能补回来但不进重启死循环），另有 `--apply` /
-`--backups` / `--restore` / `--restart` 四种真动作，见上面「对话页发图」一节。
+第四份管 QQ 发图路径那两处补丁：默认在临时副本上自测（认锚点、幂等、留备份、还原、esbuild 语法、
+上游改过锚点时必须报失败、自动更新覆写后能补回来但不进重启死循环、桌宠包上的旧补丁能被还原），
+另有 `--apply` / `--backups` / `--restore` / `--restart` 四种真动作，见上面「为什么顺手改了 QQ 扩展」一节。
 
 ```powershell
 node tools/patch.mjs
@@ -416,7 +458,9 @@ cortico-world-image/
 │  ├─ definition.js    # id/label/defaults/preflight/create
 │  ├─ config.js        # worlds.image 默认值、中英文案、配置组 schema
 │  ├─ world.js         # ImageWorld：工具、控制台面板、流式推送、生命周期
-│  ├─ chat-image-patch.js # 对话页发图的 8 处补丁（含 3 处工作区相对路径、2 处可选的 QQ 扩展）、状态文件、重启请求（自愈核心）
+│  ├─ chain.js         # 模型链：解析 worlds.image.models、排序、逐档回退、报错归纳
+│  ├─ comfyui.js       # 本地 ComfyUI 适配器（内置工作流 / 自定义 workflow / 改图 / 探活）
+│  ├─ chat-image-patch.js # QQ 发图路径的 2 处可选补丁、旧桌宠补丁还原、状态文件、重启请求（自愈核心）
 │  ├─ api.js           # OpenAI 兼容客户端的取图/落盘/错误归一化
 │  ├─ gallery.js       # 作品仓库：目录 + index.json
 │  └─ png.js           # 零依赖 PNG 编码器 + 自检样图
@@ -427,7 +471,7 @@ cortico-world-image/
    ├─ describe.mts     # 生成 / 核对 describe.json（--check 只核对）
    ├─ drymount.mts     # 用框架自带判据跑 dry-mount
    ├─ live.mjs         # 联网真画一张（自测整条链路）
-   ├─ patch.mjs        # 对话页发图补丁：自测 / --apply / --backups / --restore / --restart
+   ├─ patch.mjs        # QQ 发图路径补丁：自测 / --apply / --backups / --restore / --restart
    └─ prepublish.mjs   # 发布前自检：契约 / files / 隐私串 / 语法，顺手跑上面几套
 ```
 
@@ -435,13 +479,27 @@ cortico-world-image/
 
 - 控制台页面自己有缓存/陈旧问题：换版本或控制台重启后，更新之前就开着的那个标签页可能不再更新，
   Ctrl+F5 即可（详见「页面陈旧与浏览器缓存」）。
-- 桌宠**头顶气泡**仍然只画文字；`pet_show_image` 的图出现在控制台「对话」页（靠上面那套补丁），不在气泡里。
-- `pet_show_image` 的相对路径按桌宠工作区解析（`pet-workspace-*` 那三处补丁）；万一装配层那处
-  （`pet-workspace-wire`）没打上、世界里没拿到 `workspaceDir`，行为退回老样子：相对路径报错、
-  要求给绝对路径——不会静默拼出一个错的路径。
+- 桌宠**头顶气泡**仍然只画文字；图片出现在控制台「对话」页（`pet_say.images`），不在气泡里。
+- 贴**任意本地文件**要两步（先 `image_show` 换句柄，再 `pet_say`），会比以前的 `pet_show_image` 多一次
+  工具调用、多花约 1k+ token/张（那次调用会把图渲染给模型看）。
+- 桌宠包早于 0.2.0 时没有 `pet_say.images`，贴图这条路走不通（0.3.0 也因此不再支持老桌宠包）。
 - `image_edit` 先走 `/images/edits`（multipart 上传）；端点没这条路由（404/405）时自动退回
   `/images/generations` 的 `image` 扩展字段（data URI，阿里云百炼那类）。两条路都不通时会回一条
   带 HTTP 码的错误，不是静默失败。
+- 尺寸：`size` 能写 `1024x1536`、比例 `16:9` / `4:3`、或 `square` / `portrait` / `landscape`（中文
+  `竖图` / `横图` / `方图` 也认），比例会换成一套对齐好的尺寸（16:9 → 1344×768，4:3 → 1152×864）；
+  写死的数字只按 latent 要求对齐到 8，不动你写的整数。
+- 改图的尺寸：ComfyUI 那档**不传 `size`、或写 `auto`，就照参考图的比例**出图（最长边压到 1536、对齐
+  16），传了 `size` 就按给的；云端那档走接口自己的默认（一般不传尺寸）。所以改一张 1600×1200 的图
+  会出 1536×1152，不会变成方图。图生图的回执/作品页记的是**实际出的尺寸**，不再是 `auto`。
+- 模型链的 ComfyUI 那档**不会替你下模型**：checkpoint / LoRA 得先放进 ComfyUI 的
+  `models/checkpoints`、`models/loras`，`ckpt` 写文件名；本机没开 ComfyUI 时这档直接算不可用，
+  链会落到下一档。**裸 UNet 要放 `models/diffusion_models`**（老版本是 `models/unet`），放错到
+  `checkpoints` 里会被当成 checkpoint、`UNETLoader` 那边永远看不到——这种时候插件会把 ComfyUI 的
+  校验错误翻成人话：缺哪个字段、给了什么值、它现在认哪些名字、文件该放哪个目录。
+- 用错加载方式也会解释：拿 checkpoint 节点去开一个没有 CLIP / VAE 的裸模型时，ComfyUI 只丢一句
+  `clip input is invalid: None`，插件会说明「这是裸模型 → 改用模型文件三件套、文件放 diffusion_models」；
+  显存不足、缺自定义节点也各有对应的一句话。
 - 只有 Windows 上的「打开文件夹」会真的弹资源管理器；其他平台返回一句说明。
 - 画图本身要联网，只有自检样图是纯本地的。
 
@@ -462,7 +520,7 @@ README 里只写结论，**逐步命令、npm 账号/Token、registry、缓存
 
 MIT，见 [LICENSE](LICENSE)。
 
-这是一个**非官方**扩展：与 Coopanion / cortico 的作者无关。「对话页发图」那部分补丁直接改写
-安装目录里的框架文件与第三方扩展源码（`resources/app` 与 `data/extensions` 下的位置），
+这是一个**非官方**扩展：与 Coopanion / cortico 的作者无关。QQ 发图路径那两处补丁会改写
+**第三方 QQ 扩展**的源码（`data/extensions/node_modules/cortico-world-qq-better-alont1/src/world.ts`），
 升级、重装或自动更新前请先看那一节并留好 `.coopanion-orig` 备份；`node tools/patch.mjs --restore`
-就是按这些备份还原。
+就是按这些备份还原。桌宠包本身不改（早先版本的旧补丁会被还原）。

package/describe.json

@@ -2,7 +2,7 @@
   "tools": [
     {
       "name": "image_draw",
-      "description": "Draw a picture from a text description through the configured image API. The picture is saved to disk, attached to this conversation so you can see it, and shown in the Image Studio console page. The reply carries the absolute file path; hand that path to a channel tool such as qq_send_image to actually deliver the picture to someone.",
+      "description": "Draw a picture from a text description through the configured model chain (a local ComfyUI, an OpenAI-compatible cloud endpoint, or both in priority order). The picture is saved to disk, attached to this conversation so you can see it, and shown in the Image Studio console page. The reply carries the absolute file path; hand that path to a channel tool such as qq_send_image to actually deliver the picture to someone.",
       "parameters": {
         "type": "object",
         "properties": {
@@ -10,17 +10,21 @@
             "type": "string",
             "description": "What to draw: subject, style, composition, lighting. Any language."
           },
+          "model": {
+            "type": "string",
+            "description": "Optional chain entry name (for example \"local\" or \"cloud\"). Leave empty to try the chain in priority order."
+          },
           "note": {
             "type": "string",
             "description": "Short label for this picture in the studio list."
           },
           "size": {
             "type": "string",
-            "description": "Override the configured size, e.g. 1024x1024 or 1024x1536."
+            "description": "Override the configured size: \"1024x1536\", a ratio like \"16:9\" or \"4:3\", or \"square\" / \"portrait\" / \"landscape\"."
           },
           "quality": {
             "type": "string",
-            "description": "Override the configured quality, e.g. low / medium / high."
+            "description": "Override the configured quality, e.g. low / medium / high. Ignored by ComfyUI."
           }
         },
         "required": [
@@ -31,13 +35,13 @@
         "act"
       ],
       "summary": {
-        "zh": "按一段文字描述画一张新图，存到磁盘、贴进对话，并显示在作品页。",
-        "en": "Draw a new picture from a text description, save it to disk and show it in the conversation."
+        "zh": "按一段文字描述画一张新图（本地 ComfyUI 或云端接口，按模型链的顺序），存到磁盘、贴进对话，并显示在作品页。",
+        "en": "Draw a new picture from a text description through the model chain, save it to disk and show it in the conversation."
       }
     },
     {
       "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. 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).",
+      "description": "Redraw an existing local picture following a text instruction, through the same model chain as image_draw. `image` takes an absolute file path, or a picture id from image_gallery. OpenAI-compatible entries use /images/edits (multipart upload) or a base64 `image` field on /images/generations (e.g. Aliyun Bailian); ComfyUI entries upload the picture and run an img2img workflow.",
       "parameters": {
         "type": "object",
         "properties": {
@@ -49,17 +53,21 @@
             "type": "string",
             "description": "Absolute path of the source picture, or a picture id from image_gallery."
           },
+          "model": {
+            "type": "string",
+            "description": "Optional chain entry name. Leave empty to try the chain in priority order."
+          },
           "note": {
             "type": "string",
             "description": "Short label for the result in the studio list."
           },
           "size": {
             "type": "string",
-            "description": "Override the configured size."
+            "description": "Override the output size: \"1024x1024\", a ratio like \"16:9\", or \"square\" / \"portrait\" / \"landscape\". Leave it empty to keep the source picture ratio (local ComfyUI) — that is the usual choice for edits."
           },
           "quality": {
             "type": "string",
-            "description": "Override the configured quality."
+            "description": "Override the configured quality. Ignored by ComfyUI."
           }
         },
         "required": [
@@ -126,7 +134,7 @@
       "key": "worlds.image.envPrompt",
       "title": "环境说明（图片工坊）",
       "role": "envPrompt",
-      "content": "你可以作画。这一节说明工具箱和规矩。\n\n## 四个工具\n\n- `image_draw`：按一段文字描述画一张新图。图会存到磁盘、附加进本次对话（你自己看得到）、并显示在控制台「图片工坊 → 作品」页。\n- `image_edit`：拿一张已有的图按指令改（换风格、改细节）。`image` 给绝对路径，或 `image_gallery` 里的编号。服务端支不支持改图由接口决定，报错就照实告诉用户。\n- `image_gallery`：列出画过的图，最新的在前，带编号和绝对路径。编号可以交给 `image_show` 或 `image_edit`。\n- `image_show`：把一张旧图重新放回眼前（重新附加进对话，并在作品页高亮）。\n\n图片保存目录：`{{image.dir | 尚未确定；先看控制台「图片工坊 → 状态」。}}`\n\n当前接口状态：`{{image.ready | 未知。不确定就别调用，先告诉用户去控制台「图片工坊 → 状态」看看。}}`\n\n## 规矩\n\n1. **别每轮都画。** 用户明确想看/想让你画，或者确实需要一张图来解释、来送人，才调用。闲聊、讨论、解释概念都不需要配图。\n2. **一次画一张。** 想要不同方向就画一张、看一眼、再决定要不要重画或改。不要一次调好几个 `image_draw` 碰运气。\n3. **描述要具体。** 主体、画风、构图、光线、色调、背景，一句到位；别只给两三个词，也别把整段聊天记录塞进去。\n4. **说人话，不念路径。** 回执里的绝对路径是给工具用的，不是给用户看的。画完就用一句自然的话告诉用户画了什么，像 `pet_say` 那样说话。不要把路径、编号、`blobs`、JSON 念出来，也不要贴 Markdown 图片语法。\n5. **发到别处要另走一步。** 图默认只在你自己的界面里。\n   - 想让主人在控制台的「对话」页看到它，画完之后再调 `pet_show_image`：`path` 填 `image_draw` 回执里的绝对路径，`caption` 可选（一句配文）。它只贴图、不出声，也不会引发语音。\n   - 要发到 QQ 会话，画完之后再调 `qq_send_image`，`image` 参数填 `image_draw` 回执里那个绝对路径。\n6. **失败就停。** 如果回执说没配密钥、接口报错、超时，不要换个说法反复重试。把情况告诉用户，让他去控制台「图片工坊 → 状态」里填密钥或改接口地址。\n7. **别凭空说画好了。** 只有工具回执真的带着图回来，才算画好了。\n"
+      "content": "你可以作画。这一节说明工具箱和规矩。\n\n## 四个工具\n\n- `image_draw`：按一段文字描述画一张新图。图会存到磁盘、附加进本次对话（你自己看得到）、并显示在控制台「图片工坊 → 作品」页。\n- `image_edit`：拿一张已有的图按指令改（换风格、改细节）。`image` 给绝对路径，或 `image_gallery` 里的编号。`size` 一般不传（本地 ComfyUI 那档会照参考图的比例出图）；要固定尺寸就写 `宽x高`。服务端支不支持改图由接口决定，报错就照实告诉用户。\n- `image_gallery`：列出画过的图，最新的在前，带编号和绝对路径。编号可以交给 `image_show` 或 `image_edit`。\n- `image_show`：把一张旧图重新放回眼前（重新附加进对话，并在作品页高亮）。\n\n图片保存目录：`{{image.dir | 尚未确定；先看控制台「图片工坊 → 状态」。}}`\n\n当前接口状态：`{{image.ready | 未知。不确定就别调用，先告诉用户去控制台「图片工坊 → 状态」看看。}}`\n\n## 模型链\n\n后台可能配了一串模型（「图片工坊 → 状态 → 模型链」），本地 ComfyUI 和云端接口都在里面，按顺序试：\n前一档连不上、超时、额度用完、模型没装，就自动换下一档；回执里会写「前几档没成」和最后用的是哪一档。\n\n## 规矩\n\n1. **别每轮都画。** 用户明确想看/想让你画，或者确实需要一张图来解释、来送人，才调用。闲聊、讨论、解释概念都不需要配图。\n2. **一次画一张。** 想要不同方向就画一张、看一眼、再决定要不要重画或改。不要一次调好几个 `image_draw` 碰运气。\n3. **描述要具体。** 主体、画风、构图、光线、色调、背景，一句到位；别只给两三个词，也别把整段聊天记录塞进去。\n4. **说人话，不念路径。** 回执里的绝对路径是给工具用的，不是给用户看的。画完就用一句自然的话告诉用户画了什么，像 `pet_say` 那样说话。不要把路径、编号、`blobs`、JSON 念出来，也不要贴 Markdown 图片语法。\n5. **发到别处要另走一步。** 图默认只在你自己的界面里。\n   - 想让主人在控制台的「对话」页看到它，画完之后调桌宠的 `pet_say`，`images` 填回执里 `[blob …]` 行的句柄（就是 `[blob ` 后面那一串），`script` 给空串就只贴图不出声；想配一句话就写进 `script`（那句话会在气泡里说出来）。图只进「对话」页，不进气泡。\n   - 要发到 QQ 会话：把回执里 `[blob …]` 行的句柄交给 QQ 世界的发图工具。官方 QQ 扩展用 `qq_draft`（`image` 填句柄，`to` 填 `group:<群号>` 或 `private:<QQ号>`，再用 `qq_confirm` 确认发送）；旧版 QQ 扩展（`qqbot`）用 `qq_send_image`，`image` 填回执里的绝对路径。\n6. **失败就停。** 如果回执说没配密钥、接口报错、超时，不要换个说法反复重试。把情况告诉用户，让他去控制台「图片工坊 → 状态」里填密钥或改接口地址。\n7. **别凭空说画好了。** 只有工具回执真的带着图回来，才算画好了。\n"
     }
   ]
 }