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

package/src/repaint-export.js

@@ -0,0 +1,63 @@
+import fs from 'node:fs/promises'
+import { getRepaintHistory } from './repaint-history.js'
+import { reversePath } from './repaint-reverse.js'
+import { deliveryPath } from './repaint-delivery.js'
+import { repaintVideoPath } from './repaint-video.js'
+import { json } from './store.js'
+import { readRepaintArchive, archiveRepaintResult } from './repaint-archive.js'
+import { exclusiveOutput } from './local-output.js'
+import { hashFile, downloadVideo } from './media.js'
+import { jobPath } from './repaint-graph.js'
+
+const paths = { reverse: reversePath, delivery: deliveryPath, video: repaintVideoPath }
+const fail = (code, message) => Object.assign(new Error(message), { code })
+export async function exportRepaintResult(client, profile, operation, type, output, source = 'remote') {
+  if (!Object.hasOwn(paths, type) || !['remote', 'archive'].includes(source) || !output)
+    throw new Error('导出需要type reverse/delivery/video、output及source remote/archive')
+  if (type === 'video' && source !== 'remote')
+    throw new Error('视频归档不保存可绕过权限的下载资源；请使用remote')
+  // This retains account, space, original source, plan and node checks even when
+  // settings changed. It never relaxes submission or canvas recovery bindings.
+  const history = await getRepaintHistory(client, profile, operation, type)
+  const record = await json(paths[type](profile, operation))
+  let result = history.result, verifiedAt = new Date().toISOString()
+  let details = type === 'delivery' ? { fallback: history.fallback === true, warning: history.warning || null } : {}
+  if (source === 'archive') {
+    const archive = await readRepaintArchive(record, type)
+    if (!archive) throw fail('REPAINT_ARCHIVE_UNAVAILABLE', '没有已核验的本地原结果快照；不补造旧历史')
+    result = archive.payload.result
+    details = archive.payload.details
+    verifiedAt = archive.verified_at
+  } else if (!history.original_run_verified || !history.result_available || history.status !== 'completed') {
+    throw fail('REPAINT_RESULT_UNAVAILABLE', '原运行未确认完成或原结果不可用；不导出当前其他轮次，不重新生成')
+  }
+  // Archive only results verified from this remote run, never inferred history.
+  if (source === 'remote') await archiveRepaintResult(record, type, result, history.billing,
+    details)
+  let exported
+  if (type === 'video') {
+    let link
+    try {
+      link = await client.raw(jobPath(history.job_id) + '/redraw-tasks/' + encodeURIComponent(history.task_id) + '/download',
+        { headers: { 'X-Client-Source': 'canvas' } }, { retry: false })
+    } catch (error) {
+      if (error.apiCode !== 2001) throw error
+      throw Object.assign(fail('REPAINT_VIDEO_DOWNLOAD_FORBIDDEN', '原转绘下载接口拒绝访问（2001）；不推断为白名单问题，核验当前部署、账号及原任务可见性后仅继续原任务下载；生成仍已完成'), {
+        diagnostic: { ...(error.status ? { http_status: error.status } : {}), api_code: error.apiCode,
+          ...(error.requestId ? { request_id: error.requestId } : {}) }
+      })
+    }
+    if (!link?.file_ref || !link.url) throw new Error('原任务下载接口未返回有效文件引用')
+    exported = await exclusiveOutput(output, temporary => downloadVideo(client, link.url, temporary))
+  } else {
+    if (typeof result?.prompt !== 'string' || !result.prompt.trim())
+      throw fail('REPAINT_RESULT_UNAVAILABLE', '原文本结果缺少提示词')
+    exported = await exclusiveOutput(output, async temporary => {
+      await fs.writeFile(temporary, result.prompt, { flag: 'wx', mode: 0o600 })
+      return hashFile(temporary)
+    })
+  }
+  return { operation, type, source, task_id: history.task_id || null, ...exported,
+    verified_at: verifiedAt, ...details, current_configuration: history.current_configuration,
+    canvas_written: false, generation_submitted: false, processing_submitted: false }
+}

package/src/repaint-graph.js

