dsh-plugin-image-workbench 1.1.5 → 1.1.7

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 guohwa
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 guohwa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -79,8 +79,10 @@ Open "Plugins -> Add Plugin" and use any one of these:
 | Method | Enter | Notes |
 | --- | --- | --- |
 | npm package (preferred) | `dsh-plugin-image-workbench` | Served from a CDN, fast and interruption-free; the plugin manager probes npmjs and npmmirror in parallel and takes whichever answers first |
-| Gitee mirror | `https://gitee.com/guohwa/dsh-plugin-image-workbench` | Reachable directly from mainland China, shallow clone takes about 9 seconds |
-| GitHub upstream | `https://github.com/guohwa/dsh-plugin-image-workbench` | Source of truth; cloning often stalls on the 31 MB uv runtime |
+| Gitee mirror | `https://gitee.com/guohwa/dsh-plugin-image-workbench.git` | Reachable directly from mainland China, shallow clone takes about 9 seconds |
+| GitHub upstream | `https://github.com/guohwa/dsh-plugin-image-workbench.git` | Source of truth; cloning often stalls on the 31 MB uv runtime |
+
+> Git URLs **must end with `.git`**. The plugin manager installs through pnpm; without the suffix pnpm treats the URL as a tarball link, fetches the HTML page and fails with `ERR_PNPM_FETCH_403` plus "No authorization header was set" — that is about URL form, not permissions.
 
 All three carry the same content: every push and tag on GitHub is mirrored to Gitee, and tags also trigger an npm release. The plugin ships a roughly 31 MB uv runtime, which is exactly the part that stalls or times out when cloning from GitHub — so prefer the package name or the Gitee URL in mainland China.
 
@@ -209,7 +211,7 @@ Principal backend routes are listed below. The complete definitions are in `serv
 | Symptom | Resolution |
 | --- | --- |
 | No sidebar entry | Bundles load only at DSH startup; quit DSH completely and start it again |
-| Plugin manager reports a GitHub connection timeout | Switch to the Gitee URL `https://gitee.com/guohwa/dsh-plugin-image-workbench`, reachable directly from mainland China |
+| Plugin manager reports a GitHub connection timeout | Switch to the Gitee URL `https://gitee.com/guohwa/dsh-plugin-image-workbench.git` (**with `.git`**), reachable directly from mainland China |
 | Install fails with `ERR_PNPM_EPERM ... rename '...dsh-plugin-image-workbench_tmp_...'` | The previous version is still running and the backend process holds the plugin directory, so Windows refuses the rename. Quit DSH completely (tray menu -> Quit), end any leftover `python.exe` in Task Manager, delete `node_modules\dsh-plugin-image-workbench`, then install again. From 1.1.4 on, installs under `node_modules` relocate their runtime to `~/.dsh/image-workbench`, so this no longer happens |
 | Code stops taking effect after moving the installation directory | Re-run `node install.mjs`; the directory junction is rebuilt to the current path |
 | "Built-in pool not ready" | Start the pool under "Endpoint & Pool -> Local Pool"; allow time for first-run environment initialization |

package/README.md

@@ -78,8 +78,10 @@ flowchart LR
 | 方式 | 填什么 | 说明 |
 | --- | --- | --- |
 | npm 包名（首选） | `dsh-plugin-image-workbench` | 走 CDN，装得快且不会中途断；插件管理器会同时探测 npmjs 与 npmmirror，取先响应的那个 |
-| Gitee 镜像 | `https://gitee.com/guohwa/dsh-plugin-image-workbench` | 国内直连，浅克隆实测 9 秒左右 |
-| GitHub 原仓库 | `https://github.com/guohwa/dsh-plugin-image-workbench` | 内容源头，国内常卡在 31 MB 的 uv 运行时传输上 |
+| Gitee 镜像 | `https://gitee.com/guohwa/dsh-plugin-image-workbench.git` | 国内直连，浅克隆实测 9 秒左右 |
+| GitHub 原仓库 | `https://github.com/guohwa/dsh-plugin-image-workbench.git` | 内容源头，国内常卡在 31 MB 的 uv 运行时传输上 |
+
+> 填 Git 地址时**结尾必须带 `.git`**。插件管理器调用 pnpm，不带后缀时 pnpm 会把它当作 tarball 链接去抓页面，报 `ERR_PNPM_FETCH_403` 并附一句「No authorization header was set」——那跟权限无关，只是地址形式不对。
 
 三处是同源内容：GitHub 上每次 push 和打 tag 会自动镜像到 Gitee，npm 也由 tag 触发发布。插件里带一个约 31 MB 的 uv 运行时，这正是从 GitHub 克隆时最容易超时的那一块，所以国内优先用包名或 Gitee 地址。
 
@@ -113,6 +115,8 @@ node install.mjs
 
 首次启动会自动准备后端与账号池的运行环境，通常 1 分钟内完成，无需手动操作；环境就绪后账号池会自动拉起，也可在「接口与号池 → 本地号池」手动启动。
 
