@dickpy/dsh-imagegen 1.5.3 → 1.5.4

package/src/client/panel.module.css

@@ -488,13 +488,26 @@ html[data-dsh-imagegen-active] .sidebarHistoryHost {
   flex: 1;
 }
 
-.generation {
-  display: flex;
-  width: 100%;
-  gap: 14px;
-  min-width: 0;
-  min-height: 0;
-}
+.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;
@@ -846,29 +859,43 @@ html[data-dsh-imagegen-active] .sidebarHistoryHost {
 
 .historyActions {
   display: flex;
-  gap: 6px;
+  gap: 4px;
   justify-content: flex-end;
 }
 
-.historyAction {
-  padding: 2px 8px;
-  font: inherit;
-  font-size: 11.5px;
-  color: var(--dsw-alias-label-secondary);
+/* Compact icon actions on each history row: chat / gallery / trash. */
+.historyIconAction {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 26px;
+  height: 24px;
+  padding: 0;
+  border: 1px solid transparent;
+  border-radius: 7px;
   background: transparent;
-  border: 1px solid var(--dsw-alias-border-l2);
-  border-radius: 999px;
+  color: var(--dsw-alias-label-tertiary);
   cursor: pointer;
 }
 
-.historyAction:hover {
+.historyIconAction:hover {
   color: var(--dsw-alias-label-primary);
-  border-color: var(--dsw-alias-label-dimmed);
+  background: var(--dsw-alias-interactive-bg-hover);
 }
 
-.historyAction[data-danger]:hover {
-  color: var(--dsw-alias-label-error);
-  border-color: var(--dsw-alias-label-error);
+.historyIconAction:focus-visible {
+  outline: 2px solid var(--dsw-alias-brand-primary);
+  outline-offset: 1px;
+}
+
+.historyIconAction:disabled {
+  opacity: 0.5;
+  cursor: default;
+}
+
+.historyIconAction[data-danger]:hover {
+  color: var(--dsw-alias-state-error);
+  background: color-mix(in srgb, var(--dsw-alias-state-error) 10%, transparent);
 }
 
 /* --- cards (system-aligned rounded group chrome) ------------------------------ */
@@ -887,30 +914,36 @@ html[data-dsh-imagegen-active] .sidebarHistoryHost {
 .ecommerceWorkspace {
   display: flex;
   flex-direction: column;
-  gap: 16px;
-  max-width: 720px;
+  gap: 18px;
+  max-width: 760px;
   margin: 0 auto;
-  padding: 6px 2px 12px;
+  padding: 10px 8px 18px;
 }
 
 /* Flat sections in the CapyAI style: plain headings, no card boxes. */
 .ecommerceSection {
   display: flex;
   flex-direction: column;
-  gap: 8px;
-  padding: 0;
+  gap: 10px;
+  padding: 0 0 16px;
   border: none;
+  border-bottom: 1px solid var(--dsw-alias-border-l1);
   border-radius: 0;
   background: transparent;
 }
 
+.ecommerceSection:last-of-type {
+  padding-bottom: 4px;
+  border-bottom: none;
+}
+
 .ecommerceSection h3 {
-  margin: 0;
-  font-size: 13.5px;
-  font-weight: 600;
+  margin: 0 0 2px;
+  font-size: 14px;
+  font-weight: 650;
   display: flex;
   align-items: baseline;
-  gap: 6px;
+  gap: 7px;
 }
 
 .ecommerceSectionHint {
@@ -919,13 +952,14 @@ html[data-dsh-imagegen-active] .sidebarHistoryHost {
   color: var(--dsw-alias-label-tertiary);
 }
 
-.ecommerceSection input:not([type="checkbox"]), .ecommerceSection select, .ecommerceSection textarea { box-sizing: border-box; width: 100%; padding: 8px 10px; color: var(--dsw-alias-label-primary); background: var(--dsw-alias-bg-layer-3); border: 1px solid var(--dsw-alias-border-l2); border-radius: 8px; font: inherit; }
-.ecommerceSection textarea { min-height: 60px; resize: vertical; }
+.ecommerceSection input:not([type="checkbox"]), .ecommerceSection select, .ecommerceSection textarea { box-sizing: border-box; width: 100%; padding: 9px 11px; color: var(--dsw-alias-label-primary); background: var(--dsw-alias-bg-layer-3); border: 1px solid var(--dsw-alias-border-l2); border-radius: 9px; font: inherit; }
+.ecommerceSection input:not([type="checkbox"]):focus-visible, .ecommerceSection select:focus-visible, .ecommerceSection textarea:focus-visible { outline: 2px solid var(--dsw-alias-brand-primary); outline-offset: 1px; }
+.ecommerceSection textarea { min-height: 68px; resize: vertical; line-height: 1.5; }
 
 .ecommerceField {
   display: flex;
   flex-direction: column;
-  gap: 4px;
+  gap: 5px;
   min-width: 0;
 }
 
@@ -937,7 +971,7 @@ html[data-dsh-imagegen-active] .sidebarHistoryHost {
 .ecommerceParamGrid {
   display: grid;
   grid-template-columns: 1fr 1fr;
-  gap: 10px 8px;
+  gap: 12px 10px;
 }
 
 .ecommerceUploadHero {
@@ -963,6 +997,11 @@ html[data-dsh-imagegen-active] .sidebarHistoryHost {
   background: var(--dsw-alias-interactive-bg-hover);
 }
 
+.ecommerceUploadHero:focus-visible, .ecommerceAssetAdd:focus-visible, .ecommerceSlotCard:focus-visible, .ecommerceAdvancedToggle:focus-visible, .ecommerceAsset button:focus-visible {
+  outline: 2px solid var(--dsw-alias-brand-primary);
+  outline-offset: 2px;
+}
+
 .ecommerceUploadHero span {
   font-size: 12px;
 }
@@ -2598,6 +2637,17 @@ html[data-dsh-imagegen-chat-collapsed] [data-dsh-imagegen-chat-resizer] {
 .galleryRemove { flex: none; width: 24px; height: 24px; padding: 0; border: 0; border-radius: 50%; color: var(--dsw-alias-label-tertiary); background: transparent; cursor: pointer; font-size: 18px; }
 .galleryRemove:hover { color: var(--dsw-alias-state-error); background: var(--dsw-alias-bg-layer-2); }
 
+@media (max-width: 760px) {
+  .ecommerceParamGrid { grid-template-columns: 1fr; }
+  .ecommerceStructureGrid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+  .ecommerceAssets { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+}
+
+@media (max-width: 420px) {
+  .ecommerceWorkspace { padding-inline: 2px; }
+  .ecommerceStructureGrid, .ecommerceAssets { grid-template-columns: 1fr; }
+}
+
 @media (max-width: 1100px) {
   .galleryMasonry { grid-template-columns: repeat(2, minmax(0, 1fr)); }
 }

package/src/engine.ts

@@ -339,6 +339,7 @@ function effectiveCount(request: GenerateRequest): number {
 async function normalizeItem(
   item: Record<string, unknown>,
   upstream: UpstreamConfig,
+  signal?: AbortSignal,
 ): Promise<{ b64: string; mime: string; revisedPrompt?: string }> {
   const revisedPrompt = typeof item.revised_prompt === 'string' ? item.revised_prompt : undefined
   if (typeof item.b64_json === 'string' && item.b64_json.trim() !== '') {
@@ -356,7 +357,7 @@ async function normalizeItem(
     if (parsed === undefined) throw new ImageGenError('upstream returned a malformed data: url')
     return { b64: parsed.base64, mime: detectImageMime(Buffer.from(parsed.base64, 'base64')) ?? parsed.mime, revisedPrompt }
   }
-  const budget = requestSignal(undefined, IMAGE_FETCH_TIMEOUT_MS)
+  const budget = requestSignal(signal, IMAGE_FETCH_TIMEOUT_MS)
   let response: Response
   try {
     response = await fetch(url, {
@@ -382,6 +383,152 @@ async function normalizeItem(
   return { b64: buffer.toString('base64'), mime, revisedPrompt }
 }
 
+/** Expand a provider image item whose URL may be a string or an array. */
+function imageItemsOf(value: unknown): Array<Record<string, unknown>> {
+  if (value === null || typeof value !== 'object') return []
+  const item = value as Record<string, unknown>
+  if (Array.isArray(item.url)) {
+    return item.url.filter((url): url is string => typeof url === 'string' && url !== '').map(url => ({ ...item, url }))
+  }
+  return [item]
+}
+
+/** Return the data records from the response shapes shared by sync gateways. */
+function dataRecordsOf(payload: Record<string, unknown>): Array<Record<string, unknown>> | undefined {
+  const data = Array.isArray(payload.data)
+    ? payload.data
+    : payload.data !== null && typeof payload.data === 'object'
+      ? [payload.data]
+      : Array.isArray(payload.images)
+        ? payload.images
+        : Array.isArray(payload.output)
+          ? payload.output
+          : undefined
+  if (data === undefined) return undefined
+  return data.filter((entry): entry is Record<string, unknown> => entry !== null && typeof entry === 'object')
+}
+
+const ASYNC_PENDING_STATUSES = new Set(['submitted', 'pending', 'processing', 'running', 'in_progress', 'queued'])
+const ASYNC_COMPLETED_STATUSES = new Set(['completed', 'succeeded', 'success', 'done'])
+const ASYNC_FAILED_STATUSES = new Set(['failed', 'failure', 'cancelled', 'canceled', 'error'])
+const ASYNC_POLL_MAX_MS = 240_000
+const ASYNC_POLL_REQUEST_TIMEOUT_MS = 30_000
+
+/** Read a provider error message from the common nested locations. */
+function asyncErrorMessage(payload: unknown, fallback: string): string {
+  if (payload !== null && typeof payload === 'object') {
+    const record = payload as Record<string, unknown>
+    const candidates: unknown[] = [record.message, record.error]
+    const data = record.data
+    const entries = Array.isArray(data) ? data : [data]
+    for (const entry of entries) {
+      if (entry === null || typeof entry !== 'object') continue
+      const item = entry as Record<string, unknown>
+      candidates.push(item.message, item.error)
+      const nested = item.error
+      if (nested !== null && typeof nested === 'object') candidates.push((nested as Record<string, unknown>).message)
+    }
+    for (const candidate of candidates) {
+      if (typeof candidate === 'string' && candidate.trim() !== '') return candidate
+      if (candidate !== null && typeof candidate === 'object') {
+        const message = (candidate as Record<string, unknown>).message
+        if (typeof message === 'string' && message.trim() !== '') return message
+      }
+    }
+  }
+  return fallback
+}
+
+/** Wait between async-provider polls, but wake immediately when cancelled. */
+function waitForPoll(ms: number, signal?: AbortSignal): Promise<void> {
+  return new Promise((resolve, reject) => {
+    if (signal?.aborted === true) {
+      reject(signal.reason ?? new DOMException('The operation was aborted.', 'AbortError'))
+      return
+    }
+    const onAbort = () => {
+      clearTimeout(timer)
+      signal?.removeEventListener('abort', onAbort)
+      reject(signal?.reason ?? new DOMException('The operation was aborted.', 'AbortError'))
+    }
+    const done = () => {
+      signal?.removeEventListener('abort', onAbort)
+      resolve()
+    }
+    const timer = setTimeout(done, ms)
+    timer.unref()
+    signal?.addEventListener('abort', onAbort, { once: true })
+  })
+}
+
+/**
+ * Poll one apib/apimart-style provider task until it yields image records.
+ * The total deadline is shared by every poll and the final image downloads;
+ * local task cancellation propagates through every request and sleep.
+ */
+async function pollAsyncTask(
+  baseUrl: string,
+  upstream: UpstreamConfig,
+  taskId: string,
+  signal?: AbortSignal,
+): Promise<Array<Record<string, unknown>>> {
+  const deadline = Date.now() + ASYNC_POLL_MAX_MS
+  let delay = 1000
+  while (Date.now() < deadline) {
+    const remaining = deadline - Date.now()
+    const budget = requestSignal(signal, Math.min(ASYNC_POLL_REQUEST_TIMEOUT_MS, remaining))
+    let response: Response
+    try {
+      response = await fetch(`${baseUrl}/tasks/${encodeURIComponent(taskId)}`, {
+        method: 'GET',
+        headers: { authorization: `Bearer ${upstream.apiKey.trim()}` },
+        signal: budget.signal,
+      })
+    } catch (error) {
+      if (signal?.aborted === true) throw new ImageGenError('任务已取消', 'cancelled')
+      const message = error instanceof Error ? error.message : String(error)
+      if (/timeout|abort/i.test(message)) throw new ImageGenError('上游异步任务轮询超时', 'upstream-timeout')
+      throw new ImageGenError(`无法轮询上游异步任务：${message}`, 'upstream-unreachable')
+    } finally {
+      budget.dispose()
+    }
+    let payload: unknown
+    try {
+      payload = await response.json()
+    } catch {
+      throw new ImageGenError(`上游任务接口返回了非 JSON 响应（HTTP ${response.status}）`, 'upstream-invalid')
+    }
+    if (!response.ok || payload === null || typeof payload !== 'object') {
+      throw new ImageGenError(asyncErrorMessage(payload, `上游任务轮询失败（HTTP ${response.status}）`), 'upstream-rejected')
+    }
+    const record = payload as Record<string, unknown>
+    const data = record.data
+    const statusRecord = Array.isArray(data) ? data[0] : data !== null && typeof data === 'object' ? data : record
+    const statusValue = statusRecord !== null && typeof statusRecord === 'object'
+      ? (statusRecord as Record<string, unknown>).status
+      : undefined
+    const status = typeof statusValue === 'string' ? statusValue.toLowerCase() : ''
+    if (ASYNC_FAILED_STATUSES.has(status)) {
+      throw new ImageGenError(asyncErrorMessage(payload, `上游异步任务失败（${status || 'unknown'}）`), 'upstream-rejected')
+    }
+    const nested = statusRecord !== null && typeof statusRecord === 'object' ? statusRecord as Record<string, unknown> : record
+    const result = nested.result ?? (nested.output !== null && typeof nested.output === 'object' ? (nested.output as Record<string, unknown>).result : undefined) ?? record.result
+    const resultRecord = result !== null && typeof result === 'object' ? result as Record<string, unknown> : undefined
+    const images = resultRecord?.images ?? (nested.images ?? record.images)
+    if (ASYNC_COMPLETED_STATUSES.has(status) || images !== undefined) {
+      const items = Array.isArray(images) ? images.flatMap(imageItemsOf) : imageItemsOf(images)
+      if (items.length > 0) return items
+      if (ASYNC_COMPLETED_STATUSES.has(status)) throw new ImageGenError('上游异步任务完成但没有图片结果', 'upstream-empty')
+    }
+    if (status !== '' && !ASYNC_PENDING_STATUSES.has(status) && !ASYNC_COMPLETED_STATUSES.has(status)) {
+      throw new ImageGenError(`上游返回了未知异步任务状态：${status}`, 'upstream-invalid')
+    }
+    await waitForPoll(Math.min(delay, Math.max(1, deadline - Date.now())), signal)
+    delay = Math.min(5000, delay * 2)
+  }
+  throw new ImageGenError('上游异步任务轮询超时（240 秒）', 'upstream-timeout')
+}
+
 /**
  * Issue one single-image request (never sends `n`). The response is kept as a
  * list so a gateway that happens to return several images per call still works.
@@ -494,25 +641,20 @@ async function requestOneImage(
   }
 
   const record = payload as Record<string, unknown>
-  const data = Array.isArray(record.data)
-    ? record.data
-    : Array.isArray(record.images)
-      ? record.images
-      : Array.isArray(record.output)
-        ? record.output
-        : undefined
+  const data = dataRecordsOf(record)
   if (data === undefined) {
     throw new ImageGenError('上游响应缺少 data 数组', 'upstream-invalid')
   }
   if (data.length === 0) {
     throw new ImageGenError('上游返回了 0 张图片', 'upstream-empty')
   }
-  return Promise.all(data.map(async (entry) => {
-    if (entry === null || typeof entry !== 'object') {
-      throw new ImageGenError('上游响应包含无效的图片条目', 'upstream-invalid')
-    }
-    return normalizeItem(entry as Record<string, unknown>, upstream)
-  }))
+  const asyncEntries = data.filter(entry => typeof entry.task_id === 'string' && entry.task_id.trim() !== '')
+  if (asyncEntries.length > 0) {
+    const asyncRecords = (await Promise.all(asyncEntries.map(entry => pollAsyncTask(baseUrl, upstream, entry.task_id as string, signal)))).flat()
+    if (asyncRecords.length === 0) throw new ImageGenError('上游异步任务完成但没有图片结果', 'upstream-empty')
+    return Promise.all(asyncRecords.flatMap(imageItemsOf).map(item => normalizeItem(item, upstream, signal)))
+  }
+  return Promise.all(data.flatMap(imageItemsOf).map(item => normalizeItem(item, upstream, signal)))
 }
 
 /**

package/src/gallery-store.ts

@@ -13,6 +13,7 @@ import { createHash } from 'node:crypto'
 import { homedir } from 'node:os'
 import path from 'node:path'
 import type { GenerateMode, HistoryEntry, HistoryEntryInput } from './protocol.ts'
+import { notifyImageSaved } from './storage-sync.ts'
 
 const HISTORY_DIR = path.join(homedir(), '.dsh', 'dsh-imagegen')
 const GALLERY_DIR = path.join(HISTORY_DIR, 'gallery')
@@ -68,6 +69,7 @@ interface StoredEntry {
   projectName?: string
   slotKey?: string
   slotLabel?: string
+  canvas?: HistoryEntryInput['canvas']
 }
 
 /** The index.json shape. */
@@ -192,6 +194,7 @@ function toWire(entry: StoredEntry): HistoryEntry {
     ...entry.projectName === undefined ? {} : { projectName: entry.projectName },
     ...entry.slotKey === undefined ? {} : { slotKey: entry.slotKey },
     ...entry.slotLabel === undefined ? {} : { slotLabel: entry.slotLabel },
+    ...entry.canvas === undefined ? {} : { canvas: entry.canvas },
   }
 }
 
@@ -221,6 +224,7 @@ export async function appendGallery(input: HistoryEntryInput): Promise<GalleryAp
         const image = input.images[index]!
         const file = `${prefix}-${index}.${extensionOf(image.mime)}`
         await fs.writeFile(path.join(IMAGES_DIR, file), Buffer.from(image.b64, 'base64'))
+        notifyImageSaved('gallery', path.join(IMAGES_DIR, file))
         storedImages.push({
           file,
           mime: image.mime,
@@ -251,6 +255,7 @@ export async function appendGallery(input: HistoryEntryInput): Promise<GalleryAp
       ...input.projectName === undefined ? {} : { projectName: input.projectName },
       ...input.slotKey === undefined ? {} : { slotKey: input.slotKey },
       ...input.slotLabel === undefined ? {} : { slotLabel: input.slotLabel },
+      ...input.canvas === undefined ? {} : { canvas: input.canvas },
     }
     const merged = [entry, ...await readIndex()]
     await writeIndex(merged)

package/src/generation-runtime.ts

@@ -75,6 +75,7 @@ export class ImageGenerationRuntime {
         ...request.projectName === undefined ? {} : { projectName: request.projectName },
         ...request.slotKey === undefined ? {} : { slotKey: request.slotKey },
         ...request.slotLabel === undefined ? {} : { slotLabel: request.slotLabel },
+        ...request.canvas === undefined ? {} : { canvas: request.canvas },
       })
       return { ...result, history }
     } catch (error) {

package/src/history-store.ts

@@ -12,6 +12,7 @@ import { promises as fs } from 'node:fs'
 import { homedir } from 'node:os'
 import path from 'node:path'
 import { HISTORY_MAX, type GenerateMode, type HistoryEntry, type HistoryEntryInput } from './protocol.ts'
+import { notifyImageSaved } from './storage-sync.ts'
 
 const HISTORY_DIR = path.join(homedir(), '.dsh', 'dsh-imagegen')
 const INDEX_PATH = path.join(HISTORY_DIR, 'index.json')
@@ -56,6 +57,7 @@ interface StoredEntry {
   projectName?: string
   slotKey?: string
   slotLabel?: string
+  canvas?: HistoryEntryInput['canvas']
 }
 
 /** The index.json shape. */
@@ -174,6 +176,7 @@ function toWire(entry: StoredEntry): HistoryEntry {
     ...entry.projectName === undefined ? {} : { projectName: entry.projectName },
     ...entry.slotKey === undefined ? {} : { slotKey: entry.slotKey },
     ...entry.slotLabel === undefined ? {} : { slotLabel: entry.slotLabel },
+    ...entry.canvas === undefined ? {} : { canvas: entry.canvas },
   }
 }
 
@@ -194,6 +197,7 @@ export async function appendHistory(input: HistoryEntryInput): Promise<HistoryEn
         const image = input.images[index]!
         const file = `${prefix}-${index}.${extensionOf(image.mime)}`
         await fs.writeFile(path.join(IMAGES_DIR, file), Buffer.from(image.b64, 'base64'))
+        notifyImageSaved('history', path.join(IMAGES_DIR, file))
         storedImages.push({
           file,
           mime: image.mime,
@@ -225,6 +229,7 @@ export async function appendHistory(input: HistoryEntryInput): Promise<HistoryEn
       ...input.projectName === undefined ? {} : { projectName: input.projectName },
       ...input.slotKey === undefined ? {} : { slotKey: input.slotKey },
       ...input.slotLabel === undefined ? {} : { slotLabel: input.slotLabel },
+      ...input.canvas === undefined ? {} : { canvas: input.canvas },
     }
     const merged = [entry, ...await readIndex()]
     const kept = merged.slice(0, HISTORY_MAX)

package/src/index.ts

@@ -8,9 +8,10 @@
  */
 
 import type { Context } from '@deepseek-ai/cordis'
+import { readFileSync } from 'node:fs'
+import path from 'node:path'
 import { installSettingsSectionCompat, settingsNamespaceCompat } from './settings-compat.ts'
-import z from 'schemastery'
-// Type-only: pulls the webServer Context merge (route registration).
+import z from 'schemastery'// Type-only: pulls the webServer Context merge (route registration).
 import type {} from '@deepseek-ai/dsh-host-webserver'
 // Type-only: pulls the systemPrompt Context merge (announcement section).
 import type {} from '@deepseek-ai/dsh-system-prompt'
@@ -21,6 +22,18 @@ import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment'
 import { IMAGEGEN_SETTINGS_NAMESPACE, type ChannelConfig, type ModelMapping } from './protocol.ts'
 import { makeRoutes, type SettingsSeam } from './routes.ts'
 import { syncAllTemplates } from './templates-store.ts'
+import { setStorageSyncHandler, putObject, type StorageSyncConfig } from './storage-sync.ts'
+
+/** Content type for a saved image file name (object uploads). */
+function mimeOfPath(filePath: string): string {
+  switch (path.extname(filePath).toLowerCase()) {
+    case '.jpg':
+    case '.jpeg': return 'image/jpeg'
+    case '.webp': return 'image/webp'
+    case '.gif': return 'image/gif'
+    default: return 'image/png'
+  }
+}
 import { ImageGenerationRuntime, type ChannelsView, type RuntimeChannel } from './generation-runtime.ts'
 import { registerAgentImageTools } from './agent-image-tools.ts'
 import { registerEditImageCommand } from './edit-image-command.ts'
@@ -42,6 +55,7 @@ export { latestSessionImage, registerEditImageCommand } from './edit-image-comma
 export { appendGallery, clearGallery, listGallery, readGalleryImage, removeGallery, updateGalleryTags } from './gallery-store.ts'
 export { listTemplates, readTemplateImage, refreshTemplates, sampleTemplates, syncAllTemplates, clearTemplateMemo } from './templates-store.ts'
 export { addTemplateFavorite, clearTemplateFavoritesMemo, listTemplateFavorites, removeTemplateFavorite } from './template-favorites.ts'
+export { putObject, setStorageSyncHandler, testStorage, type StorageSyncConfig } from './storage-sync.ts'
 export { checkForUpdate, clearUpdateCache, compareVersions, CURRENT_VERSION, installUpdate, profileFromProcess } from './updater.ts'
 
 /** The branded settings namespace of this plugin (the card edits it). */
@@ -75,6 +89,22 @@ export interface Config {
   promptApiKey?: string
   /** Chat model used to expand short image prompts. */
   promptModel?: string
+  /** Sync saved images to an S3-compatible object store (COS / OSS / Qiniu S3 …). */
+  storageEnabled?: boolean
+  /** S3-compatible endpoint URL including the bucket (virtual-hosted or path style). */
+  storageEndpoint?: string
+  /** Provider region for SigV4 scope, e.g. ap-guangzhou / oss-cn-hangzhou. */
+  storageRegion?: string
+  /** Object key prefix, default 'dsh-imagegen'. */
+  storagePrefix?: string
+  /** S3 access key id. */
+  storageAccessKey?: string
+  /** S3 secret access key (stored redacted). */
+  storageSecretKey?: string
+  /** Upload gallery additions (default on when storage is enabled). */
+  storageSyncGallery?: boolean
+  /** Also upload history images. */
+  storageSyncHistory?: boolean
   /* ----- deprecated legacy single-endpoint fields (migrated to channels) ----- */
   /** Legacy base URL; synthesized into the default channel on upgrade. */
   apiUrl?: string
@@ -103,6 +133,14 @@ export const Config: z<Config> = z.object({
   promptApiUrl: z.string().default(''),
   promptApiKey: z.string().role('secret').default(''),
   promptModel: z.string().default(''),
+  storageEnabled: z.boolean().default(false),
+  storageEndpoint: z.string().default(''),
+  storageRegion: z.string().default(''),
+  storagePrefix: z.string().default('dsh-imagegen'),
+  storageAccessKey: z.string().default(''),
+  storageSecretKey: z.string().role('secret').default(''),
+  storageSyncGallery: z.boolean().default(true),
+  storageSyncHistory: z.boolean().default(false),
   apiUrl: z.string().default(''),
   apiKey: z.string().role('secret').default(''),
   imageModels: z.array(z.string()).default([]),
@@ -175,6 +213,7 @@ export interface EffectiveConfig {
   promptApiUrl: string
   promptApiKey: string
   promptModel: string
+  storage: StorageSyncConfig & { enabled: boolean; syncGallery: boolean; syncHistory: boolean }
 }
 
 /**
@@ -182,7 +221,7 @@ export interface EffectiveConfig {
  * @param ctx - host plugin context carrying webServer/systemPrompt.
  * @param config - resolved plugin config (schema defaults applied by the loader).
  */
-export function apply(ctx: Context, config?: Config): void {
+export function apply(ctx: Context, config?: Config): (() => void) | void {
   // The live source the surfaces read: the settings section once the settings
   // service is attached, the composition entry otherwise.
   let current: () => Config = () => config ?? {}
@@ -226,6 +265,16 @@ export function apply(ctx: Context, config?: Config): void {
       promptApiUrl: typeof value.promptApiUrl === 'string' ? value.promptApiUrl.trim() : '',
       promptApiKey: typeof value.promptApiKey === 'string' ? value.promptApiKey.trim() : '',
       promptModel: typeof value.promptModel === 'string' ? value.promptModel.trim() : '',
+      storage: {
+        enabled: value.storageEnabled ?? false,
+        endpoint: typeof value.storageEndpoint === 'string' ? value.storageEndpoint.trim() : '',
+        region: typeof value.storageRegion === 'string' ? value.storageRegion.trim() : '',
+        accessKey: typeof value.storageAccessKey === 'string' ? value.storageAccessKey.trim() : '',
+        secretKey: typeof value.storageSecretKey === 'string' ? value.storageSecretKey.trim() : '',
+        prefix: typeof value.storagePrefix === 'string' && value.storagePrefix.trim() !== '' ? value.storagePrefix.trim() : 'dsh-imagegen',
+        syncGallery: value.storageSyncGallery ?? true,
+        syncHistory: value.storageSyncHistory ?? false,
+      },
     }
   }
 
@@ -236,6 +285,21 @@ export function apply(ctx: Context, config?: Config): void {
     return { channels: value.channels, defaultChannelId: value.defaultChannelId }
   }
 
+  // Object-storage sync: the image stores announce every file they write; the
+  // handler resolves the live settings and uploads when enabled. Fire and
+  // forget — a sync failure never blocks the save path.
+  setStorageSyncHandler((kind, filePath) => {
+    const storage = resolve().storage
+    if (!storage.enabled || !storage.endpoint.trim() || storage.secretKey.trim() === '') return
+    if (kind === 'gallery' && !storage.syncGallery) return
+    if (kind === 'history' && !storage.syncHistory) return
+    const key = `${storage.prefix}/${kind === 'gallery' ? 'gallery' : 'images'}/${path.basename(filePath)}`
+    const data = readFileSync(filePath)
+    void putObject(storage, key, data, mimeOfPath(filePath)).catch(() => {
+      // Best-effort sync: surfaced through the settings test, never fatal here.
+    })
+  })
+
   // Browser endpoints and Agent tools share the exact same serial queue. This
   // keeps image persistence, cancellation, and retries coherent across both
   // entry points; Agent tools wait for their task result by default and render
@@ -276,6 +340,7 @@ export function apply(ctx: Context, config?: Config): void {
           attachments: sctx.attachments,
           pendingConversationImages,
           runtime,
+          resolveStorage: () => resolve().storage,
         })
         const disposers = routes.map(route => ctx.webServer.register(route))
         // Background template sync: the upstream sources update on their own
@@ -354,4 +419,6 @@ export function apply(ctx: Context, config?: Config): void {
   // Initial registration from the composition entry (covers deployments with
   // no settings service, whose installSettingsSection never fires its hooks).
   sync()
+
+  return () => { setStorageSyncHandler(undefined) }
 }