@mokuyoaxis/dsh-iris 0.2.2 → 0.2.3

package/lib/actions.js

@@ -23,7 +23,7 @@ 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, cropForDsh, diffForDsh, framesForDsh, summaryFramesForDsh, visionImageForDsh, htmlForDsh, inspectProviderTaskForDsh, submitProviderTaskForDsh, watchProviderTaskForDsh } from './dsh-core-adapter.js';
+import { coreSnapshotForDsh, 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';
@@ -32,7 +32,7 @@ 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 } from './provider-protocol.js';
-import { providerTaskBinding } from './provider-catalog.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';
@@ -564,6 +564,33 @@ async function submitCoreTts(routes, normalizedInput, signal) {
 }
 
 /* ---------- 🔊 语音合成 ---------- */
+register('music', async (host, args, { signal }) => {
+  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({
+    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
+  });
+  const task = submitted.task;
+  recordCoreTaskAttemptHealth(task, cap.CAPABILITIES.MUSIC);
+  if (submitted.localError) throw taskActionError(task.id, 'Music 结果未能可靠落盘', submitted.localError);
+  if (task.outcome !== 'succeeded' || task.deliveryState !== 'ready') {
+    throw taskActionError(task.id, task.outcome === 'succeeded'
+      ? '音乐已返回，但交付失败；可从缓存重新交付'
+      : `音乐未取得产物（已重试${submitted.retries}次）`, task.lastError);
+  }
+  return { ok: true, storage: 'core', taskId: task.id, taskIds: submitted.taskIds, retries: submitted.retries,
+    model: task.modelRef, providerId: task.providerId, artifactIds: task.artifactIds,
+    audioUrl: '/iris/api/core/artifact/' + encodeURIComponent(task.artifactIds[0]) + '/media',
+    text: `[iris] 音乐已生成（${task.modelRef}，重试${submitted.retries}次，Core task: ${task.id}）` };
+});
+
 register('tts', async (host, args, { signal }) => {
   const { providerInput } = normalizeGenerationInput('tts', {
     text: args.text, voice: optionalActionText(args.voice)
@@ -1008,6 +1035,7 @@ register('providers_list', async (host, args) => {
         id: m.id,
         capabilities: m.capabilities,
         ...(m.imageProtocol !== undefined ? { imageProtocol: m.imageProtocol } : {}),
+        ...(m.musicProtocol !== undefined ? { musicProtocol: m.musicProtocol } : {}),
         ...(m.visionInput !== undefined ? { visionInput: m.visionInput } : {}),
         ...(m.capabilities.includes(cap.CAPABILITIES.VISION) ? { visionInputEffective: visionInputLimits(p, m.id) } : {}),
         ...(m.capabilities.includes(cap.CAPABILITIES.IMAGE) ? { imageRouting: selectImageProtocol(p, m.id) } : {}),
@@ -1100,6 +1128,9 @@ register('providers_test_vision', async (host, args, { signal }) => {
 
 /** 按能力实测单个模型；返回 {ok, note}。真实调用仅在 UI 明确确认后执行。 */
 async function probeModel(host, p, modelId, capability, signal) {
+  if (capability === cap.CAPABILITIES.MUSIC) {
+    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 });
     return {
@@ -1207,6 +1238,12 @@ register('providers_set_model_image_protocol', async (host, args) => {
   return { ok: true, text: '[iris] 模型图片协议已更新' };
 });
 
+register('providers_set_model_music_protocol', async (host, args) => {
+  const ok = store.setModelMusicProtocol(String(args.id || ''), String(args.model_id || ''), args.musicProtocol);
+  if (!ok) throw new Error('iris: 模型不在池中');
+  return { ok: true, text: '[iris] 模型音乐协议已更新' };
+});
+
 register('providers_set_model_vision_input', async (host, args) => {
   if (!Object.hasOwn(args, 'visionInput')) throw new Error('iris: 需要 visionInput 对象或 null');
   const ok = store.setModelVisionInput(String(args.id || ''), String(args.model_id || ''), args.visionInput);
@@ -1221,7 +1258,7 @@ register('providers_test_model', async (host, args, { signal }) => {
   const modelId = String(args.model_id || '').trim();
   const capability = String(args.capability || '').trim();
   if (!modelId || !cap.isKnownCapability(capability)) throw new Error('iris: 需 model_id 与合法 capability');
-  if (![cap.CAPABILITIES.VIDEO, cap.CAPABILITIES.TRANSCRIBE].includes(capability) && args.confirm_paid !== true) {
+  if (![cap.CAPABILITIES.VIDEO, cap.CAPABILITIES.TRANSCRIBE, cap.CAPABILITIES.MUSIC].includes(capability) && args.confirm_paid !== true) {
     throw new Error('iris: 模型实测会发起真实供应商请求，请先明确确认');
   }
   let result;

package/lib/adapters.js

@@ -15,6 +15,7 @@ import { dashscopeApiBase, imageSizeViolation, isDashScopeBaseUrl, normalizeImag
 import { chmodPrivateFile, ensurePrivateDir, privateSibling } from './private-storage.js';
 import { isFreeQuotaExhausted, retryAfterDelay } from './provider-health.js';
 import { ProviderContractError } from './provider-contract.js';
+export { generateMusic } from './music-transport.js';
 
 /**
  * 网络调用超时档位（2026-09-03 健康检查）：挂死的连接绝不能冻住盯守 tick——

package/lib/api.js

@@ -33,9 +33,12 @@ import {
   importPromptOptimizerConfig,
   loadPromptOptimizerConfig,
   resetPromptOptimizerConfig,
+  resetPromptOptimizerInstructions,
   setPromptOptimizerEnabled
 } from './prompt-optimizer-config.js';
 
+const PROMPT_CONFIG_CAPABILITIES = Object.freeze({ ...PROMPT_OPTIMIZER_CAPABILITIES, resetInstructions: true });
+
 function readJsonSafe(file) {
   try {
     const raw = fs.readFileSync(file, 'utf8');
@@ -369,7 +372,7 @@ export function serveApi(req, res, host) {
       return serveSse(res);
     }
     if (urlPath === '/iris/api/prompt-optimizer/config') {
-      return sendJson(res, 200, method === 'HEAD' ? {} : { ...loadPromptOptimizerConfig(), capabilities: PROMPT_OPTIMIZER_CAPABILITIES });
+      return sendJson(res, 200, method === 'HEAD' ? {} : { ...loadPromptOptimizerConfig(), capabilities: PROMPT_CONFIG_CAPABILITIES });
     }
     if (urlPath === '/iris/api/doctor') {
       if (!host || typeof host !== 'object') return sendJson(res, 503, { error: 'host unavailable' });
@@ -506,7 +509,9 @@ function handleJsonPost(req, res, execute, respond = sendJson) {
     if (overflow) return finish(413, { error: 'request body too large (limit 1MB)' });
     try {
       const raw = Buffer.concat(chunks).toString('utf8');
-      const body = raw ? JSON.parse(raw) : {};
+      let body;
+      try { body = raw ? JSON.parse(raw) : {}; }
+      catch (_) { return finish(controller.signal.aborted ? 499 : 400, { error: controller.signal.aborted ? 'request canceled' : 'invalid JSON' }); }
       const result = await execute(body, controller.signal);
       if (controller.signal.aborted) return finish(499, { error: 'request canceled' });
       finish(200, result);
@@ -630,10 +635,14 @@ function handlePromptOptimizer(host, operation, req, res) {
     if (operation === 'optimize') return optimizePrompt(host, body, { signal });
     if (operation === 'import') {
       const imported = body && body.config !== undefined ? body.config : body;
-      return { ok: true, ...importPromptOptimizerConfig(imported), capabilities: PROMPT_OPTIMIZER_CAPABILITIES };
+      return { ok: true, ...importPromptOptimizerConfig(imported), capabilities: PROMPT_CONFIG_CAPABILITIES };
+    }
+    if (operation === 'reset') {
+      const scope = body?.scope === undefined ? 'all' : body.scope;
+      if (!['all', 'instructions'].includes(scope)) throw new Error('scope 只能是 all 或 instructions');
+      return { ok: true, ...(scope === 'instructions' ? resetPromptOptimizerInstructions() : resetPromptOptimizerConfig()), capabilities: PROMPT_CONFIG_CAPABILITIES };
     }
-    if (operation === 'reset') return { ok: true, ...resetPromptOptimizerConfig(), capabilities: PROMPT_OPTIMIZER_CAPABILITIES };
-    if (operation === 'enabled') return { ok: true, ...setPromptOptimizerEnabled(body && body.enabled), capabilities: PROMPT_OPTIMIZER_CAPABILITIES };
+    if (operation === 'enabled') return { ok: true, ...setPromptOptimizerEnabled(body && body.enabled), capabilities: PROMPT_CONFIG_CAPABILITIES };
     throw new Error('unknown prompt optimizer operation');
   });
 }

package/lib/bundled-skills.js

@@ -5,7 +5,7 @@ import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { requireHostPort } from './host-contract.js';
 
-const SKILL_NAMES = ['iris-verify-ui', 'iris-compose-media'];
+const SKILL_NAMES = ['iris-use', 'iris-compose-media', 'iris-verify-ui'];
 const SKILL_ROOT = fileURLToPath(new URL('../.dsh/skills/', import.meta.url));
 
 function parseScalar(value, file) {

package/lib/capability.js

@@ -14,6 +14,7 @@ export const CAPABILITIES = Object.freeze({
   IMAGE: 'image-gen',
   VIDEO: 'video-gen',
   TTS: 'tts',
+  MUSIC: 'music-gen',
   TRANSCRIBE: 'transcribe',
   VISION: 'vision'
 });
@@ -26,6 +27,7 @@ const INFER_FIELD = {
   [CAPABILITIES.IMAGE]: 'imageModel',
   [CAPABILITIES.VIDEO]: 'videoModel',
   [CAPABILITIES.TTS]: 'ttsModel',
+  [CAPABILITIES.MUSIC]: 'musicModel',
   [CAPABILITIES.TRANSCRIBE]: 'transcribeModel',
   [CAPABILITIES.VISION]: 'visionModel'
 };

package/lib/client.js

@@ -21,7 +21,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
   var exports = module.exports;
 
   var React = require('react');
-  var IRIS_CLIENT_VERSION = '0.2.2';
+  var IRIS_CLIENT_VERSION = '0.2.3';
   var HOST_CLIENT_PROTOCOL_VERSION = 0;
   var reportedSeats = [];
 
@@ -810,7 +810,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
     }
 
     /* ---- 模型池（阶段 9 P4）：发现/手动模型 + verified 标记 + 逐模型测试/移除 + 手动添加 ---- */
-    var CAP_SHORT = { 'image-gen': '图', 'video-gen': '视', 'tts': '音', 'transcribe': '转', 'vision': '视👁' };
+    var CAP_SHORT = { 'image-gen': '图', 'video-gen': '视', 'tts': '音', 'music-gen': '乐', 'transcribe': '转', 'vision': '视👁' };
     function ModelPool(props) {
       var p = props.provider;
       var addPair = React.useState('');
@@ -821,6 +821,11 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         postAction('providers_set_model_image_protocol', { id: p.id, model_id: m.id, imageProtocol: value })
           .then(function (r) { props.onNote(r.ok ? '模型图片协议已更新' : (r.d.error || '更新失败')); if (r.ok) props.onDone(); });
       }
+      function setMusicProtocol(m, value) {
+        if (!value) return;
+        postAction('providers_set_model_music_protocol', { id: p.id, model_id: m.id, musicProtocol: value })
+          .then(function (r) { props.onNote(r.ok ? '模型音乐协议已更新' : (r.d.error || '更新失败')); if (r.ok) props.onDone(); });
+      }
       function verBadge(m, c) {
         var health = m.health && m.health[c];
         var status = health && HEALTH_META[health.status] ? health.status : 'configured';
@@ -849,6 +854,10 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
               React.createElement('option', { value: 'openai-chat-images' }, '聊天生图（网关兼容）'),
               React.createElement('option', { value: 'openai-responses-images' }, 'Responses 生图')),
             m.imageRouting && m.imageRouting.protocolInferred ? ' · 协议待确认' : null) : null,
+          caps.includes('music-gen') ? React.createElement('label', { className: 'iris-pm-note' }, '音乐协议 ',
+            React.createElement('select', { value: m.musicProtocol || '', onChange: function (e) { setMusicProtocol(m, e.target.value); } },
+              React.createElement('option', { value: '' }, '请选择音乐协议'),
+              React.createElement('option', { value: 'gemini-web-music' }, 'Chat Completions（内嵌音频）'))) : null,
           caps.includes('vision') || (caps.includes('image-gen') && m.imageRouting && m.imageRouting.mediaProtocol === 'openai-chat-images') ? React.createElement(VisionInputEditor, { key: 'vision-input', provider: p, model: m,
             onNote: props.onNote, onDone: props.onDone }) : null,
           blocked ? React.createElement('span', { className: 'iris-pm-ver failed ' + healthClass(blocked), title: healthText(blocked) }, rateLimitLabel(blocked)) : null,
@@ -1000,7 +1009,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         postAction('providers_discover', { id: p.id }).then(function (r) { setNote(r.d.text || r.d.error || '发现完成'); refresh(); });
       }
       function testModel(p, m, capability) {
-        var noProbe = capability === 'video-gen' || capability === 'transcribe';
+        var noProbe = capability === 'video-gen' || capability === 'transcribe' || capability === 'music-gen';
         if (!noProbe && !window.confirm('将用模型「' + m.id + '」发起一次真实的 ' + capability + ' 请求，可能产生费用。继续吗？')) return;
         setNote('验证 ' + m.id + ' · ' + capability + '…');
         postAction('providers_test_model', { id: p.id, model_id: m.id, capability: capability, confirm_paid: !noProbe })
@@ -1166,7 +1175,8 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
           if (!r.ok || !r.d) return;
           var opts = (r.d.poolByCapability && r.d.poolByCapability[capability]) || [];
           var ord = (r.d.order && r.d.order[capability]) || [];
-          var assignedRef = ord[0] || (opts[0] && opts[0].ref) || '';
+          if (capability === 'music-gen') opts = opts.filter(function (option) { return ord.includes(option.ref); });
+          var assignedRef = ord[0] || (capability !== 'music-gen' && opts[0] && opts[0].ref) || '';
           var assignedOpt = opts.find(function (o) { return o.ref === assignedRef; });
           // 不再自动填 vals.model：留空 = 用能力分配的解析结果（避免绕过分配）
           setModelInfo({ assigned: assignedOpt ? assignedOpt.label : '', assignedRef: assignedRef, options: opts, loaded: true });
@@ -1183,7 +1193,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         })
           .then(function (r) { return r.json().then(function (d) { return { ok: r.ok, d: d }; }); })
           .then(function (res) {
-            setRun(res.ok ? { ok: true, text: res.d.text || '', img: res.d.imageUrl || res.d.imageDataUrl || null } : { ok: false, text: res.d.error || '执行失败' });
+            setRun(res.ok ? { ok: true, text: res.d.text || '', img: res.d.imageUrl || res.d.imageDataUrl || null, audio: res.d.audioUrl || null } : { ok: false, text: res.d.error || '执行失败' });
             if (res.ok && res.d && res.d.storage === 'core') window.dispatchEvent(new CustomEvent('iris-core-artifacts-changed'));
           })
           .catch(function () { setRun({ ok: false, text: '网络错误' }); });
@@ -1193,6 +1203,14 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
       if (open) {
         var inputs = fields.map(function (f) {
           var node;
+          if (f.key === 'model' && capability === 'music-gen') {
+            node = React.createElement('select', { value: vals.model || '', onChange: function (e) { setVal('model', e.target.value); } },
+              React.createElement('option', { value: '' }, '按 Music 分配顺序'),
+              ((modelInfo && modelInfo.options) || []).map(function (option) {
+                return React.createElement('option', { key: option.ref, value: option.ref }, option.label);
+              }));
+            return React.createElement('div', { key: f.key, className: 'iris-act-field' }, React.createElement('label', {}, f.label), node);
+          }
           if (f.type === 'file') {
             node = React.createElement(FileField, { value: vals[f.key] || '', accept: f.accept || '', onChange: function (v) { setVal(f.key, v); } });
             return React.createElement('div', { key: f.key, className: 'iris-act-field' },
@@ -1220,6 +1238,10 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
             result = React.createElement('div', { className: 'iris-act-result' },
               React.createElement('div', {}, run.text),
               React.createElement('img', { className: 'iris-act-img', src: run.img, alt: '结果' }));
+          } else if (run.ok && run.audio) {
+            result = React.createElement('div', { className: 'iris-act-result' }, React.createElement('div', {}, run.text),
+              React.createElement('audio', { src: run.audio, controls: true, preload: 'metadata' }),
+              React.createElement('a', { href: run.audio, download: '' }, '下载音乐'));
           } else {
             result = React.createElement('div', { className: 'iris-act-result' + (run.ok ? '' : ' err') }, run.text);
           }
@@ -1232,7 +1254,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
           modelBar = React.createElement('div', { className: 'iris-act-field' },
             React.createElement('label', {},
               React.createElement('span', { className: 'iris-pm-dot ' + healthClass(cardHealth) }, cardHealth.retryAt ? '◷' : HEALTH_META[cardHealth.status].symbol),
-              ' 模型：' + (shown || '自动') + (available ? '' : '（无可用模型）')),
+              ' 模型：' + (shown || (capability === 'music-gen' ? '未分配' : '自动')) + (available ? '' : '（无可用模型）')),
             React.createElement('div', { className: 'iris-wb-muted' },
               healthText(cardHealth) + ' · 改分配 → 上方「能力分配（failover 顺序）」'));
         }
@@ -1272,6 +1294,12 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
       { action: 'tts', title: '🔊 语音合成', capability: 'tts', fields: [
         { key: 'text', label: '文本', type: 'textarea', placeholder: '要合成的文字' },
         { key: 'voice', label: '音色 (可选)', placeholder: '如 Cherry' }] },
+      { action: 'music', title: '🎵 音乐生成', capability: 'music-gen', fields: [
+        { key: 'prompt', label: '音乐描述', type: 'textarea', placeholder: '描述风格、情绪、乐器；歌词、演唱语言和期望时长也可写在这里' },
+        { key: 'model', label: '音乐模型' },
+        { key: 'timeout_ms', label: '单次等待上限（毫秒，可选）', type: 'number', placeholder: '300000' },
+        { key: 'retry_502', label: '502重新生成次数（可选，会额外占用调用额度）', type: 'number', placeholder: '2（0关闭，最多5）' },
+        { key: 'retry_delay_ms', label: '重试等待（毫秒，可选）', type: 'number', placeholder: '5000' }] },
       { action: 'transcribe', title: '🎙️ 音频转写', capability: 'transcribe', fields: [
         { key: 'audio_path', label: '音频文件', type: 'file', accept: 'audio/*', placeholder: '/path/audio.wav' }] },
       { action: 'video_frames', title: '🎞️ 视频抽帧', fields: [
@@ -1325,6 +1353,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
       { cap: 'image-gen', label: '🎨 画图' },
       { cap: 'video-gen', label: '🎬 视频' },
       { cap: 'tts', label: '🔊 语音' },
+      { cap: 'music-gen', label: '🎵 音乐' },
       { cap: 'transcribe', label: '🎙️ 转写' },
       { cap: 'vision', label: '👁 视觉' }
     ];
@@ -1370,7 +1399,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         });
         return React.createElement('div', { key: row.cap, className: 'iris-cap-row' },
           React.createElement('span', { className: 'iris-cap-name' }, row.label),
-          chips.length ? chips : React.createElement('span', { className: 'iris-cap-auto' }, '自动（按池顺序）'),
+          chips.length ? chips : React.createElement('span', { className: 'iris-cap-auto' }, row.cap === 'music-gen' ? '尚未分配音乐模型' : '自动（按池顺序）'),
           available.length ? React.createElement('select', {
             className: 'iris-pm-model-sel', value: '',
             onChange: function (e) { if (e.target.value) save(row.cap, list.concat([e.target.value])); }
@@ -1988,7 +2017,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
     }
 
     function coreCapabilityLabel(value) {
-      return ({ image: '图片生成', video: '视频生成', tts: '语音合成', transcribe: '音频转写' })[value] || String(value || '媒体任务');
+      return ({ image: '图片生成', video: '视频生成', tts: '语音合成', music: '音乐生成', transcribe: '音频转写' })[value] || String(value || '媒体任务');
     }
 
     /* 高级诊断与用户任务区共用五类用户状态投影；与服务端 lib/core-user-projection.js 保持同一映射，
@@ -2522,6 +2551,24 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         note ? React.createElement('div', { className: 'iris-clean-note', style: { width: '100%' } }, note) : null);
     }
 
+    function promptConfigFeedback(state) {
+      var warnings = state && state.feedback && state.feedback.warnings;
+      if (!Array.isArray(warnings) || !warnings.length) return null;
+      return React.createElement('div', { className: 'iris-po-note', role: 'status' }, warnings.map(function (warning, index) {
+        var text = '';
+        if (warning.code === 'config-fallback') {
+          text = warning.reason === 'read-failed' ? '配置读取失败，当前使用 Iris 默认设置。' : '配置内容无效，当前使用 Iris 默认设置。';
+          text += warning.isolation === 'saved' ? '原文件已隔离保留，可在修正后重新导入。'
+            : warning.isolation === 'failed' ? '隔离未完成，Iris 没有覆盖原文件；请检查原文件。' : '原文件未移动；请检查文件读取权限。';
+        } else if (warning.code === 'ignored-fields' && Array.isArray(warning.fields)) {
+          text = '已忽略不支持或当前路由未使用的字段：' + warning.fields.filter(function (field) { return typeof field === 'string'; }).map(function (field) { return JSON.stringify(field); }).join('、');
+          if (warning.count > warning.fields.length) text += '（共 ' + warning.count + ' 个，仅显示前 ' + warning.fields.length + ' 个）';
+          text += '。请检查字段名；这些字段未保存到配置。';
+        }
+        return text ? React.createElement('div', { key: index }, text) : null;
+      }));
+    }
+
     function PromptOptimizerSettings() {
       var pair = React.useState(null);
       var state = pair[0];
@@ -2566,6 +2613,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
           React.createElement('span', { style: { flex: 1 } }, enabled ? '对话框入口已启用' : '对话框入口已关闭'),
           React.createElement('button', { className: 'iris-pm-btn', onClick: toggle }, enabled ? '关闭入口' : '重新启用')),
         React.createElement('div', { className: 'iris-wb-muted' }, '这里只控制对话框提示词优化入口；Iris 工作台、Agent 工具和任务后台始终保持运行。'),
+        promptConfigFeedback(state),
         note ? React.createElement('div', { className: 'iris-clean-note' }, note) : null);
     }
 
@@ -2757,6 +2805,18 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
       return { removed: before.slice(start, before.length - end).join(''), added: after.slice(start, after.length - end).join('') };
     }
 
+    function promptRequestSnapshot(processing, title) {
+      var request = processing && processing.request;
+      if (!request || typeof request.system !== 'string' || typeof request.prompt !== 'string') return null;
+      return React.createElement('details', { className: 'iris-po-config' },
+        React.createElement('summary', {}, title),
+        React.createElement('div', { className: 'iris-po-muted' }, 'Iris 发送的指令快照；宿主或供应商后续处理可能不同。'),
+        React.createElement('div', { className: 'iris-po-result-label' }, '系统指令 · 含本次规则与输出协议'),
+        React.createElement('div', { className: 'iris-po-template', 'aria-label': title + ' · 系统指令' }, request.system),
+        React.createElement('div', { className: 'iris-po-result-label' }, '用户输入 · 含素材包装'),
+        React.createElement('div', { className: 'iris-po-template', 'aria-label': title + ' · 用户输入' }, request.prompt));
+    }
+
     function PromptOptimizerControl(props) {
       var draft = props.useInput(function (value) { return value.draft; });
       var phase = props.useInput(function (value) { return value.phase; });
@@ -2822,7 +2882,9 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
       var supportsAssembly = !!(configState && configState.capabilities && configState.capabilities.assemble === true);
       var editingCapabilities = configState && configState.capabilities && configState.capabilities.editing;
       var supportsFaithful = Array.isArray(editingCapabilities) && editingCapabilities.indexOf('faithful') >= 0 && editingCapabilities.indexOf('rewrite') >= 0;
+      var supportsLocalFaithful = supportsFaithful && configState.capabilities.localFaithful === true;
       var supportsSuggestions = Array.isArray(editingCapabilities) && editingCapabilities.indexOf('suggestions') >= 0;
+      var supportsResetInstructions = !!(configState && configState.capabilities && configState.capabilities.resetInstructions === true);
       function supportsTarget(value) {
         var available = configState && configState.capabilities && configState.capabilities.targets;
         return Array.isArray(available) ? available.indexOf(value) >= 0 : value !== 'image-edit';
@@ -2922,12 +2984,12 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         if (abortRef.current) abortRef.current.abort();
         var controller = new AbortController();
         var requestSessionId = props.sessionId;
+        var previousResult = result;
+        var previewSnapshot = edited;
         abortRef.current = controller;
         setBusy(true);
-        setNote(mode === 'assemble' ? '正在组装，不调用模型…' : '正在调用模型优化…这可能产生模型费用');
-        setResult(null);
-        setSuggestions(null); setSelectedSuggestions([]); setSuggestionUndo([]);
-        lastWrittenRef.current = null;
+        setNote(mode === 'assemble' ? '正在组装，不调用模型…' : supportsLocalFaithful && editing === 'faithful'
+          ? '正在忠实整理…需要分段时可能调用模型并产生费用' : '正在调用模型优化…这可能产生模型费用');
         promptRequest('optimize', {
           text: draft,
           target: target,
@@ -2943,14 +3005,20 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
           if (data.original !== draft) throw new Error('结果原稿与本次请求不一致');
           if (mode === 'optimize' && supportsFaithful && editing === 'faithful'
               && (data.editing?.strategy !== 'faithful' || data.editing.coverage !== 'exact' || data.editing.order !== 'preserved')) throw new Error('后端未确认完整的忠实整理结果');
+          if (resultRef.current !== previousResult || editedRef.current !== previewSnapshot) {
+            setNote('预览已变化，本次结果未替换；你的编辑已保留。'); return;
+          }
           setResult(data);
           setEdited(data.optimized);
+          setSuggestions(null); setSelectedSuggestions([]); setSuggestionUndo([]);
+          lastWrittenRef.current = null;
           resultSessionRef.current = requestSessionId;
-          setNote('已生成预览，尚未写回输入框');
+          setNote(data.execution?.reason === 'single-part-faithful' && data.execution.modelInvocations === 0
+            ? '原文无需分段，未调用模型；尚未写回输入框' : '已生成预览，尚未写回输入框');
         }).catch(function (err) {
           if (abortRef.current !== controller) return;
           if (controller.signal.aborted) setNote('已取消');
-          else setNote(String(err && err.message || err));
+          else setNote(String(err && err.message || err) + (previousResult ? '；原有预览已保留' : ''));
         }).finally(function () {
           if (abortRef.current === controller) { abortRef.current = null; setBusy(false); }
         });
@@ -2980,7 +3048,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
                     || typeof item.text !== 'string' || !item.text.trim() || item.text.length > 600) return false;
                 ids.push(item.id); return true;
               }) || !data.questions.every(function (text) { return typeof text === 'string' && text.trim() && text.length <= 600; })) throw new Error('未收到完整补充建议');
-          setSuggestions({ source: snapshot, items: data.suggestions, questions: data.questions, adopted: [] });
+          setSuggestions({ source: snapshot, items: data.suggestions, questions: data.questions, adopted: [], processing: data.processing });
           setSelectedSuggestions([]); setSuggestionUndo([]);
           setNote('建议尚未加入正文；只有采纳所选建议才会改变预览。');
         }).catch(function (err) {
@@ -3060,7 +3128,8 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         event.target.value = '';
         if (!file) return;
         file.text().then(function (raw) {
-          var parsed = JSON.parse(raw);
+          var parsed;
+          try { parsed = JSON.parse(raw); } catch (_) { throw new Error('文件不是有效 JSON，请检查格式后重新导入'); }
           return promptRequest('import', { config: parsed });
         }).then(function (data) {
           publishConfig(data);
@@ -3086,11 +3155,14 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         }
       }
 
-      function resetConfig() {
-        if (!window.confirm('恢复 Iris 内置默认 Prompt、目标模板和会话模型路由？')) return;
-        promptRequest('reset', {}).then(function (data) {
+      function resetConfig(scope) {
+        if (scope === 'instructions' && !supportsResetInstructions) { setNote('当前后端不支持仅恢复指令，请更新后重新载入'); return; }
+        var question = scope === 'instructions' ? '仅恢复 Iris 内置系统指令和全部用途模板？模型路由、生成参数和入口开关保持不变。'
+          : '恢复全部 Iris 提示词设置？系统指令、全部用途模板、模型路由、生成参数与预算、入口开关都会重置；模型路由恢复为当前会话，入口重新启用。';
+        if (!window.confirm(question)) return;
+        promptRequest('reset', { scope: scope }).then(function (data) {
           publishConfig(data);
-          setNote('已恢复 Iris 内置默认配置');
+          setNote(scope === 'instructions' ? '已恢复默认指令；模型路由、生成参数与入口开关保持不变' : '已恢复全部 Iris 提示词设置');
         }).catch(function (err) {
           setNote('重置失败：' + String(err && err.message || err));
         });
@@ -3120,6 +3192,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
       var resultTarget = result && PROMPT_TARGET_OPTIONS.find(function (item) { return item.value === result.target; });
       var config = configState && configState.config;
       var targetTemplate = config && config.targets && config.targets[target];
+      var requestConfigFeedback = result && promptConfigFeedback({ feedback: result.configFeedback });
       function ruleField(label, value, update, placeholder) {
         return React.createElement('label', { className: 'iris-po-field' }, React.createElement('span', {}, label),
           React.createElement('textarea', { value: value, disabled: busy || !supportsRules, placeholder: placeholder,
@@ -3141,7 +3214,8 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
             React.createElement('strong', { className: 'iris-po-title' }, React.createElement('span', { className: 'iris-po-mark' }, '🫧'), 'Iris 提示词优化'),
             React.createElement('button', { className: 'iris-po-close', onClick: closePanel, title: '关闭', 'aria-label': '关闭提示词优化' }, '✕')),
           React.createElement('div', { className: 'iris-po-intro' },
-            React.createElement('div', { className: 'iris-po-muted' }, '按用途整理草稿，先预览和编辑，再决定是否写回。'),
+          React.createElement('div', { className: 'iris-po-muted' }, '按用途整理草稿，先预览和编辑，再决定是否写回。'),
+          promptConfigFeedback(configState),
             React.createElement('div', { className: 'iris-po-principles' },
               React.createElement('span', {}, '保留原意'), React.createElement('span', {}, '可查看改动'), React.createElement('span', {}, '确认后写回'))),
           React.createElement('details', { className: 'iris-po-section', open: generalOpen,
@@ -3177,7 +3251,9 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
             React.createElement('button', { className: 'iris-po-primary', disabled: busy || !draft || !draft.trim() || phase !== 'plain' || refCount > 0, onClick: function () { optimize('optimize'); } }, busy ? '处理中…' : supportsFaithful ? editing === 'faithful' ? '忠实整理' : '改写表达' : '智能优化'),
             React.createElement('button', { className: 'iris-po-btn', disabled: busy || !supportsAssembly || !draft || !draft.trim() || phase !== 'plain' || refCount > 0, onClick: function () { optimize('assemble'); } }, '只组装（不调用模型）'),
             busy ? React.createElement('button', { className: 'iris-po-btn', onClick: cancel }, '取消') : null),
-          React.createElement('div', { className: 'iris-po-muted' }, '智能优化调用文本模型，可能产生费用；只组装原稿与前后缀。'),
+          React.createElement('div', { className: 'iris-po-muted' }, supportsLocalFaithful
+            ? '单片段忠实整理与只组装不调用模型；其他优化及获取建议可能产生模型费用。'
+            : '智能优化调用文本模型，可能产生费用；只组装原稿与前后缀。'),
           result ? React.createElement('div', { className: 'iris-po-result' },
             React.createElement('div', { className: 'iris-po-result-label' }, '结果预览 · ' + (resultTarget ? resultTarget.label + ' · ' : '') + '可编辑 · ' + edited.length + ' 字符'),
             React.createElement('textarea', { 'aria-label': '结果预览', value: edited, onChange: function (event) { editPreview(event.target.value); } }),
@@ -3197,6 +3273,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
                 !suggestions.items.length ? React.createElement('div', { className: 'iris-po-muted' }, '没有额外补充建议。') : null,
                 suggestions.questions.length ? React.createElement('div', { className: 'iris-po-suggestion' }, React.createElement('strong', {}, '待确认 · 尚未作为要求'),
                   suggestions.questions.map(function (question, index) { return React.createElement('p', { key: index }, question); })) : null,
+                promptRequestSnapshot(suggestions.processing, '本次建议完整指令'),
                 React.createElement('div', { className: 'iris-po-actions' },
                   React.createElement('button', { className: 'iris-po-btn', disabled: busy || !selectedSuggestions.length, onClick: adoptSuggestions }, '采纳所选建议'),
                   React.createElement('button', { className: 'iris-po-btn', disabled: busy || !suggestionUndo.length, onClick: undoSuggestions }, '撤回上次采纳'))) : null) : null,
@@ -3212,7 +3289,13 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
                 return React.createElement('div', { className: 'iris-po-diff', key: rule.id }, rule.label + '（' + (rule.kind === 'optimization' ? '指导改写' : rule.position === 'prefix' ? '输出前缀' : '输出后缀') + '）\n' + rule.text);
               }) : React.createElement('div', { className: 'iris-po-muted' }, '未选择额外规则'),
               result.processing ? React.createElement('div', { className: 'iris-po-diff' }, '优化处理规则：\n' + result.processing.systemPrompt + '\n\n目标模板：\n' + result.processing.targetTemplate) : null),
-            React.createElement('div', { className: 'iris-po-route' }, result.route ? '实际使用：' + result.route.provider + ' / ' + result.route.model + ' · 思考：' + (result.route.reasoningEffort === 'provider-default' ? '供应商默认' : result.route.reasoningEffort) : '本次只组装，未调用模型'),
+            promptRequestSnapshot(result.processing, '本次正文处理完整指令'),
+            React.createElement('div', { className: 'iris-po-route' }, result.route ? '实际使用：' + result.route.provider + ' / ' + result.route.model + ' · 思考：' + (result.route.reasoningEffort === 'provider-default' ? '供应商默认' : result.route.reasoningEffort)
+              : result.execution?.reason === 'single-part-faithful' && result.execution.modelInvocations === 0 ? '忠实整理：无需分段，未调用模型'
+              : result.mode === 'assemble' ? '本次只组装，未调用模型' : '未提供模型调用信息'),
+            result.route && result.route.reason ? React.createElement('div', { className: 'iris-po-muted' }, '选择原因：' + result.route.reason + ' · ' + (result.route.textInput === 'supported' ? '宿主声明支持文本输入' : '文本输入能力未知')) : null,
+            requestConfigFeedback ? React.createElement('details', { className: 'iris-po-config' },
+              React.createElement('summary', {}, '本次请求的配置反馈'), requestConfigFeedback) : null,
             React.createElement('div', { className: 'iris-po-actions' },
               React.createElement('button', { className: 'iris-po-primary', onClick: function () { replaceDraft(edited); } }, '写回输入框'),
               React.createElement('button', { className: 'iris-po-btn', onClick: copyResult }, '复制'),
@@ -3226,11 +3309,13 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
               React.createElement('div', { className: 'iris-po-template' }, config && config.systemPrompt || '配置尚未载入'),
               React.createElement('div', { className: 'iris-po-template' }, targetTemplate || '当前后端未提供此目标模板')),
             React.createElement('div', { className: 'iris-po-result-label' }, 'JSON 配置'),
-            React.createElement('div', { className: 'iris-po-muted' }, '可导出后修改 systemPrompt、targets、route 和 generation，再重新导入。'),
+            React.createElement('div', { className: 'iris-po-muted' }, '导入会替换当前配置；局部 JSON 缺少的字段使用内置默认值。可导出后修改 systemPrompt、targets、route 和 generation，再重新导入。'),
             React.createElement('div', { className: 'iris-po-actions' },
               React.createElement('button', { className: 'iris-po-btn', onClick: exportConfig }, '导出'),
-              React.createElement('button', { className: 'iris-po-btn', onClick: function () { if (fileRef.current) fileRef.current.click(); } }, '导入'),
-              React.createElement('button', { className: 'iris-po-btn danger', onClick: resetConfig }, '恢复默认'),
+              React.createElement('button', { className: 'iris-po-btn', disabled: busy, onClick: function () { if (fileRef.current) fileRef.current.click(); } }, '导入'),
+              React.createElement('button', { className: 'iris-po-btn', disabled: busy || !supportsResetInstructions,
+                title: supportsResetInstructions ? '只更新系统指令与全部用途模板' : '当前后端尚未支持仅恢复指令', onClick: function () { resetConfig('instructions'); } }, '仅恢复默认指令'),
+              React.createElement('button', { className: 'iris-po-btn danger', disabled: busy, onClick: function () { resetConfig('all'); } }, '恢复全部设置'),
               React.createElement('input', { ref: fileRef, className: 'iris-po-file', type: 'file', accept: 'application/json,.json', onChange: importConfig })),
             React.createElement('div', { className: 'iris-po-muted' }, '当前：' + (configState && configState.source === 'custom' ? '用户 JSON' : 'Iris 默认'))),
           React.createElement('button', { className: 'iris-po-disable', disabled: busy, onClick: disableEntry }, '关闭此对话入口（工作台仍保留）')));

package/lib/command-service.js

@@ -20,6 +20,7 @@ import { GenerationInputError, normalizeGenerationInput } from './generation-inp
 import { videoTaskCandidates } from './video-input.js';
 import { waitForCoreTask } from './task-wait.js';
 import { planCoreDeletion, planCoreCleanup, quarantineCoreFiles, inspectCoreTransactions, restoreCoreTransaction } from './core-maintenance.js';
+import { deliveryCacheNeedsProvider } from './core-delivery-cache.js';
 
 export const COMMAND_CONTRACT_VERSION = 0;
 export const CORE_COMMANDS = Object.freeze([
@@ -366,16 +367,20 @@ export function createCommandService(runtime, ports = {}) {
       });
     }
     // task.redeliver：只对 outcome=succeeded / deliveryState=failed 的任务重新取回
-    // 已生成的远端产物（re-poll 拿产物清单，绝不 submit，也不会重新生成）。
+    // 已生成产物：同步结果读私有缓存，异步结果 re-poll；绝不 submit。
     if (name === 'task.redeliver') {
       exactInput(input, ['task_id']);
       return runtime.run('execute', async ({ dataRoot }) => {
         const before = inspectCoreTask(dataRoot, input.task_id);
-        if (before.outcome !== 'succeeded' || before.deliveryState !== 'failed' || !before.remoteTaskId) throw commandError('IRIS_TASK_NOT_REDELIVERABLE', 'Task 不处于可重新交付状态；不会重新生成');
+        if (before.outcome !== 'succeeded' || before.deliveryState !== 'failed' || (!before.remoteTaskId && !before.deliveryCache)) throw commandError('IRIS_TASK_NOT_REDELIVERABLE', 'Task 不处于可重新交付状态；不会重新生成');
+        if (before.deliveryCache && !deliveryCacheNeedsProvider(dataRoot, before)) {
+          const task = await createProviderTaskRunner(runtime).redeliver(input.task_id);
+          return Object.freeze({ contractVersion: COMMAND_CONTRACT_VERSION, command: name, taskId: task.id, task });
+        }
         if (typeof ports.resolveTaskAdapter !== 'function') throw commandError('IRIS_COMMAND_PROVIDER_REQUIRED', 'task.redeliver 需要宿主显式提供 Task Provider resolver');
         const adapter = await ports.resolveTaskAdapter(before);
         if (!adapter || adapter.id !== before.providerId || !adapter.capabilities?.includes(before.capability)) throw commandError('IRIS_PROVIDER_TASK_IDENTITY_MISMATCH', 'Task Provider resolver 返回了不匹配的 Adapter');
-        if (!hasProviderOperation(adapter, 'poll')) throw commandError('IRIS_PROVIDER_TASK_OBSERVE_UNSUPPORTED', 'Task 原 Provider 不支持 poll；不会重新生成');
+        if (!before.deliveryCache && !hasProviderOperation(adapter, 'poll')) throw commandError('IRIS_PROVIDER_TASK_OBSERVE_UNSUPPORTED', 'Task 原 Provider 不支持 poll；不会重新生成');
         const task = await createProviderTaskRunner(runtime).redeliver(input.task_id, adapter);
         return Object.freeze({ contractVersion: COMMAND_CONTRACT_VERSION, command: name, taskId: task.id, task });
       });
@@ -415,6 +420,10 @@ export function createCommandService(runtime, ports = {}) {
           throw commandError('IRIS_TASK_NOT_RETRYABLE', '只有终态且未成功交付的 Task 可以重试为新任务');
         }
         let normalized;
+        if (before.capability === 'music' && input.provider_input &&
+            ['retry_502', 'retry_delay_ms'].some(field => Object.hasOwn(input.provider_input, field))) {
+          throw commandError('IRIS_COMMAND_INPUT_INVALID', 'task.retry 只执行一次重新生成；502重试配置请使用Music生成入口');
+        }
         try { normalized = normalizeGenerationInput(before.capability, input.provider_input, { allowVideoPaths: before.capability === 'video' }); }
         catch (error) {
           if (error instanceof GenerationInputError) throw commandError('IRIS_COMMAND_INPUT_INVALID', error.message);