@uzooai/anime-ai-cli 0.0.0-stage → 0.5.0

package/src/generation-input.js

@@ -0,0 +1,472 @@
+// Independent implementation of the ordinary web node input contract.
+// Development oracles: nodeContent.js, generationActions.js and canvas/requests.js.
+export const generationModes = {
+  text2image: [['text'], []],
+  image2image: [['text', 'image'], ['image']],
+  text_to_video: [['text'], []],
+  image_reference: [['text', 'image'], ['image']],
+  video_reference: [['text', 'video'], ['video']],
+  audio_reference: [['text', 'image', 'video', 'audio'], ['audio']],
+  combined_reference: [
+    ['text', 'image', 'video', 'audio'],
+    ['image', 'video', 'audio']
+  ],
+  video_editing: [['text', 'image', 'video'], ['video']],
+  video_extension: [['text', 'video'], ['video']]
+}
+const labels = { image: '图片', video: '视频', audio: '音频' }
+const text = (value) => String(value ?? '').trim()
+const unique = (values) => [...new Set(values)]
+const object = (value) => value && typeof value === 'object' && !Array.isArray(value)
+export function normalizeMode(value) {
+  const aliases = {
+    'text-to-image': 'text2image',
+    'image-to-image': 'image2image',
+    'text-to-video': 'text_to_video',
+    text2video: 'text_to_video',
+    image2video: 'image_reference',
+    'image-to-video': 'image_reference',
+    'image-reference': 'image_reference',
+    'video-reference': 'video_reference',
+    'audio-reference': 'audio_reference',
+    'combined-reference': 'combined_reference',
+    omni_reference: 'combined_reference',
+    multimodal: 'combined_reference',
+    'video-editing': 'video_editing',
+    'video-extension': 'video_extension'
+  }
+  const raw = object(value)
+    ? value.value || value.code || value.mode || value.name || value.generation_mode
+    : value
+  return aliases[text(raw)] || text(raw)
+}
+export function storedReferences(doc, node) {
+  const meta = doc.meta?.node_references?.[node.id]
+  const refs = meta ?? node.data?.references ?? node.data?.extra?.references ?? []
+  if (!Array.isArray(refs) || refs.some((ref) => !object(ref) || !text(ref.id)))
+    throw new Error('节点持久参考无效；先核对画布引用')
+  return structuredClone(refs)
+}
+export function nodeReview(data = {}) {
+  const review = data.seedanceReview || data.seedance_review || data.extra?.seedance_review
+  return object(review) ? { ...review, status: text(review.status).toLowerCase() } : null
+}
+function resultText(result) {
+  const status = result?.structured_meta?.status ?? result?.structuredMeta?.status
+  const markdown = result?.structured_render?.markdown ?? result?.structuredRender?.markdown
+  if (status !== 'failed' && typeof markdown === 'string' && markdown.trim()) return markdown.trim()
+  return typeof result?.text === 'string' ? result.text.trim() : ''
+}
+function plainText(value) {
+  // Equivalent to the web plain-text projection; common editor entities are decoded.
+  return String(value ?? '')
+    .replace(/<[^>]*>/g, ' ')
+    .replace(/&(#x[\da-f]+|#\d+|amp|lt|gt|quot|apos|nbsp);/gi, (match, entity) => {
+      const named = { amp: '&', lt: '<', gt: '>', quot: '"', apos: "'", nbsp: ' ' }
+      if (entity[0] !== '#') return named[entity.toLowerCase()] ?? match
+      const n = /^#x/i.test(entity) ? parseInt(entity.slice(2), 16) : Number(entity.slice(1))
+      return n > 0 && n <= 0x10ffff ? String.fromCodePoint(n) : match
+    })
+    .replace(/\s+/g, ' ')
+    .trim()
+}
+export function readSource(node) {
+  const data = node?.data || {},
+    extra = data.extra || {},
+    output = data.node_output || {}
+  const asset = node?.type?.endsWith('_upload') || extra.node_kind === 'asset'
+  const mediaType = asset
+    ? data.mediaType || output.media_type || node.type.replace('_upload', '')
+    : node?.type
+  const result = data.result || {}
+  const status = data.status || result.status || (data.last_task_id ? 'processing' : '')
+  const content =
+    typeof data.output === 'string'
+      ? data.output
+      : (output.content ?? (status === 'completed' ? resultText(result) : '')) || data.text || ''
+  const fileRef =
+    data.fileRef || data.file_ref || extra.file_ref || result.file_ref || output.file_ref
+  const url = asset
+    ? result.url ||
+      data.url ||
+      output.url ||
+      (fileRef ? '/api/v1/files/' + encodeURIComponent(fileRef) : '')
+    : result.url || data.resultUrl || output.url || ''
+  return {
+    id: text(node?.id),
+    title: text(data.title || data.name || data.file_name || node?.id),
+    mediaType,
+    url: text(url),
+    text: mediaType === 'text' ? plainText(content) : '',
+    uploading:
+      data.uploading === true ||
+      (data.runtime?.operation === 'upload' &&
+        ['queued', 'preparing', 'processing'].includes(data.runtime.status)),
+    uploadError: text(
+      data.uploadError || (data.runtime?.operation === 'upload' ? data.runtime.error : '')
+    ),
+    seedanceReview: nodeReview(data)
+  }
+}
+export function mergeSources(sources, references) {
+  const seen = new Set()
+  return [...sources, ...references]
+    .filter((ref) => {
+      const id = text(ref.id)
+      if (!id || seen.has(id)) return false
+      seen.add(id)
+      return true
+    })
+    .map((ref) => ({
+      ...ref,
+      id: text(ref.id),
+      title: text(ref.title || ref.id),
+      mediaType: text(ref.mediaType || 'image'),
+      url: text(ref.url),
+      text: text(ref.text)
+    }))
+}
+function usable(source) {
+  if (!['text', ...Object.keys(labels)].includes(source.mediaType))
+    throw new Error(`参考 ${source.id} 的媒体类型不支持`)
+  if (source.uploading || source.uploadError)
+    throw new Error(`参考 ${source.id} 尚未上传完成或上传失败`)
+  if (source.mediaType === 'text' ? !source.text : !source.url)
+    throw new Error(`上游 ${source.id} 尚无${source.mediaType === 'text' ? '文本' : '媒体'}输出`)
+  if (source.mediaType !== 'text' && !/^(?:https?:\/\/|\/api\/|asset:\/\/)/i.test(source.url))
+    throw new Error(`参考 ${source.id} 不是可提交的服务端媒体地址`)
+}
+export function collectGenerationSources(doc, node, mediaTypes = null) {
+  const incoming = doc.edges.filter((edge) => edge.target === node.id)
+  const connected = []
+  for (const id of unique(incoming.map((edge) => edge.source))) {
+    const source = doc.nodes.find((candidate) => candidate.id === id)
+    if (!source) throw new Error(`上游 ${id} 节点不存在`)
+    const resolved = readSource(source)
+    if (mediaTypes && !mediaTypes.includes(resolved.mediaType)) continue
+    usable(resolved)
+    connected.push(resolved)
+  }
+  const references = storedReferences(doc, node).filter(
+    (ref) => !mediaTypes || mediaTypes.includes(ref.mediaType)
+  )
+  const all = mergeSources(connected, references)
+  all.forEach(usable)
+  return { connected, references, all }
+}
+function normalizePrompt(value) {
+  return value.replace(/@\{ref:([^}]+)\}/g, (marker, encoded) => {
+    let id
+    try {
+      id = decodeURIComponent(encoded)
+    } catch {
+      return marker
+    }
+    const match = /^(image|video|audio)-(\d+)$/.exec(id)
+    return match ? `@${labels[match[1]]}${match[2]}` : marker
+  })
+}
+function serializeMentions(value, sources, media, automatic) {
+  const markers = new Map(),
+    names = new Map()
+  for (const source of sources) {
+    const index = media[source.mediaType]?.indexOf(text(source.url)) ?? -1
+    if (index < 0) continue
+    markers.set(source.id, `@${labels[source.mediaType]}${index + 1}`)
+    const name = text(source.displayLabel || source.title)
+    if (name) names.set(name, names.has(name) ? null : source)
+  }
+  if (automatic) {
+    const candidates = [...names]
+      .filter(([, source]) => source)
+      .sort((a, b) => b[0].length - a[0].length)
+    const token = /^(?:@\{ref:[^}]+\}|@(?:(?:图片|音频|视频)|(?:image|audio|video))?\d+)/
+    let next = '',
+      offset = 0
+    while (offset < value.length) {
+      const marker = token.exec(value.slice(offset))
+      const candidate = marker ? null : candidates.find(([name]) => value.startsWith(name, offset))
+      if (marker) {
+        next += marker[0]
+        offset += marker[0].length
+      } else if (candidate) {
+        next += `@{ref:${encodeURIComponent(candidate[1].id)}}`
+        offset += candidate[0].length
+      } else next += value[offset++]
+    }
+    value = next
+  }
+  const resolved = value.replace(/@@?\{ref:([^}]+)\}/g, (marker, encoded) => {
+    try {
+      return markers.get(decodeURIComponent(encoded)) || normalizePrompt(marker)
+    } catch {
+      return marker
+    }
+  })
+  if (/@\{ref:[^}]+\}/.test(resolved))
+    throw new Error('提示词包含未解析的素材引用；请先核对参考素材')
+  return normalizePrompt(resolved)
+}
+export function promptInput(node, connected, references, sources, media) {
+  const contexts = [
+    ...connected.filter((s) => s.mediaType === 'text').map((s) => s.text),
+    ...references.filter((s) => s.mediaType === 'text').map((s) => text(s.text))
+  ]
+    .map(text)
+    .filter(Boolean)
+  const own = text(node.data?.prompt),
+    automatic =
+      (node.data?.autoRecognizeReferences ?? node.data?.extra?.auto_recognize_references) !== false
+  const preparation = Object.entries(labels).flatMap(([type, label]) =>
+    (media[type] || []).flatMap((url, index) => {
+      const source = sources.find((s) => s.mediaType === type && text(s.url) === url)
+      return source
+        ? [
+            `@${label}${index + 1}是${String(source.title || source.id)
+              .replace(/[\r\n]+/g, ' ')
+              .trim()}`
+          ]
+        : []
+    })
+  )
+  const prefix = preparation.length
+    ? `<!-- flow:auto-material-preparation:start -->\n素材准备：${preparation.join('；')}。\n<!-- flow:auto-material-preparation:end -->\n\n`
+    : ''
+  return {
+    prompt:
+      prefix +
+      serializeMentions([...contexts, own].filter(Boolean).join('\n\n'), sources, media, automatic),
+    nodePrompt: prefix + serializeMentions(own, sources, media, automatic),
+    contexts
+  }
+}
+function resolveReferences(doc, connected, configured, includeAll) {
+  const ordered = includeAll
+    ? mergeSources(connected, configured)
+    : configured.length
+      ? configured
+      : connected
+  const media = { image: [], video: [], audio: [] },
+    assets = [],
+    tasks = [],
+    resolved = []
+  const seen = new Set()
+  for (const reference of ordered) {
+    const id = text(reference.id)
+    if (seen.has(id) || reference.mediaType === 'text') continue
+    seen.add(id)
+    const source = doc.nodes.find((n) => n.id === id)
+    const current = source ? readSource(source) : null
+    const data = source?.data || {},
+      extra = data.extra || {}
+    const type = current?.mediaType || reference.mediaType || 'image'
+    const url = text(current?.url || reference.url)
+    const item = { ...reference, id, mediaType: type, url }
+    usable(item)
+    if (!url.startsWith('asset://')) media[type].push(url)
+    if (type !== 'audio') {
+      const asset = text(
+        reference.assetId || data.sourceAssetId || data.assetId || extra.source_asset_id
+      )
+      if (asset) assets.push(asset)
+      const review = current?.seedanceReview || reference.seedanceReview
+      if (text(review?.status).toLowerCase() === 'active' && text(review.taskId)) {
+        const reviewedRef = text(review.mediaRef || review.imageRef)
+        const currentRef = text(
+          data.resultFileRef ||
+            data.fileRef ||
+            data.file_ref ||
+            extra.file_ref ||
+            data.result?.file_ref ||
+            data.node_output?.file_ref
+        )
+        if (reviewedRef && currentRef && reviewedRef !== currentRef)
+          throw new Error('当前素材与已通过审核的引用不一致；请核对或重新审核，不复用旧关联')
+        tasks.push(text(review.taskId))
+      }
+    }
+    resolved.push(item)
+  }
+  for (const source of connected.filter((s) => s.mediaType === 'audio'))
+    media.audio.push(source.url)
+  for (const type of Object.keys(media)) media[type] = unique(media[type])
+  return {
+    media,
+    assets: unique(assets),
+    tasks: unique(tasks),
+    sources: mergeSources(resolved, connected)
+  }
+}
+function configuredValue(node, key) {
+  const data = node.data || {},
+    extra = data.extra || {}
+  return data[key] ?? extra[key]
+}
+function setting(node, model, key, listKey, fallback = '') {
+  const raw = configuredValue(node, key)
+  const choices = Array.isArray(model[listKey]) ? model[listKey] : []
+  if (raw !== undefined && raw !== null && raw !== '') {
+    if (!choices.includes(String(raw))) throw new Error(`${key} 不在当前模型选项中；请先核对参数`)
+    return String(raw)
+  }
+  return choices.includes(fallback) ? fallback : fallback ? choices[0] || '' : ''
+}
+export function buildGenerationRequest(doc, node, model, inputs) {
+  const kind = node.type,
+    data = node.data || {},
+    extra = data.extra || {}
+  const { connected, references, all } = inputs
+  let media,
+    assets = [],
+    tasks = [],
+    sources = all
+  if (kind === 'image') {
+    const referencedImages = references
+      .filter((s) => s.mediaType === 'image')
+      .map((s) => text(s.url))
+      .filter(Boolean)
+    media = {
+      image: referencedImages.length
+        ? referencedImages
+        : connected.filter((s) => s.mediaType === 'image').map((s) => s.url),
+      video: unique(
+        [...connected, ...references].filter((s) => s.mediaType === 'video').map((s) => s.url)
+      ),
+      audio: unique(
+        [...references, ...connected].filter((s) => s.mediaType === 'audio').map((s) => s.url)
+      )
+    }
+  } else {
+    const refs = resolveReferences(doc, connected, references, kind === 'video')
+    media = refs.media
+    assets = refs.assets
+    tasks = refs.tasks
+    sources = mergeSources(refs.sources, references)
+  }
+  const input = promptInput(node, connected, references, sources, media)
+  if ((!text(data.prompt) && kind === 'text') || !input.prompt.trim()) throw new Error('缺少提示词')
+  const body = {
+    doc_id: doc.id,
+    node_id: node.id,
+    segment_type: kind,
+    model_name: model.label,
+    prompt: (kind === 'text' ? input.nodePrompt : input.prompt).trim(),
+    reference_image_urls: media.image,
+    reference_video_urls:
+      kind === 'text'
+        ? unique(
+            [...connected, ...references].filter((s) => s.mediaType === 'video').map((s) => s.url)
+          )
+        : media.video,
+    reference_audio_urls: media.audio,
+    reference_asset_ids: assets,
+    ...(kind !== 'text' ? { reference_canvas_task_ids: tasks } : {}),
+    duration: null,
+    extra: {}
+  }
+  if (kind === 'text') {
+    const max = Number(data.maxTokens),
+      temperature = Number(data.temperature)
+    body.extra = {
+      context_texts: input.contexts,
+      max_tokens: Number.isFinite(max) && max > 0 ? Math.floor(max) : 4096,
+      temperature:
+        data.temperature != null && Number.isFinite(temperature) && temperature >= 0
+          ? temperature
+          : 0.7
+    }
+  } else {
+    const modeList = (
+      model.generation_modes || (kind === 'image' ? ['text2image', 'image2image'] : [])
+    ).map(normalizeMode)
+    // The current image run path resolves mode from topology; video also merges
+    // persistent references. Keep that distinction observable in the preview.
+    const types = (kind === 'image' ? connected : all).map((s) => s.mediaType)
+    const compatible = modeList.filter((mode) => {
+      const rule = generationModes[mode]
+      return (
+        rule &&
+        types.every((type) => rule[0].includes(type)) &&
+        (!rule[1].length || rule[1].some((type) => types.includes(type)))
+      )
+    })
+    const selected = normalizeMode(
+      extra.generation_mode ||
+        data.generation_mode ||
+        data[kind === 'image' ? 'imageMode' : 'videoMode']
+    )
+    const mode = compatible.includes(selected) ? selected : compatible[0]
+    if (!mode) throw new Error('目标模型不支持当前上游类型组合或缺少必需素材')
+    body.extra.generation_mode = mode
+    const aspect = setting(node, model, 'aspect_ratio', 'aspect_ratios')
+    const resolution = setting(node, model, 'resolution', 'resolutions')
+    const topLevel = kind === 'video' && /^seedance/i.test(model.label)
+    if (aspect) (topLevel ? body : body.extra).aspect_ratio = aspect
+    if (resolution) (topLevel ? body : body.extra).resolution = resolution
+    if (kind === 'image') {
+      if (extra.image_to_image_enabled === false && media.image.length)
+        throw new Error('节点已关闭图生图，不能携带图片参考')
+      const count = Number(data.image_count ?? data.imageCount ?? extra.image_count) || 1
+      if (count !== 1) throw new Error('本轮仅支持单张请求准备；请明确数量为 1')
+      body.extra.image_count = 1
+      const quality = setting(node, model, 'quality', 'quality_options', 'medium')
+      if (quality) body.extra.quality = quality
+      body.asset_type = data.asset_type || data.assetType || extra.asset_type || 'character'
+      body.enable_asset_review = Boolean(data.seedanceAutoReview)
+    } else {
+      const duration = Number(data.duration ?? extra.duration)
+      if (!Number.isFinite(duration) || duration <= 0) throw new Error('请先设置视频时长')
+      if (
+        (Number.isFinite(model.durations?.min) && duration < model.durations.min) ||
+        (Number.isFinite(model.durations?.max) && duration > model.durations.max)
+      )
+        throw new Error('视频时长超出当前模型范围')
+      body.duration = duration
+      if (media.audio.length && model.supports_audio_reference !== true)
+        throw new Error('目标模型不支持音频参考')
+      if (
+        media.audio.length &&
+        model.audio_reference_requires_visual === true &&
+        !media.image.length &&
+        !media.video.length
+      )
+        throw new Error('音频参考需要至少一个图片或视频输入')
+      body.enable_asset_review = (data.seedanceAutoReview ?? extra.seedance_auto_review) === true
+      if (model.is_sample_mode === true || extra.draft_preview === true) {
+        if (['video_editing', 'video_extension'].includes(mode))
+          throw new Error('样片模式不支持视频编辑/延长')
+        body.extra.draft_preview = true
+        if (topLevel) body.resolution = '480p'
+        else body.extra.resolution = '480p'
+      }
+    }
+  }
+  for (const type of Object.keys(labels)) {
+    const count = all.filter((s) => s.mediaType === type).length
+    const limit =
+      model[`max_${type}_references`] ?? (type === 'image' ? model.max_reference_count : undefined)
+    if (Number.isFinite(limit) && count > limit) throw new Error(`超出模型 ${type} 参考数量限制`)
+  }
+  if (
+    Number.isFinite(model.max_reference_count) &&
+    all.filter((s) => s.mediaType !== 'text').length > model.max_reference_count
+  )
+    throw new Error('超出模型参考素材总数量限制')
+  if (kind === 'text')
+    for (const type of ['image', 'video']) {
+      if (media[type].length && model[`${type}_understanding`] !== true)
+        throw new Error(`目标文本模型不支持${type === 'image' ? '图片' : '视频'}理解`)
+    }
+  if (tasks.some((id) => !/^[1-9]\d*$/.test(id)) || assets.some((id) => !/^[1-9]\d*$/.test(id)))
+    throw new Error('素材或审核任务关联 ID 无效')
+  return { request: body, sources: all }
+}
+
+// Client request order only; do not present this as a provider receipt.
+export function referenceMapping(request, sources) {
+  return Object.entries(labels).flatMap(([type, label]) =>
+    (request['reference_' + type + '_urls'] || []).map((url, index) => ({
+      marker: '@' + label + (index + 1), media_type: type, request_field: 'reference_' + type + '_urls',
+      request_index: index, source_node_ids: sources.filter(s => s.mediaType === type && text(s.url) === url).map(s => s.id)
+    })))
+}

