@mokuyoaxis/dsh-iris 0.2.2 → 0.2.4

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.4';
   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,7 +854,11 @@ 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('vision') || (caps.includes('image-gen') && m.imageRouting && m.imageRouting.mediaProtocol === 'openai-chat-images') ? React.createElement(VisionInputEditor, { key: 'vision-input', provider: p, model: m,
+          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.editSupported) ? 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,
           React.createElement('button', { className: 'iris-pm-btn danger', title: '从池移除', onClick: function () { props.removeModel(p, m); } }, '✕'));
@@ -928,7 +937,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
             placeholder: '最长边 px（可选）', value: dimensionPair[0], onChange: function (e) { dimensionPair[1](e.target.value); } }),
           React.createElement('button', { className: 'iris-pm-btn', onClick: function () { save(false); } }, '保存预算'),
           React.createElement('button', { className: 'iris-pm-btn', onClick: function () { save(true); } }, '恢复继承')),
-        React.createElement('span', { className: 'iris-pm-note' }, '用于看图、OCR 每块输入和定位。作品原图保留，定位结果换算回原图。'));
+        React.createElement('span', { className: 'iris-pm-note' }, '用于看图、OCR 每块输入、定位和改图的发送副本。作品原图保留，定位结果换算回原图。'));
     }
 
     function ProviderEndpointEditor(props) {
@@ -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) || '';
+          opts = ord.map(function (ref) { return opts.find(function (option) { return option.ref === ref; }); }).filter(Boolean);
+          var assignedRef = ord[0] || '';
           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) {
+            node = React.createElement('select', { value: vals.model || '', onChange: function (e) { setVal('model', e.target.value); } },
+              React.createElement('option', { value: '' }, '按功能分配顺序'),
+              ((modelInfo && modelInfo.options) || []).map(function (option) {
+                return React.createElement('option', { key: option.ref, value: option.ref, disabled: option.unavailable }, option.label + (option.unavailable ? ' · 当前不可用' : ''));
+              }));
+            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,15 +1254,15 @@ 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 || '未分配') + (available ? '' : '（无可用模型）')),
             React.createElement('div', { className: 'iris-wb-muted' },
-              healthText(cardHealth) + ' · 改分配 → 上方「能力分配（failover 顺序）」'));
+              healthText(cardHealth) + ' · 改分配 → 上方「功能分配（调用顺序）」'));
         }
         body = React.createElement('div', { className: 'iris-act-body' },
           modelBar,
           inputs,
           React.createElement('button', { className: 'iris-act-run', disabled: run === 'running', onClick: submit },
-            run === 'running' ? '执行中…' : '执行'),
+            run === 'running' ? '执行中…' : (props.submitLabel || '执行')),
           result);
       }
       var headStatus = capability ? cardHealth.status : 'verified';
@@ -1260,6 +1282,8 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
 
     /* ---- 操作卡片注册表（单一来源：设置页全量 / 泡泡常用子集 / 选择器三处共用） ---- */
     var CARD_DEFS = [
+      { action: 'image_import', title: '📥 导入图片', submitLabel: '保存到作品', fields: [
+        { key: 'image_path', label: '图片（静态 PNG/JPEG/WebP，最大20 MiB；保存副本，保留原文件）', type: 'file', accept: 'image/png,image/jpeg,image/webp' }] },
       { action: 'image', title: '🎨 画图', capability: 'image-gen', fields: [
         { key: 'prompt', label: '提示词', type: 'textarea', placeholder: '详细描述要生成的图片' },
         { key: 'size', label: '尺寸 (可选)', placeholder: '如 1024*1024' },
@@ -1272,6 +1296,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 +1355,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: '👁 视觉' }
     ];
@@ -1354,7 +1385,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
           var opt = opts.find(function (o) { return o.ref === ref; });
           return React.createElement('span', { key: ref, className: 'iris-cap-chip' },
             React.createElement('b', {}, (i + 1) + '.'),
-            opt ? opt.label : ref,
+            opt ? opt.label + (opt.unavailable ? ' · 当前不可用' : '') : ref + ' · 配置已失效',
             i > 0 ? React.createElement('button', {
               className: 'iris-pm-btn', title: '上移',
               onClick: function () { var n = list.slice(); var t = n.splice(i, 1)[0]; n.splice(i - 1, 0, t); save(row.cap, n); }
@@ -1370,17 +1401,17 @@ 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' }, '尚未分配模型'),
           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])); }
           },
