@ninkch/dsh-infinite-canvas 0.17.6 → 0.17.7

package/client.js

@@ -91,6 +91,13 @@ window.__ModuleLoader__.load({
       for (let i = 0; i < bin.length; i++) arr[i] = bin.charCodeAt(i);
       return new Blob([arr], { type: mime || 'application/octet-stream' });
     }
+    function arrayBufferToBase64(buf) {
+      const bytes = new Uint8Array(buf);
+      let bin = '';
+      const CH = 0x8000;
+      for (let i = 0; i < bytes.length; i += CH) bin += String.fromCharCode.apply(null, bytes.subarray(i, i + CH));
+      return btoa(bin);
+    }
     function blobToDataUrl(blob) {
       return new Promise((res, rej) => {
         const r = new FileReader();
@@ -349,6 +356,9 @@ window.__ModuleLoader__.load({
       'dataRootOpen': '打开目录',
       'dataRootMigrate': '迁移历史资产',
       'dataRootMigrated': '已迁移 {n} 个资产到数据根目录',
+      'dataRootImportBtn': '从数据目录导入',
+      'dataRootImported': '导入完成：合并 {n} 个项目、补入 {a} 条资产元数据',
+      'dataRootImportHint': '换电脑迁移：把整个数据目录拷到新机器 → 设置为数据根目录 → 点"从数据目录导入"即可恢复项目/节点/设定集/资产',
       'dataRootMigratedDone': '已迁移',
       'dataRootMigrating': '迁移中',
       'dataRootUnsupported': '当前插件后台版本较旧（不支持数据根目录）：重启 Harness 后可用',
@@ -677,6 +687,9 @@ window.__ModuleLoader__.load({
       'dataRootOpen': 'Open folder',
       'dataRootMigrate': 'Migrate existing assets',
       'dataRootMigrated': 'Migrated {n} assets to the data root',
+      'dataRootImportBtn': 'Import from data root',
+      'dataRootImported': 'Imported: {n} projects merged, {a} asset records added',
+      'dataRootImportHint': 'Migration: copy the whole data folder to the new machine, set it as data root, then click "Import from data root" to restore projects/nodes/bible/assets',
       'dataRootMigratedDone': 'Migrated',
       'dataRootMigrating': 'Migrating',
       'dataRootUnsupported': 'The plugin backend is older and lacks data-root support — restart Harness to enable',
@@ -1292,12 +1305,16 @@ window.__ModuleLoader__.load({
         entLines.length ? (zh ? '设定集：' : 'Series bible: ') + entLines.join('；') : '',
       ].filter(Boolean).join('\n');
     }
-    /** 资产命名：优先节点名（如「角色-张山 多视图」），否则用命中实体，最后兜底。 */
+    /** 资产命名时间戳（MM-DD HH:MM）：同节点多次生成靠它区分。 */
+    function nowStamp() {
+      return new Date().toISOString().slice(5, 16).replace('T', ' ');
+    }
+    /** 资产命名：**节点名 + 时间**（用户规则）；无节点名退回实体名/类型前缀 + 时间。 */
     function assetNameFor(node, entities, fallbackKind) {
       const label = String((node && node.data && node.data.label) || '').trim();
-      if (label) return label;
-      if (entities && entities.length) return entityLabelOf(entities[0].kind) + '-' + entities[0].name;
-      return (fallbackKind === 'video' ? '视频' : '图片') + '-' + new Date().toISOString().slice(5, 16).replace('T', ' ');
+      if (label) return label + ' ' + nowStamp();
+      if (entities && entities.length) return entityLabelOf(entities[0].kind) + '-' + entities[0].name + ' ' + nowStamp();
+      return (fallbackKind === 'video' ? '视频' : '图片') + '-' + nowStamp();
     }
     // <<<MENTION_PURE_END>>>
 
@@ -1509,21 +1526,72 @@ window.__ModuleLoader__.load({
       }
       await idbPut(rec);
       assetNameCache.set(rec.id, rec.name);
+      mirrorAssetIndex(rec); // 资产元数据镜像进数据目录 assets.json（迁移便利，失败静默）
       return rec;
     }
+    /** 资产元数据索引记录（去 blob；文本资产保留 text 以便导入端免读文件即可预览）。 */
+    function assetIndexRecord(rec) {
+      const out = {
+        id: rec.id, projectId: rec.projectId, kind: rec.kind, mime: rec.mime,
+        name: rec.name, createdAt: rec.createdAt, prompt: rec.prompt || '',
+        source: rec.source || '', category: rec.category || 'general',
+      };
+      if (rec.rel) { out.rel = rec.rel; out.size = rec.size || 0; }
+      if (rec.entity) out.entity = rec.entity;
+      if (Array.isArray(rec.entities) && rec.entities.length) out.entities = rec.entities;
+      if (rec.nodeLabel) out.nodeLabel = rec.nodeLabel;
+      if (rec.kind === 'text' && typeof rec.text === 'string') out.text = rec.text;
+      return out;
+    }
+    /** 把资产元数据镜像进数据目录的 assets.json（失败静默：索引是迁移便利，不是主存储）。 */
+    function mirrorAssetIndex(rec) {
+      if (!S.dataRoot || !rec || !rec.id) return;
+      const proj = S.projects.find((p) => p.id === rec.projectId);
+      hostRpc('assetIndexPut', {
+        projectId: rec.projectId, projectName: (proj && proj.name) || rec.projectId, asset: assetIndexRecord(rec),
+      }).catch(() => { /* 索引失败不影响资产本身 */ });
+    }
+    /** 启动/设置数据目录后：一次性把 IndexedDB 里的全部资产元数据同步进 assets.json（补齐历史资产索引）。
+     *  全量**替换**语义（含空项目占位）：IndexedDB 是资产库唯一事实源，借此自愈删除后残留的幽灵条目。 */
+    let assetIndexSynced = false;
+    async function syncAssetIndexToHost() {
+      if (assetIndexSynced || !S.dataRoot) return;
+      assetIndexSynced = true;
+      try {
+        const all = await idbAll();
+        const items = [];
+        const seen = new Set();
+        const projName = new Map(S.projects.map((p) => [p.id, p.name]));
+        for (const rec of all) {
+          if (!rec || !rec.id || !rec.projectId) continue;
+          seen.add(rec.projectId);
+          items.push({ projectId: rec.projectId, projectName: projName.get(rec.projectId) || rec.projectId, asset: assetIndexRecord(rec) });
+        }
+        // 本机已知但没有任何资产的项目也要发占位：assets.json 清空对齐（否则删除后会残留幽灵条目）
+        for (const p of S.projects) {
+          if (!seen.has(p.id)) items.push({ projectId: p.id, projectName: p.name, asset: null });
+        }
+        if (items.length) await hostRpc('assetIndexBulkPut', { items });
+      } catch { /* 索引同步失败不影响 */ }
+    }
     /** 一次性把 IndexedDB 里的历史资产迁移到数据根目录（保留元数据，移除 blob）。 */
     async function migrateAssetsToDisk(onProgress) {
       if (!S.dataRoot) throw new Error('请先设置数据根目录');
       const all = await idbAll();
-      const targets = all.filter((r) => r.blob && !r.rel);
+      // 二进制资产（有 blob）与文本资产（text，此前从不落盘）都要迁移
+      const targets = all.filter((r) => (r.blob && !r.rel) || (r.kind === 'text' && !r.rel && typeof r.text === 'string' && r.text.length));
       let done = 0;
       for (const rec of targets) {
-        const rel = `projects/${rec.projectId}/${rec.kind}/${assetFileBase(rec)}.${extFromMime(rec.mime)}`;
-        const r = await fetch('/' + NS + '/api/asset?rel=' + encodeURIComponent(rel), { method: 'POST', body: rec.blob });
+        const isText = rec.kind === 'text' && !rec.blob;
+        const rel = `projects/${rec.projectId}/${rec.kind}/${assetFileBase(rec)}.${isText ? 'md' : extFromMime(rec.mime)}`;
+        const blob = isText ? new Blob([rec.text || ''], { type: 'text/markdown' }) : rec.blob;
+        const r = await fetch('/' + NS + '/api/asset?rel=' + encodeURIComponent(rel), { method: 'POST', body: blob });
         if (!r.ok) throw new Error('迁移失败: ' + rel + ' — ' + (await r.text()));
-        const next = { ...rec, rel, size: rec.blob.size, stored: 'disk' };
-        delete next.blob;
+        const next = { ...rec, rel, size: blob.size, stored: 'disk' };
+        if (isText) next.text = rec.text; // 文本保留在元数据里：预览/下载不必回读文件
+        else delete next.blob;
         await idbPut(next);
+        mirrorAssetIndex(next); // 迁移后刷新数据目录 assets.json（补 rel/size）
         assetUrlCache.delete(rec.id); // 旧 objectURL 失效，改走文件 URL
         done++;
         if (onProgress) onProgress(done, targets.length);
@@ -1648,11 +1716,30 @@ window.__ModuleLoader__.load({
       return new Blob(chunks, { type: mime.split(';')[0] });
     }
 
+    /** 外部 API 请求统一经 Host 代理（图片/视频/音频网关都走这里）：浏览器直连第三方接口会被
+     *  CORS 拦截（带 Authorization 的 POST 触发预检，网关不返回 CORS 头 → TypeError: Failed to fetch）。
+     *  返回 { ok, status, contentType, text, blob }。 */
+    async function fetchViaProxy(url, { method = 'POST', headers = {}, body = null, bodyRaw = null, bodyContentType = '', timeoutMs = 120000, label = '请求' } = {}) {
+      const payload = { url, method, headers, timeoutMs };
+      if (bodyRaw != null) { payload.bodyRaw = bodyRaw; payload.bodyContentType = bodyContentType; }
+      else if (body != null) payload.body = body;
+      // 客户端→Host 的预算比上游超时多 15s：让上游超时（504/带原因）先到，而不是客户端先断
+      const res = await fetchT('/' + NS + '/api/fetch-proxy', {
+        method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(payload),
+      }, Number(timeoutMs) + 15000, label + '(代理)');
+      const ct = res.headers.get('content-type') || '';
+      const buf = await res.arrayBuffer();
+      const blob = new Blob([buf], { type: ct || 'application/octet-stream' });
+      let text = '';
+      if (!ct || /json|text|plain/.test(ct)) { try { text = new TextDecoder().decode(buf); } catch { text = ''; } }
+      return { ok: res.ok, status: res.status, contentType: ct, text, blob };
+    }
     async function apiImage(prompt, refBlobs, s, opts) {
       if (!s.baseUrl) throw new Error('未配置图片 API');
       const base = s.baseUrl.replace(/\/+$/, '');
       const refs = refBlobs || [];
       const auth = s.apiKey ? { Authorization: 'Bearer ' + s.apiKey } : {};
+      const upstreamTimeout = Number(s.timeoutMs) > 0 ? Number(s.timeoutMs) : 120000; // 商汤等同步接口 20s+，默认 120s
       // 参考图编辑模式：multipart 上传到 /images/edits（OpenAI gpt-image-1 兼容）
       if (refs.length && s.mode === 'edits') {
         const fd = new FormData();
@@ -1661,15 +1748,20 @@ window.__ModuleLoader__.load({
         fd.append('n', '1');
         if (s.size) fd.append('size', s.size);
         refs.forEach((b, i) => fd.append('image[]', b, 'ref-' + i + '.png'));
-        const res = await fetchT(base + '/images/edits', { method: 'POST', headers: auth, body: fd }, s.timeoutMs, '图片编辑 API');
-        if (!res.ok) throw new Error('图片编辑 API HTTP ' + res.status + '：' + (await res.text()).slice(0, 300));
-        const j = await res.json();
+        // FormData 经 Response 序列化为 multipart 字节（含 boundary）→ base64 经代理原样转发
+        const serialized = new Response(fd);
+        const bodyRaw = arrayBufferToBase64(await serialized.arrayBuffer());
+        const bodyContentType = serialized.headers.get('content-type') || 'multipart/form-data';
+        const res = await fetchViaProxy(base + '/images/edits', { headers: auth, bodyRaw, bodyContentType, timeoutMs: upstreamTimeout, label: '图片编辑 API' });
+        if (!res.ok) throw new Error('图片编辑 API HTTP ' + res.status + '：' + res.text.slice(0, 300));
+        let j = null;
+        try { j = JSON.parse(res.text); } catch { j = null; }
         const d = j && j.data && j.data[0];
         if (d && d.b64_json) return base64ToBlob(d.b64_json, 'image/png');
         if (d && d.url) {
-          const r2 = await fetchT(d.url, null, 60000, '下载图片');
+          const r2 = await fetchViaProxy(d.url, { method: 'GET', timeoutMs: 120000, label: '下载图片' });
           if (!r2.ok) throw new Error('下载生成图片失败 HTTP ' + r2.status);
-          return await r2.blob();
+          return r2.blob;
         }
         throw new Error('图片编辑 API 响应中没有 data[0].b64_json / url');
       }
@@ -1683,22 +1775,19 @@ window.__ModuleLoader__.load({
       const sizeOverride = String(s.size || '').trim();
       if (sizeOverride) body.size = sizeOverride;
       else { const dims = imageDimsFor(opts); body.size = `${dims.w}x${dims.h}`; }
-      // 文生图模式（generations）按界面说明**忽略参考图**；参考图只在 edits 模式使用，
-      // 否则会把大体积 base64 数组发给不识别的网关 → HTTP 400，用户看到的却是"没反应"
-      if (refs.length && (s.mode === 'edits')) body.images = await Promise.all(refs.map((b) => blobToDataUrl(b)));
-      const res = await fetchT(base + '/images/generations', {
-        method: 'POST',
+      const res = await fetchViaProxy(base + '/images/generations', {
         headers: { 'Content-Type': 'application/json', ...auth },
-        body: JSON.stringify(body),
-      }, s.timeoutMs, '图片 API');
-      if (!res.ok) throw new Error('图片 API HTTP ' + res.status + '：' + (await res.text()).slice(0, 300));
-      const j = await res.json();
+        body, timeoutMs: upstreamTimeout, label: '图片 API',
+      });
+      if (!res.ok) throw new Error('图片 API HTTP ' + res.status + '：' + res.text.slice(0, 300));
+      let j = null;
+      try { j = JSON.parse(res.text); } catch { j = null; }
       const d = j && j.data && j.data[0];
       if (d && d.b64_json) return base64ToBlob(d.b64_json, 'image/png');
       if (d && d.url) {
-        const r2 = await fetchT(d.url, null, 60000, '下载图片');
+        const r2 = await fetchViaProxy(d.url, { method: 'GET', timeoutMs: 120000, label: '下载图片' });
         if (!r2.ok) throw new Error('下载生成图片失败 HTTP ' + r2.status);
-        return await r2.blob();
+        return r2.blob;
       }
       throw new Error('图片 API 响应中没有 data[0].b64_json / url');
     }
@@ -1734,9 +1823,10 @@ window.__ModuleLoader__.load({
         ?? (j.output && (j.output.task_id ?? j.output.id));
     }
     async function downloadVideo(url, headers) {
-      const r = await fetchT(url, { headers }, 300000, '下载视频');
+      // 经 Host 代理：签名下载直连同样会被 CORS 拦
+      const r = await fetchViaProxy(url, { method: 'GET', headers: headers || {}, timeoutMs: 300000, label: '下载视频' });
       if (!r.ok) throw new Error('下载视频失败 HTTP ' + r.status);
-      return await r.blob();
+      return r.blob;
     }
     /** 火山方舟 Seedance 官方协议：创建任务 → 轮询 → 下载（支持首帧 + 最多 4 张参考图）。 */
     async function seedanceVideo(prompt, frameBlob, refs, s, opts) {
@@ -1762,17 +1852,17 @@ window.__ModuleLoader__.load({
         generate_audio: s.generateAudio !== false,
       };
       body.ratio = frameBlob ? 'adaptive' : (o.ratio || '16:9');
-      const res = await fetchT(base, { method: 'POST', headers, body: JSON.stringify(body) }, s.timeoutMs, 'Seedance 视频 API');
-      if (!res.ok) throw new Error('Seedance HTTP ' + res.status + '：' + (await res.text()).slice(0, 300));
-      const j = await res.json();
+      const res = await fetchViaProxy(base, { headers, body, timeoutMs: Number(s.timeoutMs) > 0 ? Number(s.timeoutMs) : 120000, label: 'Seedance 视频 API' });
+      if (!res.ok) throw new Error('Seedance HTTP ' + res.status + '：' + res.text.slice(0, 300));
+      const j = JSON.parse(res.text || '{}');
       const taskId = j && j.id;
       if (!taskId) throw new Error('Seedance 响应中没有任务 id');
       const deadline = Date.now() + 15 * 60 * 1000;
       while (Date.now() < deadline) {
         await sleep(10000);
-        const r2 = await fetchT(base + '/' + taskId, { headers }, 60000, '查询视频任务');
+        const r2 = await fetchViaProxy(base + '/' + taskId, { method: 'GET', headers, timeoutMs: 60000, label: '查询 Seedance 任务' });
         if (!r2.ok) throw new Error('查询 Seedance 任务失败 HTTP ' + r2.status);
-        const st = await r2.json();
+        const st = JSON.parse(r2.text || '{}');
         if (st.status === 'succeeded') {
           const u = st.content && st.content.video_url;
           if (!u) throw new Error('Seedance 任务成功但未返回视频地址');
@@ -1805,10 +1895,10 @@ window.__ModuleLoader__.load({
       if (frameBlob) {
         try { body.image = await blobToDataUrl(frameBlob); } catch { /* 忽略首帧编码失败 */ }
       }
-      const res = await fetchT(base, { method: 'POST', headers, body: JSON.stringify(body) }, s.timeoutMs, '视频 API');
-      if (!res.ok) throw new Error('视频 API HTTP ' + res.status + '：' + (await res.text()).slice(0, 300));
+      const res = await fetchViaProxy(base, { headers, body, timeoutMs: Number(s.timeoutMs) > 0 ? Number(s.timeoutMs) : 120000, label: '视频 API' });
+      if (!res.ok) throw new Error('视频 API HTTP ' + res.status + '：' + res.text.slice(0, 300));
       let j = null;
-      try { j = await res.json(); } catch { /* 非 JSON 响应 */ }
+      try { j = JSON.parse(res.text); } catch { /* 非 JSON 响应 */ }
       const direct = extractVideoUrl(j);
       if (direct) return await downloadVideo(direct, {});
       const taskId = extractTaskId(j);
@@ -1816,10 +1906,10 @@ window.__ModuleLoader__.load({
       const deadline = Date.now() + 15 * 60 * 1000;
       while (Date.now() < deadline) {
         await sleep(3000);
-        const r2 = await fetchT(base + '/' + taskId, { headers }, 60000, '查询视频任务');
+        const r2 = await fetchViaProxy(base + '/' + taskId, { method: 'GET', headers, timeoutMs: 60000, label: '查询视频任务' });
         if (!r2.ok) throw new Error('查询视频任务失败 HTTP ' + r2.status);
         let st = null;
-        try { st = await r2.json(); } catch { /* 忽略 */ }
+        try { st = JSON.parse(r2.text); } catch { /* 忽略 */ }
         const u = extractVideoUrl(st);
         if (u) return await downloadVideo(u, {});
         // 失败判定必须看状态字段，不能拿整串 JSON 做子串匹配：
@@ -3012,8 +3102,25 @@ window.__ModuleLoader__.load({
         source: (meta && meta.source) || 'ai',
         category: (meta && meta.category) || 'script',
       };
+      // 文本资产同样落盘到数据根目录（<root>/projects/<项目>/text/<名>.md），
+      // IndexedDB 保留元数据与 text 字段（文本很小，预览/下载不必回读文件）。
+      // 落盘失败降级为仅 IndexedDB（绝不阻塞生成主流程），控制台留痕。
+      if (S.dataRoot) {
+        try {
+          const rel = `projects/${projectId}/text/${assetFileBase(rec)}.md`;
+          const blob = new Blob([rec.text], { type: 'text/markdown' });
+          const r = await fetch('/' + NS + '/api/asset?rel=' + encodeURIComponent(rel), { method: 'POST', body: blob });
+          if (!r.ok) throw new Error(await r.text());
+          rec.rel = rel;
+          rec.size = blob.size;
+          rec.stored = 'disk';
+        } catch (err) {
+          console.warn('[infinite-canvas] 文本资产落盘失败（降级为浏览器存储）:', String((err && err.message) || err));
+        }
+      }
       await idbPut(rec);
       assetNameCache.set(rec.id, rec.name);
+      mirrorAssetIndex(rec); // 文本资产元数据同样镜像进 assets.json
       return rec;
     }
 
@@ -3541,7 +3648,7 @@ window.__ModuleLoader__.load({
         if (!String(text || '').trim()) throw new Error(T('aiEmptyResult'));
         update((s) => { const nd = s.graph.nodes[n.id]; if (nd) { nd.data.output = text; nd.data.prevOutput = null; nd.data.aiStatus = 'idle'; nd.data.status = 'done'; nd.data.error = null; } s.assetsTick++; });
         await saveTextAssetRecord(S.activeId, {
-          name: T('scriptAssetPrefix') + new Date().toISOString().slice(5, 16).replace('T', ' '),
+          name: (String(n.data.label || '').trim() || T('scriptAssetPrefix')) + ' ' + nowStamp(),
           text, category: 'script', prompt: n.data.idea,
         });
         update((s) => { s.assetsTick++; });
@@ -3561,6 +3668,11 @@ window.__ModuleLoader__.load({
       }
     }
 
+    /** 分镜节点的资产文本（自动入库与手动"存为资产"共用，避免两处格式漂移）。 */
+    function storyboardAssetText(shots) {
+      return (shots || []).map((x) => `【${x.title}】${x.duration}s\n画面：${x.visual}\n动作：${x.motion}\n角色：${(x.characters || []).join('、') || '-'}｜场景：${x.scene || '-'}｜道具：${(x.props || []).join('、') || '-'}`).join('\n\n');
+    }
+
     /** 分镜节点：剧本 → 镜头列表（含一致性检查）。 */
     async function genStoryboardNode(n) {
       const st = storyboardScriptText(n);
@@ -3579,8 +3691,8 @@ window.__ModuleLoader__.load({
         // 分镜里出现的新角色/场景/道具 → 自动补进设定集（描述留空待补充），保证设定集始终是唯一事实源
         try { await autoRegisterBibleEntries(shots); } catch { /* 补录失败不影响分镜 */ }
         await saveTextAssetRecord(S.activeId, {
-          name: T('storyboardAssetPrefix') + new Date().toISOString().slice(5, 16).replace('T', ' '),
-          text: shots.map((x) => `【${x.title}】${x.duration}s\n画面：${x.visual}\n动作：${x.motion}\n角色：${x.characters.join('、') || '-'}｜场景：${x.scene || '-'}｜道具：${x.props.join('、') || '-'}`).join('\n\n'),
+          name: (String(n.data.label || '').trim() || T('storyboardAssetPrefix')) + ' ' + nowStamp(),
+          text: storyboardAssetText(shots),
           category: 'storyboard', prompt: st.slice(0, 200),
         });
         update((s) => { s.assetsTick++; });
@@ -3635,7 +3747,7 @@ window.__ModuleLoader__.load({
           update((s) => { const nd = s.graph.nodes[n.id]; if (nd) nd.data.progress = Math.round(frac * 100) + '% · ' + name; });
         });
         const rec = await saveAssetRecord(S.activeId, 'video', blob, {
-          name: T('finalCutDone') + '-' + new Date().toISOString().slice(5, 16).replace('T', ' '),
+          name: (String(n.data.label || '').trim() || T('finalCutDone')) + ' ' + nowStamp(),
           prompt: metas.length + ' segments', source: 'finalcut', category: 'finalcut',
         });
         metas.forEach((m) => URL.revokeObjectURL(m.url));
@@ -4976,7 +5088,7 @@ window.__ModuleLoader__.load({
             type: 'button', className: 'dshic-mini is-ghost', title: T('saveTextAsset'),
             onPointerDown: (e) => e.stopPropagation(),
             onClick: async () => {
-              await saveTextAssetRecord(S.activeId, { name: T('scriptAssetPrefix') + new Date().toISOString().slice(5, 16).replace('T', ' '), text: n.data.output, category: 'script', prompt: n.data.idea });
+              await saveTextAssetRecord(S.activeId, { name: (String(n.data.label || '').trim() || T('scriptAssetPrefix')) + ' ' + nowStamp(), text: n.data.output, category: 'script', prompt: n.data.idea });
               update((s) => { s.assetsTick++; });
               toast(T('savedOk'));
             },
@@ -5058,8 +5170,26 @@ window.__ModuleLoader__.load({
             )
           : null,
         shots.length
-          ? h('button', { key: 'expand', type: 'button', className: 'dshic-mini', style: { alignSelf: 'flex-start' }, onClick: () => expandStoryboard(n), onPointerDown: (e) => e.stopPropagation() },
-              Ic('expandAll', 11), T('expand') + ` (${shots.length})`)
+          ? h('div', { key: 'acts', className: 'dshic-node-row', style: { alignSelf: 'flex-start' } },
+              // 手动"存为资产"：AI 生成已自动入库（category=storyboard），这里用于留存当前分镜的一版快照
+              h('button', {
+                key: 'save', type: 'button', className: 'dshic-mini is-ghost', title: T('saveTextAsset'),
+                onPointerDown: (e) => e.stopPropagation(),
+                onClick: async () => {
+                  try {
+                    await saveTextAssetRecord(S.activeId, {
+                      name: (String(n.data.label || '').trim() || T('storyboardAssetPrefix')) + ' ' + nowStamp(),
+                      text: storyboardAssetText(shots), category: 'storyboard',
+                      prompt: String(n.data.script || '').slice(0, 200),
+                    });
+                    update((s) => { s.assetsTick++; });
+                    toast(T('savedOk'));
+                  } catch (err) { toast(String((err && err.message) || err)); }
+                },
+              }, Ic('download', 11), T('saveTextAsset')),
+              h('button', { key: 'expand', type: 'button', className: 'dshic-mini', onClick: () => expandStoryboard(n), onPointerDown: (e) => e.stopPropagation() },
+                Ic('expandAll', 11), T('expand') + ` (${shots.length})`),
+            )
           : null,
       ];
     }
@@ -5156,14 +5286,15 @@ window.__ModuleLoader__.load({
         if (!text) { toast(T('subPlaceholder')); return; }
         update((s) => { const nd = s.graph.nodes[n.id]; if (nd) { nd.data.tts = nd.data.tts || {}; nd.data.tts[x.e.id] = { status: 'running' }; } });
         try {
-          const res = await fetchT((cfg.baseUrl || '').replace(/\/+$/, '') + '/audio/speech', {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json', ...(cfg.apiKey ? { Authorization: 'Bearer ' + cfg.apiKey } : {}) },
-            body: JSON.stringify({ ...(cfg.model ? { model: cfg.model } : {}), input: text, voice: cfg.voice || 'alloy', response_format: 'mp3' }),
-          }, cfg.timeoutMs, 'TTS API');
-          if (!res.ok) throw new Error('TTS HTTP ' + res.status + '：' + (await res.text()).slice(0, 200));
-          const buf = await res.arrayBuffer();
-          const blob = new Blob([buf], { type: res.headers.get('content-type') || 'audio/mpeg' });
+          // TTS 也走 Host 代理：浏览器直连 TTS 网关同样会被 CORS 拦
+          const res = await fetchViaProxy((cfg.baseUrl || '').replace(/\/+$/, '') + '/audio/speech', {
+            headers: { ...(cfg.apiKey ? { Authorization: 'Bearer ' + cfg.apiKey } : {}) },
+            body: { ...(cfg.model ? { model: cfg.model } : {}), input: text, voice: cfg.voice || 'alloy', response_format: 'mp3' },
+            timeoutMs: Number(cfg.timeoutMs) > 0 ? Number(cfg.timeoutMs) : 120000,
+            label: 'TTS API',
+          });
+          if (!res.ok) throw new Error('TTS HTTP ' + res.status + '：' + res.text.slice(0, 200));
+          const blob = /^audio\//.test(res.contentType) ? res.blob : new Blob([res.blob], { type: 'audio/mpeg' });
           const rec = await saveAssetRecord(S.activeId, 'audio', blob, { name: 'TTS-' + text.slice(0, 12), prompt: text, source: 'api', category: 'audio' });
           update((s) => { const nd = s.graph.nodes[n.id]; if (nd) { nd.data.tts = nd.data.tts || {}; nd.data.tts[x.e.id] = { status: 'done', assetId: rec.id }; } s.assetsTick++; });
         } catch (e) {
@@ -5540,7 +5671,9 @@ window.__ModuleLoader__.load({
       const confirmDel = async () => {
         const pid = delTarget && delTarget.id;
         if (!pid) return;
-        flushSave();
+        // 只刷"非待删项目"的待存文档：flushSave 推的是 S.activeId 的全量文档，
+        // 若推的正是待删项目，会与 projectsDelete 竞速把项目原地复活（资产/设定集已清的残废形态）
+        if (pid !== S.activeId) flushSave();
         update((s) => {
           s.projects = s.projects.filter((p) => p.id !== pid);
           try { localStorage.removeItem(LS_GRAPH + pid); } catch { /* 忽略 */ }
@@ -5755,7 +5888,11 @@ window.__ModuleLoader__.load({
         if (files.length) setTick((x) => x + 1);
       };
       const del = async (a) => {
-        if (a.rel) { try { await hostRpc('assetDelete', { rel: a.rel }); } catch { /* 磁盘清理失败不阻塞 */ } }
+        // 数据目录同步：删文件（逻辑路径由 Host 映射到项目名文件夹）+ 清 assets.json 索引
+        const proj = S.projects.find((p) => p.id === (a.projectId || S.activeId));
+        try {
+          await hostRpc('assetDelete', { projectId: a.projectId || S.activeId, projectName: (proj && proj.name) || '', id: a.id, rel: a.rel || '' });
+        } catch { /* 磁盘/索引清理失败不阻塞 */ }
         await idbDelete(a.id);
         update((s) => {
           for (const nd of Object.values(s.graph.nodes)) {
@@ -6386,6 +6523,8 @@ window.__ModuleLoader__.load({
           await hostRpc('dataRootSet', { root: val.trim() });
           await refreshDataRoot();
           toast(T('dataRootSaved') + (S.dataRoot ? '：' + S.dataRoot : ''));
+          assetIndexSynced = false; // 换了目录：索引要往新目录重建
+          syncAssetIndexToHost();
         } catch (e) { toast('设置失败：' + ((e && e.message) || e)); }
         setBusy(false);
       };
@@ -6394,6 +6533,8 @@ window.__ModuleLoader__.load({
         await refreshDataRoot();
         setVal(S.dataRoot || root);
         toast(T('dataRootSaved') + '：' + S.dataRoot);
+        assetIndexSynced = false; // 换了目录：索引要往新目录重建
+        syncAssetIndexToHost();
       };
       const browse = async () => {
         if (busy || picking) return;
@@ -6410,6 +6551,31 @@ window.__ModuleLoader__.load({
         setPicking(false); setBusy(false);
       };
       const openDir = async () => { try { await hostRpc('dataRootReveal'); } catch (e) { toast((e && e.message) || e); } };
+      const importFromRoot = async () => {
+        if (busy || picking) return;
+        setBusy(true);
+        try {
+          const r = await hostRpc('dataRootImport');
+          // 资产元数据 → IndexedDB（本机已存在的同 id 资产跳过，绝不覆盖）
+          let assets = 0;
+          const byProject = r.assets || {};
+          for (const pid of Object.keys(byProject)) {
+            for (const rec of byProject[pid] || []) {
+              if (!rec || !rec.id) continue;
+              const cur = await idbGet(rec.id).catch(() => null);
+              if (cur && (cur.rel || cur.blob)) continue;
+              await idbPut({ ...rec, projectId: pid, stored: rec.rel ? 'disk' : 'idb' });
+              assets++;
+            }
+          }
+          if (assets) update((s) => { s.assetsTick++; });
+          toast(T('dataRootImported').replace('{n}', String((r.imported || []).length)).replace('{a}', String(assets)));
+          // 项目文档 Host 侧已合并：立即拉一轮同步，把新项目带进画布
+          try { await hostSyncTick(); } catch { /* 下一轮 3s 轮询会带 */ }
+          await refreshDataRoot();
+        } catch (e) { toast('导入失败：' + ((e && e.message) || e)); }
+        setBusy(false);
+      };
       const migrate = async () => {
         if (busy || picking || mig) return;
         setBusy(true); setMig({ done: 0, total: 0 });
@@ -6440,6 +6606,11 @@ window.__ModuleLoader__.load({
                 S.dataRoot ? h('button', { type: 'button', className: 'dshic-mini', disabled: busy || picking || !!mig, onPointerDown: (e) => e.stopPropagation(), onClick: migrate }, mig === 'done' ? T('dataRootMigratedDone') : T('dataRootMigrate')) : null,
                 (mig && mig !== 'done') ? h('span', { style: { fontSize: 11, opacity: 0.85 } }, T('dataRootMigrating') + ' ' + mig.done + '/' + mig.total) : null,
               ),
+              h('div', { className: 'dshic-row', key: 'row3' },
+                S.dataRoot ? h('button', { type: 'button', className: 'dshic-mini is-ghost', disabled: busy || picking, onPointerDown: (e) => e.stopPropagation(), onClick: importFromRoot }, Ic('folder', 11), T('dataRootImportBtn')) : null,
+                h('div', { className: 'dshic-flex' }),
+              ),
+              S.dataRoot ? h('div', { className: 'dshic-hint', key: 'importHint' }, T('dataRootImportHint')) : null,
             ],
       );
     }
@@ -7043,8 +7214,8 @@ window.__ModuleLoader__.load({
           probeCraft();
           // 检查更新（Host RPC；Host 旧版未带此方法时静默）
           checkUpdate(true);
-          // 数据根目录（Host 旧版静默降级为 IndexedDB 模式）
-          refreshDataRoot();
+          // 数据根目录（Host 旧版静默降级为 IndexedDB 模式）；就绪后把 IDB 资产元数据补齐进数据目录索引
+          refreshDataRoot().then(() => syncAssetIndexToHost()).catch(() => { /* 静默 */ });
           // 对话 ↔ 画布同步（启动一次 + 3s 轮询；旧 Host 自动停轮询）
           hostSyncTick().then(() => pushAllProjectsToHost());
           const hostSyncTimer = setInterval(() => hostSyncTick(), 3000);

package/docs/release.md

@@ -60,6 +60,8 @@ node scripts/test-host-hardening.mjs # Host 加固回归（读流错误接管/
 node scripts/test-llm-stream.mjs   # LLM 流式与推理模型重试（思考实时推送/按配置上限重试）
 node scripts/test-sync-bible.mjs   # 同步合并回归（设定集拉回/边墓碑防复活）
 node scripts/test-user-scenarios.mjs # 用户实测场景定向复验（轮询无损/自动连线/设定集读写）
+node scripts/test-dataroot.mjs       # 数据目录回归（项目名文件夹/文档镜像/资产索引/一键导入）
+node scripts/test-image-proxy.mjs    # 图片 API 代理回归（CORS 规避：JSON/二进制/状态码透传/超时）
 ```
 
 `check-pack` 防的三类事故：漏打包（如 locale/icon 没进包）、多打包（`.github`/`scripts` 混入）、元数据漂移（版本/exports/`dsh.bundle.patch`）。

package/index.js

@@ -8,7 +8,7 @@
  */
 import { spawn } from 'node:child_process';
 import fs from 'node:fs/promises';
-import { createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { createReadStream, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -121,6 +121,246 @@ function dataRoot() {
   const r = readIcConfig().dataRoot;
   return (typeof r === 'string' && r.trim()) ? path.resolve(r.trim()) : null;
 }
+
+// ============================================================
+// 数据目录 = 可迁移的完整数据包（换电脑拷贝整个目录 → 一键导入）
+//   <root>/canvas.meta.json          清单：项目 id → 文件夹映射（文件夹按项目名）
+//   <root>/projects/<项目名>/
+//     project.json                   项目完整文档（节点/连线/视图/**设定集（含 assetIds 绑定）**）
+//     assets.json                    资产元数据索引（id/名称/类型/rel/实体绑定/提示词）
+//     image|video|audio|text/...     媒体文件
+// 客户端资产记录里的 rel 保持**逻辑路径**（projects/<pid>/…）；
+// Host 在读写边界做 pid→项目名 文件夹映射（physicalRel），旧记录无需重写。
+// ============================================================
+const DATA_META_FILE = 'canvas.meta.json';
+
+function dataRootMetaFile() {
+  const root = dataRoot();
+  return root ? path.join(root, DATA_META_FILE) : null;
+}
+function readDataRootMeta() {
+  const f = dataRootMetaFile();
+  if (f) {
+    try {
+      const m = JSON.parse(readFileSync(f, 'utf8'));
+      if (m && typeof m === 'object' && Array.isArray(m.projects)) return m;
+    } catch { /* 缺失/损坏 → 重建 */ }
+  }
+  return { version: 1, updatedAt: 0, projects: [] };
+}
+function writeDataRootMeta(meta) {
+  const f = dataRootMetaFile();
+  if (!f) return;
+  try {
+    mkdirSync(path.dirname(f), { recursive: true });
+    meta.updatedAt = Date.now();
+    const tmp = f + '.' + process.pid + '.tmp';
+    writeFileSync(tmp, JSON.stringify(meta, null, 1), 'utf8');
+    renameSync(tmp, f);
+  } catch { /* 清单写失败不影响主存储 */ }
+}
+function sanitizeFolderName(name) {
+  const s = String(name || '').replace(/[\\/:*?"<>|\u0000-\u001f]/g, '_').replace(/\s+/g, ' ').trim().slice(0, 60);
+  return s || '未命名项目';
+}
+/** 确保项目的物理文件夹（按项目名）与清单条目存在；改名时尽力重命名目录（被占用/冲突则保留旧文件夹）。返回文件夹名。 */
+function ensureProjectFolder(pid, name) {
+  const root = dataRoot();
+  if (!root) return null;
+  const meta = readDataRootMeta();
+  const want = sanitizeFolderName(name || pid);
+  let entry = meta.projects.find((p) => p.id === pid) || null;
+  if (!entry) {
+    let folder = want;
+    let i = 2;
+    while (meta.projects.some((p) => p.folder === folder)) folder = want + '-' + i++;
+    entry = { id: pid, name: want, folder, createdAt: Date.now() };
+    meta.projects.push(entry);
+  } else {
+    entry.name = want;
+    if (entry.folder !== want) {
+      let target = want;
+      let i = 2;
+      while (meta.projects.some((p) => p.folder === target && p.id !== pid)) target = want + '-' + i++;
+      const from = path.join(root, 'projects', entry.folder);
+      const to = path.join(root, 'projects', target);
+      if (!existsSync(to)) {
+        try {
+          if (existsSync(from)) renameSync(from, to);
+          entry.folder = target; // 目录被占用（Windows 文件锁）时保留旧文件夹，仅改清单名
+        } catch { /* 保留旧文件夹 */ }
+      }
+    }
+  }
+  writeDataRootMeta(meta);
+  return entry.folder;
+}
+/** 逻辑路径（projects/<pid>/…）→ 物理路径（projects/<项目名>/…）；无法识别时原样返回。 */
+function physicalRel(logicalRel) {
+  const m = /^projects\/([^/]+)(\/.*)?$/.exec(String(logicalRel || '').trim().replace(/\\/g, '/'));
+  if (!m) return null;
+  const meta = readDataRootMeta();
+  const entry = meta.projects.find((p) => p.id === m[1]);
+  return 'projects/' + (entry ? entry.folder : m[1]) + (m[2] || '');
+}
+/** 把项目文档镜像到数据目录（project.json，含设定集与 assetIds 绑定）；镜像失败不影响主存储。 */
+function mirrorProjectToDataRoot(id, doc) {
+  const root = dataRoot();
+  if (!root || !id) return;
+  try {
+    const folder = ensureProjectFolder(id, (doc && doc.name) || id);
+    if (!folder) return;
+    const dir = path.join(root, 'projects', folder);
+    mkdirSync(dir, { recursive: true });
+    const out = {
+      id, name: (doc && doc.name) || id,
+      createdAt: (doc && doc.createdAt) || null,
+      updatedAt: (doc && doc.updatedAt) || Date.now(), // 用文档自身的时间戳：导入时"新者胜"比较才有意义
+      nodes: (doc && doc.nodes) || {},
+      edges: (doc && doc.edges) || [],
+      view: (doc && doc.view) || null,
+      tombstones: (doc && doc.tombstones) || [],
+      edgeTombstones: (doc && doc.edgeTombstones) || [],
+      bible: (doc && doc.bible) || null,           // 设定集（角色/场景/道具条目含 assetIds 资产绑定）
+      bibleUpdatedAt: (doc && doc.bibleUpdatedAt) || 0,
+    };
+    const tmp = path.join(dir, 'project.json.tmp');
+    writeFileSync(tmp, JSON.stringify(out, null, 1), 'utf8');
+    renameSync(tmp, path.join(dir, 'project.json'));
+  } catch { /* 镜像失败不影响主存储 */ }
+}
+/** 资产元数据索引 upsert：<项目文件夹>/assets.json。
+ *  opts.replace=true 时整表替换（客户端启动全量同步用：IndexedDB 是资产库的唯一事实源，
+ *  替换语义能自愈"删除后残留的幽灵条目"）；默认按 id 合并（单资产保存用）。 */
+function writeAssetIndex(pid, projectName, assets, opts) {
+  const root = dataRoot();
+  if (!root) throw new Error('未设置数据根目录');
+  const folder = ensureProjectFolder(pid, projectName || pid);
+  if (!folder) throw new Error('数据目录不可用');
+  const dir = path.join(root, 'projects', folder);
+  mkdirSync(dir, { recursive: true });
+  const f = path.join(dir, 'assets.json');
+  let list = [];
+  if (!(opts && opts.replace)) {
+    try {
+      const parsed = JSON.parse(readFileSync(f, 'utf8'));
+      if (Array.isArray(parsed)) list = parsed;
+    } catch { /* 首次/损坏 → 重建 */ }
+  }
+  for (const a of assets || []) {
+    if (!a || !a.id) continue;
+    const i = list.findIndex((x) => x.id === a.id);
+    if (i >= 0) list[i] = a;
+    else list.push(a);
+  }
+  const tmp = f + '.' + process.pid + '.tmp';
+  writeFileSync(tmp, JSON.stringify(list, null, 1), 'utf8');
+  renameSync(tmp, f);
+  return { ok: true, folder, count: list.length };
+}
+/** 删除项目的数据目录镜像（项目被删除时调用）。 */
+function removeDataRootProject(pid) {
+  const root = dataRoot();
+  if (!root || !pid) return;
+  const meta = readDataRootMeta();
+  const entry = meta.projects.find((p) => p.id === pid);
+  meta.projects = meta.projects.filter((p) => p.id !== pid);
+  writeDataRootMeta(meta);
+  if (entry) {
+    try { rmSync(path.join(root, 'projects', entry.folder), { recursive: true, force: true }); } catch { /* 占用时残留，无碍 */ }
+  }
+}
+/** 一次性迁移/对齐数据目录布局：旧 pid 文件夹 → 项目名文件夹，并镜像全部项目文档。 */
+function dataRootMigrate() {
+  const root = dataRoot();
+  if (!root) throw new Error('未设置数据根目录');
+  let ids = [];
+  try {
+    ids = existsSync(PROJECTS_DIR)
+      ? readdirSync(PROJECTS_DIR).filter((f) => f.endsWith('.json')).map((f) => f.replace(/\.json$/, ''))
+      : [];
+  } catch { ids = []; }
+  let filesMoved = 0;
+  const folders = [];
+  for (const id of ids) {
+    let doc = null;
+    try { doc = JSON.parse(readFileSync(projectFile(id), 'utf8')); } catch { continue; }
+    const folder = ensureProjectFolder(id, (doc && doc.name) || id);
+    folders.push(folder);
+    const dir = path.join(root, 'projects', folder);
+    mkdirSync(dir, { recursive: true });
+    // 旧物理布局（projects/<pid>/<kind>/…）→ 新布局（projects/<项目名>/<kind>/…）
+    const oldDir = path.join(root, 'projects', id);
+    if (id !== folder && existsSync(oldDir)) {
+      try {
+        for (const kind of readdirSync(oldDir)) {
+          const fromKind = path.join(oldDir, kind);
+          const toKind = path.join(dir, kind);
+          mkdirSync(toKind, { recursive: true });
+          for (const f of readdirSync(fromKind)) {
+            const from = path.join(fromKind, f);
+            const to = path.join(toKind, f);
+            if (!existsSync(to)) { renameSync(from, to); filesMoved++; }
+          }
+        }
+        rmSync(oldDir, { recursive: true, force: true });
+      } catch { /* 目录被占用：保留旧目录，下轮再试 */ }
+    }
+    mirrorProjectToDataRoot(id, doc);
+  }
+  return { ok: true, projects: folders.filter(Boolean).length, filesMoved, folders };
+}
+/** 从项目的 assets.json 索引里移除一条资产记录（资产被删除时保持数据目录同步）。 */
+function removeAssetIndexEntry(pid, projectName, assetId) {
+  const root = dataRoot();
+  if (!root || !pid || !assetId) return { ok: true, removed: false };
+  let folder = null;
+  try { folder = ensureProjectFolder(pid, projectName || pid); } catch { return { ok: true, removed: false }; }
+  if (!folder) return { ok: true, removed: false };
+  const f = path.join(root, 'projects', folder, 'assets.json');
+  let list = [];
+  try {
+    const parsed = JSON.parse(readFileSync(f, 'utf8'));
+    if (Array.isArray(parsed)) list = parsed;
+  } catch { return { ok: true, removed: false }; }
+  const next = list.filter((x) => x && x.id !== assetId);
+  if (next.length === list.length) return { ok: true, removed: false };
+  const tmp = f + '.' + process.pid + '.tmp';
+  writeFileSync(tmp, JSON.stringify(next, null, 1), 'utf8');
+  renameSync(tmp, f);
+  return { ok: true, removed: true };
+}
+/** 一键导入：扫描数据目录 → 合并 project.json 进主存储（updatedAt 新者胜）→ 返回资产元数据供客户端入 IDB。 */
+function dataRootImport() {
+  const root = dataRoot();
+  if (!root) throw new Error('未设置数据根目录');
+  const projectsDir = path.join(root, 'projects');
+  const dirs = existsSync(projectsDir)
+    ? readdirSync(projectsDir, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name)
+    : [];
+  const imported = [];
+  const assets = {};
+  for (const folder of dirs) {
+    const dir = path.join(projectsDir, folder);
+    let doc = null;
+    try { doc = JSON.parse(readFileSync(path.join(dir, 'project.json'), 'utf8')); } catch { continue; }
+    const id = String(doc.id || '');
+    if (!id) continue;
+    let cur = null;
+    try { cur = JSON.parse(readFileSync(projectFile(id), 'utf8')); } catch { /* 本机没有该项目 */ }
+    if (!cur || (cur.updatedAt || 0) < (doc.updatedAt || 0)) {
+      doc.updatedAt = Date.now();
+      writeIcDoc(id, doc); // 会同步镜像回数据目录（无害）
+      clearDeletedProjectId(id); // 导入恢复：撤掉长效墓碑，后续客户端推送不再被拒收
+      imported.push({ id, name: doc.name || id });
+    }
+    try {
+      const list = JSON.parse(readFileSync(path.join(dir, 'assets.json'), 'utf8'));
+      if (Array.isArray(list)) assets[id] = list;
+    } catch { /* 无资产索引 */ }
+  }
+  return { ok: true, imported, assets };
+}
 /** 设定集字段规范化（世界观/风格 + 角色/场景/道具条目，条目可携带链接资产 assetIds）。 */
 function normalizeBible(raw) {
   const b = (raw && typeof raw === 'object') ? raw : {};
@@ -268,6 +508,9 @@ function projectsList() {
 }
 async function projectsPut(args) {
   const id = String((args && args.id) || '');
+  // 项目删除墓碑（长效）：删除后迟到的全量推送（450ms 防抖竞速 / 启动 pushAllProjectsToHost 快照）
+  // 一律拒收——否则项目原地复活（资产/设定集已清，复活即残废）。客户端不会复用项目 id，拒收永不误伤。
+  if (deletedProjectIds().includes(id)) return { ok: true, id, deleted: true };
   const f = projectFile(id);
   const doc = (args && args.doc) || {};
   let prev = {};
@@ -368,14 +611,85 @@ async function projectsPut(args) {
     out.bibleUpdatedAt = prev.bibleUpdatedAt || 0;
   }
   mkdirSync(PROJECTS_DIR, { recursive: true });
-  writeFileSync(f, JSON.stringify(out, null, 1), 'utf8');
+  writeIcDoc(id, out); // 统一走原子写 + 数据目录镜像（此前直写绕过了镜像与原子性）
   return { ok: true, id, updatedAt: out.updatedAt };
 }
 async function projectsGet(args) {
   return readDoc(String((args && args.id) || ''));
 }
+/** 长效项目删除墓碑（区别于 projectsSync 的一次性 deletedProjects 通知信号）：
+ *  删除后任何迟到的 projectsPut 都被拒收，直到 dataRootImport 显式恢复该 id。 */
+function deletedProjectIds(cfg) {
+  const c = cfg || readIcConfig();
+  return (c.ui && Array.isArray(c.ui.deletedProjectIds)) ? c.ui.deletedProjectIds : [];
+}
+function addDeletedProjectId(id) {
+  const pid = String(id || '');
+  if (!pid) return;
+  const cfg = readIcConfig();
+  const prev = (cfg.ui && Array.isArray(cfg.ui.deletedProjectIds)) ? cfg.ui.deletedProjectIds : [];
+  cfg.ui = { ...(cfg.ui || {}), deletedProjectIds: [...new Set([...prev, pid])].slice(-200) };
+  writeIcConfig(cfg);
+}
+function clearDeletedProjectId(id) {
+  const pid = String(id || '');
+  if (!pid) return;
+  const cfg = readIcConfig();
+  if (!cfg.ui || !Array.isArray(cfg.ui.deletedProjectIds) || !cfg.ui.deletedProjectIds.includes(pid)) return;
+  cfg.ui = { ...cfg.ui, deletedProjectIds: cfg.ui.deletedProjectIds.filter((x) => x !== pid) };
+  writeIcConfig(cfg);
+}
+/** 外部 API 代理转发：浏览器直连第三方图片/视频/音频网关会被 CORS 拦截（带 Authorization 头的
+ *  POST 触发预检，绝大多数网关不返回 CORS 头 → TypeError: Failed to fetch）。
+ *  由 Host 服务端（Node fetch，无 CORS）代为请求并原样回传状态码与响应体。
+ *  req: { url, method?, headers?, body?（对象→JSON 序列化）, bodyRaw?（base64 原文，multipart 用）, bodyContentType?, timeoutMs? } */
+async function fetchProxyForward(reqBody) {
+  const url = String((reqBody && reqBody.url) || '');
+  if (!/^https?:\/\//i.test(url)) throw new Error('需要 http(s) 接口 url');
+  const method = String((reqBody && reqBody.method) || 'POST').toUpperCase();
+  const headers = { ...((reqBody && reqBody.headers && typeof reqBody.headers === 'object') ? reqBody.headers : {}) };
+  let body;
+  if (method !== 'GET' && method !== 'HEAD') {
+    if (reqBody && reqBody.bodyRaw != null) {
+      body = Buffer.from(String(reqBody.bodyRaw), 'base64');
+      if (reqBody.bodyContentType) headers['content-type'] = String(reqBody.bodyContentType);
+    } else if (reqBody && reqBody.body != null) {
+      body = typeof reqBody.body === 'string' ? reqBody.body : JSON.stringify(reqBody.body);
+      if (!headers['content-type']) headers['content-type'] = 'application/json';
+    }
+  }
+  const ms = Number(reqBody && reqBody.timeoutMs) > 0 ? Number(reqBody.timeoutMs) : 120000;
+  const upstream = await fetch(url, {
+    method,
+    headers,
+    ...(body !== undefined ? { body } : {}),
+    signal: AbortSignal.timeout(ms),
+  });
+  const buf = Buffer.from(await upstream.arrayBuffer());
+  return { status: upstream.status, contentType: upstream.headers.get('content-type') || 'application/json; charset=utf-8', buf };
+}
+/** 设置数据根目录（绝对路径）并立即迁移布局；供 RPC 与测试复用。 */
+function setDataRoot(raw) {
+  raw = String(raw ?? '').trim();
+  if (!raw) throw new Error('需要数据根目录路径');
+  // 必须在 resolve 之前判绝对路径：resolve 之后恒为绝对路径，检查就成了死代码，
+  // 相对路径会静默落到应用 cwd（升级即丢数据）
+  if (!path.isAbsolute(raw)) throw new Error('需要绝对路径（如 D:\\canvas-data）');
+  const root = path.resolve(raw);
+  mkdirSync(root, { recursive: true });
+  const cfg = readIcConfig();
+  cfg.dataRoot = root;
+  writeIcConfig(cfg);
+  // 首次设置/换目录：立即迁移布局（pid 文件夹 → 项目名文件夹）并镜像全部项目文档
+  let migrated = null;
+  try { migrated = dataRootMigrate(); } catch (e) { migrated = { error: String((e && e.message) || e) }; }
+  return { ok: true, dataRoot: root, migrated };
+}
 async function projectsDelete(args) {
-  try { unlinkSync(projectFile(args && args.id)); } catch { /* 已不存在视为成功 */ }
+  const id = String((args && args.id) || '');
+  try { unlinkSync(projectFile(id)); } catch { /* 已不存在视为成功 */ }
+  try { addDeletedProjectId(id); } catch { /* 墓碑写失败不影响删除 */ }
+  try { removeDataRootProject(id); } catch { /* 数据目录镜像清理失败不影响删除 */ }
   return { ok: true };
 }
 async function projectsSync() {
@@ -621,6 +935,7 @@ function writeIcDoc(id, doc) {
   const tmp = f + '.' + process.pid + '.tmp';
   writeFileSync(tmp, JSON.stringify(doc, null, 1), 'utf8');
   renameSync(tmp, f);
+  mirrorProjectToDataRoot(id, doc); // 数据目录镜像（含设定集/assetIds 绑定）：失败不影响主存储
 }
 /** 读取设定集（对话侧"设定集先行"的前提）。 */
 async function canvasGetBible(args) {
@@ -641,7 +956,13 @@ async function canvasUpdateBible(args) {
   const mergeList = (base, incoming) => {
     if (incoming === undefined) return base;
     const list = (Array.isArray(incoming) ? incoming : [])
-      .map((x) => ({ name: String((x && x.name) || ''), desc: String((x && x.desc) || '') }))
+      .map((x) => ({
+        name: String((x && x.name) || ''),
+        desc: String((x && x.desc) || ''),
+        // 资产绑定（assetIds）必须透传：设定集落地到数据目录时要携带"连接的资产信息"；
+        // 未提供 assetIds 的合并不抹掉既有绑定（spread 只覆盖存在的键）
+        ...(Array.isArray(x && x.assetIds) ? { assetIds: x.assetIds.map(String).filter(Boolean).slice(0, 20) } : {}),
+      }))
       .filter((x) => x.name);
     if ((args && args.mode) === 'replace') return list;
     const out = [...base];
@@ -746,10 +1067,16 @@ async function canvasDeleteProject(args) {
   let name = id;
   try { name = JSON.parse(readFileSync(f, 'utf8')).name || id; } catch { /* 本来就不存在 */ }
   try { unlinkSync(f); } catch { /* 已删除 */ }
-  // 通知客户端把这个项目也从本地删掉，否则下次推送会把它复活
+  try { removeDataRootProject(id); } catch { /* 数据目录镜像清理失败不影响删除 */ }
+  // 通知客户端把这个项目也从本地删掉，否则下次推送会把它复活 + 长效墓碑：拒收迟到的推送
   const cfg = readIcConfig();
   const prev = (cfg.ui && cfg.ui.deletedProjects) || [];
-  cfg.ui = { ...(cfg.ui || {}), deletedProjects: [...new Set([...prev, id])].slice(-50) };
+  const prevTomb = Array.isArray(cfg.ui.deletedProjectIds) ? cfg.ui.deletedProjectIds : [];
+  cfg.ui = {
+    ...(cfg.ui || {}),
+    deletedProjects: [...new Set([...prev, id])].slice(-50),
+    deletedProjectIds: [...new Set([...prevTomb, id])].slice(-200),
+  };
   writeIcConfig(cfg);
   return { ok: true, projectId: id, name };
 }
@@ -1000,7 +1327,7 @@ async function updateInstall() {
 export const inject = ['webServer', 'tools'];
 
 // 仅供诊断 / 自动化测试（不属于 RPC 面，运行时行为不受影响）
-export const _internals = { updateCheck, updateInstall, npmLatestVersion, cmpVer, findPnpm, getProfileDir: () => PROFILE_DIR, getVersion: () => VERSION, dataRoot, safeJoin, mimeOf, pipeFile, getIcConfigPath: () => CONFIG_PATH, canvasCreateProject, canvasWriteNode, canvasConnect, canvasDeleteProject, canvasDeleteNode, canvasRunNode, canvasNodeStatus, canvasGetBible, canvasUpdateBible, canvasCreateNode, canvasOpen, projectsList, projectsPut, projectsGet, projectsDelete, projectsSync };
+export const _internals = { updateCheck, updateInstall, npmLatestVersion, cmpVer, findPnpm, getProfileDir: () => PROFILE_DIR, getVersion: () => VERSION, dataRoot, setDataRoot, dataRootMigrate, dataRootImport, ensureProjectFolder, physicalRel, mirrorProjectToDataRoot, writeAssetIndex, removeAssetIndexEntry, readDataRootMeta, removeDataRootProject, deletedProjectIds, addDeletedProjectId, clearDeletedProjectId, fetchProxyForward, safeJoin, mimeOf, pipeFile, getIcConfigPath: () => CONFIG_PATH, canvasCreateProject, canvasWriteNode, canvasConnect, canvasDeleteProject, canvasDeleteNode, canvasRunNode, canvasNodeStatus, canvasGetBible, canvasUpdateBible, canvasCreateNode, canvasOpen, projectsList, projectsPut, projectsGet, projectsDelete, projectsSync };
 
 function resolveModel(providers, want) {
   const byProvider = want && want.provider
@@ -1163,17 +1490,7 @@ export function apply(ctx) {
         return { dataRoot: root, exists, configPath: CONFIG_PATH };
       },
       async dataRootSet(args) {
-        const raw = String((args && args.root) ?? '').trim();
-        if (!raw) throw new Error('需要数据根目录路径');
-        // 必须在 resolve 之前判绝对路径：resolve 之后恒为绝对路径，检查就成了死代码，
-        // 相对路径会静默落到应用 cwd（升级即丢数据）
-        if (!path.isAbsolute(raw)) throw new Error('需要绝对路径（如 D:\\canvas-data）');
-        const root = path.resolve(raw);
-        mkdirSync(root, { recursive: true });
-        const cfg = readIcConfig();
-        cfg.dataRoot = root;
-        writeIcConfig(cfg);
-        return { ok: true, dataRoot: root };
+        return setDataRoot((args && args.root) ?? '');
       },
       async dataRootReveal() {
         const root = dataRoot();
@@ -1188,6 +1505,34 @@ export function apply(ctx) {
         } catch { /* 同步抛错同样忽略 */ }
         return { ok: true, dataRoot: root };
       },
+      // 资产元数据索引：客户端把资产记录（无 blob）写入 <项目文件夹>/assets.json（数据目录随拷随用）
+      async assetIndexPut(args) {
+        const projectId = String((args && args.projectId) || '');
+        const asset = (args && args.asset) || null;
+        if (!projectId || !asset || !asset.id) throw new Error('需要 projectId 与 asset');
+        return writeAssetIndex(projectId, String((args && args.projectName) || ''), [asset]);
+      },
+      async assetIndexBulkPut(args) {
+        const items = Array.isArray(args && args.items) ? args.items : [];
+        const byProject = new Map();
+        for (const it of items) {
+          if (!it || !it.projectId) continue;
+          const key = String(it.projectId);
+          if (!byProject.has(key)) byProject.set(key, { name: String(it.projectName || key), list: [] });
+          if (it.asset && it.asset.id) byProject.get(key).list.push(it.asset); // asset=null 的项目占位也入组：assets.json 清空对齐
+        }
+        let indexed = 0;
+        // 整表替换：客户端 IDB 是资产库唯一事实源，启动全量同步借此自愈残留的幽灵条目
+        for (const [pid, { name, list }] of byProject) {
+          writeAssetIndex(pid, name, list, { replace: true });
+          indexed += list.length;
+        }
+        return { ok: true, indexed, projects: byProject.size };
+      },
+      // 一键迁移/对齐：旧 pid 文件夹 → 项目名文件夹 + 全部项目文档镜像
+      async dataRootMigrate() { return dataRootMigrate(); },
+      // 一键导入：换电脑后把数据目录拷过来 → 扫描 project.json/assets.json 合并进本机
+      async dataRootImport() { return dataRootImport(); },
       async pickFolder() {
         const r = await pickFolderDialog();
         return r; // { ok, path } | { ok:false, cancelled } | { ok:false, unsupported }
@@ -1209,9 +1554,21 @@ export function apply(ctx) {
       async canvasOpen(args) { return canvasOpen(args); },
       async assetDelete(args) {
         const root = dataRoot();
-        if (!root) throw new Error('未设置数据根目录');
-        const { abs } = safeJoin(root, (args && args.rel) || '');
-        try { unlinkSync(abs); } catch { /* 已不存在视为成功 */ }
+        const rel = String((args && args.rel) || '');
+        // 逻辑路径（pid）→ 物理路径（项目名文件夹）：不映射会删不到真实文件
+        if (root && rel) {
+          const mapped = physicalRel(rel) || rel;
+          try {
+            const { abs } = safeJoin(root, mapped);
+            unlinkSync(abs);
+          } catch { /* 已不存在视为成功 */ }
+        }
+        // 同步清掉 assets.json 里的记录，保持数据目录与应用状态一致
+        const pid = String((args && args.projectId) || '');
+        const assetId = String((args && args.id) || '');
+        if (pid && assetId) {
+          try { removeAssetIndexEntry(pid, String((args && args.projectName) || ''), assetId); } catch { /* 索引清理失败不影响 */ }
+        }
         return { ok: true };
       },
       async listSkills() {
@@ -1550,6 +1907,9 @@ export function apply(ctx) {
     // 内置技能：把画布操作规程交给 skills 服务（Agent 可加载，作为硬约束）
     try { registerCanvasSkill(ctx, toolDisposers); } catch { /* skills 服务不可用时跳过 */ }
 
+    // 数据根目录已设置时：启动即迁移/对齐布局（pid 文件夹 → 项目名文件夹 + 项目文档镜像），失败静默（下次设置/重启再试）
+    try { if (dataRoot()) dataRootMigrate(); } catch { /* 迁移失败不影响启动 */ }
+
     const registrations = [
       ctx.webServer.register({
         kind: 'exact',
@@ -1628,7 +1988,9 @@ export function apply(ctx) {
             const root = dataRoot();
             if (!root) throw new Error('未设置数据根目录');
             const u = new URL(req.url, 'http://localhost');
-            const { abs, clean } = safeJoin(root, u.searchParams.get('rel') || '');
+            const rawRel = u.searchParams.get('rel') || '';
+            const rel = physicalRel(rawRel) || rawRel; // 逻辑路径（pid）→ 物理路径（项目名文件夹）
+            const { abs, clean } = safeJoin(root, rel);
             mkdirSync(path.dirname(abs), { recursive: true });
             let size = 0;
             const MAX_UPLOAD = 512 * 1024 * 1024; // 512MB 上限：避免无界写盘
@@ -1657,6 +2019,39 @@ export function apply(ctx) {
           }
         },
       }),
+      // 外部 API 代理：浏览器直连第三方图片/视频/音频网关会被 CORS 拦（Failed to fetch），由 Host 代为请求
+      ctx.webServer.register({
+        kind: 'exact',
+        path: `/${NAME}/api/fetch-proxy`,
+        async handler(req, res) {
+          try {
+            if (req.method !== 'POST') {
+              res.statusCode = 405;
+              res.setHeader('content-type', 'application/json; charset=utf-8');
+              res.end(JSON.stringify({ error: '仅接受 POST' }));
+              return;
+            }
+            const chunks = [];
+            let size = 0;
+            for await (const c of req) {
+              size += c.length;
+              if (size > 16e6) { res.statusCode = 413; res.setHeader('content-type', 'application/json; charset=utf-8'); res.end(JSON.stringify({ error: '请求体过大（上限 16MB）' })); return; }
+              chunks.push(c);
+            }
+            let payload = {};
+            try { payload = JSON.parse(Buffer.concat(chunks).toString('utf8') || '{}'); } catch { payload = {}; }
+            const out = await fetchProxyForward(payload);
+            res.statusCode = out.status;
+            res.setHeader('content-type', out.contentType);
+            res.end(out.buf);
+          } catch (e) {
+            const timedOut = e && (e.name === 'TimeoutError' || /aborted|timeout/i.test(String((e && e.message) || e)));
+            res.statusCode = timedOut ? 504 : 502;
+            res.setHeader('content-type', 'application/json; charset=utf-8');
+            res.end(JSON.stringify({ error: (timedOut ? '图片接口代理超时：' : '图片接口代理请求失败：') + String((e && e.message) || e) }));
+          }
+        },
+      }),
       ctx.webServer.register({
         kind: 'exact',
         path: `/${NAME}/api/file`,
@@ -1666,7 +2061,9 @@ export function apply(ctx) {
             const root = dataRoot();
             if (!root) { res.statusCode = 404; res.end('未设置数据根目录'); return; }
             const u = new URL(req.url, 'http://localhost');
-            const { abs } = safeJoin(root, u.searchParams.get('rel') || '');
+            const rawRel = u.searchParams.get('rel') || '';
+            const rel = physicalRel(rawRel) || rawRel; // 逻辑路径（pid）→ 物理路径（项目名文件夹）
+            const { abs } = safeJoin(root, rel);
             let st;
             try { st = statSync(abs); } catch { res.statusCode = 404; res.end('not found'); return; }
             if (!st.isFile()) { res.statusCode = 404; res.end('not found'); return; }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ninkch/dsh-infinite-canvas",
-  "version": "0.17.6",
+  "version": "0.17.7",
   "description": "Node-based short-drama studio for DeepSeek Harness: script → storyboard → assets → shots → voiced, subtitled final cut on an infinite canvas.",
   "keywords": [
     "dsh",