+首次启动还会在后台补齐风格、版式与配色的预览样图（共 574 张，约 33 MB，从 CDN 拉取，失败自动换源）。下载完成前，风格库与配色库里显示的是渐变占位块，刷新页面即可看到真图；进度写在 `~/.dsh/image-workbench/samples.log`。样图不进 npm 包，也不参与升级同步，所以只在第一次装好后下一遍。
+
 插件以 `node_modules` 形式安装时，后端代码会同步到 `~/.dsh/image-workbench/server`，号池源码快照同步到同级的 `vendor/`，Python 环境、生成图片、账号与历史数据都留在这个目录里。插件包本身保持只读，升级插件不会冲掉环境和图片。用 `link:` 指向源码目录（开发场景）时不复制，直接用源码目录。
 
 ## 接口接入与账号管理
@@ -209,7 +213,7 @@ python -m venv .venv
 | 现象 | 处理方式 |
 | --- | --- |
 | 侧栏未出现入口 | bundle 仅在 DSH 启动时加载，完全退出 DSH 再启动 |
-| 插件管理器提示连接 GitHub 超时 | 换成 Gitee 地址 `https://gitee.com/guohwa/dsh-plugin-image-workbench`，国内直连 |
+| 插件管理器提示连接 GitHub 超时 | 换成 Gitee 地址 `https://gitee.com/guohwa/dsh-plugin-image-workbench.git`（**带 `.git`**），国内直连 |
 | 安装报 `ERR_PNPM_EPERM ... rename '...dsh-plugin-image-workbench_tmp_...'` | 上一个版本还在运行，后端进程把插件目录锁住了，Windows 不允许重命名。完全退出 DSH（托盘菜单 → 退出），在任务管理器结束残留的 `python.exe`，删掉 `node_modules\dsh-plugin-image-workbench` 后重装。1.1.4 起装在 `node_modules` 里时运行时会自动搬到 `~/.dsh/image-workbench`，不再出现 |
 | 移动过插件目录后代码不再生效 | 重跑 `node install.mjs`，安装器会把目录联接重建到当前路径 |
 | 提示「工作台后端未运行」 | 面板会直接显示原因：多为本机没有 Python 3.10+ 且自动下载失败。装一个 Python 3.13 后点「立即启动并重试」；有代理时插件会自动识别并使用 |

package/client.js

