@mokuyoaxis/dsh-iris 0.2.6 → 0.3.0-alpha.1

package/lib/actions.js

@@ -7,7 +7,7 @@ import { visionInputLimits } from './vision-image-input.js';
  * ① `POST /iris/api/actions/:name` 路由（GUI 直连，submit-only 不等待）
  * ② 工具 execute 体（Agent 调用，可等待）
  *
- * 每个 action 是纯函数 `(host, args, { signal }) => result`，
+ * 每个 action 接收 `(host, args, { signal, core })`，显式使用所属实例，
  * 结果只有可序列化 JSON（无 live 对象）。
  */
 import fs from 'node:fs';
@@ -23,7 +23,6 @@ import { registerMedia, mediaLinksOf, webBase } from './media.js';
 import { RED_TEST_IMAGE } from './vision.js';
 import { runVisionRequest, readVisionImageFile, probeVisionModel, visionImageFromDataUrl } from './vision-model-routing.js';
 import { HOST_CONTRACT_VERSION, HOST_PORTS, defineHostAdapter, hasHostPort, requireHostPort } from './host-contract.js';
-import { coreSnapshotForDsh, importImageForDsh, cropForDsh, diffForDsh, framesForDsh, summaryFramesForDsh, visionImageForDsh, htmlForDsh, inspectProviderTaskForDsh, submitMusicForDsh, submitProviderTaskForDsh, watchProviderTaskForDsh } from './dsh-core-adapter.js';
 import { runLocateRequest, runSummaryRequest } from './composite-vision-routing.js';
 import { normalizeSummarySource, summaryFrameRecords, summaryTimelineLabel } from './summary-input.js';
 import { normalizeVisionImageSource } from './vision-input.js';
@@ -40,12 +39,17 @@ import { normalizeGenerationInput } from './generation-input.js';
 import { videoTaskCandidates } from './video-input.js';
 import { normalizeDshProvider, withDshProviderConfig } from './dsh-provider-config.js';
 import { modelDirectorySummary, modelUnavailableReason } from './model-directory.js';
+import { ModelPortError } from './model-port-contract.js';
+import { compileComfyWorkflow, projectComfyWorkflow } from './comfyui-workflow.js';
+import { createComfyUiClient } from './comfyui-client.js';
+import { inspectComfyWorkflow } from './comfyui-inspection.js';
 
 const PROVIDER_ACTIONS = new Set(['image', 'image_edit', 'video', 'music', 'tts', 'transcribe', 'look', 'relook',
   'locate', 'ocr', 'media_summarize', 'task_reobserve', 'task_redeliver', 'task_manual_retry',
-  'providers_discover', 'providers_sync_directory', 'providers_test_vision', 'providers_test_model']);
+  'providers_discover', 'providers_sync_directory', 'providers_test_vision', 'providers_test_model', 'providers_check_comfy_workflow']);
 const AUTO_DIRECTORY_ACTIONS = new Set(['image', 'image_edit', 'video', 'music', 'tts', 'transcribe', 'look', 'relook',
   'locate', 'ocr', 'media_summarize']);