@@ -0,0 +1,214 @@
+// Persisted canvas protocol, independent of Vue and the frontend runtime.
+import { segment } from './workflows.js'
+import { isDeepStrictEqual } from 'node:util'
+
+export const object = value => value !== null && typeof value === 'object' && !Array.isArray(value)
+export const repaintOf = node => node?.data?.repaint || node?.data?.extra?.repaint || {}
+export const mediaUrl = node => node?.data?.url || node?.data?.result?.url || ''
+export const jobPath = id => `/video-segmentation/${segment(id)}`
+export function assertJob(job, record) {
+  const body = record.input
+  if (!job || String(job.id) !== record.jobId || job.canvas_doc_id !== body.doc_id ||
+    job.canvas_node_id !== record.detailId || String(job.team_uid || '') !== String(body.team_uid || '') ||
+    job.segmentation_mode !== body.segmentation_mode) throw new Error('任务与 operation 的画布、节点、团队或分割模式绑定不一致，停止')
+}
+export async function readCanvas(client, input) {
+  const doc = await client.raw(`/canvas/docs/${segment(input.doc_id)}`)
+  if (doc?.id !== input.doc_id || !Number.isSafeInteger(doc.version) || doc.version < 1 ||
+    !Array.isArray(doc.nodes) || !Array.isArray(doc.edges) || !object(doc.meta) || !object(doc.viewport) || typeof doc.name !== 'string') throw new Error('画布快照不完整，停止保存')
+  if (!['owner', 'editor'].includes(doc.role)) throw new Error('画布没有可确认的编辑权限')
+  if (String(doc.team_uid || '') !== String(input.team_uid || '')) throw new Error('画布归属与已选空间/团队不一致，停止')
+  if (new Set(doc.nodes.map(n => n.id)).size !== doc.nodes.length) throw new Error('画布有重复节点 ID，停止')
+  const source = doc.nodes.find(n => n.id === input.source_node_id)
+  const entry = doc.nodes.find(n => n.id === input.entry_node_id)
+  if (!source || !['video', 'video_upload'].includes(source.type) || !mediaUrl(source) || repaintOf(source).role ||
+    source.data?.videoRemake || source.data?.clipRedraw || source.data?.extra?.video_remake || source.data?.extra?.clip_redraw) throw new Error('源节点必须是有真实视频地址的普通视频/视频素材节点')
+  if (!entry || entry.type !== 'video_repain_begain' || repaintOf(entry).role !== 'entry') throw new Error('entry_node_id 必须指向普通视频转绘入口')
+  const inputs = doc.edges.filter(e => e.target === entry.id && e.data?.role === 'video-repaint-input')
+  if (inputs.some(e => e.source !== source.id)) throw new Error('视频转绘入口已连接另一源视频，停止')
+  return doc
+}
+const promptText = value => typeof value === 'string' ? value : value?.prompt || value?.text || value?.content || ''
+const absoluteMedia = (url, base) => {
+  const parsed = new URL(url, base)
+  if (!['http:', 'https:'].includes(parsed.protocol) || parsed.username || parsed.password) throw new Error('任务媒体地址无效')
+  return parsed.href
+}
+function node(id, type, title, x, y, data, width = 320, height = 260) {
+  return { id, type, position: { x, y }, width, height, data: { title, ...data } }
+}
+function edge(id, source, target, role) {
+  return { id, source, target, sourceHandle: '', targetHandle: '', type: 'default', data: { repaintSystem: true, role } }
+}
+function addEdge(doc, wanted) {
+  const collision = doc.edges.find(e => e.id === wanted.id)
+  if (collision && (collision.source !== wanted.source || collision.target !== wanted.target || collision.data?.role !== wanted.data.role)) throw new Error('流程连线 ID 冲突')
+  if (!collision && !doc.edges.some(e => e.source === wanted.source && e.target === wanted.target && e.data?.role === wanted.data.role)) doc.edges.push(wanted)
+}
+function segmentsOf(job) {
+  const segments = job.plan?.segments
+  if (!Array.isArray(segments) || !segments.length || segments.length > 63 || new Set(segments.map(s => s.index)).size !== segments.length ||
+    segments.some(s => !Number.isSafeInteger(s.index) || s.index < 1 || !Number.isSafeInteger(s.start_ms) || !Number.isSafeInteger(s.end_ms) || s.end_ms <= s.start_ms || s.duration_ms !== s.end_ms - s.start_ms)) throw new Error('完成任务的真实片段列表无效')
+  return segments
+}
+function checkCompletedGroup(doc, group, job) {
+  if (!Array.isArray(group.nodeIds) || new Set(group.nodeIds).size !== group.nodeIds.length || !group.nodeIds.every(id => doc.nodes.some(n => n.id === id))) throw new Error('已有流程分组不完整，停止')
+  const nodes = doc.nodes.filter(n => group.nodeIds.includes(n.id) && repaintOf(n).jobId === job.id)
+  const find = (role, index) => nodes.filter(n => repaintOf(n).role === role && (index === undefined || repaintOf(n).segmentIndex === index))
+  if (find('global-prompt').length !== 1 || segmentsOf(job).some(s => ['segment', 'reverse-prompt', 'final-prompt', 'generation'].some(role => find(role, s.index).length !== 1))) throw new Error('已有流程分组缺少完整片段节点链，停止')
+}
+
+export function assertAvailable(doc, record) {
+  const pending = doc.meta.cli_repaint_pending || {}
+  if (!object(pending)) throw new Error('待处理流程元数据无效')
+  for (const [operation, claim] of Object.entries(pending)) {
+    if (claim?.source_id === record.input.source_node_id && claim?.entry_id === record.input.entry_node_id &&
+      (operation !== record.operation || claim.job_id !== record.jobId)) throw new Error('该入口与源视频已有未确认流程；先恢复原 operation，不能重新提交分析')
+  }
+}
+export async function claimRepaint(client, record) {
+  const doc = await readCanvas(client, record.input)
+  assertAvailable(doc, record)
+  if (doc.nodes.some(n => repaintOf(n).role === 'split-detail' && repaintOf(n).sourceNodeId === record.input.source_node_id && repaintOf(n).parentNodeId === record.input.entry_node_id)) throw new Error('该源视频已有分段详情，未提交新分析')
+  const claim = { job_id: record.jobId, source_id: record.input.source_node_id, entry_id: record.input.entry_node_id, detail_id: record.detailId }
+  if (isDeepStrictEqual(doc.meta.cli_repaint_pending?.[record.operation], claim)) return
+  const body = { version: doc.version, name: doc.name, viewport: doc.viewport, nodes: doc.nodes, edges: doc.edges,
+    meta: { ...doc.meta, cli_repaint_pending: { ...doc.meta.cli_repaint_pending, [record.operation]: claim } } }
+  // The reservation contains no fabricated node and prevents a second CLI operation from billing the same flow.
+  try {
+    const saved = await client.raw(`/canvas/docs/${segment(doc.id)}`, { method: 'PUT', body }, { retry: false })
+    if (saved?.meta?.cli_repaint_pending?.[record.operation]?.job_id !== record.jobId) throw new Error('流程占用保存响应不完整')
+  } catch (error) {
+    if (error.status === 409 || error.apiCode === 3002) throw new Error('流程占用版本冲突，未执行分析提交；读取最新画布后再决定继续原 operation', { cause: error })
+    throw new Error('流程占用保存结果未确认，未执行分析提交；先读取画布核对原 operation', { cause: error })
+  }
+}
+
+// This private writer only accepts a server job whose binding was verified above.
+// Generic node add/update remains unable to fabricate derived nodes.
+export async function syncRepaintGraph(client, record, job, { restoreDetail = false } = {}) {
+  assertJob(job, record)
+  const doc = await readCanvas(client, record.input)
+  assertAvailable(doc, record)
+  const before = structuredClone([doc.nodes, doc.edges, doc.meta])
+  const source = doc.nodes.find(n => n.id === record.input.source_node_id)
+  const entry = doc.nodes.find(n => n.id === record.input.entry_node_id)
+  const aspectRatio = source.data.aspect_ratio || source.data.extra?.aspect_ratio || '16:9'
+  const markers = doc.meta.cli_repaint_workflows || {}
+  if (!object(markers)) throw new Error('流程元数据格式无效')
+  const stored = Object.hasOwn(markers, record.operation) ? markers[record.operation] : null
+  if (stored && (stored.job_id !== job.id || stored.detail_id !== record.detailId)) throw new Error('画布流程绑定冲突')
+  let detail = doc.nodes.find(n => n.id === record.detailId)
+  if (restoreDetail && (job.status !== 'awaiting_review' || stored?.materialized || record.lastStatus === 'completed')) throw new Error('仅可恢复原待审核分析详情，不重建已切片节点链')
+  if ((stored || record.lastStatus) && !detail && !restoreDetail) throw new Error('流程详情已被删除，停止；不会自动重建')
+  if (detail && (repaintOf(detail).role !== 'split-detail' || repaintOf(detail).jobId !== job.id)) throw new Error('流程详情 ID 已被其他节点占用')
+  if (doc.nodes.some(n => n.id !== record.detailId && repaintOf(n).role === 'split-detail' &&
+    (repaintOf(n).jobId === job.id || (repaintOf(n).sourceNodeId === source.id && repaintOf(n).parentNodeId === entry.id)))) throw new Error('已有其他分段详情，停止避免重复流程')
+  if (!detail) {
+    detail = node(record.detailId, 'video_upload', '视频分段详情', (entry.position?.x || 0) + (entry.width || 320) + 100, entry.position?.y || 0,
+      { mediaType: 'video', url: mediaUrl(source), file_name: source.data.file_name || job.source_name || '', aspect_ratio: aspectRatio, extra: {} })
+    doc.nodes.push(detail)
+  }
+  if (!stored) {
+    const manual = record.input.segmentation_mode === 'uniform'
+    entry.data.extra = { ...entry.data.extra, repaint: { ...repaintOf(entry), role: 'entry',
+      splitMode: manual ? 'manual' : 'intelligent', manualSplitExpanded: manual,
+      ...(manual ? { manualSplitStrategy: 'fixed-duration', manualSplitSeconds: record.input.uniform_interval_seconds } : {}) } }
+    if (entry.data.repaint) entry.data.repaint = entry.data.extra.repaint
+  }
+  const phase = ['failed', 'cancelled'].includes(job.status) ? 'failed' : ['awaiting_review', 'rendering', 'completed'].includes(job.status) || job.confirmed_at ? 'completed' : 'analyzing'
+  detail.data.extra = { ...detail.data.extra, repaint_job_id: job.id, repaint_source_node_id: source.id,
+    repaint: { ...repaintOf(detail), role: 'split-detail', sourceNodeId: source.id, parentNodeId: entry.id,
+      jobId: job.id, analysisStatus: phase, segmentCount: job.plan?.segments?.length || 0,
+      progress: Number(job.progress) || 0, stageMessage: job.stage_message || '', error: job.analysis_error_summary || job.error || '',
+      splitMode: record.input.segmentation_mode === 'intelligent' ? 'smart' : 'even',
+      uniformIntervalSeconds: record.input.uniform_interval_seconds ?? null } }
+  // Avoid leaving a stale alternate representation if the server supplied both forms.
+  if (detail.data.repaint) detail.data.repaint = detail.data.extra.repaint
+  if (detail.data.repaintJobId) detail.data.repaintJobId = job.id
+  for (const wanted of [edge(`${record.prefix}-input`, source.id, entry.id, 'video-repaint-input'), edge(`${record.prefix}-detail-link`, entry.id, detail.id, 'split-detail-link')]) {
+    if (stored && !restoreDetail && !doc.edges.some(e => e.source === wanted.source && e.target === wanted.target && e.data?.role === wanted.data.role)) throw new Error('流程连线已被删除，停止；不会自动重建')
+    addEdge(doc, wanted)
+  }
+  const groups = doc.meta.canvas_groups || []
+  if (!Array.isArray(groups)) throw new Error('画布分组格式无效')
+  const linkedGroups = groups.filter(g => (g.repaint?.jobId || g.repaintJobId) === job.id)
+  if (linkedGroups.length > 1) throw new Error('任务存在多个分组，停止避免重复物化')
+  let group = linkedGroups[0]
+  if (stored?.materialized) {
+    if (!group || group.id !== stored.group_id || group.repaint?.status !== 'completed' ||
+      !Array.isArray(stored.node_ids) || !stored.node_ids.every(id => doc.nodes.some(n => n.id === id))) throw new Error('已保存的流程节点或分组发生删除/变更，停止；不会自动重建')
+    if (stored.plan_version !== job.plan_version) throw new Error('分段方案已变化；当前版本不自动覆盖已有节点链')
+    checkCompletedGroup(doc, group, job)
+  } else if (job.status === 'completed') {
+    if (job.confirmed_plan_version !== job.plan_version || !job.confirmed_at) throw new Error('完成任务缺少匹配的已确认方案版本')
+    if (record.confirmVersion && record.confirmVersion !== job.plan_version) throw new Error('任务方案版本已变化，停止物化')
+    if (group?.repaint?.status === 'completed') {
+      // The webpage may already have materialized this real job. Adopt instead of duplicating.
+      checkCompletedGroup(doc, group, job)
+    } else {
+      const foreign = doc.nodes.filter(n => n.id !== detail.id && repaintOf(n).jobId === job.id && repaintOf(n).role !== 'entry')
+      if (foreign.length) throw new Error('任务已有未归组派生节点，停止避免重复创建')
+      const segments = segmentsOf(job)
+      const downloads = await client.raw(`${jobPath(job.id)}/downloads`)
+      const files = downloads?.files
+      if (!Array.isArray(files) || new Set(files.map(f => f.index)).size !== files.length || segments.some(s => !files.some(f => f.index === s.index && f.url))) throw new Error('片段下载结果不完整，未写入节点链')
+      const x = group?.position?.x ?? ((detail.position?.x || 0) + 440)
+      const y = group?.position?.y ?? (detail.position?.y || 0)
+      const generated = [], links = []
+      const textData = (value, role, index) => ({ prompt: value, output: value, extra: { repaint: { jobId: job.id, role, ...(index ? { segmentIndex: index } : {}) } } })
+      const globalId = `${record.prefix}-global`
+      const globalData = textData(String(group?.repaint?.globalPrompt || ''), 'global-prompt')
+      globalData.extra.repaint.attachments = Array.isArray(group?.repaint?.globalPromptAttachments) ? group.repaint.globalPromptAttachments : []
+      generated.push(node(globalId, 'text', '全局提示词', x + 408, y + 24, globalData, 320, 240))
+      for (const [row, s] of segments.entries()) {
+        const f = files.find(item => item.index === s.index)
+        const out = (job.outputs || []).find(item => item.index === s.index) || {}
+        const delivery = (job.delivery_prompts || []).find(item => item.segment_index === s.index)
+        const edit = (job.delivery_prompt_edits || []).find(item => item.segment_index === s.index)
+        const reverse = promptText(out.reverse_prompt), final = edit?.prompt ?? (promptText(delivery) || reverse)
+        const prefix = `${record.prefix}-${s.index}`, yy = y + 312 + row * 330
+        const segmentId = `${prefix}-segment`, reverseId = `${prefix}-reverse`, finalId = `${prefix}-final`, generationId = `${prefix}-generation`
+        generated.push(node(segmentId, 'video_upload', `片段 ${s.index}`, x + 24, yy,
+          { mediaType: 'video', url: absoluteMedia(f.url, client.baseUrl), file_name: f.file_name || out.file_name || '',
+            aspect_ratio: aspectRatio, duration: Number(s.duration_ms) / 1000, extra: { node_kind: 'asset', repaint: { jobId: job.id, role: 'segment', segmentIndex: s.index } } }))
+        generated.push(node(reverseId, 'text', `反推提示词 ${s.index}`, x + 408, yy, textData(reverse, 'reverse-prompt', s.index), 320, 240))
+        generated.push(node(finalId, 'text', `最终提示词 ${s.index}`, x + 792, yy, textData(final, 'final-prompt', s.index), 320, 240))
+        generated.push(node(generationId, 'video', `生成视频 ${s.index}`, x + 1176, yy,
+          { prompt: '', extra: { aspect_ratio: '16:9', repaint: { jobId: job.id, role: 'generation', segmentIndex: s.index } } }))
+        for (const [a, b, role] of [[detail.id, segmentId, 'source-link'], [segmentId, reverseId, 'segment-reverse-link'], [reverseId, finalId, 'reverse-final-link'], [globalId, finalId, 'global-prompt-link'], [finalId, generationId, 'final-generation-link']]) links.push(edge(`${prefix}-${role}`, a, b, role))
+      }
+      if (generated.some(n => doc.nodes.some(existing => existing.id === n.id))) throw new Error('流程节点 ID 已存在，停止')
+      doc.nodes.push(...generated)
+      links.forEach(e => addEdge(doc, e))
+      if (!group) {
+        if (groups.some(g => g.id === record.groupId)) throw new Error('流程分组 ID 冲突')
+        group = { id: record.groupId, exitedNodeIds: [], position: { x, y }, padding: 24, color: '#2c2c2c', borderColor: 'rgba(255, 255, 255, 0.28)', label: '视频转绘' }
+        groups.push(group)
+      }
+      Object.assign(group, { nodeIds: generated.map(n => n.id), size: { width: 1520, height: 336 + segments.length * 330 }, repaintJobId: job.id,
+        repaint: { ...group.repaint, jobId: job.id, sourceNodeId: detail.id, status: 'completed', layout: { aspectRatio, mediaSize: { width: 320, height: 260 } } } })
+      doc.meta.canvas_groups = groups
+    }
+  }
+  const materialized = Boolean(group?.repaint?.status === 'completed')
+  doc.meta.cli_repaint_workflows = { ...markers, [record.operation]: {
+    job_id: job.id, detail_id: detail.id, source_id: source.id, entry_id: entry.id, status: job.status,
+    plan_version: job.plan_version, materialized,
+    ...(materialized ? { group_id: group.id, node_ids: group.nodeIds } : {}),
+  } }
+  if (doc.meta.cli_repaint_pending?.[record.operation]) {
+    delete doc.meta.cli_repaint_pending[record.operation]
+    if (!Object.keys(doc.meta.cli_repaint_pending).length) delete doc.meta.cli_repaint_pending
+  }
+  if (isDeepStrictEqual([doc.nodes, doc.edges, doc.meta], before)) return { saved: false, version: doc.version, detail_id: detail.id, materialized, group_id: group?.id }
+  const body = { version: doc.version, name: doc.name, viewport: doc.viewport, nodes: doc.nodes, edges: doc.edges, meta: doc.meta }
+  try {
+    const saved = await client.raw(`/canvas/docs/${segment(doc.id)}`, { method: 'PUT', body }, { retry: false })
+    if (saved?.version !== doc.version + 1 || !saved.nodes?.some(n => n.id === detail.id) || saved.meta?.cli_repaint_workflows?.[record.operation]?.job_id !== job.id) throw new Error('画布保存响应不完整')
+    return { saved: true, version: saved.version, detail_id: detail.id, materialized, group_id: group?.id }
+  } catch (error) {
+    if (error.status === 409 || error.apiCode === 3002) throw new Error('画布版本冲突；先读取最新画布，再使用 repaint recover 核对恢复；未自动覆盖', { cause: error })
+    throw new Error('任务仍保留；画布保存结果未确认，使用 repaint recover 查询同一任务并核对恢复，勿重新提交分析', { cause: error })
+  }
+}

