@mokuyoaxis/dsh-iris 0.2.5 → 0.2.7

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';
@@ -31,13 +30,23 @@ import { formatOcrResult } from './ocr.js';
 import { runOcrRequest } from './ocr-model-routing.js';
 import { ffmpegAvailable, extractFrames, probeVideo } from './media-probe.js';
 import { ensurePrivateDir, writePrivateFile } from './private-storage.js';
-import { selectMediaProtocol, selectImageProtocol, providerForImageModel, supportsImageEdit } from './provider-protocol.js';
+import { selectMediaProtocol, selectImageProtocol, providerForImageModel, supportsImageEdit, supportsModelCapability, dashscopeTtsProtocolIssue, dashscopeTtsInputIssue } from './provider-protocol.js';
 import { musicCandidatesFromCatalog, providerTaskBinding } from './provider-catalog.js';
 import { invokeProviderOperation, providerPollTaskView, prepareProviderInput } from './provider-adapter.js';
 import { createConfiguredProviderAdapter as createProviderAdapter } from './provider-adapters.js';
 import { deriveUserState } from './task-semantics.js';
 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';
+
+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']);
+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',
@@ -46,6 +55,7 @@ const MEDIA_TYPES = {
 
 function createConfiguredProviderAdapter(provider, options = {}) {
   return createProviderAdapter(provider, { ...options,
+    onModelAvailability: event => store.recordAvailability(event),
     onRateLimit: options.allowRateLimited ? undefined : store.recordRateLimit });
 }
 
@@ -92,11 +102,14 @@ function throwIfAborted(signal) {
  * 不因后续轮询或结果下载失败重提，避免同一请求重复计费。
  */
 function selectProviders(capability, label, requestedModelRef) {
+  const policy = models.functionPolicy(store.assignments()[capability], capability);
+  if (policy.mode === 'disabled') throw new Error('iris: 没有可用' + label + '模型：此功能已停用，请在功能池中选择调用方式');
   let providers = store.pickAllFor(capability);
   const requested = String(requestedModelRef || '').trim();
   if (requested) {
-    const pool = models.orderedModels(models.modelPool(store.providers()), capability, store.assignments()[capability], { includeRateLimited: true });
+    const pool = models.orderedModels(models.functionModelPool(store.providers(), capability, store.assignments()[capability]), capability, store.assignments()[capability], { includeRateLimited: true, includeUnavailable: true });
     const selected = models.resolvePoolModel(pool, requested, capability);
+    if (selected?.unavailableCapabilities?.includes(capability)) throw new Error('iris: ' + modelUnavailableReason());
     if (selected?.rateLimited) throw Object.assign(new Error(store.modelHealth(selected.providerId, selected.id, capability).retryAt
       ? 'iris: 指定模型正在限流冷却，请稍后使用或手动实测'
       : 'iris: 指定模型额度或预算耗尽，请手动实测成功后再使用'), {
@@ -106,7 +119,7 @@ function selectProviders(capability, label, requestedModelRef) {
     providers = selected ? providers.filter((p) => p.id === selected.providerId && p[field] === selected.id) : [];
     if (!providers.length) throw new Error('iris: 指定模型未分配给该功能、不可用或不具备' + label + '能力');
   }
-  if (!providers.length) throw new Error('iris: 没有可用' + label + '供应商——先在 Iris 设置里添加、标注并分配模型');
+  if (!providers.length) throw new Error('iris: 没有可用' + label + '模型：请检查连接、已确认的模型用途、协议和冷却状态；手选模式还需选择模型');
   return providers;
 }
 
@@ -161,13 +174,13 @@ async function observeProviderCapability(route, capability, operation, { recordS
     const result = await operation();
     if (recordSuccess && result && ['accepted', 'completed', 'pending', 'succeeded'].includes(result.kind)) {
       recordProviderHealthSafe(route.provider.id, route.model, capability, {
-        ok: true,
+        ok: true, stage: 'poll',
         category: 'success',
         note: result.kind === 'accepted' ? '任务已受理' : '供应商请求成功'
       });
     } else if (result && result.error) {
       recordProviderHealthSafe(route.provider.id, route.model, capability, {
-        ok: false,
+        ok: false, stage: 'poll',
         category: result.error.category,
         httpStatus: result.error.httpStatus,
         note: result.error.safeMessage
@@ -176,7 +189,7 @@ async function observeProviderCapability(route, capability, operation, { recordS
     return result;
   } catch (error) {
     recordProviderHealthSafe(route.provider.id, route.model, capability, {
-      ok: false,
+      ok: false, stage: 'poll',
       category: error && error.category,
       httpStatus: error && (error.httpStatus ?? error.status),
       note: String(error && (error.safeMessage || error.message) || error)
@@ -200,7 +213,8 @@ function recordVisionHealth(errors) {
 
 async function askSingleVisionWithHealth(host, request) {
   try {
-    const result = await runVisionRequest(host, { providers: store.pickAllFor(cap.CAPABILITIES.VISION), onRateLimit: store.recordRateLimit, ...request });
+    const result = await runVisionRequest(host, { providers: store.pickAllFor(cap.CAPABILITIES.VISION), onRateLimit: store.recordRateLimit,
+      onModelAvailability: store.recordAvailability, ...request });
     recordVisionHealth(result.errors);
     if (result.via === 'selfstack') recordProviderHealthSafe(result.backendId, result.model, cap.CAPABILITIES.VISION, {
       ok: true, category: 'success', note: '视觉请求成功'
@@ -229,8 +243,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,
@@ -254,7 +268,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);
   }
@@ -266,7 +280,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 } : {}),
@@ -274,7 +288,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,
@@ -297,7 +311,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);
   }
@@ -459,17 +473,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}"`);
-  return fn(actionHost(host), args || {}, { signal });
+  if (!fn) throw new Error('iris: 未知动作 "' + name + '"');
+  const adapter = actionHost(host);
+  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,
@@ -477,7 +508,7 @@ 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,
@@ -486,7 +517,7 @@ async function imageAction(host, args, { signal }, editing = false) {
 
   const imageProviders = selectProviders(cap.CAPABILITIES.IMAGE, '图像', args.model);
   const routes = imageProviders.map((provider) => imageRoute(provider, args));
-  const submitted = await submitCoreImage(routes, providerInput, signal, sourceArtifactId);
+  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);
@@ -505,7 +536,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);
@@ -525,7 +556,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);
@@ -545,12 +576,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,
@@ -578,15 +609,15 @@ 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 } : {}),
     ...(optionalActionText(args.retry_502) !== undefined ? { retry_502: args.retry_502 } : {}),
     ...(optionalActionText(args.retry_delay_ms) !== undefined ? { retry_delay_ms: args.retry_delay_ms } : {})
   });
-  const routes = musicCandidatesFromCatalog({ providers: store.allProviders(), assignments: store.assignments() }, args.model);
-  const submitted = await submitMusicForDsh({
+  const routes = musicCandidatesFromCatalog({ providers: store.runtimeProviders(), assignments: store.assignments() }, args.model);
+  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
@@ -605,13 +636,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,
@@ -628,7 +659,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, {
@@ -636,7 +667,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,
@@ -659,7 +690,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);
   }
@@ -667,7 +698,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()];
@@ -679,18 +710,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');
@@ -698,9 +729,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
   });
@@ -716,32 +747,33 @@ 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 必须是绝对路径');
   const mt = MEDIA_TYPES[path.extname(p).toLowerCase()] || 'image/png';
-  const r = await runLocateRequest(host, { providers: store.pickAllFor(cap.CAPABILITIES.VISION), onRateLimit: store.recordRateLimit, model: args.model,
+  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()];
@@ -750,9 +782,9 @@ register('ocr', async (host, args, { signal }) => {
     if (!mediaType || mediaType === 'image/gif') throw new Error('iris: 不支持的图片格式（png/jpg/jpeg/webp）');
   }
   const result = await runOcrRequest(host, { providers: store.pickAllFor(cap.CAPABILITIES.VISION),
-    onRateLimit: store.recordRateLimit,
+    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,
@@ -761,7 +793,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);
@@ -776,14 +808,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);
@@ -795,7 +827,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 || '未选择模型'}`
@@ -822,7 +854,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');
@@ -864,7 +896,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);
@@ -888,7 +920,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] 原任务提醒已归档，并保留新旧任务关联；本次新任务可能与远端未知任务重复。' };
@@ -1001,7 +1033,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();
@@ -1032,22 +1064,32 @@ register('relook', async (host, args, { signal }) => {
 /** 列出全部供应商及其模型池（管理 GUI 用；apiKey 只给 hint） */
 register('providers_list', async (host, args) => {
   const list = store.allProviders();
+  const connections = list.some(provider => provider.dshProvider) && hasHostPort(host, 'providerConnections')
+    ? await host.ports.providerConnections.list() : [];
   return {
     ok: true,
+    setupSuggested: Object.keys(store.assignments()).length === 0 && list.every(provider => models.providerModels(provider).length === 0),
     providers: list.map((p) => ({
       id: p.id,
       name: p.name || p.id,
       type: p.type || 'openai',
-      baseUrl: p.baseUrl,
+      baseUrl: p.dshProvider ? (connections.find(item => item.provider === p.dshProvider.provider
+        && item.settingsNs === p.dshProvider.settingsNs)?.baseUrl || '') : p.baseUrl,
+      ...(p.dshProvider ? { dshProvider: p.dshProvider,
+        connection: connections.find(item => item.provider === p.dshProvider.provider && item.settingsNs === p.dshProvider.settingsNs)
+          || { available: false, reason: 'DSH 原连接不可用，请检查宿主供应商设置' } } : {}),
       mediaBaseUrl: p.mediaBaseUrl || '',
       enabled: p.enabled !== false,
       auth: p.auth === 'none' ? 'none' : 'bearer',
       ...selectMediaProtocol(p),
       visionInput: p.visionInput || null,
-      apiKeyHint: String(p.apiKey || '').length <= 8 ? '****' : String(p.apiKey).slice(0, 3) + '****' + String(p.apiKey).slice(-4),
-      models: models.providerModels(p).map((m) => ({
+      directory: modelDirectorySummary(p),
+      apiKeyHint: p.dshProvider ? '由 DSH 管理' : String(p.apiKey || '').length <= 8 ? '****' : String(p.apiKey).slice(0, 3) + '****' + String(p.apiKey).slice(-4),
+      models: models.providerModelsWithDirectory(p).map((m) => ({
         id: m.id,
         capabilities: m.capabilities,
+        ...(m.directoryOnly ? { directoryOnly: true } : {}),
+        ...(m.catalogStatus ? { catalogStatus: m.catalogStatus } : {}),
         ...(m.imageProtocol !== undefined ? { imageProtocol: m.imageProtocol } : {}),
         ...(m.musicProtocol !== undefined ? { musicProtocol: m.musicProtocol } : {}),
         ...(m.visionInput !== undefined ? { visionInput: m.visionInput } : {}),
@@ -1064,6 +1106,12 @@ register('providers_list', async (host, args) => {
   };
 });
 
+register('providers_host_connections', async host => {
+  if (!hasHostPort(host, 'providerConnections')) return { ok: true, connections: [],
+    note: '当前 DSH 未提供连接复用接口，请手动添加 Iris 供应商' };
+  return { ok: true, connections: await host.ports.providerConnections.list() };
+});
+
 /** 新增/更新供应商 */
 register('providers_upsert', async (host, args) => {
   const id = args.id || undefined;
@@ -1073,6 +1121,16 @@ 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(args, 'dshProvider')) {
+    patch.dshProvider = normalizeDshProvider(args.dshProvider);
+    const source = requireHostPort(host, 'providerConnections', '复用 DSH 供应商连接');
+    const connection = (await source.list()).find(item => item.provider === patch.dshProvider.provider
+      && item.settingsNs === patch.dshProvider.settingsNs);
+    if (!connection?.available) throw new Error(connection?.reason || 'DSH 连接不可用');
+    if (!['dashscope', 'openai-images', 'openai-chat-images', 'openai-responses-images'].includes(patch.mediaProtocol)) {
+      throw new Error('复用 DSH 连接时请明确选择媒体协议');
+    }
+  }
   if (!id && !Object.prototype.hasOwnProperty.call(patch, 'enabled')) patch.enabled = true;
   const saved = store.upsert(patch);
   return { ok: true, providerId: saved.id };
@@ -1095,33 +1153,39 @@ 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: 供应商不存在或未启用');
-  let discoveredModels;
-  try {
-    const providerAdapter = createConfiguredProviderAdapter(p);
-    const discovered = await invokeProviderOperation(providerAdapter, 'discover', { signal });
-    discoveredModels = discovered.models;
-  } catch (err) {
-    throw new Error('iris: 模型发现失败（保留现有池）：' + String(err.message || err));
-  }
-  const entries = discoveredModels.map((model) => ({ id: model.id, capabilities: models.capabilitiesOfDiscoveredModel(model) }));
+  const [updated] = await store.refreshProviderDirectories({ providerId: p.id, force: true, signal });
+  if (updated.error) throw new Error('iris: 模型发现失败（保留现有池）：' + updated.error);
+  const entries = updated.directory.models;
   const mediaCount = entries.filter((model) => model.capabilities.length).length;
   store.mergeDiscoveredModels(p.id, entries);
-  return { ok: true, total: discoveredModels.length, media: mediaCount,
+  return { ok: true, total: entries.length, media: mediaCount,
     text: `[iris] ${p.name}：发现 ${entries.length} 个模型，${mediaCount} 个有能力声明；未标注模型请在模型池中设置能力` };
 });
 
+/** 只更新目录快照；新增项在管理视图待确认，不改模型用途与功能名单。 */
+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 });
+  if (result.error) return { ok: true, synced: false, error: result.error,
+    text: '目录同步失败，已保留上次完整目录：' + result.error };
+  return { ok: true, synced: true, refreshed: result.refreshed,
+    text: result.refreshed ? '模型目录已同步；新模型仍需确认用途' : '目录仍在有效期内',
+    directory: modelDirectorySummary(store.providerById(id)) };
+});
+
 /** 能力实测（红色测试图）：对某供应商的 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));
   if (!vision) return { ok: true, tested: false, text: '该供应商未配置 vision 模型，跳过' };
   const model = vision.id;
   if (args.confirm_paid !== true) throw new Error('iris: 视觉实测会发起真实供应商请求，请先明确确认');
-  const r = await probeVisionModel(p, model, visionImageFromDataUrl(RED_TEST_IMAGE), { timeoutMs: 15000, signal });
+  const r = await probeVisionModel(p, model, visionImageFromDataUrl(RED_TEST_IMAGE), { timeoutMs: 15000, signal, onModelAvailability: store.recordAvailability });
   store.setModelVerified(p.id, model, cap.CAPABILITIES.VISION, {
     ok: r.ok,
     note: r.ok ? '认出红色测试图' : (r.error || '未识别出红色'),
@@ -1146,7 +1210,7 @@ async function probeModel(host, p, modelId, capability, signal) {
     return { skipped: true, ok: false, note: 'Music 不发起小样本探测；请通过音乐功能提交实际创作要求' };
   }
   if (capability === cap.CAPABILITIES.VISION) {
-    const r = await probeVisionModel(p, modelId, visionImageFromDataUrl(RED_TEST_IMAGE), { timeoutMs: 15000, signal });
+    const r = await probeVisionModel(p, modelId, visionImageFromDataUrl(RED_TEST_IMAGE), { timeoutMs: 15000, signal, onModelAvailability: store.recordAvailability });
     return {
       ok: r.ok,
       note: r.ok ? '认出红色测试图' : (r.error || '未识别出红色'),
@@ -1158,6 +1222,8 @@ async function probeModel(host, p, modelId, capability, signal) {
     return { skipped: true, ok: false, note: '需真实音频；可用 CLI models test --capability transcribe --input 提供素材进行实测恢复' };
   }
   if (capability === cap.CAPABILITIES.TTS) {
+    const issue = selectMediaProtocol(p).mediaProtocol === 'dashscope' && dashscopeTtsInputIssue(modelId);
+    if (issue) return { skipped: true, ok: false, note: issue };
     const providerAdapter = createConfiguredProviderAdapter(p, { allowRateLimited: true });
     const submitted = await invokeProviderOperation(providerAdapter, 'submit', {
       capability: 'tts', model: modelId, input: { text: '你好' }, signal
@@ -1231,6 +1297,14 @@ register('providers_add_model', async (host, args) => {
   return { ok: true, text: `[iris] 已添加模型 ${modelId}（能力：${(caps || []).join(',') || '未标注'}）` };
 });
 
+register('providers_confirm_model', async (_host, args) => {
+  const entry = store.confirmModelUsage(args.id, args.model_id, args.capabilities, {
+    enableAutomatic: args.enableAutomatic, musicProtocol: args.musicProtocol
+  });
+  return { ok: true, model_id: entry.id, text: args.enableAutomatic
+    ? '已确认模型用途，并启用所选功能的自动池' : '已确认模型用途；已有调用方式保持' };
+});
+
 /** 从池移除模型 */
 register('providers_remove_model', async (host, args) => {
   const ok = store.removeProviderModel(String(args.id || ''), String(args.model_id || ''));
@@ -1266,7 +1340,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();
@@ -1303,22 +1377,62 @@ register('providers_test_model', async (host, args, { signal }) => {
 register('assignments_get', async (host, args) => {
   const providers = store.allProviders();
   const configured = new Set(store.providers().map(provider => provider.id));
+  const connections = providers.some(provider => provider.dshProvider) && hasHostPort(host, 'providerConnections')
+    ? await host.ports.providerConnections.list() : [];
+  for (const provider of providers) {
+    if (provider.enabled !== false && provider.dshProvider && connections.some(item => item.available
+        && item.provider === provider.dshProvider.provider && item.settingsNs === provider.dshProvider.settingsNs)) {
+      configured.add(provider.id);
+    }
+  }
+  const previewProviders = providers.map(provider => provider.dshProvider ? { ...provider,
+    baseUrl: connections.find(item => item.provider === provider.dshProvider.provider
+      && item.settingsNs === provider.dshProvider.settingsNs)?.baseUrl } : provider);
   const pool = models.modelPool(providers, { includeHostVision: true });
   const byCap = {};
   for (const m of pool) {
     for (const c of m.capabilities) {
       if (!byCap[c]) byCap[c] = [];
-      const provider = providers.find(provider => provider.id === m.providerId);
+      const provider = previewProviders.find(provider => provider.id === m.providerId);
+      const hostResource = m.ref === models.HOST_VISION_REF;
+      const protocolSupported = hostResource || supportsModelCapability(provider, m.id, c);
+      const modelUnavailable = m.unavailableCapabilities?.includes(c) === true;
+      const connected = hostResource ? hasHostPort(host, 'textModel') : configured.has(m.providerId);
       byCap[c].push({ ref: m.ref, id: m.id, providerId: m.providerId,
         label: m.ref === models.HOST_VISION_REF ? 'DSH 当前默认模型' : m.id + ' · ' + m.providerId,
-        unavailable: m.ref !== models.HOST_VISION_REF && (!configured.has(m.providerId) || m.rateLimited === true),
+        unavailable: !connected || !protocolSupported || m.rateLimited === true || modelUnavailable,
+        modelUnavailable,
+        pendingConfirmation: m.source === 'discovered', protocolSupported,
+        reason: !connected ? '连接未就绪，请检查供应商或宿主服务' : !protocolSupported
+          ? (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) } : {}) });
     }
   }
   // order：归一化的有序分配列表（GUI 直接渲染 failover 顺序，无需处理单字符串旧格式）
   const order = {};
   for (const c of Object.values(cap.CAPABILITIES)) order[c] = store.assignmentOrder(c);
-  return { ok: true, assignments: store.assignments(), order, poolByCapability: byCap };
+  const policies = {}, readiness = {};
+  for (const capability of Object.values(cap.CAPABILITIES)) {
+    const assignment = store.assignments()[capability];
+    const policy = models.functionPolicy(assignment, capability);
+    policies[capability] = policy;
+    if (policy.mode === 'auto') order[capability] = models.orderedModels(
+      models.functionModelPool(previewProviders, capability, assignment, { includeHostVision: true }),
+      capability, assignment, { includeRateLimited: true, includeUnavailable: true }).map(model => model.ref);
+    const options = byCap[capability] || [];
+    const candidates = options.filter(model => order[capability].includes(model.ref) && !model.unavailable);
+    let note = '';
+    if (policy.mode === 'disabled') note = '此功能已停用，可选择自动池或手选模型';
+    else if (policy.mode === 'manual' && !order[capability].length) note = '尚未选择模型，可添加所选项或改用自动池';
+    else if (!options.length) note = '请先添加模型，并确认它可用于此功能';
+    else if (!candidates.length) note = options.some(model => model.pendingConfirmation)
+      ? '发现的模型尚待确认用途，请在供应商中确认功能'
+      : options.find(model => model.reason)?.reason || '当前没有匹配的候选，请检查功能范围和模型';
+    readiness[capability] = { mode: policy.mode, candidateCount: candidates.length, note };
+  }
+  return { ok: true, assignments: store.assignments(), order, poolByCapability: byCap, policies, readiness };
 });
 
 /**
@@ -1329,6 +1443,10 @@ register('assignments_get', async (host, args) => {
 register('assignments_set', async (host, args) => {
   const capability = String(args.capability || '').trim();
   if (!capability) throw new Error('iris: capability 不能为空');
+  if (Object.hasOwn(args, 'mode')) {
+    const policy = store.setFunctionPolicy(capability, args.mode, { hostVision: args.hostVision });
+    return { ok: true, capability, mode: policy.mode, model_refs: store.assignmentOrder(capability) };
+  }
   const listArg = Array.isArray(args.model_refs) ? args.model_refs : args.model_ids;
   if (Array.isArray(listArg)) {
     const refs = listArg.map((x) => String(x || '').trim()).filter(Boolean);
@@ -1378,7 +1496,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/
@@ -1409,7 +1527,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 });
@@ -1418,7 +1536,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);
@@ -1435,8 +1553,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
   });
@@ -1456,7 +1574,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') {
@@ -1465,11 +1583,11 @@ register('media_summarize', async (host, args, { signal }) => {
     if (!ffmpegAvailable()) throw new Error('iris: ffmpeg/ffprobe 不可用，无法分析视频（可选安装 ffmpeg 后启用）');
   }
   const { answer, via, model, sheet, meta, frames } = await runSummaryRequest(host, {
-    onRateLimit: store.recordRateLimit,
+    onRateLimit: store.recordRateLimit, onModelAvailability: store.recordAvailability,
     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),