+const VISION_ACTIONS = new Set(['look', 'relook', 'locate', 'ocr', 'media_summarize']);
 
 const MEDIA_TYPES = {
   '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
@@ -63,6 +67,12 @@ function imageRoutingForModel(provider, modelId) {
   return { ...routing, editSupported: supportsImageEdit(routing.mediaProtocol, modelId) };
 }
 
+function comfySummaryForModel(provider, modelId) {
+  const route = providerForImageModel(provider, modelId);
+  return route.mediaProtocol === 'comfyui' && route.comfyWorkflow !== undefined
+    ? { comfyWorkflow: projectComfyWorkflow(route.comfyWorkflow) } : {};
+}
+
 const EMPTY_ACTION_HOST = defineHostAdapter({
   id: 'iris-hostless',
   ports: {},
@@ -242,8 +252,8 @@ function recordCoreTaskAttemptHealth(task, capability) {
 }
 
 /** DSH 图片入口：同步和异步候选共用一份 Core Task/Attempt/Artifact 事实。 */
-async function submitCoreImage(routes, providerInput, signal, sourceArtifactId) {
-  const submitted = await submitProviderTaskForDsh({
+async function submitCoreImage(core, routes, providerInput, signal, sourceArtifactId) {
+  const submitted = await core.submitProviderTaskForDsh({
     capability: 'image',
     candidates: routes.map((route) => ({
       adapter: route.adapter,
@@ -267,7 +277,7 @@ async function submitCoreImage(routes, providerInput, signal, sourceArtifactId)
   if (!selected) throw taskActionError(task.id, 'Core Task 的供应商身份无法映射回当前路由', task);
   if (task.acceptance === 'accepted' && task.remoteTaskId
       && ['none', 'unknown'].includes(task.outcome) && task.phase !== 'terminal') {
-    await watchProviderTaskForDsh({ taskId: task.id, signal });
+    await core.watchProviderTaskForDsh({ taskId: task.id, signal });
   } else if (task.outcome !== 'succeeded' || task.deliveryState !== 'ready' || !task.artifactIds.length) {
     throw taskActionError(task.id, '图片路由没有得到可观察任务或可交付产物；事实已保留在 Core，未回退重提', task);
   }
@@ -279,7 +289,7 @@ async function submitCoreImage(routes, providerInput, signal, sourceArtifactId)
  * 不共用图片状态机——视频走自己的交付 Profile（video/mp4 / generated-video）。
  * s2v 在写前 Attempt 之后按账号上传首帧和音频，交付复用视频 Profile。
  */
-async function submitCoreVideo(routes, frame, prompt, args, signal) {
+async function submitCoreVideo(core, routes, frame, prompt, args, signal) {
   const normalized = normalizeGenerationInput('video', {
     ...(prompt ? { prompt } : {}),
     ...(frame ? { first_frame_path: frame.absPath } : {}),
@@ -287,7 +297,7 @@ async function submitCoreVideo(routes, frame, prompt, args, signal) {
     size: optionalActionText(args.size),
     duration: args.duration
   }, { allowVideoPaths: true });
-  const submitted = await submitProviderTaskForDsh({
+  const submitted = await core.submitProviderTaskForDsh({
     capability: 'video',
     candidates: videoTaskCandidates(routes.map((route) => ({
       adapter: route.adapter,
@@ -310,7 +320,7 @@ async function submitCoreVideo(routes, frame, prompt, args, signal) {
   if (!selected) throw taskActionError(task.id, 'Core Task 的供应商身份无法映射回当前路由', task);
   if (task.acceptance === 'accepted' && task.remoteTaskId
       && ['none', 'unknown'].includes(task.outcome) && task.phase !== 'terminal') {
-    await watchProviderTaskForDsh({ taskId: task.id, signal });
+    await core.watchProviderTaskForDsh({ taskId: task.id, signal });
   } else if (task.outcome !== 'succeeded' || task.deliveryState !== 'ready' || !task.artifactIds.length) {
     throw taskActionError(task.id, '视频路由没有得到可观察任务或可交付产物；事实已保留在 Core，未回退重提', task);
   }
@@ -472,24 +482,34 @@ export function listActions() {
 }
 
 /** 执行一个动作 */
-export async function runAction(host, name, args, { signal } = {}) {
+export async function runAction(host, name, args, { signal, core } = {}) {
   const fn = actions[name];
-  if (!fn) throw new Error(`iris: 未知动作 "${name}"`);
+  if (!fn) throw new Error('iris: 未知动作 "' + name + '"');
   const adapter = actionHost(host);
-  const execute = async () => {
-    if (AUTO_DIRECTORY_ACTIONS.has(name) && !args?.model) await store.refreshAutomaticDirectories({
-      capability: ({ image: 'image-gen', image_edit: 'image-gen', video: 'video-gen', music: 'music-gen', tts: 'tts', transcribe: 'transcribe' })[name] || 'vision', signal
-    });
-    return fn(adapter, args || {}, { signal });
-  };
-  return PROVIDER_ACTIONS.has(name) ? withDshProviderConfig(adapter, execute, { signal }) : execute();
+  const owned = structuredClone(args || {});
+  return core.runHostOperation(operationSignal => {
+    const execute = async () => {
+      if (AUTO_DIRECTORY_ACTIONS.has(name) && !owned.model) await store.refreshAutomaticDirectories({
+        capability: ({ image: 'image-gen', image_edit: 'image-gen', video: 'video-gen', music: 'music-gen', tts: 'tts', transcribe: 'transcribe' })[name] || 'vision', signal: operationSignal
+      });
+      operationSignal.throwIfAborted();
+      return fn(adapter, owned, { signal: operationSignal, core });
+    };
+    return PROVIDER_ACTIONS.has(name) ? withDshProviderConfig(adapter, execute, { signal: operationSignal }) : execute();
+  }, { signal }).catch(error => {
+    // Ownership can stop the request before it enters the Model Port's error boundary.
+    if (VISION_ACTIONS.has(name) && signal?.aborted && error === signal.reason) {
+      throw new ModelPortError('IRIS_MODEL_ABORTED');
+    }
+    throw error;
+  });
 }
 
 /* ============ 动作实现 ============ */
 
-register('image_import', async (_host, args, { signal }) => {
+register('image_import', async (_host, args, { signal, core }) => {
   if (args.image_path !== undefined && args.image_bytes !== undefined) throw new Error('图片导入只能选择一个来源');
-  const { artifact } = await importImageForDsh({ imagePath: args.image_path, imageBytes: args.image_bytes, signal });
+  const { artifact } = await core.importImageForDsh({ imagePath: args.image_path, imageBytes: args.image_bytes, signal });
   const imageUrl = '/iris/api/core/artifact/' + artifact.id + '/media';
   const text = `已导入图片（${artifact.metadata.width}×${artifact.metadata.height}），原文件保留。\n作品ID：${artifact.id}`;
   return { ok: true, storage: 'core', artifact, artifactId: artifact.id, artifactIds: [artifact.id], imageUrl, text,
@@ -497,16 +517,27 @@ register('image_import', async (_host, args, { signal }) => {
 });
 
 /* ---------- 🖼️ 画图 ---------- */
-async function imageAction(host, args, { signal }, editing = false) {
+async function imageAction(host, args, { signal, core }, editing = false) {
   if (editing && !args.source_artifact_id) throw new Error('iris: 改图必须提供 source_artifact_id');
   const { providerInput, sourceArtifactId } = normalizeGenerationInput('image', {
     prompt: args.prompt, size: optionalActionText(args.size), n: args.n,
+    ...(args.workflow_parameters !== undefined ? { model_ref: args.model, workflow_parameters: args.workflow_parameters } : {}),
     ...(editing ? { source_artifact_id: args.source_artifact_id } : {})
   });
 
   const imageProviders = selectProviders(cap.CAPABILITIES.IMAGE, '图像', args.model);
   const routes = imageProviders.map((provider) => imageRoute(provider, args));
-  const submitted = await submitCoreImage(routes, providerInput, signal, sourceArtifactId);
+  if (args.workflow_sha !== undefined && (typeof args.workflow_sha !== 'string' || routes.length !== 1
+      || projectComfyWorkflow(routes[0].provider.comfyWorkflow)?.sha256 !== args.workflow_sha)) {
+    throw Object.assign(new Error('工作流已变化，请重新选择并核对参数'), { code: 'IRIS_CONFIG_CHANGED' });
+  }
+  if (providerInput.workflow_parameters !== undefined) {
+    if (!models.parseModelRef(args.model) || routes.length !== 1 || routes[0].protocol !== 'comfyui') {
+      throw new TypeError('工作流参数需要明确选择一个 ComfyUI 工作流');
+    }
+    compileComfyWorkflow(routes[0].provider.comfyWorkflow, providerInput);
+  }
+  const submitted = await submitCoreImage(core, routes, providerInput, signal, sourceArtifactId);
   const firstArtifactId = submitted.task.artifactIds[0];
   const ready = submitted.task.outcome === 'succeeded'
     && submitted.task.deliveryState === 'ready' && Boolean(firstArtifactId);
@@ -525,7 +556,7 @@ register('image', imageAction);
 register('image_edit', (host, args, context) => imageAction(host, args, context, true));
 
 /* ---------- 🎬 视频生成 ---------- */
-register('video', async (host, args, { signal }) => {
+register('video', async (host, args, { signal, core }) => {
   const prompt = String(args.prompt || '').trim();
   const frame = await resolveFirstFrameFile(host, args, signal);
   const providers = selectProviders(cap.CAPABILITIES.VIDEO, '视频', args.model);
@@ -545,7 +576,7 @@ register('video', async (host, args, { signal }) => {
   if (!coreRoutes.length) {
     throw new Error(s2v ? 'iris: 未配置可用 s2v 数字人模型' : 'iris: 当前视频候选只有 s2v 数字人模型；请使用 audio_path 的数字人入口');
   }
-  const submitted = await submitCoreVideo(coreRoutes, frame, prompt, args, signal);
+  const submitted = await submitCoreVideo(core, coreRoutes, frame, prompt, args, signal);
   const firstArtifactId = submitted.task.artifactIds[0];
   const ready = submitted.task.outcome === 'succeeded'
     && submitted.task.deliveryState === 'ready' && Boolean(firstArtifactId);
@@ -565,12 +596,12 @@ register('video', async (host, args, { signal }) => {
  * 直接交付 generated-audio Artifact（无 remote 长轮询）。整条候选链共用一个
  * voice（Core providerInput 静态；legacy 曾按候选各自取 provider.ttsVoice）。
  */
-async function submitCoreTts(routes, normalizedInput, signal) {
+async function submitCoreTts(core, routes, normalizedInput, signal) {
   const voice = normalizedInput.voice || String(routes[0].provider.ttsVoice || '').trim();
   const { providerInput } = normalizeGenerationInput('tts', {
     text: normalizedInput.text, ...(voice ? { voice } : {})
   });
-  const submitted = await submitProviderTaskForDsh({
+  const submitted = await core.submitProviderTaskForDsh({
     capability: 'tts',
     candidates: routes.map((route) => ({
       adapter: route.adapter,
@@ -598,7 +629,7 @@ async function submitCoreTts(routes, normalizedInput, signal) {
 }
 
 /* ---------- 🔊 语音合成 ---------- */
-register('music', async (host, args, { signal }) => {
+register('music', async (host, args, { signal, core }) => {
   const normalized = normalizeGenerationInput('music', {
     prompt: args.prompt,
     ...(optionalActionText(args.timeout_ms) !== undefined ? { timeout_ms: args.timeout_ms } : {}),
@@ -606,7 +637,7 @@ register('music', async (host, args, { signal }) => {
     ...(optionalActionText(args.retry_delay_ms) !== undefined ? { retry_delay_ms: args.retry_delay_ms } : {})
   });
   const routes = musicCandidatesFromCatalog({ providers: store.runtimeProviders(), assignments: store.assignments() }, args.model);
-  const submitted = await submitMusicForDsh({
+  const submitted = await core.submitMusicForDsh({
     candidates: routes.map(route => ({ adapter: createConfiguredProviderAdapter(route.provider), model: route.modelRef,
       selectionReason: route.selectionReason, providerBinding: providerTaskBinding(route.provider) })),
     providerInput: normalized.providerInput, musicOptions: normalized.musicOptions, signal
@@ -625,13 +656,13 @@ register('music', async (host, args, { signal }) => {
     text: `[iris] 音乐已生成（${task.modelRef}，重试${submitted.retries}次，Core task: ${task.id}）` };
 });
 
-register('tts', async (host, args, { signal }) => {
+register('tts', async (host, args, { signal, core }) => {
   const { providerInput } = normalizeGenerationInput('tts', {
     text: args.text, voice: optionalActionText(args.voice)
   });
   const providers = selectProviders(cap.CAPABILITIES.TTS, '语音', args.model);
   const routes = providers.map((provider) => simpleModelRoute(provider, args, cap.CAPABILITIES.TTS));
-  const submitted = await submitCoreTts(routes, providerInput, signal);
+  const submitted = await submitCoreTts(core, routes, providerInput, signal);
   const firstArtifactId = submitted.task.artifactIds[0];
   return {
     ok: true, storage: 'core', taskId: submitted.task.id, model: submitted.model,
@@ -648,7 +679,7 @@ register('tts', async (host, args, { signal }) => {
  * 与人工控制面复用同一 Task/Attempt 轴；正文物化为 text/plain transcript Artifact。
  * 已知边界：临时音频 URL 属于首选候选的账号，failover 到不同账号时如实记录失败。
  */
-async function submitCoreTranscribe(routes, normalized, signal) {
+async function submitCoreTranscribe(core, routes, normalized, signal) {
   let providerInput = normalized.providerInput;
   if (normalized.audioPath) {
     const prepared = await prepareProviderInput(routes[0].adapter, {
@@ -656,7 +687,7 @@ async function submitCoreTranscribe(routes, normalized, signal) {
     });
     providerInput = normalizeGenerationInput('transcribe', { audio_url: prepared.url }).providerInput;
   }
-  const submitted = await submitProviderTaskForDsh({
+  const submitted = await core.submitProviderTaskForDsh({
     capability: 'transcribe',
     candidates: routes.map((route) => ({
       adapter: route.adapter,
@@ -679,7 +710,7 @@ async function submitCoreTranscribe(routes, normalized, signal) {
   if (!selected) throw taskActionError(task.id, 'Core Task 的供应商身份无法映射回当前路由', task);
   if (task.acceptance === 'accepted' && task.remoteTaskId
       && ['none', 'unknown'].includes(task.outcome) && task.phase !== 'terminal') {
-    await watchProviderTaskForDsh({ taskId: task.id, signal });
+    await core.watchProviderTaskForDsh({ taskId: task.id, signal });
   } else if (task.outcome !== 'succeeded' || task.deliveryState !== 'ready' || !task.artifactIds.length) {
     throw taskActionError(task.id, '转写路由没有得到可观察任务或可交付产物；事实已保留在 Core，未回退重提', task);
   }
@@ -687,7 +718,7 @@ async function submitCoreTranscribe(routes, normalized, signal) {
 }
 
 /* ---------- 👁 看图 ---------- */
-register('look', async (host, args, { signal }) => {
+register('look', async (host, args, { signal, core }) => {
   const source = normalizeVisionImageSource(args);
   const p = String(args.image_path || '').trim();
   const mt = MEDIA_TYPES[path.extname(p).toLowerCase()];
@@ -699,18 +730,18 @@ register('look', async (host, args, { signal }) => {
   const { answer, via, model } = await askSingleVisionWithHealth(host, { model: args.model,
     question: String(args.question || '').trim() || '详细描述这张图片。',
     prepareImage: operationSignal => source === 'artifact_id'
-      ? visionImageForDsh({ artifactId: args.artifact_id, signal: operationSignal }) : readVisionImageFile(p, mt, operationSignal), signal });
+      ? core.visionImageForDsh({ artifactId: args.artifact_id, signal: operationSignal }) : readVisionImageFile(p, mt, operationSignal), signal });
   const viaLabel = via === 'selfstack' ? 'iris 自持栈' : 'DSH 全局视觉模型';
   return { ok: true, ...(args.artifact_id ? { artifactId: args.artifact_id } : {}),
     text: `[iris] 看图回答（${model} · ${viaLabel}）：\n${answer}` };
 });
 
 /* ---------- ✂️ 裁剪 ---------- */
-register('crop', async (host, args, { signal }) => {
+register('crop', async (host, args, { signal, core }) => {
   const p = String(args.image_path || '').trim();
   if (!p || !path.isAbsolute(p)) throw new Error('iris: image_path 必须是绝对路径');
   if (!fs.existsSync(p)) throw new Error('iris: 图片不存在');
-  const result = await cropForDsh({
+  const result = await core.cropForDsh({
     imagePath: p, left: args.left, top: args.top, width: args.width, height: args.height, signal
   });
   const b64 = result.bytes.toString('base64');
@@ -718,9 +749,9 @@ register('crop', async (host, args, { signal }) => {
 });
 
 /* ---------- 📷 像素 diff ---------- */
-register('diff', async (host, args, { signal }) => {
+register('diff', async (host, args, { signal, core }) => {
   if (!args.image_a_path || !args.image_b_path) throw new Error('iris: 需要 image_a_path 和 image_b_path');
-  const result = await diffForDsh({
+  const result = await core.diffForDsh({
     imageA: { imagePath: args.image_a_path }, imageB: { imagePath: args.image_b_path },
     grid: args.grid, topRegions: args.top_regions, signal
   });
@@ -736,7 +767,7 @@ register('diff', async (host, args, { signal }) => {
 });
 
 /* ---------- 📍 定位 ---------- */
-register('locate', async (host, args, { signal }) => {
+register('locate', async (host, args, { signal, core }) => {
   const source = normalizeVisionImageSource(args);
   const p = String(args.image_path || '').trim();
   if (source === 'image_path' && (!p || !path.isAbsolute(p))) throw new Error('iris: image_path 必须是绝对路径');
@@ -744,25 +775,25 @@ register('locate', async (host, args, { signal }) => {
   const r = await runLocateRequest(host, { providers: store.pickAllFor(cap.CAPABILITIES.VISION), onRateLimit: store.recordRateLimit,
     onModelAvailability: store.recordAvailability, model: args.model,
     target: args.target, prepareImage: operationSignal => source === 'artifact_id'
-      ? visionImageForDsh({ artifactId: args.artifact_id, signal: operationSignal }) : readVisionImageFile(p, mt, operationSignal), signal });
+      ? core.visionImageForDsh({ artifactId: args.artifact_id, signal: operationSignal }) : readVisionImageFile(p, mt, operationSignal), signal });
   const { width, height } = r;
   const provenance = args.artifact_id ? { artifactId: args.artifact_id } : {};
   if (!r.found) return { ok: true, ...provenance, text: `[iris] 在图片中未找到「${args.target}」` };
   return { ok: true, ...provenance, text: `[iris] 定位「${args.target}」：bbox (${r.x1},${r.y1},${r.x2},${r.y2}) / ${width}x${height}（${r.via} · ${r.model}）` };
 });
 /* ---------- 🖼️ HTML 截图 ---------- */
-register('html', async (host, args, { signal }) => {
+register('html', async (host, args, { signal, core }) => {
   const html = String(args.html || '').trim();
   if (!html) throw new Error('iris: html 不能为空');
   const browser = requireHostPort(host, 'browser', 'HTML 截图');
-  const rendered = await htmlForDsh({ browser, html, width: args.width, height: args.height,
+  const rendered = await core.htmlForDsh({ browser, html, width: args.width, height: args.height,
     fullPage: args.fullPage !== false, signal });
   const png = Buffer.from(rendered.bytes);
   return { ok: true, storage: 'core', artifactIds: [rendered.artifact.id], text: `[iris] HTML 截图完成（fullPage: ${args.fullPage !== false}）`, imageDataUrl: `data:image/png;base64,${png.toString('base64')}` };
 });
 
 /* ---------- 📄 长截图 OCR ---------- */
-register('ocr', async (host, args, { signal }) => {
+register('ocr', async (host, args, { signal, core }) => {
   const source = normalizeVisionImageSource(args);
   const p = String(args.image_path || '').trim();
   const mediaType = MEDIA_TYPES[path.extname(p).toLowerCase()];
@@ -773,7 +804,7 @@ register('ocr', async (host, args, { signal }) => {
   const result = await runOcrRequest(host, { providers: store.pickAllFor(cap.CAPABILITIES.VISION),
     onRateLimit: store.recordRateLimit, onModelAvailability: store.recordAvailability,
     prepareImage: operationSignal => source === 'artifact_id'
-      ? visionImageForDsh({ artifactId: args.artifact_id, signal: operationSignal }) : readVisionImageFile(p, mediaType, operationSignal),
+      ? core.visionImageForDsh({ artifactId: args.artifact_id, signal: operationSignal }) : readVisionImageFile(p, mediaType, operationSignal),
     chunkHeight: args.chunk_height, overlap: args.overlap, signal });
   return { ok: result.status !== 'failed', status: result.status,
     totalChunks: result.totalChunks, successfulChunks: result.successfulChunks,
@@ -782,7 +813,7 @@ register('ocr', async (host, args, { signal }) => {
 });
 
 /* ---------- 📋 任务查询 ---------- */
-register('status', async (host, args, { signal }) => {
+register('status', async (host, args, { signal, core }) => {
   const requestedId = String(args.task_id || '').trim();
   if (requestedId) {
     const legacy = tasks.get(requestedId);
@@ -797,14 +828,14 @@ register('status', async (host, args, { signal }) => {
     }
     if (/^task_[a-f0-9]{24}$/.test(requestedId)) {
       try {
-        const core = await inspectProviderTaskForDsh(requestedId, { signal });
-        const lines = [`[${core.capability}] ${core.id} · Core ${core.phase} · ${core.outcome} / ${core.deliveryState} · ${core.modelRef || '未选择模型'}`];
-        if (core.lastError) lines.push('error: ' + core.lastError.safeMessage);
-        if (core.remoteTaskId) lines.push('remoteTask: ' + core.remoteTaskId);
-        if (core.artifactIds.length) {
-          lines.push('artifacts:\n' + core.artifactIds.map((id) => id + ' · /iris/api/core/artifact/' + encodeURIComponent(id) + '/media').join('\n'));
+        const coreTask = await core.inspectProviderTaskForDsh(requestedId, { signal });
+        const lines = [`[${coreTask.capability}] ${coreTask.id} · Core ${coreTask.phase} · ${coreTask.outcome} / ${coreTask.deliveryState} · ${coreTask.modelRef || '未选择模型'}`];
+        if (coreTask.lastError) lines.push('error: ' + coreTask.lastError.safeMessage);
+        if (coreTask.remoteTaskId) lines.push('remoteTask: ' + coreTask.remoteTaskId);
+        if (coreTask.artifactIds.length) {
+          lines.push('artifacts:\n' + coreTask.artifactIds.map((id) => id + ' · /iris/api/core/artifact/' + encodeURIComponent(id) + '/media').join('\n'));
         }
-        return { ok: true, storage: 'core', taskId: core.id, artifactIds: core.artifactIds, text: lines.join('\n') };
+        return { ok: true, storage: 'core', taskId: coreTask.id, artifactIds: coreTask.artifactIds, text: lines.join('\n') };
       } catch (_) { /* 对外统一为不存在，不暴露 Core 数据根 */ }
     }
     throw new Error('iris: 没有这个任务：' + args.task_id);
@@ -816,7 +847,7 @@ register('status', async (host, args, { signal }) => {
   }));
   let coreRows = [];
   try {
-    const snapshot = await coreSnapshotForDsh({ limit: 5, signal });
+    const snapshot = await core.coreSnapshotForDsh({ limit: 5, signal });
     coreRows = (snapshot.tasks.recent || []).map((task) => ({
       at: task.updatedAt,
       text: `[${task.capability}] ${task.id} · Core ${task.phase} · ${task.outcome} / ${task.deliveryState} · ${task.modelRef || '未选择模型'}`
@@ -843,7 +874,7 @@ register('task_reobserve', async (host, args) => {
   return { ok: true, taskId: id, text: '[iris] 已重新观察远端任务；不会重新提交生成请求。' };
 });
 
-register('task_redeliver', async (host, args, { signal }) => {
+register('task_redeliver', async (host, args, { signal, core }) => {
   const id = String(args.task_id || '').trim();
   const task = tasks.get(id);
   if (!task || !tasks.isV2Task(task)) throw new Error('iris: 找不到可重新交付的 Task v2');
@@ -885,7 +916,7 @@ register('task_restore_attention', async (_host, args) => {
   return { ok: true, taskId: id, text: '[iris] 已恢复任务提醒。' };
 });
 
-register('task_manual_retry', async (host, args, { signal }) => {
+register('task_manual_retry', async (host, args, { signal, core }) => {
   const id = String(args.task_id || '').trim();
   if (args.confirm_duplicate_charge !== true) throw new Error('iris: 必须明确确认本次操作可能产生重复任务或重复费用');
   const task = tasks.get(id);
@@ -909,7 +940,7 @@ register('task_manual_retry', async (host, args, { signal }) => {
   if (task.modelRef) retryArgs.model = task.modelRef;
   retryArgs._retryOf = id;
   try {
-    const result = await runAction(host, action, retryArgs, { signal });
+    const result = await runAction(host, action, retryArgs, { signal, core });
     if (result.taskId) tasks.linkManualRetry(id, result.taskId);
     return { ...result, retryOf: id, text: (result.text || '[iris] 已创建新任务')
       + '\n[iris] 原任务提醒已归档，并保留新旧任务关联；本次新任务可能与远端未知任务重复。' };
@@ -1022,7 +1053,7 @@ register('tasks_purge_orphans', async () => {
 });
 
 /* ---------- 👁 重看（GUI：只查 iris 自己的任务产物，无会话上下文） ---------- */
-register('relook', async (host, args, { signal }) => {
+register('relook', async (host, args, { signal, core }) => {
   const id = String(args.attachment_id || '').trim();
   if (!id) throw new Error('iris: attachment_id 不能为空');
   const question = String(args.question || '').trim();
@@ -1080,6 +1111,7 @@ register('providers_list', async (host, args) => {
         ...(m.directoryOnly ? { directoryOnly: true } : {}),
         ...(m.catalogStatus ? { catalogStatus: m.catalogStatus } : {}),
         ...(m.imageProtocol !== undefined ? { imageProtocol: m.imageProtocol } : {}),
+        ...comfySummaryForModel(p, m.id),
         ...(m.musicProtocol !== undefined ? { musicProtocol: m.musicProtocol } : {}),
         ...(m.visionInput !== undefined ? { visionInput: m.visionInput } : {}),
         ...(m.capabilities.includes(cap.CAPABILITIES.VISION) ? { visionInputEffective: visionInputLimits(p, m.id) } : {}),
@@ -1101,6 +1133,34 @@ register('providers_host_connections', async host => {
   return { ok: true, connections: await host.ports.providerConnections.list() };
 });
 
+/** Explicit template save; no provider request or model execution. */
+register('providers_save_comfy_workflow', async (_host, args) => {
+  if (Object.keys(args).some(key => !['id', 'model_id', 'workflow', 'expectedSha', 'enableAutomatic'].includes(key))) throw new TypeError('工作流保存包含不支持的字段');
+  const entry = store.setComfyWorkflow(args.id, args.model_id, args.workflow, {
+    expectedSha: args.expectedSha, enableAutomatic: args.enableAutomatic
+  });
+  return { ok: true, modelId: entry.id, comfyWorkflow: projectComfyWorkflow(entry.comfyWorkflow),
+    text: '工作流已保存；未执行生成' + (args.enableAutomatic ? '，图片功能已使用自动池' : '，功能池设置保持') };
+});
+
+/** Uses only an already saved connection. /object_info never enqueues a prompt. */
+register('providers_check_comfy_workflow', async (_host, args, { signal }) => {
+  if (Object.keys(args).some(key => !['id', 'model_id', 'workflow', 'workflow_parameters'].includes(key))
+      || (args.workflow !== undefined) === (args.model_id !== undefined)) throw new TypeError('请选择已保存工作流或导入一份草稿进行检查');
+  const provider = store.providerById(args.id);
+  if (!provider) throw new TypeError('请先保存并启用 ComfyUI 连接');
+  const route = args.workflow !== undefined ? provider : providerForImageModel(provider, args.model_id);
+  if (route.mediaProtocol !== 'comfyui') throw new TypeError('此检查仅用于 ComfyUI 连接');
+  const file = path.join(store.irisHome(), 'providers.json'), before = fs.readFileSync(file);
+  const workflow = compileComfyWorkflow(args.workflow !== undefined ? args.workflow : route.comfyWorkflow,
+    { workflow_parameters: args.workflow_parameters });
+  const report = await inspectComfyWorkflow(createComfyUiClient(route), workflow, { signal });
+  signal?.throwIfAborted();
+  if (!fs.readFileSync(file).equals(before)) throw Object.assign(new Error('检查期间配置已变化，请重新检查'), { code: 'IRIS_CONFIG_CHANGED' });
+  const key = route.apiKey;
+  return { ok: true, report: key ? JSON.parse(JSON.stringify(report).split(key).join('[redacted]')) : report };
+});
+
 /** 新增/更新供应商 */
 register('providers_upsert', async (host, args) => {
   const id = args.id || undefined;
@@ -1110,6 +1170,7 @@ register('providers_upsert', async (host, args) => {
   for (const key of allowed) {
     if (Object.prototype.hasOwnProperty.call(args, key)) patch[key] = args[key];
   }
+  if (Object.hasOwn(patch, 'auth') && !['none', 'bearer'].includes(patch.auth)) throw new TypeError('认证方式必须为 bearer 或 none');
   if (Object.hasOwn(args, 'dshProvider')) {
     patch.dshProvider = normalizeDshProvider(args.dshProvider);
     const source = requireHostPort(host, 'providerConnections', '复用 DSH 供应商连接');
@@ -1142,7 +1203,7 @@ register('providers_set_models', async (host, args) => {
  * 模型发现：读取供应商目录 → 明确能力元数据 → 合并模型池。
  * 免费只读；拉不到/不支持则原样保留现有池（优雅降级），报人话错误。
  */
-register('providers_discover', async (host, args, { signal }) => {
+register('providers_discover', async (host, args, { signal, core }) => {
   const p = store.providerById(String(args.id || ''));
   if (!p) throw new Error('iris: 供应商不存在或未启用');
   const [updated] = await store.refreshProviderDirectories({ providerId: p.id, force: true, signal });
@@ -1155,7 +1216,7 @@ register('providers_discover', async (host, args, { signal }) => {
 });
 
 /** 只更新目录快照；新增项在管理视图待确认，不改模型用途与功能名单。 */
-register('providers_sync_directory', async (host, args, { signal }) => {
+register('providers_sync_directory', async (host, args, { signal, core }) => {
   const id = String(args.id || '').trim();
   if (!store.providerById(id)) throw new Error('iris: 供应商不存在或连接未就绪');
   const [result] = await store.refreshProviderDirectories({ providerId: id, force: args.force === true, signal });
@@ -1167,7 +1228,7 @@ register('providers_sync_directory', async (host, args, { signal }) => {
 });
 
 /** 能力实测（红色测试图）：对某供应商的 vision 模型跑 testVisionCapability */
-register('providers_test_vision', async (host, args, { signal }) => {
+register('providers_test_vision', async (host, args, { signal, core }) => {
   const p = store.providerById(String(args.id || ''));
   if (!p) throw new Error('iris: 供应商不存在');
   const vision = models.providerModels(p).find(m => m.capabilities.includes(cap.CAPABILITIES.VISION));
@@ -1224,6 +1285,7 @@ async function probeModel(host, p, modelId, capability, signal) {
   }
   if (capability === cap.CAPABILITIES.IMAGE) {
     p = providerForImageModel(p, modelId);
+    if (p.mediaProtocol === 'comfyui') return { skipped: true, ok: false, note: 'ComfyUI 请在画图表单选择工作流验证，以持久 Task 保留受理与结果；只读工作流检查不生成图片' };
     const providerAdapter = createConfiguredProviderAdapter(p, { allowRateLimited: true, modelId });
     const submitted = await invokeProviderOperation(providerAdapter, 'submit', {
       capability: 'image', model: modelId,
@@ -1329,7 +1391,7 @@ register('providers_set_model_vision_input', async (host, args) => {
 });
 
 /** 逐模型实测某能力 → 存 verified（"test it, don't guess it"；用户手动触发，发现不自动跑） */
-register('providers_test_model', async (host, args, { signal }) => {
+register('providers_test_model', async (host, args, { signal, core }) => {
   const p = store.providerById(String(args.id || ''));
   if (!p) throw new Error('iris: 供应商不存在或未启用');
   const modelId = String(args.model_id || '').trim();
@@ -1396,7 +1458,7 @@ register('assignments_get', async (host, args) => {
           ? (c === cap.CAPABILITIES.TTS && selectMediaProtocol(provider).mediaProtocol === 'dashscope'
             && dashscopeTtsProtocolIssue(m.id)) || '当前接口协议不支持此功能'
           : modelUnavailable ? modelUnavailableReason() : m.rateLimited ? '限流冷却或额度不可用，请稍后或检查账号' : m.source === 'discovered' ? '已发现，待确认模型用途' : '',
-        ...(c === cap.CAPABILITIES.IMAGE && provider ? { imageRouting: imageRoutingForModel(provider, m.id) } : {}) });
+        ...(c === cap.CAPABILITIES.IMAGE && provider ? { imageRouting: imageRoutingForModel(provider, m.id), ...comfySummaryForModel(provider, m.id) } : {}) });
     }
   }
   // order：归一化的有序分配列表（GUI 直接渲染 failover 顺序，无需处理单字符串旧格式）
@@ -1485,7 +1547,7 @@ register('attachments_list', async (host, args) => {
  * 把一个附件（会话 image 或 iris 产物）导出为宿主可读的文件路径，供工具消费。
  * iris 产物直接返回其 outputs 路径；会话附件读字节存 uploads/（按 attachmentId 哈希缓存，不重复落盘）。
  */
-register('attachment_export', async (host, args, { signal }) => {
+register('attachment_export', async (host, args, { signal, core }) => {
   const id = String(args.attachment_id || '').trim();
   if (!id) throw new Error('iris: attachment_id 不能为空');
   // 1) iris 自有产物：文件已在 outputs/
@@ -1516,7 +1578,7 @@ register('attachment_export', async (host, args, { signal }) => {
 
 /* ============ 音频转写（阶段 7.2） ============ */
 
-register('transcribe', async (host, args, { signal }) => {
+register('transcribe', async (host, args, { signal, core }) => {
   const normalized = normalizeGenerationInput('transcribe', {
     audio_url: args.audio_url, audio_path: args.audio_path
   }, { allowAudioPath: true });
@@ -1525,7 +1587,7 @@ register('transcribe', async (host, args, { signal }) => {
   const routes = providers.map((provider) =>
     simpleModelRoute(provider, args, cap.CAPABILITIES.TRANSCRIBE)
   );
-  const submitted = await submitCoreTranscribe(routes, normalized, signal);
+  const submitted = await submitCoreTranscribe(core, routes, normalized, signal);
   const firstArtifactId = submitted.task.artifactIds[0];
   const ready = submitted.task.outcome === 'succeeded'
     && submitted.task.deliveryState === 'ready' && Boolean(firstArtifactId);
@@ -1542,8 +1604,8 @@ register('transcribe', async (host, args, { signal }) => {
 
 /* ============ 视频抽帧（阶段 7.1） ============ */
 
-register('video_frames', async (host, args, { signal }) => {
-  const { media: meta, frames } = await framesForDsh({
+register('video_frames', async (host, args, { signal, core }) => {
+  const { media: meta, frames } = await core.framesForDsh({
     videoPath: args.video_path, maxFrames: args.max_frames, targetWidth: args.target_width,
     format: optionalActionText(args.format), quality: args.quality, signal
   });
@@ -1563,7 +1625,7 @@ register('video_frames', async (host, args, { signal }) => {
 
 /* ============ 多模态视频摘要（阶段 7.3，GUI 同步快速版） ============ */
 
-register('media_summarize', async (host, args, { signal }) => {
+register('media_summarize', async (host, args, { signal, core }) => {
   const source = normalizeSummarySource(args);
   const p = String(args.video_path || '').trim();
   if (source === 'video') {
@@ -1576,7 +1638,7 @@ register('media_summarize', async (host, args, { signal }) => {
     providers: store.pickAllFor(cap.CAPABILITIES.VISION), model: args.model, question: args.question, signal,
     async prepareMedia(operationSignal) {
       if (source === 'core-artifacts') {
-        return { ...await summaryFramesForDsh({ frameArtifactIds: args.frame_artifact_ids, signal: operationSignal }), transcript: args.transcribe_text };
+        return { ...await core.summaryFramesForDsh({ frameArtifactIds: args.frame_artifact_ids, signal: operationSignal }), transcript: args.transcribe_text };
       }
       const meta = probeVideo(p);
       const frames = await extractFrames({ inputPath: p, maxFrames: Math.min(Number(args.max_frames) || 8, 12),