@dickpy/dsh-imagegen 1.5.5 → 1.5.6

package/src/client/SettingsCard.tsx

@@ -33,6 +33,7 @@ export interface ImageGenSettings {
   promptApiUrl?: string
   promptApiKey?: string
   promptModel?: string
+  localStoragePath?: string
   storageEnabled?: boolean
   storageEndpoint?: string
   storageRegion?: string
@@ -55,6 +56,7 @@ export interface ImageGenSettingsCardState extends CardShell {
   promptApiUrl: CardFieldState
   promptApiKey: CardFieldState
   promptModel: CardFieldState
+  localStoragePath: CardFieldState
   storageEnabled: CardFieldState
   storageEndpoint: CardFieldState
   storageRegion: CardFieldState
@@ -98,6 +100,7 @@ export class ImageGenSettingsCardController {
       textField('promptApiUrl'),
       secretField('promptApiKey'),
       textField('promptModel'),
+      textField('localStoragePath'),
       booleanField('storageEnabled'),
       textField('storageEndpoint'),
       textField('storageRegion'),
@@ -124,6 +127,7 @@ export class ImageGenSettingsCardController {
       promptApiUrl: this.form.field('promptApiUrl'),
       promptApiKey: this.form.field('promptApiKey'),
       promptModel: this.form.field('promptModel'),
+      localStoragePath: this.form.field('localStoragePath'),
       storageEnabled: this.form.field('storageEnabled'),
       storageEndpoint: this.form.field('storageEndpoint'),
       storageRegion: this.form.field('storageRegion'),
@@ -475,6 +479,16 @@ export function ImageGenSettingsCard(props: ImageGenSettingsCardProps) {
               <span aria-hidden="true">{storageOpen ? '⌃' : '⌄'}</span>
             </button>
             {storageOpen ? <div className={css.optionalContent}>
+            <ValueField
+              id="dsh-imagegen-settings-local-storage-path"
+              label={t('settings.localStoragePath')}
+              hint={t('settings.localStoragePathHint')}
+              placeholder="E:\\dsh-imagegen-data"
+              {...fieldProps}
+              {...state.localStoragePath}
+              onEdit={(text) => { props.edit('localStoragePath', text) }}
+              onReset={() => { props.resetField('localStoragePath') }}
+            />
             <BooleanField
               id="dsh-imagegen-settings-storage-enabled"
               label={t('settings.storageEnabled')}

package/src/client/canvas-workspace.module.css

@@ -142,6 +142,68 @@
 
 .grid[data-mode="blank"] { background-image: none; }
 
+.grid[data-mode="diagonal"] {
+  background-image: repeating-linear-gradient(45deg, color-mix(in srgb, var(--dsw-alias-label-primary) 8%, transparent) 0 1px, transparent 1px 16px);
+}
+
+.grid[data-mode="checker"] {
+  background-image:
+    conic-gradient(color-mix(in srgb, var(--dsw-alias-label-primary) 7%, transparent) 90deg, transparent 90deg 180deg, color-mix(in srgb, var(--dsw-alias-label-primary) 7%, transparent) 180deg 270deg, transparent 270deg);
+  background-size: 48px 48px;
+}
+
+.grid[data-mode="image"] { background-image: none; }
+
+.gridScrim {
+  position: absolute;
+  inset: 0;
+  background: var(--dsw-alias-bg-layer-1);
+  opacity: 0.6;
+}
+
+/* ------------------------------------------------ background menu */
+
+.backgroundMenu {
+  position: absolute;
+  transform: translate(-50%, -100%);
+  z-index: 45;
+  min-width: 168px;
+  padding: 5px;
+  border-radius: 11px;
+  border: 1px solid var(--dsw-alias-border-l1);
+  background: color-mix(in srgb, var(--dsw-alias-bg-layer-1) 96%, transparent);
+  box-shadow: 0 16px 40px rgb(15 23 42 / 20%);
+  display: flex;
+  flex-direction: column;
+}
+
+.backgroundMenu button {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  border: none;
+  border-radius: 7px;
+  background: transparent;
+  color: var(--dsw-alias-label-primary);
+  font-size: 12.5px;
+  padding: 7px 10px;
+  cursor: pointer;
+  text-align: left;
+}
+
+.backgroundMenu button:hover { background: var(--dsw-alias-interactive-bg-hover); }
+
+.backgroundMenu button[data-active] {
+  color: var(--dsw-alias-brand-primary);
+  background: color-mix(in srgb, var(--dsw-alias-brand-primary) 12%, transparent);
+}
+
+.backgroundMenuDivider {
+  height: 1px;
+  margin: 4px 6px;
+  background: var(--dsw-alias-border-l1);
+}
+
 .world {
   position: absolute;
   left: 0;
@@ -256,6 +318,33 @@
   display: block;
 }
 
+.imageInfo {
+  position: absolute;
+  top: 6px;
+  z-index: 2;
+  padding: 3px 8px;
+  border-radius: 6px;
+  background: color-mix(in srgb, var(--dsw-alias-label-primary) 62%, transparent);
+  color: var(--dsw-alias-bg-layer-1);
+  font-size: 10.5px;
+  line-height: 1.4;
+  pointer-events: none;
+  backdrop-filter: blur(3px);
+  max-width: calc(100% - 90px);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.imageInfoLeft { left: 6px; font-weight: 600; }
+
+.imageInfoRight {
+  right: 6px;
+  left: auto;
+  font-variant-numeric: tabular-nums;
+  opacity: 0.85;
+}
+
 .nodeState,
 .nodeStateError {
   display: flex;
@@ -343,7 +432,53 @@
   backdrop-filter: blur(10px);
 }
 
-.dock .iconButton { width: 34px; height: 34px; }
+.dock .iconButton {
+  position: relative;
+  overflow: hidden;
+  width: 40px;
+  height: 40px;
+  border-radius: 11px;
+  transition: transform 0.18s cubic-bezier(0.34, 1.9, 0.64, 1), background 0.15s ease, color 0.15s ease, box-shadow 0.18s ease;
+}
+
+/* water-wave sheen sweeping across + gentle lift on hover */
+.dock .iconButton::before {
+  content: '';
+  position: absolute;
+  top: -4px;
+  bottom: -4px;
+  left: -150%;
+  width: 65%;
+  background: linear-gradient(105deg, transparent, color-mix(in srgb, currentColor 26%, transparent), transparent);
+  transform: skewX(-18deg);
+  opacity: 0;
+  pointer-events: none;
+}
+
+.dock .iconButton:not(:disabled):hover {
+  transform: translateY(calc(-3px - var(--dock-lift, 0px)));
+  box-shadow: 0 6px 14px color-mix(in srgb, var(--dsw-alias-label-primary) 20%, transparent);
+}
+
+.dock .iconButton:not(:disabled):hover::before {
+  animation: dockShine 0.55s ease forwards;
+}
+
+.dock .iconButton:not(:disabled):active {
+  transform: translateY(-1px) scale(0.96);
+}
+
+@keyframes dockShine {
+  0% { left: -150%; opacity: 1; }
+  100% { left: 170%; opacity: 1; }
+}
+
+.dock .iconButton[data-active] {
+  background: var(--dsw-alias-label-primary);
+  color: var(--dsw-alias-bg-layer-1);
+}
+
+.dock .iconButton[data-active]:hover { background: var(--dsw-alias-label-primary); color: var(--dsw-alias-bg-layer-1); }
 
 .dockDivider {
   width: 1px;
@@ -439,29 +574,30 @@
 /* ------------------------------------------------------ config node */
 
 .configNode {
-  padding: 0 10px 10px;
+  padding: 0 14px 14px;
   cursor: grab;
 }
 
-.configNode .nodeHeader { padding: 7px 2px 5px; }
+.configNode .nodeHeader { padding: 10px 2px 6px; font-size: 12px; }
 
 .configLinks {
   display: flex;
-  margin: 2px 0 8px;
+  align-items: center;
+  margin: 4px 0 10px;
   flex: none;
 }
 
 .configLinks .composerChip {
-  font-size: 10.5px;
-  padding: 2px 8px;
+  font-size: 11px;
+  padding: 3px 10px;
 }
 
 .configHint {
   flex: 1;
   min-height: 0;
   margin: 0;
-  font-size: 11px;
-  line-height: 1.55;
+  font-size: 11.5px;
+  line-height: 1.7;
   color: var(--dsw-alias-label-tertiary);
   overflow: auto;
 }

package/src/client/locales.ts

@@ -31,7 +31,7 @@ export const zh = {
   'canvas.untitled': '未命名画布',
   'canvas.imageNode': '图片节点',
   'canvas.textNode': '文本节点',
-  'canvas.fromGallery': '画廊图片',
+  'canvas.fromGallery': '素材库图片',
   'canvas.fromHistory': '历史图片',
   'canvas.project': '画布项目',
   'canvas.newCanvas': '新建画布',
@@ -39,7 +39,15 @@ export const zh = {
   'canvas.deleteCanvasConfirm': '再点一次确认删除',
   'canvas.rename': '重命名画布',
   'canvas.renameHint': '双击重命名',
-  'canvas.background': '切换画布背景',
+  'canvas.background': '画布背景',
+  'canvas.backgroundDots': '点阵',
+  'canvas.backgroundLines': '网格线',
+  'canvas.backgroundDiagonal': '斜线',
+  'canvas.backgroundChecker': '棋盘格',
+  'canvas.backgroundBlank': '空白',
+  'canvas.backgroundUpload': '上传自定义背景…',
+  'canvas.backgroundRemove': '移除自定义背景',
+  'canvas.templateLibrary': '模板库（选择提示词生成文本+配置节点）',
   'canvas.undo': '撤销 (Ctrl+Z)',
   'canvas.redo': '重做 (Ctrl+Shift+Z)',
   'canvas.saving': '保存中…',
@@ -89,7 +97,11 @@ export const zh = {
   'canvas.close': '关闭',
   'canvas.tabUpload': '上传',
   'canvas.tabHistory': '历史记录',
-  'canvas.tabGallery': '画廊',
+  'canvas.tabGallery': '素材库',
+  'canvas.imageMenuUpload': '上传本地图片',
+  'canvas.imageMenuAssets': '从素材库选择',
+  'canvas.imageMenuHistory': '从历史记录选择',
+  'canvas.imageMenuGenerate': 'AI 生成新图',
   'canvas.tabGenerate': 'AI 生成',
   'canvas.dropHint': '图片拖动到此处即可添加',
   'canvas.dropSub': '支持多选，PNG / JPG / WebP / GIF',
@@ -241,14 +253,18 @@ export const zh = {
   'history.allModels': '全部模型',
   'history.allRatios': '全部比例',
   // gallery
-  'gallery.title': '画廊',
+  'gallery.title': '素材库',
   'gallery.categories': '分类',
-  'gallery.all': '全部作品',
+  'gallery.all': '全部素材',
+  'gallery.upload': '上传素材',
+  'gallery.uploadModel': '本地上传',
+  'gallery.uploaded': '素材已入库',
+  'gallery.uploadHint': '把本地图保存进素材库，画布随时可用',
   'gallery.gpt': 'gpt-image-2',
   'gallery.grok': 'grok-imagine-image',
   'gallery.ratio': '画面比例',
   'gallery.tags': '标签',
-  'gallery.filterHint': '按生成模式、模型和比例筛选画廊',
+  'gallery.filterHint': '按生成模式、模型和比例筛选素材',
   'gallery.count': '· 共 {count} 幅',
   'gallery.viewMode': '视图模式',
   'gallery.masonry': '瀑布流',
@@ -270,16 +286,16 @@ export const zh = {
   'gallery.downloadSelected': '下载所选',
   'gallery.exportJson': '导出 JSON',
   'gallery.select': '选择作品',
-  'gallery.add': '加入画廊',
-  'gallery.added': '已加入画廊',
-  'gallery.already': '已在画廊中',
-  'gallery.delete': '移出画廊',
+  'gallery.add': '加入素材库',
+  'gallery.added': '已加入素材库',
+  'gallery.already': '已在素材库中',
+  'gallery.delete': '移出素材库',
   'gallery.openFolder': '打开文件夹',
-  'gallery.clear': '清空画廊',
+  'gallery.clear': '清空素材库',
   'gallery.openFolderHint': '在系统的文件管理器中打开图片保存目录（~/.dsh/dsh-imagegen）',
-  'gallery.clearConfirm': '确定要清空整个画廊吗？此操作不可撤销。',
-  'gallery.empty': '画廊还是空的，把喜欢的图片加入进来吧',
-  'gallery.viewing': '画廊 · {time}',
+  'gallery.clearConfirm': '确定要清空整个素材库吗？此操作不可撤销。',
+  'gallery.empty': '素材库还是空的，把喜欢的图片加入进来吧',
+  'gallery.viewing': '素材库 · {time}',
   // preview
   'preview.title': '图片预览',
   'preview.open': '点击预览',
@@ -340,6 +356,8 @@ export const zh = {
   'settings.removeModel': '移除模型',
   'settings.optional': '可选',
   'settings.moreOptions': '更多设置',
+  'settings.localStoragePath': '本地图片存储目录',
+  'settings.localStoragePathHint': '生成历史、素材库和无限画布图片统一保存到此目录；留空使用默认的 ~/.dsh/dsh-imagegen。',
   'settings.storageTitle': '对象存储同步',
   'settings.storageEnabled': '启用对象存储同步',
   'settings.storageHint': '图片保存到本地后，异步上传一份到 S3 兼容对象存储（腾讯云 COS / 阿里云 OSS / 七牛云 S3 / MinIO / R2 等）',
@@ -353,8 +371,8 @@ export const zh = {
   'settings.storageAccessKeyHint': 'S3 兼容密钥 ID（COS SecretId / OSS AccessKeyId / 七牛 AK）',
   'settings.storageSecretKey': 'Secret Key',
   'settings.storageSecretKeyHint': 'S3 兼容密钥，仅保存在本机设置文档',
-  'settings.storageSyncGallery': '同步画廊图片',
-  'settings.storageSyncGalleryHint': '加入画廊的图片自动上传',
+  'settings.storageSyncGallery': '同步素材库图片',
+  'settings.storageSyncGalleryHint': '加入素材库的图片自动上传',
   'settings.storageSyncHistory': '同步历史记录图片',
   'settings.storageSyncHistoryHint': '所有生成结果也一并上传（数量可能较大）',
   'settings.storageTest': '测试连接',
@@ -458,7 +476,7 @@ export const zh = {
   'channels.statusIncomplete': '配置未完成',
   'channels.edit': '编辑',
   'channels.delete': '删除',
-  'channels.deleteConfirmTitle': '删除渠道「{name}」？该渠道的密钥将被移除；历史与画廊中的记录仍会保留。',
+  'channels.deleteConfirmTitle': '删除渠道「{name}」？该渠道的密钥将被移除；历史与素材库中的记录仍会保留。',
   'channels.confirm': '确认删除',
   'channels.cancel': '取消',
   'channels.editorTitle': '渠道',
@@ -530,7 +548,15 @@ export const en: Record<keyof typeof zh, string> = {
   'canvas.deleteCanvasConfirm': 'Click again to confirm',
   'canvas.rename': 'Rename canvas',
   'canvas.renameHint': 'Double-click to rename',
-  'canvas.background': 'Cycle canvas background',
+  'canvas.background': 'Canvas background',
+  'canvas.backgroundDots': 'Dots',
+  'canvas.backgroundLines': 'Grid lines',
+  'canvas.backgroundDiagonal': 'Diagonal',
+  'canvas.backgroundChecker': 'Checkerboard',
+  'canvas.backgroundBlank': 'Blank',
+  'canvas.backgroundUpload': 'Upload custom background…',
+  'canvas.backgroundRemove': 'Remove custom background',
+  'canvas.templateLibrary': 'Template library (pick a prompt to create text + config nodes)',
   'canvas.undo': 'Undo (Ctrl+Z)',
   'canvas.redo': 'Redo (Ctrl+Shift+Z)',
   'canvas.saving': 'Saving…',
@@ -580,7 +606,11 @@ export const en: Record<keyof typeof zh, string> = {
   'canvas.close': 'Close',
   'canvas.tabUpload': 'Upload',
   'canvas.tabHistory': 'History',
-  'canvas.tabGallery': 'Gallery',
+  'canvas.tabGallery': 'Assets',
+  'canvas.imageMenuUpload': 'Upload local image',
+  'canvas.imageMenuAssets': 'Pick from assets',
+  'canvas.imageMenuHistory': 'Pick from history',
+  'canvas.imageMenuGenerate': 'Generate with AI',
   'canvas.tabGenerate': 'AI generate',
   'canvas.dropHint': 'Drop images here to add them',
   'canvas.dropSub': 'Multiple files, PNG / JPG / WebP / GIF',
@@ -725,9 +755,13 @@ export const en: Record<keyof typeof zh, string> = {
   'history.ratio': 'Ratio filter',
   'history.allModels': 'All models',
   'history.allRatios': 'All ratios',
-  'gallery.title': 'Gallery',
+  'gallery.title': 'Assets',
   'gallery.categories': 'Categories',
-  'gallery.all': 'All works',
+  'gallery.all': 'All assets',
+  'gallery.upload': 'Upload',
+  'gallery.uploadModel': 'Local upload',
+  'gallery.uploaded': 'Asset saved',
+  'gallery.uploadHint': 'Save local images for reuse on the canvas',
   'gallery.gpt': 'gpt-image-2',
   'gallery.grok': 'grok-imagine-image',
   'gallery.ratio': 'Aspect ratio',
@@ -820,6 +854,8 @@ export const en: Record<keyof typeof zh, string> = {
   'settings.removeModel': 'Remove model',
   'settings.optional': 'Optional',
   'settings.moreOptions': 'More settings',
+  'settings.localStoragePath': 'Local image storage directory',
+  'settings.localStoragePathHint': 'History, assets and canvas images share this directory; leave empty for the default ~/.dsh/dsh-imagegen.',
   'settings.storageTitle': 'Object storage sync',
   'settings.storageEnabled': 'Enable object storage sync',
   'settings.storageHint': 'After images land locally, mirror them to an S3-compatible store (Tencent COS / Alibaba OSS / Qiniu S3 / MinIO / R2 …)',
@@ -1013,7 +1049,15 @@ export const ru: Record<keyof typeof zh, string> = {
   'canvas.deleteCanvasConfirm': 'Нажмите ещё раз для подтверждения',
   'canvas.rename': 'Переименовать холст',
   'canvas.renameHint': 'Двойной клик — переименовать',
-  'canvas.background': 'Сменить фон холста',
+  'canvas.background': 'Фон холста',
+  'canvas.backgroundDots': 'Точки',
+  'canvas.backgroundLines': 'Сетка',
+  'canvas.backgroundDiagonal': 'Диагональ',
+  'canvas.backgroundChecker': 'Шахматка',
+  'canvas.backgroundBlank': 'Пустой',
+  'canvas.backgroundUpload': 'Загрузить свой фон…',
+  'canvas.backgroundRemove': 'Убрать свой фон',
+  'canvas.templateLibrary': 'Библиотека шаблонов (выберите промпт — создадутся текстовый узел и узел конфигурации)',
   'canvas.undo': 'Отменить (Ctrl+Z)',
   'canvas.redo': 'Повторить (Ctrl+Shift+Z)',
   'canvas.saving': 'Сохранение…',
@@ -1063,7 +1107,11 @@ export const ru: Record<keyof typeof zh, string> = {
   'canvas.close': 'Закрыть',
   'canvas.tabUpload': 'Загрузка',
   'canvas.tabHistory': 'История',
-  'canvas.tabGallery': 'Галерея',
+  'canvas.tabGallery': 'Материалы',
+  'canvas.imageMenuUpload': 'Загрузить локальное изображение',
+  'canvas.imageMenuAssets': 'Выбрать из материалов',
+  'canvas.imageMenuHistory': 'Выбрать из истории',
+  'canvas.imageMenuGenerate': 'Создать через AI',
   'canvas.tabGenerate': 'AI-генерация',
   'canvas.dropHint': 'Перетащите изображения сюда',
   'canvas.dropSub': 'Несколько файлов, PNG / JPG / WebP / GIF',
@@ -1208,9 +1256,13 @@ export const ru: Record<keyof typeof zh, string> = {
   'history.ratio': 'Фильтр по пропорциям',
   'history.allModels': 'Все модели',
   'history.allRatios': 'Все пропорции',
-  'gallery.title': 'Галерея',
+  'gallery.title': 'Материалы',
   'gallery.categories': 'Категории',
-  'gallery.all': 'Все работы',
+  'gallery.all': 'Все материалы',
+  'gallery.upload': 'Загрузить',
+  'gallery.uploadModel': 'Локальный файл',
+  'gallery.uploaded': 'Материал добавлен',
+  'gallery.uploadHint': 'Сохраните локальные изображения для холста',
   'gallery.gpt': 'gpt-image-2',
   'gallery.grok': 'grok-imagine-image',
   'gallery.ratio': 'Пропорции',
@@ -1303,6 +1355,8 @@ export const ru: Record<keyof typeof zh, string> = {
   'settings.removeModel': 'Удалить модель',
   'settings.optional': 'необязательно',
   'settings.moreOptions': 'Дополнительно',
+  'settings.localStoragePath': 'Локальная папка изображений',
+  'settings.localStoragePathHint': 'История, материалы и холст используют эту папку; пусто — ~/.dsh/dsh-imagegen.',
   'settings.storageTitle': 'Синхронизация с объектным хранилищем',
   'settings.storageEnabled': 'Включить синхронизацию',
   'settings.storageHint': 'После сохранения локально изображения выгружаются в S3-совместимое хранилище (Tencent COS / Alibaba OSS / Qiniu S3 / MinIO / R2…)',

package/src/client/panel.module.css

@@ -488,26 +488,26 @@ html[data-dsh-imagegen-active] .sidebarHistoryHost {
   flex: 1;
 }
 
-.generation {
-  display: flex;
-  width: 100%;
-  gap: 14px;
-  min-width: 0;
-  min-height: 0;
-}
-
-/* The canvas workspace owns the full generation surface. Keep the classic
-   config/result DOM mounted so switching tabs remains instantaneous, but hide
-   those siblings while the scene graph is active. */
-.generation[data-workspace='canvas'] {
-  display: flex;
-  height: 100%;
-}
-
-.generation[data-workspace='canvas'] > .config,
-.generation[data-workspace='canvas'] > .canvas {
-  display: none !important;
-}
+.generation {
+  display: flex;
+  width: 100%;
+  gap: 14px;
+  min-width: 0;
+  min-height: 0;
+}
+
+/* The canvas workspace owns the full generation surface. Keep the classic
+   config/result DOM mounted so switching tabs remains instantaneous, but hide
+   those siblings while the scene graph is active. */
+.generation[data-workspace='canvas'] {
+  display: flex;
+  height: 100%;
+}
+
+.generation[data-workspace='canvas'] > .config,
+.generation[data-workspace='canvas'] > .canvas {
+  display: none !important;
+}
 
 .config {
   display: flex;
@@ -2534,12 +2534,6 @@ html[data-dsh-imagegen-chat-collapsed] [data-dsh-imagegen-chat-resizer] {
 }
 
 /* --- gallery workspace -------------------------------------------------------- */
-.config[data-gallery='true'] .configScroll > *:not(:first-child),
-.config[data-gallery='true'] .footer,
-.canvas[data-gallery='true'] > .canvasState,
-.canvas[data-gallery='true'] > .canvasError,
-.canvas[data-gallery='true'] > .canvasBody,
-.studio:has(.config[data-gallery='true']) > .history { display: none; }
 .config[data-gallery='true'] .configScroll { display: flex; flex: none; overflow: visible; order: 1; }
 .config[data-gallery='true'] .galleryFilters { order: 2; flex: 1; min-height: 0; }
 .galleryFilters { padding: 18px 14px; overflow-y: auto; overflow-x: hidden; }

package/src/engine.ts

@@ -559,17 +559,25 @@ async function requestOneImage(
     if (typeof request.image !== 'string' || request.image === '') {
       throw new ImageGenError('图生图需要上传参考图片', 'edit-image-missing')
     }
-    const parsed = parseDataUrl(request.image)
-    if (parsed === undefined) throw new ImageGenError('参考图片格式无效', 'edit-image-invalid')
-    let bytes: Buffer
-    try {
-      bytes = Buffer.from(parsed.base64, 'base64')
-    } catch {
-      throw new ImageGenError('参考图片数据无法解码', 'edit-image-invalid')
-    }
-    if (bytes.byteLength > MAX_EDIT_IMAGE_BYTES) {
-      throw new ImageGenError('参考图片超过 10MB 上限', 'edit-image-too-large')
+    const decodeReference = (dataUrl: string): { bytes: Buffer; mime: string; filename: string } => {
+      const parsed = parseDataUrl(dataUrl)
+      if (parsed === undefined) throw new ImageGenError('参考图片格式无效', 'edit-image-invalid')
+      let bytes: Buffer
+      try {
+        bytes = Buffer.from(parsed.base64, 'base64')
+      } catch {
+        throw new ImageGenError('参考图片数据无法解码', 'edit-image-invalid')
+      }
+      if (bytes.byteLength > MAX_EDIT_IMAGE_BYTES) {
+        throw new ImageGenError('参考图片超过 10MB 上限', 'edit-image-too-large')
+      }
+      return { bytes, mime: parsed.mime, filename: `reference.${extensionOf(parsed.mime)}` }
     }
+    const primary = decodeReference(request.image)
+    const extras = (request.images ?? [])
+      .filter(img => typeof img === 'string' && img !== '')
+      .slice(0, 4)
+      .map(decodeReference)
     // Grok Imagine /images/edits takes a JSON image_url object (a base64 data
     // URI is accepted) instead of OpenAI's multipart form-data upload.
     if (isGrokImagine(params.model)) {
@@ -585,7 +593,7 @@ async function requestOneImage(
       // Nano Banana OpenAI-compatible gateways accept the standard multipart
       // edit upload, with the family's own aspect_ratio / image_size knobs.
       const form = new FormData()
-      form.append('image', new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf(parsed.mime)}`)
+      form.append('image', new Blob([primary.bytes], { type: primary.mime }), primary.filename)
       form.append('prompt', request.prompt)
       form.append('model', params.model)
       if (params.aspect_ratio !== undefined) form.append('aspect_ratio', params.aspect_ratio)
@@ -593,19 +601,28 @@ async function requestOneImage(
       body = form
     } else if (isSeedream(params.model)) {
       // Seedream unifies generation and editing on /images/generations; the
-      // reference image is a JSON URL / data-URL array, never multipart.
+      // reference image is a JSON URL / data-URL array, never multipart, and
+      // the protocol natively accepts several references.
       headers['content-type'] = 'application/json'
       body = JSON.stringify({
         model: params.model,
         prompt: request.prompt,
-        image: [request.image],
+        image: [request.image, ...(request.images ?? []).filter(img => typeof img === 'string' && img !== '').slice(0, 4)],
         ...params.size !== undefined ? { size: params.size } : {},
         ...params.resolution !== undefined ? { resolution: params.resolution } : {},
         response_format: isVolcSeedream(params.model) ? 'url' : 'b64_json',
       })
     } else {
       const form = new FormData()
-      form.append('image', new Blob([bytes], { type: parsed.mime }), `reference.${extensionOf(parsed.mime)}`)
+      if (extras.length > 0) {
+        // OpenAI-style multi-reference upload: repeat the image[] field so
+        // every connected canvas reference reaches the gateway.
+        for (const [index, reference] of [primary, ...extras].entries()) {
+          form.append('image[]', new Blob([reference.bytes], { type: reference.mime }), `reference-${index}.${extensionOf(reference.mime)}`)
+        }
+      } else {
+        form.append('image', new Blob([primary.bytes], { type: primary.mime }), primary.filename)
+      }
       form.append('prompt', request.prompt)
       form.append('model', params.model)
       if (params.size !== undefined) form.append('size', params.size)