package/src/graph-disconnect.js

@@ -0,0 +1,89 @@
+import { isDeepStrictEqual as same } from 'node:util'
+import { scopedCanvas } from './materials.js'
+import { save, sourceType } from './graph.js'
+import { generationModes, normalizeMode, storedReferences, readSource } from './generation-input.js'
+
+export function disconnectMentions(value, reference) {
+  let result = String(value || '').replace(/@@?{ref:[^}]+}/g, marker => {
+    const manual = marker.startsWith('@@'), token = manual ? marker.slice(1) : marker
+    let id
+    try { id = decodeURIComponent(token.slice(6,-1)) } catch { return marker }
+    return id === reference.id ? manual ? '' : String(reference.displayLabel || reference.title || '') : marker
+  })
+  const legacy = String(reference.legacyMarker || reference.marker || '')
+  if (legacy && !/^@{ref:[^}]+}$/.test(legacy)) result = result.split(legacy).join('')
+  return result
+}
+const derived = n => n?.type === 'video_repain_begain' || n?.data?.repaint || n?.data?.videoRemake ||
+  n?.data?.extra?.repaint || n?.data?.extra?.video_remake || n?.data?.extra?.clip_redraw || n?.data?.draftFinalizeGeneration || n?.data?.extra?.draft_finalize
+
+export async function disconnectGraph(client, input, confirmed = false) {
+  if (!input || typeof input !== 'object' || Array.isArray(input) ||
+      Object.keys(input).some(k=>!['doc_id','space','team_uid','edge_id','expected_version'].includes(k)) ||
+      !['doc_id','edge_id'].every(k=>typeof input[k]==='string' && input[k].trim()))
+    throw new Error('断线输入需要doc_id/space/team_uid/edge_id，可选expected_version')
+  if (input.expected_version !== undefined && (!Number.isSafeInteger(input.expected_version) || input.expected_version < 1))
+    throw new Error('expected_version必须为正整数')
+  const doc = await scopedCanvas(client,input.doc_id,input.space,input.team_uid)
+  if (!Number.isSafeInteger(doc.version) || doc.version < 1 || !Array.isArray(doc.nodes) || !Array.isArray(doc.edges) ||
+      !doc.meta || typeof doc.meta !== 'object' || Array.isArray(doc.meta) ||
+      !doc.viewport || typeof doc.viewport !== 'object' || Array.isArray(doc.viewport) || typeof doc.name !== 'string' ||
+      doc.nodes.some(n=>!n || typeof n.id!=='string') || doc.edges.some(e=>!e || typeof e.id!=='string') ||
+      new Set(doc.nodes.map(n=>n.id)).size !== doc.nodes.length || new Set(doc.edges.map(e=>e.id)).size !== doc.edges.length)
+    throw new Error('画布快照不完整或ID重复')
+  if (input.expected_version !== undefined && input.expected_version !== doc.version) throw new Error('画布已变化，重新预览')
+  const edge = doc.edges.find(e=>e.id===input.edge_id)
+  if (!edge) throw new Error('连线不存在，先读回核对')
+  const source=doc.nodes.find(n=>n.id===edge.source), target=doc.nodes.find(n=>n.id===edge.target)
+  if (!source || !target) throw new Error('连线端点缺失')
+  if (edge.data?.repaintSystem || edge.data?.role || derived(source) || derived(target))
+    throw new Error('仅支持普通连线；系统线与派生流程不支持')
+  if (target.data?.generation_config || target.data?.node_output) throw new Error('目标配置协议尚未接入断线')
+  const next=structuredClone(doc), nextTarget=next.nodes.find(n=>n.id===target.id)
+  next.edges=next.edges.filter(e=>e.id!==edge.id)
+  const stillConnected=next.edges.some(e=>e.source===edge.source && e.target===edge.target)
+  if (!stillConnected) {
+    const refs=storedReferences(doc,target), reference=readSource(source)
+    const retained=refs.filter(r=>String(r.id)!==source.id)
+    nextTarget.data ||= {}
+    nextTarget.data.prompt=disconnectMentions(target.data?.prompt,reference)
+    if (Object.hasOwn(target.data||{},'references')) nextTarget.data.references=retained
+    if (target.data?.extra && Object.hasOwn(target.data.extra,'references')) nextTarget.data.extra.references=retained
+    if (doc.meta.node_references && Object.hasOwn(doc.meta.node_references,target.id)) next.meta.node_references[target.id]=retained
+  }
+  if (['image','video'].includes(target.type)) {
+    const catalog=await client.raw('/canvas/models'+(doc.team_uid?'?team_uid='+encodeURIComponent(doc.team_uid):''))
+    const model=catalog.items?.find(m=>m.label===target.data?.model_name && m.content_type===target.type && !m.member_locked)
+    if (!model) throw new Error('请先选择目标节点当前空间可用模型')
+    const types=next.edges.filter(e=>e.target===target.id).map(e=>sourceType(doc.nodes.find(n=>n.id===e.source)))
+    // Match the mounted node's mode normalization after removeEdge: retained
+    // persistent material references still constrain the eventual saved mode.
+    types.push(...storedReferences(next,nextTarget).map(r=>r.mediaType||sourceType(next.nodes.find(n=>n.id===r.id))).filter(Boolean))
+    const supported=(model.generation_modes||[]).map(normalizeMode).filter(m=>generationModes[m])
+    const compatible=supported.filter(m=>types.every(t=>generationModes[m][0].includes(t)) &&
+      (!generationModes[m][1].length || generationModes[m][1].some(t=>types.includes(t))))
+    // Model choice is a user decision: do not silently switch to another model.
+    if (!compatible.length) throw new Error('断线后当前模型无兼容模式，请先明确选择模型')
+    const current=normalizeMode(target.data?.extra?.generation_mode || target.data?.generation_mode || target.data?.imageMode || target.data?.videoMode)
+    const mode=compatible.includes(current)?current:compatible[0]
+    nextTarget.data.extra={...nextTarget.data.extra,generation_mode:mode}
+    if (Object.hasOwn(nextTarget.data,'generation_mode')) nextTarget.data.generation_mode=mode
+  }
+  const preview={doc_id:doc.id,edge_id:edge.id,source_node_id:source.id,target_node_id:target.id,
+    expected_version:doc.version,still_connected:stillConnected,prompt_before:target.data?.prompt||'',
+    prompt_after:nextTarget.data?.prompt||'',references_before:storedReferences(doc,target).map(r=>r.id),
+    references_after:storedReferences(next,nextTarget).map(r=>r.id),
+    mode_before:target.data?.extra?.generation_mode,mode_after:nextTarget.data?.extra?.generation_mode,
+    canvas_written:false,generation_submitted:false}
+  if (!confirmed) return preview
+  if (input.expected_version===undefined) throw new Error('执行须提供预览expected_version')
+  const saved=await save(client,doc,{nodes:next.nodes,edges:next.edges,meta:next.meta})
+  let actual
+  try { actual=await scopedCanvas(client,input.doc_id,input.space,input.team_uid) }
+  catch(cause){throw new Error('断线保存已尝试但读回未确认，不自动重放',{cause})}
+  if (!Number.isSafeInteger(actual.version) || actual.version < saved.version ||
+      !same(actual.viewport,doc.viewport) || actual.name !== doc.name ||
+      !same(actual.nodes,next.nodes) || !same(actual.edges,next.edges) || !same(actual.meta,next.meta))
+    throw new Error('断线读回不一致，保留当前画布，不自动重放')
+  return {...preview,version:actual.version,canvas_written:true,disconnect_verified:true}
+}