-            React.createElement('option', { value: '' }, '+ 加入 failover'),
+            React.createElement('option', { value: '' }, '+ 分配模型'),
             available.map(function (o) { return React.createElement('option', { key: o.ref, value: o.ref }, o.label); })) : null,
           list.length ? React.createElement('button', {
-            className: 'iris-pm-btn', title: '清除手动分配，回退自动',
+            className: 'iris-pm-btn', title: '清空分配后，该功能不再发起新调用',
             onClick: function () { save(row.cap, []); }
-          }, '恢复自动') : null);
+          }, '清空分配') : null);
       }));
     }
 
@@ -1534,7 +1565,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
     }
 
     function galleryKindLabel(kind) {
-      return ({ __proto__: null, 'generated-image': '生成图片', 'generated-video': '生成视频', 'generated-audio': '生成音频',
+      return ({ __proto__: null, 'imported-image': '导入图片', 'generated-image': '生成图片', 'generated-video': '生成视频', 'generated-audio': '生成音频',
         'tts-audio': '合成语音', transcript: '转写文本', 'video-frame': '视频帧', crop: '裁剪图片',
         'cropped-image': '裁剪图片', 'pixel-diff': '差异热图', 'diff-heatmap': '差异热图', 'html-screenshot': 'HTML 截图',
         'legacy-output': '旧版作品' })[kind] || kind;
@@ -1750,19 +1781,15 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
       var running = result && result.status === 'running';
       React.useEffect(function () {
         var active = true;
-        postAction('providers_list', {}).then(function (response) {
+        postAction('assignments_get', {}).then(function (response) {
           if (!active) return;
           if (!response.ok || !response.d.ok) throw new Error('模型列表读取失败');
           var choices = [];
-          (response.d.providers || []).forEach(function (provider) {
-            if (!provider.enabled) return;
-            (provider.models || []).forEach(function (entry) {
-              if ((entry.capabilities || []).indexOf('image-gen') < 0
-                  || !entry.imageRouting || entry.imageRouting.mediaProtocol !== 'openai-chat-images') return;
-              var health = entry.health && entry.health['image-gen'];
-              choices.push({ id: provider.id + '::' + entry.id, label: provider.name + ' · ' + entry.id,
-                blocked: !!(health && health.rateLimited) });
-            });
+          var pool = response.d.poolByCapability && response.d.poolByCapability['image-gen'] || [];
+          (response.d.order && response.d.order['image-gen'] || []).forEach(function (ref) {
+            var entry = pool.find(function (item) { return item.ref === ref; });
+            if (!entry || !entry.imageRouting || !entry.imageRouting.editSupported) return;
+            choices.push({ id: ref, label: entry.label, blocked: entry.unavailable === true });
           });
           setModels(choices);
         }).catch(function (error) { if (active) { setModels([]); setResult({ status: 'failed', text: error.message }); } });
@@ -1802,7 +1829,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
           React.createElement('label', {}, '改图模型', React.createElement('select', { 'aria-label': '改图模型', value: model, disabled: !!running,
             onChange: function (e) { setModel(e.target.value); } }, React.createElement('option', { value: '' }, '按当前顺序选择可用改图模型'),
             (models || []).map(function (entry) { return React.createElement('option', { key: entry.id, value: entry.id, disabled: entry.blocked }, entry.label + (entry.blocked ? ' · 冷却或额度耗尽' : '')); }))),
-          models && !models.some(function (entry) { return !entry.blocked; }) ? React.createElement('div', { role: 'status' }, '暂无可用改图模型，请在模型设置中配置聊天生图协议，或手动实测恢复模型。') : null,
+          models && !models.some(function (entry) { return !entry.blocked; }) ? React.createElement('div', { role: 'status' }, '暂无可用改图模型，请在生图名单分配聊天生图或 DashScope Qwen 改图模型，并检查模型是否可用。') : null,
           React.createElement('div', { className: 'iris-gallery-actions' },
             React.createElement('button', { className: 'iris-clean-btn', type: 'button', disabled: !!running || !prompt.trim() || !models || !models.some(function (entry) { return !entry.blocked; }), onClick: execute }, running ? '编辑中…' : '生成修改版'),
             running ? React.createElement('button', { className: 'iris-pm-btn', type: 'button', onClick: cancel }, '停止等待') : null),
@@ -1927,6 +1954,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
       var blocked = busy || mutating;
 
       return React.createElement('div', {},
+        React.createElement(ActionCard, CARD_DEFS.find(function (card) { return card.action === 'image_import'; })),
         React.createElement('div', { className: 'iris-gallery-tools' },
           React.createElement('span', { className: 'iris-clean-note' },
             '匹配 ' + data.total + ' 个作品 · Core ' + data.counts.core + ' · 旧版 ' + data.counts.legacy + ' · 清任务历史不会删除'),
@@ -1988,7 +2016,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 +2550,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 +2612,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);
     }
 
@@ -2639,7 +2686,7 @@ window.__ModuleLoader__.load({ id: '@mokuyoaxis/dsh-iris', factory: (require) =>
         React.createElement('div', { className: 'iris-wb-sec' }, '能力健康'),
         React.createElement(CapabilityHealthOverview, {}),
         React.createElement('div', { className: 'iris-wb-muted' }, '绿色有效 7 天；真实成功或显式实测会刷新。429 冷却显示琥珀色，额度或预算耗尽显示红色；点击模型能力可实测恢复。不会后台探测。'),
-        React.createElement('div', { className: 'iris-wb-sec' }, '能力分配（failover 顺序）'),
+        React.createElement('div', { className: 'iris-wb-sec' }, '功能分配（调用顺序）'),
         React.createElement(CapabilityAssigner, {}),
         React.createElement('div', { className: 'iris-wb-sec' }, 'Iris 泡泡快捷卡片（勾选后显示在「⚡ 常用」标签）'),
         React.createElement(BubbleCardPicker, {}),
@@ -2757,6 +2804,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 +2881,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 +2983,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 +3004,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 +3047,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 +3127,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 +3154,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 +3191,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 +3213,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 +3250,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 +3272,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 +3288,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 +3308,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,11 +20,13 @@ 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';
+import { readImportImage } from './image-import.js';
 
 export const COMMAND_CONTRACT_VERSION = 0;
 export const CORE_COMMANDS = Object.freeze([
   'crop', 'media.diff', 'media.frames', 'media.html', 'task.inspect', 'task.list', 'task.wait', 'task.observe', 'task.reobserve', 'task.redeliver', 'task.cancel', 'task.retry',
-  'task.inspect-many', 'artifact.inspect', 'artifact.inspect-many', 'artifact.list', 'artifact.export', 'artifact.export-many', 'artifact.rebuild',
+  'task.inspect-many', 'artifact.import', 'artifact.inspect', 'artifact.inspect-many', 'artifact.list', 'artifact.export', 'artifact.export-many', 'artifact.rebuild',
   'core.delete', 'core.cleanup', 'core.transactions', 'core.restore'
 ]);
 
@@ -108,6 +110,20 @@ export function createCommandService(runtime, ports = {}) {
 
   async function execute(name, input) {
     if (!CORE_COMMANDS.includes(name)) throw commandError('IRIS_COMMAND_UNKNOWN', `未知 Command：${String(name)}`);
+    if (name === 'artifact.import') {
+      exactInput(input, ['image_path', 'image_bytes']);
+      const hasPath = input.image_path !== undefined;
+      if (hasPath === (input.image_bytes !== undefined)) {
+        throw commandError('IRIS_COMMAND_INPUT_INVALID', '图片导入须且只能提供image_path或image_bytes之一');
+      }
+      const filePath = hasPath ? localImage(input) : undefined;
+      return runtime.run('execute', async ({ dataRoot, signal }) => {
+        const source = await readImportImage({ filePath, imageBytes: input.image_bytes }, signal);
+        signal.throwIfAborted();
+        const artifact = createCoreArtifact(dataRoot, { ...source, kind: 'imported-image' });
+        return Object.freeze({ contractVersion: COMMAND_CONTRACT_VERSION, command: name, artifact });
+      });
+    }
     if (name === 'core.delete' || name === 'core.cleanup') {
       exactInput(input, name === 'core.delete' ? ['task_ids', 'artifact_ids', 'confirm_delete'] : ['paths', 'older_than_ms', 'confirm_delete']);
       if (input.confirm_delete !== undefined && typeof input.confirm_delete !== 'boolean') throw commandError('IRIS_COMMAND_INPUT_INVALID', 'confirm_delete 必须是布尔值');
@@ -366,16 +382,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 +435,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);