@@ -1,241 +1,241 @@
-/**
- * DSH Client 插件：把 127.0.0.1:8092 的生图工作台嵌进侧栏面板。
- * 页面本体是 image-local/static/index.html，浏览器直连与插件内看到的是同一个工作台。
- * 号池是工作台自带的进程，所以侧栏只注册这一个面板，不再有独立号池入口。
- */
-window.__ModuleLoader__.load({
-  id: 'dsh-plugin-image-workbench',
-  factory(require) {
-    const { createElement: h, useState, useEffect, useCallback } = require('react');
-    const PANEL = 'image-workbench';
-    const STATUS_API = '/api/image-workbench.status';
-    const CSS = `
-.iw-root{display:flex;flex-direction:column;height:100%;min-height:0;width:100%;background:#e7eaee;color:#1c1e21;font:14px/1.5 "PingFang SC","Microsoft YaHei",system-ui,sans-serif;box-sizing:border-box}
-.iw-root *{box-sizing:border-box}
-.iw-bar{display:flex;align-items:center;justify-content:flex-start;gap:12px;flex:none;padding:10px 18px;background:#fff;border-bottom:1px solid #dee3e9;flex-wrap:wrap}
-.iw-title{display:flex;align-items:center;gap:10px;font-size:14px;font-weight:600;color:#0a1317;flex-wrap:wrap}
-.iw-title small{font-weight:400;color:#8595a4;font-size:12px}
-.iw-actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-left:auto}
-.iw-btn{border:1px solid #d7dde5;background:#fff;color:#1c1e21;border-radius:7px;padding:5px 11px;font-size:12px;cursor:pointer;text-decoration:none;font-family:inherit;line-height:1.5}
-.iw-btn:hover{border-color:#0064e0;color:#0064e0}
-.iw-btn.primary{background:#0064e0;border-color:#0064e0;color:#fff}
-.iw-btn.primary:hover{background:#0053bb;color:#fff}
-.iw-btn:disabled{opacity:.5;cursor:default}
-.iw-chip{display:inline-flex;align-items:center;gap:6px;border-radius:99px;padding:3px 10px;font-size:11px;background:#eef1f5;color:#5d6c7b}
-.iw-chip.on{background:#e6f6ec;color:#1d7a3c}
-.iw-chip.off{background:#fff0ed;color:#b3402f}
-.iw-chip.warn{background:#fff5e2;color:#9a6700}
-.iw-dot{width:7px;height:7px;border-radius:50%;background:currentColor}
-.iw-frame{flex:1;min-height:0;width:100%;border:0;background:#e7eaee;display:block}
-.iw-empty{flex:1;min-height:0;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:12px;padding:32px;text-align:center;color:#5d6c7b}
-.iw-empty h2{margin:0;font-size:18px;color:#1c1e21}
-.iw-empty p{margin:0;max-width:560px;font-size:13px;line-height:1.8}
-.iw-empty code{background:#dfe4ea;padding:2px 6px;border-radius:4px;font-size:12px}
-.iw-error{margin:8px 18px 0;padding:9px 12px;border-radius:7px;background:#fff3ef;border:1px solid #f3cfc4;color:#a13c28;font-size:12px;flex:none}
-.iw-empty .iw-why{margin:0;max-width:560px;padding:9px 12px;border-radius:7px;background:#fff3ef;
-  border:1px solid #f3cfc4;color:#a13c28;font-size:12.5px;line-height:1.7;text-align:left}
-.iw-empty .iw-why .iw-tail{margin:6px 0 0;padding:8px;max-height:150px;overflow:auto;background:#fff;
-  border:1px solid #f0d8d1;border-radius:5px;color:#6b3a30;font-size:11.5px;line-height:1.55;
-  white-space:pre-wrap;word-break:break-all;font-family:ui-monospace,Consolas,monospace}
-.iw-note{flex:0 1 auto;min-width:0;max-width:min(420px,38vw);padding:4px 10px;border-radius:7px;
-  font-size:12px;line-height:1.55;background:#eef4ff;border:1px solid #cddffb;color:#1b4d8f;
-  white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
-.iw-note.bad{background:#fff3ef;border-color:#f3cfc4;color:#a13c28}
-/* 窄一点先把次要的自述说明收起来，优先保证提示条和按钮不换行 */
-@media(max-width:1180px){.iw-title small{display:none}}
-@media(max-width:820px){.iw-bar{padding:8px 12px}}
-`;
-
-    function Button(label, onClick, opts = {}) {
-      return h('button', { type: 'button', className: 'iw-btn' + (opts.primary ? ' primary' : ''), onClick, disabled: !!opts.disabled, ...(opts.extra || {}) }, label);
-    }
-
-    function Workbench() {
-      const [status, setStatus] = useState(null);
-      const [error, setError] = useState('');
-      const [notice, setNotice] = useState(null);
-      const [busy, setBusy] = useState('');
-      const [nonce, setNonce] = useState(0);
-
-      const call = useCallback(async (action) => {
-        setBusy(action || '刷新');
-        setError('');
-        try {
-          const response = action
-            ? await fetch(STATUS_API, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ action }) })
-            : await fetch(STATUS_API, { cache: 'no-store' });
-          if (!response.ok) throw new Error('宿主接口返回 HTTP ' + response.status);
-          const data = await response.json();
-          setStatus(data);
-          if (data.running && action === 'start') setNonce(n => n + 1);
-          if (!data.running && action === 'start') setError('后端仍未就绪，可查看日志：' + (data.log || '~/.dsh/image-workbench/backend.log'));
-
-          // 每个动作都要能看见结果：以前点了像没反应，就是因为什么都不回显
-          // 文案压短，完整信息放 hint（渲染成 title），否则窄一点就把按钮挤到第二行
-          if (action === 'open') {
-            const done = data.lastAction || {};
-            setNotice(done.ok
-              ? { ok: true, text: '已用系统浏览器打开', hint: '已在系统默认浏览器打开 ' + (data.url || '') }
-              : { ok: false, text: '打开浏览器失败', hint: '原因：' + (done.error || '未知') + '。也可以手动访问 ' + (data.url || '') });
-          } else if (action === 'refresh') {
-            setNotice(data.running
-              ? { ok: true, text: '后端正常 · 端口 ' + (data.port || 8092), hint: '已检查：工作台后端在跑，端口正常响应' }
-              : { ok: false, text: '端口 ' + (data.port || 8092) + ' 无响应', hint: '已检查：后端没在跑，点「启动后端」' });
-          }
-        } catch (e) {
-          setError(e.message || '状态查询失败');
-        } finally {
-          setBusy('');
-        }
-      }, []);
-
-      // 提示条自动消失，避免一直占着页面顶部
-      useEffect(() => {
-        if (!notice) return undefined;
-        const timer = setTimeout(() => setNotice(null), notice.ok ? 6000 : 10000);
-        return () => clearTimeout(timer);
-      }, [notice]);
-
-      const copyUrl = useCallback(async () => {
-        const url = status?.url || 'http://127.0.0.1:8092/';
-        try {
-          await navigator.clipboard.writeText(url);
-          setNotice({ ok: true, text: '地址已复制', hint: '已复制到剪贴板，可直接粘到浏览器打开：' + url });
-        } catch {
-          setNotice({ ok: false, text: '复制失败', hint: '复制被环境拦下了，手动复制这个地址：' + url });
-        }
-      }, [status]);
-
-      // 不做定时轮询：iframe 一旦重载，正在编辑的工程会被打断。
-      useEffect(() => { call(); }, [call]);
-
-      // 后端没起来时（首次装环境、刚被拉起）轻量轮询，起来就自动切成 iframe。
-      // 只在没有 iframe 的时候轮询，所以不会打断正在编辑的内容；最多盯 2 分钟。
-      useEffect(() => {
-        if (Boolean(status?.running)) return undefined;
-        let tick = 0;
-        const timer = setInterval(() => {
-          tick += 1;
-          if (tick > 40) { clearInterval(timer); return; }
-          void call();
-        }, 3000);
-        return () => clearInterval(timer);
-      }, [status?.running, call]);
-
-      // 后端起不来时，把真实原因复制出来，不用让用户去翻日志文件
-      const copyDiag = useCallback(async () => {
-        const d = {
-          time: new Date().toISOString(),
-          running: status?.running, port: status?.port,
-          serverDir: status?.serverDir, python: status?.python,
-          venv: status?.venv, lastError: status?.lastError,
-          watchdog: status?.watchdog, log: status?.log,
-        };
-        try {
-          await navigator.clipboard.writeText(JSON.stringify(d, null, 2));
-          setNotice({ ok: true, text: '诊断信息已复制', hint: '已复制到剪贴板，可直接发给作者' });
-        } catch {
-          setNotice({ ok: false, text: '复制失败', hint: JSON.stringify(d) });
-        }
-      }, [status]);
-
-      const running = Boolean(status?.running);
-      const appUrl = status?.url || 'http://127.0.0.1:8092/';
-      const guard = status?.watchdog;
-      const guardText = !status ? '检查中'
-        : !guard ? '守护未加载 · 需重启 DSH'
-          : !guard.enabled ? '守护已关闭'
-            : '守护已开' + (guard.restarts ? ' · 已自动拉起 ' + guard.restarts + ' 次' : '')
-              + (guard.consecutiveFailures ? ' · 拉起失败 ' + guard.consecutiveFailures + ' 次' : '');
-      const guardClass = !status ? '' : !guard ? 'warn' : guard.enabled && !guard.consecutiveFailures ? 'on' : 'off';
-      // 号池是工作台自带的第二个进程，状态由后端上报；不再有独立号池插件
-      const bp = status?.pool;
-      const poolText = !status ? '' : !bp ? '内置号池读取中'
-        : bp.online ? `内置号池 ${bp.active}/${bp.total} · 剩 ${bp.quota} 次`
-          : '内置号池未就绪';
-      const poolClass = !bp ? 'warn' : bp.online ? 'on' : 'off';
-
-      return h('div', { className: 'iw-root' },
-        h('style', null, CSS),
-        h('header', { className: 'iw-bar' },
-          h('div', { className: 'iw-title' },
-            'Bluxe手绘工坊 · 生图工作台',
-            h('small', null, '号池运行时随插件自带 · 可独立运行'),
-            h('span', { className: 'iw-chip ' + guardClass, title: '后端端口掉线时由 DSH 宿主自动拉起；修改插件后需重启 DSH 才会加载新代码' },
-              h('span', { className: 'iw-dot' }), guardText),
-            h('span', { className: 'iw-chip ' + poolClass, title: '号池服务端代码与 uv 随插件自带，全新机器首次启动自动初始化虚拟环境；由工作台后端自己启动与守护，不需要任何第三方号池插件' },
-              h('span', { className: 'iw-dot' }), poolText)),
-          // 提示放在标题右侧、按钮左侧这条空档里，不额外占一行高度
-          notice && h('div', { className: 'iw-note' + (notice.ok ? '' : ' bad'), role: 'status', title: notice.hint || notice.text }, notice.text),
-          h('div', { className: 'iw-actions' },
-            Button(busy === 'refresh' ? '检查中…' : '刷新状态', () => call('refresh'), { disabled: !!busy }),
-            // 只有在没跑的时候才给「启动后端」，跑着的时候这个按钮点了也没意义
-            !running && Button(busy === 'start' ? '启动中…' : '启动后端', () => call('start'), { disabled: !!busy, primary: true }),
-            Button(busy === 'open' ? '正在打开…' : '用系统浏览器打开', () => call('open'), { disabled: !!busy }),
-            // 原来的「新窗口打开」是 <a target="_blank">，DSH 里既开不了新窗口又会静默失败，换成复制地址
-            Button('复制地址', copyUrl))),
-        error && h('div', { className: 'iw-error', role: 'alert' }, error),
-        running
-          ? h('iframe', {
-              key: 'frame-' + nonce,
-              className: 'iw-frame',
-              src: appUrl + (appUrl.includes('?') ? '&' : '?') + 'dsh=' + nonce,
-              title: '生图工作台（图文 / 摄影）',
-              allow: 'clipboard-read; clipboard-write; fullscreen',
-            })
-          : h('div', { className: 'iw-empty' },
-              h('h2', null, status ? '工作台后端未运行' : '正在连接工作台'),
-              h('p', null,
-                '插件会自动拉起本机 image-local 工作台（uvicorn，端口 ',
-                h('code', null, String(status?.port || 8092)),
-                '）。若这里一直是空白，请确认 DSH 已重启加载插件，或点「用系统浏览器打开」直接访问。'),
-              status?.serverDir && h('p', null, '后端目录：', h('code', null, status.serverDir)),
-              // 初始化中 / 失败原因：以前这里只说「未运行」，用户完全看不出卡在哪一步
-              !status ? null
-                : (status.venv?.message || status.lastError)
-                  ? h('div', { className: 'iw-why' },
-                      h('div', null, '原因：' + (status.venv?.message || status.lastError)),
-                      status.backendTail
-                        ? h('pre', { className: 'iw-tail' }, status.backendTail)
-                        : null)
-                  : (status.venv?.tried && !status.venv?.ready)
-                    ? h('p', null, '正在初始化运行环境（首次启动约 1 分钟），装好后这里会自动刷新。')
-                    : null,
-              h('div', { style: { display: 'flex', gap: '8px', flexWrap: 'wrap' } },
-                Button(busy ? '正在处理' : '立即启动并重试', () => call('start'), { primary: true, disabled: !!busy }),
-                Button('复制诊断信息', copyDiag),
-                status?.venv?.log && h('span', {
-                  style: { fontSize: '12px', color: '#6b7280', alignSelf: 'center' },
-                  title: status.venv.log,
-                }, '日志：' + status.venv.log)),
-            ),
-      );
-    }
-
-    function HeaderIcon({ size = 20 }) {
-      return h('svg', { width: size, height: size, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 1.7, 'aria-hidden': true },
-        h('rect', { x: 3, y: 3, width: 18, height: 18, rx: 2 }),
-        h('circle', { cx: 9, cy: 9, r: 2.2 }),
-        h('path', { d: 'M21 15l-5-5L5 21' }));
-    }
-
-    function apply(ctx) {
-      const slots = ctx?.slots;
-      if (!slots?.inject) return;
-      const register = () => {
-        const disposers = [];
-        disposers.push(slots.inject('sidebar.panellist', () => slots.register(
-          { name: 'sidebar.panellist', id: PANEL, order: 73, label: () => 'Bluxe手绘工坊 · 生图工作台' },
-          HeaderIcon)));
-        disposers.push(slots.inject('main', () => slots.register(
-          { name: 'main', key: PANEL },
-          Workbench)));
-        return () => { for (const fn of disposers.reverse()) if (typeof fn === 'function') fn(); };
-      };
-      if (typeof ctx.effect === 'function') ctx.effect(register, 'image-workbench: panel registrations');
-      else register();
-    }
-
-    return { name: PANEL, inject: ['slots'], apply };
-  },
-});
+/**
+ * DSH Client 插件：把 127.0.0.1:8092 的生图工作台嵌进侧栏面板。
+ * 页面本体是 image-local/static/index.html，浏览器直连与插件内看到的是同一个工作台。
+ * 号池是工作台自带的进程，所以侧栏只注册这一个面板，不再有独立号池入口。
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-plugin-image-workbench',
+  factory(require) {
+    const { createElement: h, useState, useEffect, useCallback } = require('react');
+    const PANEL = 'image-workbench';
+    const STATUS_API = '/api/image-workbench.status';
+    const CSS = `
+.iw-root{display:flex;flex-direction:column;height:100%;min-height:0;width:100%;background:#e7eaee;color:#1c1e21;font:14px/1.5 "PingFang SC","Microsoft YaHei",system-ui,sans-serif;box-sizing:border-box}
+.iw-root *{box-sizing:border-box}
+.iw-bar{display:flex;align-items:center;justify-content:flex-start;gap:12px;flex:none;padding:10px 18px;background:#fff;border-bottom:1px solid #dee3e9;flex-wrap:wrap}
+.iw-title{display:flex;align-items:center;gap:10px;font-size:14px;font-weight:600;color:#0a1317;flex-wrap:wrap}
+.iw-title small{font-weight:400;color:#8595a4;font-size:12px}
+.iw-actions{display:flex;align-items:center;gap:8px;flex-wrap:wrap;margin-left:auto}
+.iw-btn{border:1px solid #d7dde5;background:#fff;color:#1c1e21;border-radius:7px;padding:5px 11px;font-size:12px;cursor:pointer;text-decoration:none;font-family:inherit;line-height:1.5}
+.iw-btn:hover{border-color:#0064e0;color:#0064e0}
+.iw-btn.primary{background:#0064e0;border-color:#0064e0;color:#fff}
+.iw-btn.primary:hover{background:#0053bb;color:#fff}
+.iw-btn:disabled{opacity:.5;cursor:default}
+.iw-chip{display:inline-flex;align-items:center;gap:6px;border-radius:99px;padding:3px 10px;font-size:11px;background:#eef1f5;color:#5d6c7b}
+.iw-chip.on{background:#e6f6ec;color:#1d7a3c}
+.iw-chip.off{background:#fff0ed;color:#b3402f}
+.iw-chip.warn{background:#fff5e2;color:#9a6700}
+.iw-dot{width:7px;height:7px;border-radius:50%;background:currentColor}
+.iw-frame{flex:1;min-height:0;width:100%;border:0;background:#e7eaee;display:block}
+.iw-empty{flex:1;min-height:0;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:12px;padding:32px;text-align:center;color:#5d6c7b}
+.iw-empty h2{margin:0;font-size:18px;color:#1c1e21}
+.iw-empty p{margin:0;max-width:560px;font-size:13px;line-height:1.8}
+.iw-empty code{background:#dfe4ea;padding:2px 6px;border-radius:4px;font-size:12px}
+.iw-error{margin:8px 18px 0;padding:9px 12px;border-radius:7px;background:#fff3ef;border:1px solid #f3cfc4;color:#a13c28;font-size:12px;flex:none}
+.iw-empty .iw-why{margin:0;max-width:560px;padding:9px 12px;border-radius:7px;background:#fff3ef;
+  border:1px solid #f3cfc4;color:#a13c28;font-size:12.5px;line-height:1.7;text-align:left}
+.iw-empty .iw-why .iw-tail{margin:6px 0 0;padding:8px;max-height:150px;overflow:auto;background:#fff;
+  border:1px solid #f0d8d1;border-radius:5px;color:#6b3a30;font-size:11.5px;line-height:1.55;
+  white-space:pre-wrap;word-break:break-all;font-family:ui-monospace,Consolas,monospace}
+.iw-note{flex:0 1 auto;min-width:0;max-width:min(420px,38vw);padding:4px 10px;border-radius:7px;
+  font-size:12px;line-height:1.55;background:#eef4ff;border:1px solid #cddffb;color:#1b4d8f;
+  white-space:nowrap;overflow:hidden;text-overflow:ellipsis}
+.iw-note.bad{background:#fff3ef;border-color:#f3cfc4;color:#a13c28}
+/* 窄一点先把次要的自述说明收起来，优先保证提示条和按钮不换行 */
+@media(max-width:1180px){.iw-title small{display:none}}
+@media(max-width:820px){.iw-bar{padding:8px 12px}}
+`;
+
+    function Button(label, onClick, opts = {}) {
+      return h('button', { type: 'button', className: 'iw-btn' + (opts.primary ? ' primary' : ''), onClick, disabled: !!opts.disabled, ...(opts.extra || {}) }, label);
+    }
+
+    function Workbench() {
+      const [status, setStatus] = useState(null);
+      const [error, setError] = useState('');
+      const [notice, setNotice] = useState(null);
+      const [busy, setBusy] = useState('');
+      const [nonce, setNonce] = useState(0);
+
+      const call = useCallback(async (action) => {
+        setBusy(action || '刷新');
+        setError('');
+        try {
+          const response = action
+            ? await fetch(STATUS_API, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ action }) })
+            : await fetch(STATUS_API, { cache: 'no-store' });
+          if (!response.ok) throw new Error('宿主接口返回 HTTP ' + response.status);
+          const data = await response.json();
+          setStatus(data);
+          if (data.running && action === 'start') setNonce(n => n + 1);
+          if (!data.running && action === 'start') setError('后端仍未就绪，可查看日志：' + (data.log || '~/.dsh/image-workbench/backend.log'));
+
+          // 每个动作都要能看见结果：以前点了像没反应，就是因为什么都不回显
+          // 文案压短，完整信息放 hint（渲染成 title），否则窄一点就把按钮挤到第二行
+          if (action === 'open') {
+            const done = data.lastAction || {};
+            setNotice(done.ok
+              ? { ok: true, text: '已用系统浏览器打开', hint: '已在系统默认浏览器打开 ' + (data.url || '') }
+              : { ok: false, text: '打开浏览器失败', hint: '原因：' + (done.error || '未知') + '。也可以手动访问 ' + (data.url || '') });
+          } else if (action === 'refresh') {
+            setNotice(data.running
+              ? { ok: true, text: '后端正常 · 端口 ' + (data.port || 8092), hint: '已检查：工作台后端在跑，端口正常响应' }
+              : { ok: false, text: '端口 ' + (data.port || 8092) + ' 无响应', hint: '已检查：后端没在跑，点「启动后端」' });
+          }
+        } catch (e) {
+          setError(e.message || '状态查询失败');
+        } finally {
+          setBusy('');
+        }
+      }, []);
+
+      // 提示条自动消失，避免一直占着页面顶部
+      useEffect(() => {
+        if (!notice) return undefined;
+        const timer = setTimeout(() => setNotice(null), notice.ok ? 6000 : 10000);
+        return () => clearTimeout(timer);
+      }, [notice]);
+
+      const copyUrl = useCallback(async () => {
+        const url = status?.url || 'http://127.0.0.1:8092/';
+        try {
+          await navigator.clipboard.writeText(url);
+          setNotice({ ok: true, text: '地址已复制', hint: '已复制到剪贴板，可直接粘到浏览器打开：' + url });
+        } catch {
+          setNotice({ ok: false, text: '复制失败', hint: '复制被环境拦下了，手动复制这个地址：' + url });
+        }
+      }, [status]);
+
+      // 不做定时轮询：iframe 一旦重载，正在编辑的工程会被打断。
+      useEffect(() => { call(); }, [call]);
+
+      // 后端没起来时（首次装环境、刚被拉起）轻量轮询，起来就自动切成 iframe。
+      // 只在没有 iframe 的时候轮询，所以不会打断正在编辑的内容；最多盯 2 分钟。
+      useEffect(() => {
+        if (Boolean(status?.running)) return undefined;
+        let tick = 0;
+        const timer = setInterval(() => {
+          tick += 1;
+          if (tick > 40) { clearInterval(timer); return; }
+          void call();
+        }, 3000);
+        return () => clearInterval(timer);
+      }, [status?.running, call]);
+
+      // 后端起不来时，把真实原因复制出来，不用让用户去翻日志文件
+      const copyDiag = useCallback(async () => {
+        const d = {
+          time: new Date().toISOString(),
+          running: status?.running, port: status?.port,
+          serverDir: status?.serverDir, python: status?.python,
+          venv: status?.venv, lastError: status?.lastError,
+          watchdog: status?.watchdog, log: status?.log,
+        };
+        try {
+          await navigator.clipboard.writeText(JSON.stringify(d, null, 2));
+          setNotice({ ok: true, text: '诊断信息已复制', hint: '已复制到剪贴板，可直接发给作者' });
+        } catch {
+          setNotice({ ok: false, text: '复制失败', hint: JSON.stringify(d) });
+        }
+      }, [status]);
+
+      const running = Boolean(status?.running);
+      const appUrl = status?.url || 'http://127.0.0.1:8092/';
+      const guard = status?.watchdog;
+      const guardText = !status ? '检查中'
+        : !guard ? '守护未加载 · 需重启 DSH'
+          : !guard.enabled ? '守护已关闭'
+            : '守护已开' + (guard.restarts ? ' · 已自动拉起 ' + guard.restarts + ' 次' : '')
+              + (guard.consecutiveFailures ? ' · 拉起失败 ' + guard.consecutiveFailures + ' 次' : '');
+      const guardClass = !status ? '' : !guard ? 'warn' : guard.enabled && !guard.consecutiveFailures ? 'on' : 'off';
+      // 号池是工作台自带的第二个进程，状态由后端上报；不再有独立号池插件
+      const bp = status?.pool;
+      const poolText = !status ? '' : !bp ? '内置号池读取中'
+        : bp.online ? `内置号池 ${bp.active}/${bp.total} · 剩 ${bp.quota} 次`
+          : '内置号池未就绪';
+      const poolClass = !bp ? 'warn' : bp.online ? 'on' : 'off';
+
+      return h('div', { className: 'iw-root' },
+        h('style', null, CSS),
+        h('header', { className: 'iw-bar' },
+          h('div', { className: 'iw-title' },
+            'Bluxe手绘工坊 · 生图工作台',
+            h('small', null, '号池运行时随插件自带 · 可独立运行'),
+            h('span', { className: 'iw-chip ' + guardClass, title: '后端端口掉线时由 DSH 宿主自动拉起；修改插件后需重启 DSH 才会加载新代码' },
+              h('span', { className: 'iw-dot' }), guardText),
+            h('span', { className: 'iw-chip ' + poolClass, title: '号池服务端代码与 uv 随插件自带，全新机器首次启动自动初始化虚拟环境；由工作台后端自己启动与守护，不需要任何第三方号池插件' },
+              h('span', { className: 'iw-dot' }), poolText)),
+          // 提示放在标题右侧、按钮左侧这条空档里，不额外占一行高度
+          notice && h('div', { className: 'iw-note' + (notice.ok ? '' : ' bad'), role: 'status', title: notice.hint || notice.text }, notice.text),
+          h('div', { className: 'iw-actions' },
+            Button(busy === 'refresh' ? '检查中…' : '刷新状态', () => call('refresh'), { disabled: !!busy }),
+            // 只有在没跑的时候才给「启动后端」，跑着的时候这个按钮点了也没意义
+            !running && Button(busy === 'start' ? '启动中…' : '启动后端', () => call('start'), { disabled: !!busy, primary: true }),
+            Button(busy === 'open' ? '正在打开…' : '用系统浏览器打开', () => call('open'), { disabled: !!busy }),
+            // 原来的「新窗口打开」是 <a target="_blank">，DSH 里既开不了新窗口又会静默失败，换成复制地址
+            Button('复制地址', copyUrl))),
+        error && h('div', { className: 'iw-error', role: 'alert' }, error),
+        running
+          ? h('iframe', {
+              key: 'frame-' + nonce,
+              className: 'iw-frame',
+              src: appUrl + (appUrl.includes('?') ? '&' : '?') + 'dsh=' + nonce,
+              title: '生图工作台（图文 / 摄影）',
+              allow: 'clipboard-read; clipboard-write; fullscreen',
+            })
+          : h('div', { className: 'iw-empty' },
+              h('h2', null, status ? '工作台后端未运行' : '正在连接工作台'),
+              h('p', null,
+                '插件会自动拉起本机 image-local 工作台（uvicorn，端口 ',
+                h('code', null, String(status?.port || 8092)),
+                '）。若这里一直是空白，请确认 DSH 已重启加载插件，或点「用系统浏览器打开」直接访问。'),
+              status?.serverDir && h('p', null, '后端目录：', h('code', null, status.serverDir)),
+              // 初始化中 / 失败原因：以前这里只说「未运行」，用户完全看不出卡在哪一步
+              !status ? null
+                : (status.venv?.message || status.lastError)
+                  ? h('div', { className: 'iw-why' },
+                      h('div', null, '原因：' + (status.venv?.message || status.lastError)),
+                      status.backendTail
+                        ? h('pre', { className: 'iw-tail' }, status.backendTail)
+                        : null)
+                  : (status.venv?.tried && !status.venv?.ready)
+                    ? h('p', null, '正在初始化运行环境（首次启动约 1 分钟），装好后这里会自动刷新。')
+                    : null,
+              h('div', { style: { display: 'flex', gap: '8px', flexWrap: 'wrap' } },
+                Button(busy ? '正在处理' : '立即启动并重试', () => call('start'), { primary: true, disabled: !!busy }),
+                Button('复制诊断信息', copyDiag),
+                status?.venv?.log && h('span', {
+                  style: { fontSize: '12px', color: '#6b7280', alignSelf: 'center' },
+                  title: status.venv.log,
+                }, '日志：' + status.venv.log)),
+            ),
+      );
+    }
+
+    function HeaderIcon({ size = 20 }) {
+      return h('svg', { width: size, height: size, viewBox: '0 0 24 24', fill: 'none', stroke: 'currentColor', strokeWidth: 1.7, 'aria-hidden': true },
+        h('rect', { x: 3, y: 3, width: 18, height: 18, rx: 2 }),
+        h('circle', { cx: 9, cy: 9, r: 2.2 }),
+        h('path', { d: 'M21 15l-5-5L5 21' }));
+    }
+
+    function apply(ctx) {
+      const slots = ctx?.slots;
+      if (!slots?.inject) return;
+      const register = () => {
+        const disposers = [];
+        disposers.push(slots.inject('sidebar.panellist', () => slots.register(
+          { name: 'sidebar.panellist', id: PANEL, order: 73, label: () => 'Bluxe手绘工坊 · 生图工作台' },
+          HeaderIcon)));
+        disposers.push(slots.inject('main', () => slots.register(
+          { name: 'main', key: PANEL },
+          Workbench)));
+        return () => { for (const fn of disposers.reverse()) if (typeof fn === 'function') fn(); };
+      };
+      if (typeof ctx.effect === 'function') ctx.effect(register, 'image-workbench: panel registrations');
+      else register();
+    }
+
+    return { name: PANEL, inject: ['slots'], apply };
+  },
+});

package/cordis.patch.yml

@@ -1,14 +1,14 @@
-# DSH profile patch: register the workbench as a loader entry.
-# All paths are resolved at runtime by host.js; no absolute paths are stored here.
-# The DSH host manages the workbench backend on port 8092 only.
-# The account-pool process on port 38651 is managed by server/pool_service.py.
-- insert:
-    - id: image-workbench
-      name: dsh-plugin-image-workbench
-      config:
-        port: 8092
-        poolPort: 38651
-        autoStart: true
-        # 宿主侧守护：探测失败时自动重启后端，不重载面板。设为 false 并重启 DSH 可关闭。
-        watchdog: true
-        watchdogIntervalMs: 15000
+# DSH profile patch: register the workbench as a loader entry.
+# All paths are resolved at runtime by host.js; no absolute paths are stored here.
+# The DSH host manages the workbench backend on port 8092 only.
+# The account-pool process on port 38651 is managed by server/pool_service.py.
+- insert:
+    - id: image-workbench
+      name: dsh-plugin-image-workbench
+      config:
+        port: 8092
+        poolPort: 38651
+        autoStart: true
+        # 宿主侧守护：探测失败时自动重启后端，不重载面板。设为 false 并重启 DSH 可关闭。
+        watchdog: true
+        watchdogIntervalMs: 15000