package/src/repaint-history.js

@@ -0,0 +1,267 @@
+import crypto from 'node:crypto'
+import { isDeepStrictEqual as equal } from 'node:util'
+import { json, safeName } from './store.js'
+import {
+  reversePath,
+  repaintPromptContext,
+  validateReverseRun
+} from './repaint-reverse.js'
+import { deliveryPath, validateDeliveryRun } from './repaint-delivery.js'
+import {
+  repaintVideoPath,
+  validateRepaintVideoTask,
+  repaintVideoNodeView
+} from './repaint-video.js'
+import { repaintAttachmentView } from './repaint-settings.js'
+import { repaintOf, jobPath } from './repaint-graph.js'
+import { readSource } from './generation-input.js'
+import { requireServiceReady } from './service.js'
+
+const paths = {
+  reverse: reversePath,
+  delivery: deliveryPath,
+  video: repaintVideoPath
+}
+const hash = (v) =>
+  crypto.createHash('sha256').update(JSON.stringify(v)).digest('hex')
+const omit = (v, keys) =>
+  Object.fromEntries(Object.entries(v).filter(([k]) => !keys.includes(k)))
+const text = (v) => String(v || '').trim()
+
+// Read-only path: never relax the binding used by submit/recover. Prompt APIs
+// expose the latest run only; a local journal is not a server archive.
+export async function getRepaintHistory(client, profile, operation, type) {
+  safeName(operation)
+  if (!Object.hasOwn(paths, type))
+    throw new Error('history --type须为reverse、delivery或video')
+  const r = await json(paths[type](profile, operation), null)
+  if (
+    !r ||
+    r.schema !== 1 ||
+    r.profile !== profile ||
+    r.operation !== operation ||
+    r.baseUrl !== client.baseUrl ||
+    !r.binding ||
+    !r.parentOperation
+  )
+    throw new Error('原历史operation不存在或服务/记录绑定不匹配')
+  await requireServiceReady(client)
+  const ctx = await repaintPromptContext(
+    client,
+    profile,
+    r.parentOperation,
+    r.index,
+    { allowUnsyncedGlobal: true }
+  )
+  if (r.owner !== ctx.parent.owner) throw new Error('历史operation账号不匹配')
+  if (
+    !ctx.doc.edges.some(
+      (e) =>
+        e.source === ctx.global.id &&
+        e.target === ctx.final.id &&
+        e.data?.role === 'global-prompt-link'
+    )
+  )
+    throw new Error('原画布全局提示词系统线缺失')
+  let node = ctx.node,
+    binding = { ...ctx.binding },
+    mutable = ['rules']
+  if (type === 'delivery') {
+    node = ctx.final
+    binding = {
+      ...binding,
+      node_id: node.id,
+      reverse_hash: hash(ctx.output.reverse_prompt)
+    }
+    mutable.push('reverse_hash', 'attachments')
+  } else if (type === 'video') {
+    const nodes = ctx.doc.nodes.filter(
+      (n) =>
+        ctx.doc.meta.cli_repaint_workflows[r.parentOperation].node_ids.includes(
+          n.id
+        ) &&
+        repaintOf(n).jobId === ctx.job.id &&
+        repaintOf(n).role === 'generation' &&
+        repaintOf(n).segmentIndex === r.index
+    )
+    if (nodes.length !== 1 || nodes[0].type !== 'video')
+      throw new Error('原画布视频节点关联缺失或不唯一；不认领其他节点')
+    node = nodes[0]
+    if (
+      !ctx.doc.edges.some(
+        (e) =>
+          e.source === ctx.final.id &&
+          e.target === node.id &&
+          e.data?.role === 'final-generation-link'
+      )
+    )
+      throw new Error('原画布最终提示词→视频系统线缺失')
+    binding = {
+      ...binding,
+      reverse_node_id: ctx.node.id,
+      node_id: node.id,
+      final_id: ctx.final.id,
+      final_text: readSource(ctx.final).text
+    }
+    mutable.push('final_text')
+  }
+  if (!equal(omit(binding, mutable), omit(r.binding, mutable)))
+    throw new Error('历史任务的job/方案/片段/来源/节点关联变化，停止查询')
+  const serverAttachments = repaintAttachmentView(
+    ctx.job.delivery_prompt_attachments,
+    client.baseUrl
+  )
+  const canvasAttachments = repaintAttachmentView(
+    repaintOf(ctx.global).attachments,
+    client.baseUrl
+  )
+  const canvasRules = text(
+    ctx.global.data?.output || ctx.global.data?.prompt || ctx.global.data?.input
+  )
+    .replace(/<[^>]*>/g, '')
+    .trim()
+  const changes = {
+    global_rules: ctx.binding.rules !== r.binding.rules,
+    canvas_global_rules: canvasRules !== r.binding.rules,
+    global_settings_synced:
+      canvasRules === ctx.binding.rules &&
+      equal(canvasAttachments, serverAttachments),
+    attachments: Object.hasOwn(r.binding, 'attachments')
+      ? !equal(serverAttachments, r.binding.attachments)
+      : null,
+    ...(type === 'delivery'
+      ? { reverse_prompt: binding.reverse_hash !== r.binding.reverse_hash }
+      : {}),
+    ...(type === 'video'
+      ? { final_prompt: binding.final_text !== r.binding.final_text }
+      : {}),
+    original_attachment_snapshot_available: Object.hasOwn(
+      r.binding,
+      'attachments'
+    )
+  }
+  const out = {
+    operation,
+    repaint_operation: r.parentOperation,
+    type,
+    workflow: 'canvas_redraw',
+    read_only: true,
+    job_id: r.binding.job_id,
+    plan_version: r.binding.plan_version,
+    segment_index: r.index,
+    node_id: r.binding.node_id,
+    operation_state: r.state,
+    current_configuration: changes,
+    original_inputs: {
+      global_rules: r.binding.rules,
+      ...(type === 'video'
+        ? { parameters: r.input, prompt: r.body?.prompt }
+        : {}),
+      ...(type === 'delivery' ? { rules: r.input } : {}),
+      attachment_count: Object.hasOwn(r.binding, 'attachments')
+        ? r.binding.attachments.length
+        : null
+    },
+    original_run_verified: false,
+    result_available: false,
+    result: null,
+    billing: null,
+    canvas_matches_original_result: null,
+    canvas_written: false,
+    generation_submitted: false,
+    processing_submitted: false,
+    material_library_saved: false,
+    next: '仅查看原运行；配置变化后原结果不代表新配置已生效。写回仍走原recover的严格校验，不重新生成。'
+  }
+  if (type === 'video') {
+    if (!r.taskId)
+      return {
+        ...out,
+        status: r.attempted ? 'submission_unknown' : 'not_submitted',
+        reason: '没有原接收task_id；不从任务列表自动认领'
+      }
+    const task = validateRepaintVideoTask(
+      r,
+      await client.raw(
+        jobPath(r.binding.job_id) +
+          '/redraw-tasks/' +
+          encodeURIComponent(r.taskId),
+        { headers: { 'X-Client-Source': 'canvas' } },
+        { retry: false }
+      )
+    )
+    const currentTask = text(
+      node.data?.last_task_id ||
+        node.data?.lastTaskId ||
+        node.data?.result?.task_id
+    )
+    return {
+      ...out,
+      status: task.status,
+      original_run_verified: true,
+      result_available: task.status === 'completed' && !!task.result,
+      task_id: task.id,
+      task,
+      result: task.result || null,
+      billing: {
+        estimated_credit_cost: task.estimated_credit_cost,
+        credit_cost: task.credit_cost,
+        billing_status: task.billing_status
+      },
+      canvas_matches_original_result:
+        task.status === 'completed' &&
+        currentTask === String(task.id) &&
+        Boolean(r.savedView) &&
+        equal(repaintVideoNodeView(node), r.savedView),
+      download: '如需下载仍须原任务download权限接口；本命令不下载或请求文件地址'
+    }
+  }
+  if (!r.accepted)
+    return {
+      ...out,
+      status: r.attempted ? 'submission_unknown' : 'not_submitted',
+      reason: '没有原运行接收证据；当前job结果不归属于该operation'
+    }
+  if (type === 'delivery')
+    ctx.result =
+      (ctx.job.delivery_prompts || []).find(
+        (p) => p.segment_index === r.index
+      ) || null
+  let state
+  try {
+    state =
+      type === 'reverse'
+        ? validateReverseRun(r, ctx)
+        : validateDeliveryRun(r, ctx)
+  } catch {
+    return {
+      ...out,
+      status: 'original_result_unavailable',
+      reason:
+        '服务端当前运行标记或结果与原记录不匹配；提示词接口仅提供当前轮，不能当作原历史结果或自动重做'
+    }
+  }
+  const prompt = state.prompt?.prompt
+  return {
+    ...out,
+    status: state.status,
+    original_run_verified: true,
+    billing: state.billing,
+    result_available: state.status === 'completed' && !!prompt,
+    result: state.status === 'completed' ? state.prompt : null,
+    canvas_matches_original_result:
+      state.status === 'completed' &&
+      text(node.data?.output || node.data?.prompt || node.data?.input) ===
+        text(prompt),
+    ...(type === 'delivery'
+      ? {
+          fallback: ctx.output.delivery_prompt_fallback === true,
+          warning: ctx.output.delivery_prompt_warning || null
+        }
+      : {}),
+    remote_error:
+      ctx.output[
+        type === 'reverse' ? 'reverse_prompt_error' : 'delivery_prompt_error'
+      ] || null
+  }
+}