@exccoder/dsh-media-workbench 0.1.2 → 0.2.2

package/CHANGELOG.md

@@ -2,6 +2,32 @@
 
 All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project uses [Semantic Versioning](https://semver.org/).
 
+## [0.2.2] - 2026-11-09
+
+Image workflow and storage update.
+
+### Added
+
+- Reference queue for Image Studio: up to 8 images, Ctrl+V paste, multi-file drop/select, per-image up/down reorder and removal, with「图一 / 图二」labels.
+- Multi-reference image edits use ordered `image[]` fields; single references keep the existing `image` field.
+- Reuse now carries the original reference images. If the source image had references, a confirmation asks whether to replace the current queue or reuse the prompt only.
+- Custom **Library folder**: image/video files can move to another drive. Saving migrates existing files, removes them from the old folder, and rejects invalid, unwritable, nested, or name-conflicting targets.
+- Image right-click menu: copy image to clipboard, download original, copy prompt, and open the containing folder (file is selected in Explorer/Finder).
+- Settings cleanup: removed the read-only workbench data card; maintenance actions now live under「维护」.
+
+### Fixed
+
+- Workbench height now fills the full DSH panel, including the bottom of the rail and composer.
+- Settings copy now distinguishes workbench records from the actual media library folder.
+
+## [0.1.4] - 2026-11-07
+
+Fixed video downloads that returned 401 from gateways which require the same Bearer token on the media URL. The downloader now retries the provider URL with authentication and falls back to the configured content endpoint.
+
+## [0.1.3] - 2026-11-07
+
+Removed external inspiration attribution and the legacy data-directory migration from earlier prototypes. The four workbenches are unchanged.
+
 ## [0.1.2] - 2026-11-07
 
 First npm publication as **@exccoder/dsh-media-workbench**. The package was renamed from the `@modern` scope before publishing; there are no functional changes since 0.1.1. The GitHub `v0.1.1` release is superseded by `v0.1.2`.
@@ -13,7 +39,6 @@ Initial GitHub release under `@modern/dsh-media-workbench`; not published to npm
 ### Added
 
 - Package name `@modern/dsh-media-workbench`, sidebar title「摩登-媒体工作室」with the English label `Modern-MediaStudio`, following the DSH locale.
-- One-time migration from the earlier prototype directory `$DSH_HOME/levelup-workbench/` into `$DSH_HOME/media-workbench-modern/`; the old directory is kept as a backup.
 - **Image Studio**: prompt, negative prompt, nine style presets, six aspect ratios, 1–4 images, reference-image editing through `/images/edits`, favorites, search, history, lightbox, retry/download/reuse.
 - **Writing Studio**: local document library, autosave, Markdown export, selection-aware continue/polish/expand/rewrite/outline/title actions, streaming output with stop/apply/discard.
 - **Star Map**: typed node graph (prompt, writing, image, video, preview, note), drag-to-connect ports, type/single-input/cycle validation, topological parallel execution, run-to-node, undo/redo, templates, user blueprints, JSON import/export, responsive inspector.

package/README.en.md

@@ -9,8 +9,6 @@ A [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH) plug
 
 Writing uses DSH's currently selected model. Image and video providers are configured separately. All works, images, videos and Star Maps stay on this machine. The UI is available in Chinese and English and follows DSH's language and light/dark theme.
 
-Inspired by the creative space in [LevelUpAgent](https://github.com/TippingGame/LevelUpAgent); this is an original implementation for DSH's plugin system.
-
 [中文说明](README.md)
 
 ## Install
@@ -62,7 +60,6 @@ No extra key. Writing uses the model selected in DSH. The plugin does not store
   - `state.json` — images, videos, documents, Star Maps, blueprints
   - `settings.json` — provider endpoints, model names and keys, mode `600`
   - `files/` — generated media and uploaded references
-- If an earlier build used the old directory `~/.dsh/levelup-workbench/`, its settings, works and files are copied once into the new directory on first start. The old directory is kept as a backup and can be deleted after verification.
 - Provider keys never reach the browser; the UI only receives `hasKey` and the last four characters.
 - Write routes validate the DSH connection service and same-origin headers. Static files are whitelisted. Generated files use a strict name pattern.
 - Remote image/video URLs are checked before download; loopback, private, link-local and metadata addresses are rejected.

package/README.md

@@ -2,15 +2,13 @@
 
 一个 DeepSeek Harness（DSH）插件。装上之后，DSH 侧栏会多一个「摩登-媒体工作室」，里面是四个连在一起的工作台：
 
-- **生图工作台**：一句话出图，风格、画幅、数量、参考图、收藏与历史。
+- **生图工作台**：一句话出图，风格、画幅、数量、最多 8 张参考图队列、收藏与历史。
 - **视频工作台**：文生视频、图生视频，以及不消耗视频额度的「分镜短片」。
 - **写作工作台**：作品库、长文编辑器、续写/润色/扩写/改写/大纲/起标题，流式生成。
 - **星图工作台**：把提示词、写作、图像、视频接成 DAG，逐波并行运行，可存成蓝图复用。
 
 写作走 DSH 当前默认模型；生图和视频各自配置自己的接口。作品、图片、视频、星图都留在本机，不上传云端。界面支持中文 / English，并跟随 DSH 的语言和明暗主题。
 
-灵感来自 [LevelUpAgent](https://github.com/TippingGame/LevelUpAgent) 的创作空间，按 DSH 的插件体系重新实现。
-
 GitHub：[ExcCoder/modern-dsh-media-workbench](https://github.com/ExcCoder/modern-dsh-media-workbench)
 
 ## 界面
@@ -51,7 +49,9 @@ dsh plugin --profile desktop add /absolute/path/to/dsh-media-workbench
 2. 填接口地址、模型和密钥，保存，点「试画一张」确认能通。
 3. 回生图工作台写提示词，选风格和画幅，生成。
 
-任何兼容 OpenAI Images API 的服务都能用：`POST {baseUrl}/images/generations`；上传参考图时走 `POST {baseUrl}/images/edits`（multipart，字段 `image`）。返回 `data[0].b64_json`、`images[0].url` 两种常见形状都支持。
+任何兼容 OpenAI Images API 的服务都能用：`POST {baseUrl}/images/generations`；上传参考图时走 `POST {baseUrl}/images/edits`（multipart，单张字段 `image`，多张按顺序用 `image[]`）。返回 `data[0].b64_json`、`images[0].url` 两种常见形状都支持。
+
+参考图支持拖入、文件多选和 **Ctrl+V 粘贴**，最多 8 张，按「图一、图二…」编号，可以上移/下移。图片右键可以复制图片到剪贴板、下载原图、复制提示词或打开所在目录；复用带参考图的记录时会询问是覆盖当前参考图，还是只复用提示词。
 
 ### 视频
 
@@ -92,11 +92,10 @@ dsh plugin --profile desktop add /absolute/path/to/dsh-media-workbench
 
 ## 数据与安全
 
-- 数据目录：`$DSH_HOME/media-workbench-modern/`（默认 `~/.dsh/media-workbench-modern/`）
+- 数据目录：`$DSH_HOME/media-workbench-modern/`（默认 `~/.dsh/media-workbench-modern/`）。图片和视频的文件主目录可以在「设置 → 作品文件目录」换到其他盘，保存时会迁移已有文件并删除旧文件；作品记录和设置仍留在默认数据目录。
   - `state.json`：图片/视频记录、写作文档、星图、蓝图
   - `settings.json`：接口地址、模型、密钥，权限 `600`
   - `files/`：生成的图片、视频和上传的参考图
-- 如果之前装过旧名字的版本，第一次启动会把 `~/.dsh/levelup-workbench/` 里的设置、作品和素材复制一次到新目录；旧目录保留作备份，确认无误后可自行删除。
 - 密钥只存在本机，返回浏览器时只给「有没有密钥」和尾四位。
 - 所有写接口校验同源与 DSH 登录凭据；静态文件只服务 `web/` 白名单；文件下载只接受 `files/` 下的安全文件名。
 - 下载远端图片/视频前会拒绝本机、内网和云元数据地址，避免 SSRF。
@@ -135,8 +134,6 @@ tools/        本地预览和离线验证脚本
 - 发布到 npm / GitHub 的步骤：[PUBLISHING.md](PUBLISHING.md)。
 - npm 包名 `@exccoder/dsh-media-workbench` 使用 npm 账号 `exccoder` 的用户 scope，发布不需要组织权限；改用其他 scope 时需要同步四处包名，见 [PUBLISHING.md](PUBLISHING.md)。
 
-本项目的代码是原创实现；产品灵感来自 LevelUpAgent 的创作空间，未复制其源码或素材。
-
 ## 许可
 
 MIT。与 DeepSeek 官方无关；DSH 的名称和标识归其所有者。

package/lib/client.js

@@ -47,21 +47,49 @@ window.__ModuleLoader__.load({
       const ref = React.useRef(null)
       const [src] = React.useState(() => `${SRC}?lang=${lang}&theme=${scheme}`)
       React.useEffect(() => {
-        const frame = ref.current
-        if (frame) frames.add(frame)
-        return () => { if (frame) frames.delete(frame) }
+        const host = ref.current
+        if (!host) return
+        const frame = document.createElement('iframe')
+        frame.src = src
+        frame.title = TITLE[lang]
+        frame.allow = 'clipboard-write; fullscreen'
+        frame.style.border = '0'
+        frame.style.display = 'block'
+        frame.style.background = 'transparent'
+        frame.style.position = 'fixed'
+        frame.style.zIndex = '1'
+        frame.addEventListener('load', () => {
+          pushTheme(frame)
+          pushLocale(frame)
+        })
+        document.body.appendChild(frame)
+        frames.add(frame)
+        const fit = () => {
+          const box = host.getBoundingClientRect()
+          if (box.width < 200 || box.height < 80) {
+            frame.style.display = 'none'
+            return
+          }
+          frame.style.display = 'block'
+          frame.style.top = `${box.top}px`
+          frame.style.left = `${box.left}px`
+          frame.style.width = `${box.width}px`
+          frame.style.height = `${Math.max(200, window.innerHeight - box.top)}px`
+        }
+        requestAnimationFrame(fit)
+        const timer = setTimeout(fit, 80)
+        const observer = new ResizeObserver(fit)
+        observer.observe(host)
+        window.addEventListener('resize', fit)
+        return () => {
+          clearTimeout(timer)
+          observer.disconnect()
+          window.removeEventListener('resize', fit)
+          frames.delete(frame)
+          frame.remove()
+        }
       }, [])
-      return h('iframe', {
-        ref,
-        src,
-        title: TITLE[lang],
-        allow: 'clipboard-write; fullscreen',
-        onLoad: event => {
-          pushTheme(event.currentTarget)
-          pushLocale(event.currentTarget)
-        },
-        style: { width: '100%', height: '100%', border: 0, display: 'block', background: 'transparent' },
-      })
+      return h('div', { ref, style: { width: '100%', height: '100%', minHeight: '100%' } })
     }
 
     function apply(ctx) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@exccoder/dsh-media-workbench",
-  "version": "0.1.2",
+  "version": "0.2.2",
   "description": "DeepSeek Harness 插件「摩登-媒体工作室」：生图、写作、星图、视频四个工作台，带本机作品库与星图 DAG 编排。",
   "type": "module",
   "main": "src/index.js",

package/src/image.js

@@ -66,7 +66,7 @@ function extraOf(settings) {
 /**
  * 生成一张图。
  * @param {object} settings 插件设置
- * @param {object} request {prompt, style, negative, size, quality, reference, model}
+ * @param {object} request {prompt, style, negative, size, quality, reference, references, model}
  * @param {{signal?: AbortSignal, filesDir?: string}} options
  * @returns {Promise<{buffer: Buffer, ext: string, width: number, height: number, revisedPrompt?: string}>}
  */
@@ -83,15 +83,24 @@ export async function generateImage(settings, request, { signal, filesDir } = {}
   const combined = signal ? AbortSignal.any([signal, timeout]) : timeout
   let result
 
-  if (request.reference && filesDir) {
-    const file = join(filesDir, String(request.reference).replace(/[^\w.-]/g, ''))
-    let buffer
-    try {
-      buffer = await readFile(file)
-    } catch {
-      throw Object.assign(new Error('参考图不存在，重新上传一次'), { status: 400 })
+  const references = (Array.isArray(request.references) ? request.references : request.reference ? [request.reference] : [])
+    .map(name => String(name ?? '').replace(/[^\w.-]/g, ''))
+    .filter(Boolean)
+    .slice(0, 8)
+
+  if (references.length && filesDir) {
+    const images = []
+    for (const name of references) {
+      const file = join(filesDir, name)
+      let buffer
+      try {
+        buffer = await readFile(file)
+      } catch {
+        throw Object.assign(new Error(`参考图不存在：${name}，重新上传一次`), { status: 400 })
+      }
+      const type = extname(file).toLowerCase() === '.jpg' ? 'image/jpeg' : extname(file).toLowerCase() === '.webp' ? 'image/webp' : 'image/png'
+      images.push({ buffer, type, ext: extname(file) || '.png', name })
     }
-    const type = extname(file).toLowerCase() === '.jpg' ? 'image/jpeg' : extname(file).toLowerCase() === '.webp' ? 'image/webp' : 'image/png'
     const form = new FormData()
     form.set('model', model)
     form.set('prompt', prompt)
@@ -99,7 +108,11 @@ export async function generateImage(settings, request, { signal, filesDir } = {}
     if (request.size) form.set('size', request.size)
     if (request.quality) form.set('quality', request.quality)
     for (const [k, v] of Object.entries(extra)) form.set(k, typeof v === 'string' ? v : JSON.stringify(v))
-    form.set('image', new Blob([buffer], { type }), `reference${extname(file) || '.png'}`)
+    if (images.length === 1) {
+      form.set('image', new Blob([images[0].buffer], { type: images[0].type }), `reference${images[0].ext}`)
+    } else {
+      images.forEach((image, index) => form.append('image[]', new Blob([image.buffer], { type: image.type }), `reference-${index + 1}${image.ext}`))
+    }
     const res = await fetch(`${settings.image.baseUrl}/images/edits`, {
       method: 'POST',
       headers: { authorization: `Bearer ${key}` },

package/src/index.js

@@ -1,14 +1,16 @@
 // @exccoder/dsh-media-workbench · host 入口
 // 四个工作台共用一套本机存储：生图 / 视频 / 写作 / 星图
-import { writeFile } from 'node:fs/promises'
-import { dirname, join } from 'node:path'
+import { constants } from 'node:fs'
+import { spawn } from 'node:child_process'
+import { copyFile, mkdir, readdir, stat, unlink, writeFile } from 'node:fs/promises'
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { createNode, dependencyClosure, normalizeGraph, RATIOS, templateGraph, topoWaves } from './graph.js'
 import { apply as applyTools } from './tools.js'
 import { generateImage } from './image.js'
 import { modelInfo, streamText } from './llm.js'
 import { imageReady, IMAGE_PRESETS, publicSettings, Settings, VIDEO_PRESETS, videoReady } from './settings.js'
-import { Store, migrateLegacyData } from './store.js'
+import { Store } from './store.js'
 import { clampInt, extensionOf, fail, imageSize, json, newId, readBuffer, readJson, safeJoin, sendFile, videoExtensionOf } from './util.js'
 import { generateStoryboard, generateVideo } from './video.js'
 import { cleanOutput, writingPrompts } from './writing.js'
@@ -16,7 +18,7 @@ import { cleanOutput, writingPrompts } from './writing.js'
 const ROOT = dirname(fileURLToPath(import.meta.url))
 const WEB_DIR = join(ROOT, '..', 'web')
 const BASE = '/media-workbench-modern'
-const VERSION = '0.1.2'
+const VERSION = '0.2.2'
 
 const STATIC = new Map([
   ['', 'index.html'],
@@ -55,11 +57,18 @@ export function apply(ctx) {
   const graphJobs = new Map()
   let settled = false
 
-  // 第一次改名后，把旧目录的数据复制一次；不阻塞页面静态资源
-  const ready = migrateLegacyData(store.root).catch(err => {
-    console.warn('[media-workbench-modern] legacy data migration failed:', err.message)
-    return false
-  })
+  const defaultFilesDir = join(store.root, 'files')
+  const ready = (async () => {
+    const current = await settings.read()
+    const outputDir = current.storage?.outputDir?.trim()
+    if (!outputDir) { await store.useFilesDir(defaultFilesDir); return }
+    try {
+      await store.useFilesDir(outputDir)
+    } catch (err) {
+      console.warn('[media-workbench-modern] custom library folder unavailable:', err.message)
+      await store.useFilesDir(defaultFilesDir)
+    }
+  })()
 
   const settleOnce = async () => {
     await ready
@@ -70,10 +79,60 @@ export function apply(ctx) {
 
   const saveImageBuffer = async (id, result) => {
     const file = `${id}${result.ext}`
-    await writeFile(join(store.filesDir, file), result.buffer)
+    await saveOutput(file, result.buffer)
     return file
   }
 
+  async function saveOutput(name, buffer) {
+    await writeFile(join(store.filesDir, name), buffer)
+  }
+
+  async function fileExists(path) {
+    try { await stat(path); return true } catch { return false }
+  }
+
+  async function switchFilesDir(target) {
+    const from = resolve(store.filesDir)
+    const to = resolve(target || defaultFilesDir)
+    if (to === from) { await store.useFilesDir(to); return }
+    if (to.startsWith(from + sep)) throw fail('作品目录不能选在当前作品库里面', 400)
+    await mkdir(to, { recursive: true })
+    let entries = []
+    try { entries = await readdir(from, { withFileTypes: true }) } catch (err) {
+      if (err.code !== 'ENOENT') throw err
+    }
+    const moved = []
+    try {
+      for (const entry of entries) {
+        if (!entry.isFile()) continue
+        const source = join(from, entry.name)
+        const destination = join(to, entry.name)
+        let created = true
+        try {
+          await copyFile(source, destination, constants.COPYFILE_EXCL)
+        } catch (err) {
+          if (err.code === 'EEXIST') throw fail(`目标目录已有同名文件：${entry.name}，请换一个空目录`, 400)
+          throw err
+        }
+        await unlink(source)
+        moved.push({ name: entry.name, created })
+      }
+    } catch (err) {
+      for (const item of moved.reverse()) {
+        const source = join(from, item.name)
+        const destination = join(to, item.name)
+        try {
+          if (!(await fileExists(source)) && await fileExists(destination)) await copyFile(destination, source)
+          if (item.created) await unlink(destination).catch(() => {})
+        } catch (rollbackError) {
+          console.warn('[media-workbench-modern] file migration rollback failed:', rollbackError.message)
+        }
+      }
+      throw err
+    }
+    await store.useFilesDir(to)
+  }
+
   const updateImage = (id, patch) => store.mutate(state => {
     const row = state.images.find(item => item.id === id)
     if (!row) return null
@@ -115,6 +174,10 @@ export function apply(ctx) {
     const ratio = RATIOS[body.ratio]
     const size = String(body.size ?? '').trim() || ratio?.size || current.image.size
     const reference = typeof body.reference === 'string' ? body.reference.replace(/[^\w.-]/g, '') : ''
+    const references = (Array.isArray(body.references) ? body.references : reference ? [reference] : [])
+      .map(name => String(name ?? '').replace(/[^\w.-]/g, ''))
+      .filter(Boolean)
+      .slice(0, 8)
     const records = []
     for (let i = 0; i < count; i++) {
       records.push({
@@ -124,7 +187,8 @@ export function apply(ctx) {
         style: String(body.style ?? '').slice(0, 40),
         model: String(body.model ?? current.image.model).slice(0, 120),
         size,
-        reference,
+        reference: references[0] ?? '',
+        references,
         file: '',
         width: 0,
         height: 0,
@@ -193,7 +257,7 @@ export function apply(ctx) {
         const frames = []
         for (const [index, frame] of result.frames.entries()) {
           const name = `vid_${id}_${index + 1}${frame.ext}`
-          await writeFile(join(store.filesDir, name), frame.buffer)
+          await saveOutput(name, frame.buffer)
           frames.push(name)
         }
         await patch({
@@ -210,7 +274,7 @@ export function apply(ctx) {
           onProgress: progress => { void patch({ progress }) },
         })
         const name = `vid_${id}${result.ext || videoExtensionOf(result.buffer)}`
-        await writeFile(join(store.filesDir, name), result.buffer)
+        await saveOutput(name, result.buffer)
         await patch({ status: 'done', progress: 100, file: name })
       }
     } catch (err) {
@@ -423,7 +487,7 @@ export function apply(ctx) {
         reference: reference?.kind === 'image' ? reference.file : undefined,
       }, { signal: controller.signal, filesDir: store.filesDir })
       const name = `node_${node.id}_${Date.now().toString(36)}${result.ext}`
-      await writeFile(join(store.filesDir, name), result.buffer)
+      await saveOutput(name, result.buffer)
       return { kind: 'image', file: name, width: result.width, height: result.height }
     }
     if (node.type === 'video') {
@@ -446,7 +510,7 @@ export function apply(ctx) {
         const frames = []
         for (const [index, frame] of result.frames.entries()) {
           const name = `node_${node.id}_${index + 1}${frame.ext}`
-          await writeFile(join(store.filesDir, name), frame.buffer)
+          await saveOutput(name, frame.buffer)
           frames.push(name)
         }
         return { kind: 'video', file: '', frames, poster: frames[0] ?? '', storyboard: true }
@@ -454,7 +518,7 @@ export function apply(ctx) {
       if (!videoReady(appSettings)) throw new Error('未配置视频服务，可把节点模式改成「分镜」')
       const result = await generateVideo(appSettings, record, { signal: controller.signal, filesDir: store.filesDir })
       const name = `node_${node.id}_${Date.now().toString(36)}${result.ext || videoExtensionOf(result.buffer)}`
-      await writeFile(join(store.filesDir, name), result.buffer)
+      await saveOutput(name, result.buffer)
       return { kind: 'video', file: name }
     }
     throw new Error(`不支持的节点类型：${node.type}`)
@@ -559,8 +623,40 @@ export function apply(ctx) {
 
     const body = await readJson(req)
 
+    if (api === 'reveal') {
+      const name = String(body.file ?? '').trim()
+      if (!/^[\w.-]+$/.test(name)) return json(res, 400, { error: '文件名无效' })
+      const file = join(store.filesDir, name)
+      const rel = relative(store.filesDir, file)
+      if (!rel || rel.startsWith('..') || isAbsolute(rel)) return json(res, 400, { error: '路径无效' })
+      try { await stat(file) } catch { return json(res, 404, { error: '文件不存在' }) }
+      try {
+        if (process.platform === 'win32') {
+          const child = spawn('explorer.exe', ['/select,', file], { detached: true, stdio: 'ignore' })
+          child.on('error', () => {})
+          child.unref()
+        } else if (process.platform === 'darwin') {
+          spawn('open', ['-R', file], { detached: true, stdio: 'ignore' }).unref()
+        } else {
+          spawn('xdg-open', [dirname(file)], { detached: true, stdio: 'ignore' }).unref()
+        }
+      } catch (err) {
+        return json(res, 500, { error: `打开目录失败：${err.message}` })
+      }
+      return json(res, 200, { ok: true })
+    }
     if (api === 'settings') {
+      const previous = await settings.read()
+      const changingDir = Boolean(body.storage && Object.prototype.hasOwnProperty.call(body.storage, 'outputDir'))
       const next = await settings.update(body)
+      if (changingDir) {
+        try {
+          await switchFilesDir(next.storage?.outputDir)
+        } catch (err) {
+          await settings.update({ storage: { outputDir: previous.storage?.outputDir ?? '' } }).catch(() => {})
+          throw err
+        }
+      }
       return json(res, 200, { settings: publicSettings(next) })
     }
     if (api === 'settings/test-image') {

package/src/settings.js

@@ -1,5 +1,6 @@
 // 插件设置：接口地址、模型、密钥。密钥只留本机，返回浏览器时永远脱敏。
-import { chmod, readFile, rename, writeFile } from 'node:fs/promises'
+import { access, chmod, mkdir, readFile, rename, unlink, writeFile } from 'node:fs/promises'
+import { constants } from 'node:fs'
 import { join } from 'node:path'
 
 export const IMAGE_PRESETS = [
@@ -37,6 +38,9 @@ const DEFAULTS = {
     extra: '',
   },
   language: 'auto',
+  storage: {
+    outputDir: '',
+  },
 }
 
 function trim(value, max = 300) {
@@ -66,6 +70,28 @@ function normalizePath(value, fallback, max = 200) {
   return text
 }
 
+function normalizeOutputDir(value) {
+  if (value === undefined) return undefined
+  if (typeof value !== 'string') {
+    const err = new Error('产物目录要是文本路径')
+    err.status = 400
+    throw err
+  }
+  let dir = value.trim()
+  if (/^[a-zA-Z]:[\\/]?$/.test(dir)) {
+    dir = `${dir.slice(0, 2)}\\`
+  } else {
+    dir = dir.replace(/[\\/]+$/, '')
+  }
+  if (!dir) return ''
+  if (!/^(?:[a-zA-Z]:[\\/]|\/)/.test(dir)) {
+    const err = new Error('产物目录要填绝对路径，例如 D:\\AI作品')
+    err.status = 400
+    throw err
+  }
+  return dir
+}
+
 function normalizeExtra(value) {
   if (value === undefined) return undefined
   if (typeof value !== 'string') {
@@ -104,6 +130,7 @@ export class Settings {
         ...saved,
         image: { ...DEFAULTS.image, ...(saved.image ?? {}) },
         video: { ...DEFAULTS.video, ...(saved.video ?? {}) },
+        storage: { ...DEFAULTS.storage, ...(saved.storage ?? {}) },
       }
     } catch (err) {
       if (err.code !== 'ENOENT') throw err
@@ -144,6 +171,25 @@ export class Settings {
     if (typeof video.apiKey === 'string' && video.apiKey.trim()) next.video.apiKey = video.apiKey.trim().slice(0, 500)
     if (video.clearKey === true) next.video.apiKey = ''
 
+    const storage = patch.storage ?? {}
+    const outputDir = normalizeOutputDir(storage.outputDir)
+    if (outputDir !== undefined) {
+      if (outputDir) {
+        try {
+          await mkdir(outputDir, { recursive: true })
+          await access(outputDir, constants.W_OK)
+          const probe = join(outputDir, `.media-workbench-write-test-${process.pid}`)
+          await writeFile(probe, '')
+          await unlink(probe).catch(() => {})
+        } catch {
+          const err = new Error('产物目录不可写，换一个目录')
+          err.status = 400
+          throw err
+        }
+      }
+      next.storage.outputDir = outputDir
+    }
+
     if (['auto', 'zh', 'en'].includes(patch.language)) next.language = patch.language
 
     const tmp = `${this.file}.${process.pid}.tmp`

package/src/store.js

@@ -1,5 +1,5 @@
 // 本机持久化：$DSH_HOME/media-workbench-modern/state.json
-import { chmod, cp, mkdir, readFile, rename, stat, writeFile } from 'node:fs/promises'
+import { mkdir, readFile, rename, stat, writeFile } from 'node:fs/promises'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { templateGraph } from './graph.js'
@@ -10,48 +10,6 @@ export function dshHome(env = process.env) {
   return env.DSH_HOME || join(homedir(), '.dsh')
 }
 
-/** 改名前的旧目录，只用于一次性迁移 */
-export function legacyRoot(env = process.env) {
-  return join(dshHome(env), 'levelup-workbench')
-}
-
-/**
- * 从旧插件目录复制一次数据（settings / state / files）。
- * 旧目录保留作备份；新目录已经有 state.json 时不再迁移。
- * @returns {Promise<boolean>} 是否执行了迁移
- */
-export async function migrateLegacyData(root, env = process.env) {
-  const legacy = legacyRoot(env)
-  if (root === legacy) return false
-  try {
-    await stat(join(root, 'state.json'))
-    return false
-  } catch (err) {
-    if (err.code !== 'ENOENT') throw err
-  }
-  try {
-    await stat(join(legacy, 'state.json'))
-  } catch (err) {
-    if (err.code === 'ENOENT') return false
-    throw err
-  }
-  await mkdir(root, { recursive: true })
-  // 先素材、再设置、最后 state：中途失败时下次还能重试
-  for (const name of ['files', 'settings.json', 'state.json']) {
-    const target = join(root, name)
-    try {
-      await stat(target)
-      continue
-    } catch (err) {
-      if (err.code !== 'ENOENT') throw err
-    }
-    await cp(join(legacy, name), target, { recursive: true, force: false, errorOnExist: false })
-  }
-  await writeFile(join(root, '.migrated-from'), `${legacy}\n`, { mode: 0o600 })
-  await chmod(join(root, 'settings.json'), 0o600).catch(() => {})
-  return true
-}
-
 const WELCOME = `写作不是一次成形的。
 
 先把脑子里的画面写下来，不用管顺序；等它有了轮廓，再回头删掉多余的解释。留下动作、声音、光线，和人物没有说出口的那句话。
@@ -123,6 +81,9 @@ export function normalizeState(input) {
 
 function normalizeImage(row) {
   const status = ['queued', 'running', 'done', 'error'].includes(row.status) ? row.status : 'done'
+  const references = (Array.isArray(row.references) ? row.references : row.reference ? [row.reference] : [])
+    .filter(name => typeof name === 'string' && name)
+    .slice(0, 8)
   return {
     id: row.id,
     prompt: String(row.prompt ?? ''),
@@ -131,7 +92,8 @@ function normalizeImage(row) {
     model: String(row.model ?? ''),
     provider: String(row.provider ?? ''),
     size: String(row.size ?? ''),
-    reference: String(row.reference ?? ''),
+    reference: String(row.reference ?? references[0] ?? ''),
+    references,
     file: String(row.file ?? ''),
     width: Number(row.width) || 0,
     height: Number(row.height) || 0,
@@ -184,6 +146,11 @@ export class Store {
     this.queue = Promise.resolve()
   }
 
+  async useFilesDir(dir) {
+    this.filesDir = dir
+    await mkdir(dir, { recursive: true })
+  }
+
   async refresh() {
     await mkdir(this.filesDir, { recursive: true })
     let info = null

package/src/video.js

@@ -64,6 +64,25 @@ function progressOf(data) {
   return Math.max(0, Math.min(100, n <= 1 ? Math.round(n * 100) : Math.round(n)))
 }
 
+function sameSite(a, b) {
+  try {
+    const ha = new URL(a).hostname.toLowerCase()
+    const hb = new URL(b).hostname.toLowerCase()
+    return ha === hb || ha.endsWith(`.${hb}`) || hb.endsWith(`.${ha}`)
+  } catch {
+    return false
+  }
+}
+
+async function fetchRemoteVideo(url, settings, key, signal) {
+  let res = await fetch(url, { signal })
+  if (!res.ok && (res.status === 401 || res.status === 403) && sameSite(url, settings.video.baseUrl)) {
+    await res.body?.cancel().catch(() => {})
+    res = await fetch(url, { headers: { authorization: `Bearer ${key}` }, signal })
+  }
+  return res
+}
+
 async function fetchVideoContent(settings, key, id, signal) {
   const path = settings.video.contentPath.replace('{id}', encodeURIComponent(id))
   const res = await fetch(`${settings.video.baseUrl}${path}`, { headers: { authorization: `Bearer ${key}` }, signal })
@@ -164,9 +183,16 @@ export async function generateVideo(settings, record, { signal, filesDir, onProg
   const url = findUrl(final)
   if (url) {
     const remote = assertRemoteUrl(url)
-    const download = await fetch(remote, { signal: combined })
-    if (!download.ok) throw new Error(`下载视频失败（${download.status}）`)
-    buffer = Buffer.from(await download.arrayBuffer())
+    const download = await fetchRemoteVideo(remote, settings, key, combined)
+    if (download.ok) {
+      buffer = Buffer.from(await download.arrayBuffer())
+    } else if (id && settings.video.contentPath) {
+      // 有些网关返回的下载地址需要额外鉴权或已经过期，回退到内容的官方路径。
+      await download.body?.cancel().catch(() => {})
+      buffer = await fetchVideoContent(settings, key, id, combined)
+    } else {
+      throw new Error(`下载视频失败（${download.status}）`)
+    }
   } else if (id && settings.video.contentPath) {
     buffer = await fetchVideoContent(settings, key, id, combined)
   }

package/web/lib/dom.js

@@ -78,6 +78,33 @@ export async function copyText(text) {
   }
 }
 
+async function blobToPng(blob) {
+  if (blob.type === 'image/png') return blob
+  const bitmap = await createImageBitmap(blob)
+  try {
+    const canvas = document.createElement('canvas')
+    canvas.width = bitmap.width
+    canvas.height = bitmap.height
+    const context = canvas.getContext('2d')
+    if (!context) throw new Error('Canvas is unavailable')
+    context.drawImage(bitmap, 0, 0)
+    return await new Promise((resolve, reject) => {
+      canvas.toBlob(next => next ? resolve(next) : reject(new Error('Could not encode PNG')), 'image/png')
+    })
+  } finally {
+    bitmap.close?.()
+  }
+}
+
+export async function copyImage(url) {
+  if (!navigator.clipboard?.write || typeof ClipboardItem === 'undefined') throw new Error('此环境不支持复制图片')
+  const response = await fetch(new URL(url, location.href), { credentials: 'same-origin' })
+  if (!response.ok) throw new Error(`图片读取失败（${response.status}）`)
+  const png = await blobToPng(await response.blob())
+  await navigator.clipboard.write([new ClipboardItem({ 'image/png': png })])
+  return true
+}
+
 export function downloadJson(data, filename) {
   const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' })
   const url = URL.createObjectURL(blob)

package/web/styles.css

@@ -104,9 +104,11 @@ pre { font-family: var(--mono); }
 
 /* ---------- 壳 ---------- */
 .app-shell {
-  height: 100vh;
+  height: 100%;
+  min-height: 100vh;
   display: grid;
   grid-template-columns: var(--rail) minmax(0, 1fr);
+  grid-template-rows: minmax(0, 1fr);
   background: var(--bg);
 }
 
@@ -165,7 +167,14 @@ pre { font-family: var(--mono); }
 }
 .rail-btn { position: relative; }
 
-.rail-foot { margin-top: auto; display: flex; flex-direction: column; gap: 2px; }
+.rail-foot {
+  margin-top: auto;
+  padding-top: 10px;
+  border-top: 1px solid var(--line);
+  display: flex;
+  flex-direction: column;
+  gap: 2px;
+}
 .rail-theme { min-height: 38px; }
 
 .workspace {
@@ -434,6 +443,15 @@ textarea { resize: vertical; line-height: 1.6; min-height: 44px; }
   overflow: hidden;
 }
 .drop:hover, .drop.is-over { border-color: var(--accent); background: var(--accent-soft); }
+.ref-drop { display: block; padding: 8px; }
+.ref-list { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 6px; width: 100%; }
+.ref-item { position: relative; margin: 0; aspect-ratio: 1; min-width: 0; overflow: hidden; border-radius: 9px; background: var(--surface-3); }
+.ref-item img { width: 100%; height: 100%; object-fit: cover; }
+.ref-badge { position: absolute; left: 5px; top: 5px; padding: 2px 5px; border-radius: 5px; background: rgba(20, 16, 12, 0.65); color: #fff; font-size: 9px; line-height: 1.35; pointer-events: none; }
+.ref-tools { position: absolute; right: 4px; bottom: 4px; display: flex; gap: 2px; }
+.ref-tools button { width: 20px; height: 20px; border-radius: 5px; background: rgba(20, 16, 12, 0.62); color: #fff; display: grid; place-items: center; font-size: 11px; line-height: 1; }
+.ref-tools button:hover { background: rgba(20, 16, 12, 0.85); }
+.ref-tools button:disabled { opacity: 0.3; }
 .drop-empty { display: flex; flex-direction: column; align-items: center; gap: 5px; color: var(--muted); font-size: 11.5px; text-align: center; padding: 14px; }
 .drop-empty small { font-size: 10.5px; opacity: 0.8; }
 .drop-preview { position: absolute; inset: 0; }
@@ -616,6 +634,35 @@ textarea { resize: vertical; line-height: 1.6; min-height: 44px; }
 .lb-meta b { font-weight: 550; color: var(--ink-2); text-align: right; max-width: 65%; overflow: hidden; text-overflow: ellipsis; }
 .lb-actions { display: grid; grid-template-columns: 1fr 1fr; gap: 7px; margin-top: auto; }
 .lb-actions .btn { height: 34px; font-size: 12px; }
+
+.image-menu {
+  position: fixed;
+  z-index: 1200;
+  min-width: 184px;
+  padding: 5px;
+  border: 1px solid var(--line);
+  border-radius: 10px;
+  background: var(--surface);
+  box-shadow: var(--shadow);
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+.image-menu button {
+  width: 100%;
+  min-height: 32px;
+  padding: 0 10px;
+  border-radius: 7px;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  text-align: left;
+  font-size: 12px;
+  color: var(--ink-2);
+}
+.image-menu button:hover { background: var(--surface-2); color: var(--ink); }
+.image-menu button .ic { color: var(--muted); }
+.image-menu-sep { height: 1px; margin: 4px 6px; background: var(--line); }
 .lb-close { position: absolute; top: 12px; right: 12px; z-index: 3; width: 32px; height: 32px; border-radius: 9px; background: rgba(20, 16, 12, 0.45); color: #fff; display: grid; place-items: center; }
 .lb-close:hover { background: rgba(20, 16, 12, 0.7); }
 .lb-nav { position: absolute; top: 50%; transform: translateY(-50%); z-index: 3; width: 38px; height: 58px; border-radius: 10px; background: rgba(20, 16, 12, 0.35); color: #fff; display: grid; place-items: center; }

package/web/views/image.js

@@ -1,5 +1,5 @@
 import { api, fileUrl, upload } from '../lib/api.js'
-import { $, $$, autoGrow, copyText, downloadUrl, esc, fmtTime, modKey } from '../lib/dom.js'
+import { $, $$, autoGrow, copyImage, copyText, downloadUrl, esc, fmtTime, modKey } from '../lib/dom.js'
 import { icon } from '../lib/icons.js'
 import { app, t } from '../lib/state.js'
 import { INSPIRATIONS, RATIOS, STYLE_LABELS_EN, STYLES } from '../lib/constants.js'
@@ -9,7 +9,7 @@ export function mount(root) {
   let style = prefs.imageStyle ?? '电影感'
   let ratio = RATIOS.some(r => r.id === prefs.imageRatio) ? prefs.imageRatio : '16:9'
   let count = Math.min(4, Math.max(1, Number(prefs.imageCount) || 1))
-  let reference = null
+  let references = []
   let filter = 'all'
   let query = ''
   let busy = false
@@ -18,6 +18,74 @@ export function mount(root) {
   const inspoTitle = item => (app.lang === 'en' ? item.titleEn : item.title)
   const inspoPrompt = item => (app.lang === 'en' ? item.promptEn : item.prompt)
 
+  let imageMenu = null
+  let imageMenuOff = null
+
+  function closeImageMenu() {
+    if (imageMenu) imageMenu.remove()
+    imageMenu = null
+    imageMenuOff?.()
+    imageMenuOff = null
+  }
+
+  function showImageMenu(event, row) {
+    if (!row?.file) return
+    closeImageMenu()
+    const menu = document.createElement('div')
+    menu.className = 'image-menu'
+    menu.setAttribute('role', 'menu')
+    menu.innerHTML = `
+      <button type="button" role="menuitem" data-image-menu="copy">${icon('copy', 14)}${esc(t('复制图片', 'Copy image'))}</button>
+      <button type="button" role="menuitem" data-image-menu="download">${icon('download', 14)}${esc(t('下载原图', 'Download original'))}</button>
+      <button type="button" role="menuitem" data-image-menu="reveal">${icon('folder', 14)}${esc(t('打开文件所在目录', 'Open containing folder'))}</button>
+      <span class="image-menu-sep"></span>
+      <button type="button" role="menuitem" data-image-menu="prompt">${icon('pen', 14)}${esc(t('复制提示词', 'Copy prompt'))}</button>
+    `
+    document.body.appendChild(menu)
+    const box = menu.getBoundingClientRect()
+    menu.style.left = `${Math.max(8, Math.min(event.clientX, innerWidth - box.width - 8))}px`
+    menu.style.top = `${Math.max(8, Math.min(event.clientY, innerHeight - box.height - 8))}px`
+    imageMenu = menu
+
+    const onOutside = next => {
+      if (!menu.contains(next.target)) closeImageMenu()
+    }
+    const onKey = next => { if (next.key === 'Escape') closeImageMenu() }
+    const onScroll = () => closeImageMenu()
+    window.addEventListener('pointerdown', onOutside, true)
+    window.addEventListener('keydown', onKey)
+    window.addEventListener('scroll', onScroll, true)
+    window.addEventListener('blur', onScroll)
+    imageMenuOff = () => {
+      window.removeEventListener('pointerdown', onOutside, true)
+      window.removeEventListener('keydown', onKey)
+      window.removeEventListener('scroll', onScroll, true)
+      window.removeEventListener('blur', onScroll)
+    }
+
+    menu.querySelectorAll('[data-image-menu]').forEach(button => {
+      button.addEventListener('click', async () => {
+        const action = button.dataset.imageMenu
+        closeImageMenu()
+        try {
+          if (action === 'copy') {
+            await copyImage(fileUrl(row.file))
+            app.toast(t('图片已复制到剪贴板', 'Image copied to clipboard'), 'success')
+          } else if (action === 'download') {
+            downloadUrl(fileUrl(row.file), `modern-media-${row.id}${row.file?.match(/\.\w+$/)?.[0] ?? '.png'}`)
+          } else if (action === 'reveal') {
+            await api('reveal', { file: row.file })
+          } else if (action === 'prompt') {
+            const ok = await copyText(row.prompt)
+            app.toast(ok ? t('提示词已复制', 'Prompt copied') : t('复制失败', 'Copy failed'), ok ? 'success' : 'error')
+          }
+        } catch (err) {
+          app.toast(err.message || t('复制失败', 'Copy failed'), 'error')
+        }
+      })
+    })
+  }
+
   root.innerHTML = `
     <section class="bench bench-image">
       <aside class="composer" id="composer">
@@ -68,10 +136,10 @@ export function mount(root) {
         <details class="advanced" id="advanced">
           <summary>${icon('layers', 14)}<span>${esc(t('参考图与高级参数', 'Reference & advanced'))}</span>${icon('chevron', 14)}</summary>
           <div class="advanced-body">
-            <div class="drop" id="drop" tabindex="0" role="button" aria-label="${esc(t('上传参考图', 'Upload reference'))}">
-              <input type="file" id="ref-input" accept="image/png,image/jpeg,image/webp" hidden>
-              <div class="drop-empty">${icon('upload', 18)}<span>${esc(t('拖入或选择一张参考图', 'Drop or choose a reference image'))}</span><small>${esc(t('会走图生图 / 编辑接口', 'Uses the image edit endpoint'))}</small></div>
-              <div class="drop-preview" id="drop-preview" hidden><img id="ref-img" alt=""><button type="button" class="mini-x" id="ref-clear" aria-label="移除">${icon('x', 12)}</button></div>
+            <div class="drop ref-drop" id="drop" tabindex="0" role="button" aria-label="${esc(t('上传参考图', 'Upload reference'))}">
+              <input type="file" id="ref-input" accept="image/png,image/jpeg,image/webp" multiple hidden>
+              <div class="drop-empty" id="ref-empty">${icon('upload', 18)}<span>${esc(t('拖入、选择或 Ctrl+V 粘贴参考图', 'Drop, choose or paste (Ctrl+V) reference images'))}</span><small>${esc(t('最多 8 张，按顺序对应图一、图二', 'Up to 8 images, ordered as figure 1, 2…'))}</small></div>
+              <div class="ref-list" id="ref-list"></div>
             </div>
             <label class="field">
               <span class="field-label">${esc(t('反向提示词', 'Negative prompt'))}</span>
@@ -153,16 +221,56 @@ export function mount(root) {
     if (event.target.closest('[data-act="settings"]')) app.navigate('settings')
   })
 
-  // 参考图
+  // 参考图队列：最多 8 张，可粘贴、拖入、排序
   const refInput = $('#ref-input')
   const drop = $('#drop')
+  const refList = $('#ref-list')
+  const refEmpty = $('#ref-empty')
   const pickRef = () => refInput.click()
-  drop.addEventListener('click', event => { if (!event.target.closest('#ref-clear')) pickRef() })
-  drop.addEventListener('keydown', event => { if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); pickRef() } })
+
+  function renderReferences() {
+    const label = index => app.lang === 'en' ? `Fig. ${index + 1}` : `图${'一二三四五六七八'[index] ?? index + 1}`
+    refEmpty.hidden = references.length > 0
+    refList.innerHTML = references.map((ref, index) => `
+      <figure class="ref-item" data-ref-index="${index}">
+        <img src="${esc(ref.url)}" alt="${esc(label(index))}">
+        <span class="ref-badge">${esc(label(index))}</span>
+        <span class="ref-tools">
+          <button type="button" data-ref-act="up" title="${esc(t('上移', 'Move up'))}" ${index === 0 ? 'disabled' : ''}>↑</button>
+          <button type="button" data-ref-act="down" title="${esc(t('下移', 'Move down'))}" ${index === references.length - 1 ? 'disabled' : ''}>↓</button>
+          <button type="button" data-ref-act="remove" title="${esc(t('移除', 'Remove'))}">${icon('x', 11)}</button>
+        </span>
+      </figure>`).join('')
+  }
+
+  async function addReferences(files) {
+    const images = [...files].filter(file => file?.type?.startsWith('image/'))
+    if (!images.length) return
+    const room = 8 - references.length
+    if (room <= 0) return app.toast(t('最多 8 张参考图', 'Up to 8 references'), 'error')
+    for (const file of images.slice(0, room)) {
+      try {
+        const result = await upload(file)
+        references.push(result)
+        renderReferences()
+      } catch (err) {
+        app.toast(err.message, 'error')
+      }
+    }
+    if (images.length > room) app.toast(t('最多 8 张参考图，多出的已忽略', 'Up to 8 references; extras ignored'), 'error')
+  }
+
+  renderReferences()
+  drop.addEventListener('click', event => {
+    if (event.target.closest('.ref-item')) return
+    pickRef()
+  })
+  drop.addEventListener('keydown', event => {
+    if (event.target.closest('.ref-item')) return
+    if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); pickRef() }
+  })
   refInput.addEventListener('change', async () => {
-    const file = refInput.files?.[0]
-    if (!file) return
-    await handleReference(file)
+    await addReferences([...(refInput.files ?? [])])
     refInput.value = ''
   })
   for (const type of ['dragenter', 'dragover']) {
@@ -172,30 +280,38 @@ export function mount(root) {
     drop.addEventListener(type, event => { event.preventDefault(); drop.classList.remove('is-over') })
   }
   drop.addEventListener('drop', event => {
-    const file = [...(event.dataTransfer?.files ?? [])].find(f => f.type.startsWith('image/'))
-    if (file) handleReference(file)
+    addReferences([...(event.dataTransfer?.files ?? [])])
   })
-  $('#ref-clear').addEventListener('click', event => {
+  refList.addEventListener('click', event => {
+    const button = event.target.closest('[data-ref-act]')
+    if (!button) return
     event.stopPropagation()
-    reference = null
-    $('#drop-preview').hidden = true
-    $('#drop').querySelector('.drop-empty').hidden = false
+    const index = Number(button.closest('.ref-item')?.dataset.refIndex)
+    if (!Number.isInteger(index) || !references[index]) return
+    if (button.dataset.refAct === 'remove') references.splice(index, 1)
+    if (button.dataset.refAct === 'up' && index > 0) {
+      [references[index - 1], references[index]] = [references[index], references[index - 1]]
+    }
+    if (button.dataset.refAct === 'down' && index < references.length - 1) {
+      [references[index + 1], references[index]] = [references[index], references[index + 1]]
+    }
+    renderReferences()
   })
 
-  async function handleReference(file) {
-    if (!file.type.startsWith('image/')) return app.toast(t('请选图片文件', 'Choose an image file'), 'error')
-    try {
-      const result = await upload(file)
-      reference = result
-      const img = $('#ref-img')
-      img.src = result.url
-      $('#drop-preview').hidden = false
-      $('#drop').querySelector('.drop-empty').hidden = true
-      app.toast(t('参考图已加入', 'Reference added'), 'success')
-    } catch (err) {
-      app.toast(err.message, 'error')
+  function onPaste(event) {
+    if (!drop.isConnected) {
+      document.removeEventListener('paste', onPaste)
+      return
     }
+    const files = [...(event.clipboardData?.items ?? [])]
+      .filter(item => item.type.startsWith('image/'))
+      .map(item => item.getAsFile())
+      .filter(Boolean)
+    if (!files.length) return
+    event.preventDefault()
+    addReferences(files)
   }
+  document.addEventListener('paste', onPaste)
 
   function paintChoices() {
     $$('#styles [data-style]').forEach(btn => btn.classList.toggle('is-on', btn.dataset.style === style))
@@ -295,6 +411,45 @@ export function mount(root) {
     galleryEl.innerHTML = list.map(card).join('')
   }
 
+  async function reuseImage(row) {
+    const original = (Array.isArray(row.references) && row.references.length ? row.references : row.reference ? [row.reference] : [])
+      .filter(name => typeof name === 'string' && name)
+      .slice(0, 8)
+    let usedReferences = false
+    if (original.length) {
+      const useReferences = await app.confirm({
+        title: t('这张图带了参考图', 'This image has references'),
+        message: t(
+          `这张图用了 ${original.length} 张参考图。要一起复用吗？选「覆盖参考图」会替换当前队列；选「只用提示词」会保留当前参考图。`,
+          `This image used ${original.length} reference image(s). Reuse them too? Choose "Use references" to replace the current queue, or "Prompt only" to keep what you have.`,
+        ),
+        confirmText: t('覆盖参考图', 'Use references'),
+        cancelText: t('只用提示词', 'Prompt only'),
+      })
+      if (useReferences) {
+        references = original.map(name => ({ name, url: fileUrl(name) }))
+        renderReferences()
+        usedReferences = true
+      }
+    } else {
+      references = []
+      renderReferences()
+    }
+    promptEl.value = row.prompt
+    promptEl.dispatchEvent(new Event('input'))
+    if (row.style && STYLES.includes(row.style)) style = row.style
+    if (row.size?.includes('x')) {
+      const match = RATIOS.find(item => item.hint.replaceAll(' × ', 'x') === row.size)
+      if (match) ratio = match.id
+    }
+    paintChoices()
+    promptEl.focus()
+    app.toast(
+      usedReferences ? t('已复用提示词和参考图', 'Prompt and references loaded') : t('已复用提示词', 'Prompt loaded'),
+      'success',
+    )
+  }
+
   galleryEl.addEventListener('click', async event => {
     const btn = event.target.closest('[data-act]')
     if (!btn) return
@@ -317,16 +472,7 @@ export function mount(root) {
       return
     }
     if (act === 'reuse') {
-      promptEl.value = row.prompt
-      promptEl.dispatchEvent(new Event('input'))
-      if (row.style && STYLES.includes(row.style)) style = row.style
-      if (row.size?.includes('x')) {
-        const match = RATIOS.find(item => item.hint.replaceAll(' × ', 'x') === row.size)
-        if (match) ratio = match.id
-      }
-      paintChoices()
-      promptEl.focus()
-      app.toast(t('已填入提示词', 'Prompt loaded'), 'success')
+      await reuseImage(row)
       return
     }
     if (act === 'retry') {
@@ -353,6 +499,16 @@ export function mount(root) {
     openLightbox(media.dataset.id)
   })
 
+  galleryEl.addEventListener('contextmenu', event => {
+    const media = event.target.closest('.shot-media')
+    const image = event.target.closest('.shot-media img')
+    if (!media || !image) return
+    const row = (app.state?.images ?? []).find(item => item.id === media.closest('.shot')?.dataset.id)
+    if (!row) return
+    event.preventDefault()
+    showImageMenu(event, row)
+  })
+
   galleryEl.addEventListener('click', event => {
     const inspo = event.target.closest('[data-inspo]')
     if (!inspo) return
@@ -390,6 +546,7 @@ export function mount(root) {
           </div>
           <div class="lb-actions">
             <button class="btn btn-primary" data-lb="download">${icon('download', 15)}${esc(t('下载', 'Download'))}</button>
+            <button class="btn btn-ghost" data-lb="copy-image">${icon('copy', 15)}${esc(t('复制图片', 'Copy image'))}</button>
             <button class="btn btn-ghost" data-lb="fav">${icon('heart', 15)}${row.favorite ? t('取消收藏', 'Unsave') : t('收藏', 'Save')}</button>
             <button class="btn btn-ghost" data-lb="copy">${icon('copy', 15)}${esc(t('复制提示词', 'Copy prompt'))}</button>
             <button class="btn btn-ghost" data-lb="reuse">${icon('refresh', 15)}${esc(t('用它再画', 'Use again'))}</button>
@@ -403,14 +560,17 @@ export function mount(root) {
           if (act === 'prev') { index = (index - 1 + list.length) % list.length; paint(); return }
           if (act === 'next') { index = (index + 1) % list.length; paint(); return }
           if (act === 'download') { downloadUrl(fileUrl(row.file), `modern-media-${row.id}.png`); return }
+          if (act === 'copy-image') {
+            try {
+              await copyImage(fileUrl(row.file))
+              app.toast(t('图片已复制到剪贴板', 'Image copied to clipboard'), 'success')
+            } catch (err) { app.toast(err.message || t('复制失败', 'Copy failed'), 'error') }
+            return
+          }
           if (act === 'copy') { await copyText(row.prompt); app.toast(t('已复制', 'Copied'), 'success'); return }
           if (act === 'reuse') {
-            promptEl.value = row.prompt
-            promptEl.dispatchEvent(new Event('input'))
-            if (row.style && STYLES.includes(row.style)) style = row.style
-            paintChoices()
+            await reuseImage(row)
             closeRef.fn()
-            promptEl.focus()
             return
           }
           if (act === 'fav') {
@@ -424,6 +584,10 @@ export function mount(root) {
           }
         })
       })
+      cardEl.querySelector('.lb-figure img')?.addEventListener('contextmenu', event => {
+        event.preventDefault()
+        showImageMenu(event, list[index])
+      })
     }
     paint()
     const onKey = event => {
@@ -458,7 +622,7 @@ export function mount(root) {
         count,
         quality: $('#quality').value,
         negative: $('#negative').value.trim(),
-        reference: reference?.name ?? '',
+        references: references.map(item => item.name),
       })
       api('preferences', { imageStyle: style, imageRatio: ratio, imageCount: count }).catch(() => {})
       app.toast(t(`已提交 ${count} 张，稍等片刻`, `Queued ${count} image(s)`), 'success')

package/web/views/settings.js

@@ -98,17 +98,31 @@ export function mount(root) {
 
         <section class="settings-card">
           <header class="settings-head">
-            <div class="settings-title"><span class="settings-ic" style="--c:#6b7280">${icon('folder', 18)}</span><div><h3>${esc(t('本机数据', 'Local data'))}</h3><p>${esc(t('作品、图片、视频和星图都在这个目录，不上传云端。', 'Works, images, videos and star maps live here. Nothing is uploaded.'))}</p></div></div>
+            <div class="settings-title"><span class="settings-ic" style="--c:#6b7280">${icon('settings', 18)}</span><div><h3>${esc(t('维护', 'Maintenance'))}</h3><p>${esc(t('导出工作台记录，或者清空列表。这里只动记录，不会删除作品文件目录里的图片和视频。', 'Export workbench records or clear the lists. This only touches records; files in the Library folder are left alone.'))}</p></div></div>
           </header>
-          <div class="data-path"><code id="data-path">${esc(app.dataDir)}</code><button class="text-btn" id="copy-path">${icon('copy', 13)}${esc(t('复制路径', 'Copy path'))}</button></div>
           <div class="settings-actions wrap">
-            <button class="btn btn-small btn-ghost" id="export-all">${icon('download', 14)}${esc(t('导出全部数据', 'Export all data'))}</button>
+            <button class="btn btn-small btn-ghost" id="export-all">${icon('download', 14)}${esc(t('导出记录 JSON', 'Export records JSON'))}</button>
             <button class="btn btn-small btn-ghost" id="clear-images">${esc(t('清空图片记录', 'Clear images'))}</button>
             <button class="btn btn-small btn-ghost" id="clear-videos">${esc(t('清空视频记录', 'Clear videos'))}</button>
             <button class="btn btn-small btn-ghost danger-quiet" id="clear-all">${esc(t('清空全部记录', 'Clear everything'))}</button>
           </div>
         </section>
 
+        <section class="settings-card">
+          <header class="settings-head">
+            <div class="settings-title"><span class="settings-ic" style="--c:#c96442">${icon('download', 18)}</span><div><h3>${esc(t('作品文件目录', 'Library folder'))}</h3><p>${esc(t('图片、视频的实际文件主目录。换到其他盘时会把已有文件迁移过去，释放 C 盘；状态和设置文件仍留在系统盘。留空恢复默认目录。', 'The actual storage folder for images and videos. Changing it migrates existing files and frees the system drive; state and settings stay on the system drive. Leave blank to use the default.'))}</p></div></div>
+          </header>
+          <label class="field"><span class="field-label">${esc(t('目录绝对路径', 'Absolute folder path'))}</span>
+            <input class="input" id="output-dir" value="${esc(settings.storage?.outputDir ?? '')}" placeholder="D:\\AI作品" spellcheck="false">
+          </label>
+          <div class="settings-actions">
+            <span class="fine" id="output-dir-hint">${esc(t('建议选空目录；保存时会创建目录并迁移现有文件，目标里有同名文件会拒绝迁移。', 'Prefer an empty folder. It is created and existing files are migrated; same-name files cause the move to be rejected.'))}</span>
+            <span class="spacer"></span>
+            <button class="btn btn-small btn-ghost" id="output-dir-clear">${esc(t('恢复默认目录', 'Use default'))}</button>
+            <button class="btn btn-small btn-primary" id="output-dir-save">${esc(t('保存目录', 'Save folder'))}</button>
+          </div>
+        </section>
+
         <section class="settings-card about-card">
           <div class="about-mark">${icon('spark', 22)}</div>
           <div>
@@ -185,6 +199,21 @@ export function mount(root) {
   field('image-save').addEventListener('click', saveImage)
   field('video-save').addEventListener('click', saveVideo)
 
+  async function saveOutputDir(value) {
+    if (busy) return
+    busy = true
+    try {
+      const data = await api('settings', { storage: { outputDir: value } })
+      app.settings = data.settings
+      field('output-dir').value = data.settings?.storage?.outputDir ?? ''
+      app.toast(value ? t('作品目录已迁移', 'Library folder moved') : t('已恢复默认目录', 'Default folder restored'), 'success')
+      await app.refresh()
+    } catch (err) { app.toast(err.message, 'error') }
+    finally { busy = false }
+  }
+  field('output-dir-save').addEventListener('click', () => saveOutputDir(field('output-dir').value))
+  field('output-dir-clear').addEventListener('click', () => { field('output-dir').value = ''; saveOutputDir('') })
+
   field('image-clear-key')?.addEventListener('click', async () => {
     try {
       const data = await api('settings', { image: { clearKey: true } })
@@ -218,10 +247,6 @@ export function mount(root) {
     finally { busy = false; btn.textContent = t('试画一张', 'Test image') }
   })
 
-  field('copy-path').addEventListener('click', async () => {
-    try { await navigator.clipboard.writeText(app.dataDir); app.toast(t('路径已复制', 'Path copied'), 'success') } catch { app.toast(t('复制失败', 'Copy failed'), 'error') }
-  })
-
   field('export-all').addEventListener('click', () => { location.href = '/media-workbench-modern/api/export' })
 
   async function clearScope(scope) {