@ninkch/dsh-infinite-canvas 0.17.13 → 0.17.14

package/assets/canvas-studio/SKILL.md

@@ -136,7 +136,12 @@ description: 用无限画布（Infinite Canvas）做短剧/视频创作时使用
 5. **生成角色/场景/道具参考图**：为设定集里的每个条目
    `canvas_create_node({ projectId, type: 'image-gen', name: '角色-张山 多视图', prompt: '按设定集写外观关键词' })`
    → `canvas_run_node({ projectId, nodeId })` 触发（画布用它配置的图片接口）
-   - 需要补连任意两节点时用 `canvas_connect({ projectId, fromNode, toNode })`（端口类型必须匹配）
+   - 需要补连任意两节点时用 `canvas_connect({ projectId, fromNode, toNode })`（端口类型必须匹配；
+     连分镜表时系统按语义自动选口：剧本/文本 → `script`，分镜表 → `prev`，不用手写端口）
+   - **布局乱了/节点重叠**：`canvas_relayout({ projectId })` 一键重排——横向数据流决定列
+     （文本→分镜表→视频），竖向关系（承接 `prev` / 首帧 `frame`）留在同列，同行 = 一个横向连通组
+     （如「场N文本 ↔ 场N分镜表」对齐），行间保留间距、绝不重叠。新建节点已做碰撞检测；
+     存量节点乱了一律用这个工具重排，不要手工挪。
 6. `canvas_open({ projectId })` —— 让用户看到画布结果
 
 ## 三、@引用与资产命名（跨集一致性的核心手法）

package/assets/support/README.md

@@ -0,0 +1,21 @@
+# 帮助与反馈静态资源
+
+画布界面里的「帮助与反馈」弹窗（工具栏按钮 / 设置面板一行入口）会加载这里的文件。
+
+## 微信二维码
+
+- 当前文件：`wechat.png`（**个人微信二维码**——永久有效；群二维码 7 天过期，难维护，所以用个人码 + 手动拉群）
+- 换图：直接替换本目录的 `wechat.png`（同名即可；若换扩展名，请同步改 `client.js` 里的 `SUPPORT_QR_URL`）
+- 建议正方形、400×400 以上，且**不带多余文字**（弹窗里已有说明文案，图上再印字会重复）
+- **改完需重启 DSH**（静态资源路由在插件启动时注册）
+- 文件缺失时弹窗显示占位提示，不会报错
+
+访问方式（插件自身路由，白名单 `assets/` 目录 + 拒绝路径穿越）：
+
+```
+/infinite-canvas/api/plugin-asset?rel=assets/support/wechat.png
+```
+
+## GitHub 地址
+
+仓库与 Issue 地址写在 `client.js` 顶部的 `SUPPORT_GITHUB` / `SUPPORT_ISSUES` 常量里，改地址只需改这两行。

package/client.js

@@ -252,9 +252,23 @@ window.__ModuleLoader__.load({
       'nStoryboard': '分镜表',
       'nScript': '剧本',
       'vendorLabel': '厂商格式（选后只需填 Base URL + 模型 id）',
+      'showKey': '显示明文',
+      'hideKey': '隐藏（脱敏显示）',
+      'supportBtn': '帮助与反馈',
+      'supportTitle': '帮助与反馈',
+      'supportNote': '有问题或改进建议，提 Issue 或进群反馈。',
+      'supportGithub': 'GitHub 仓库',
+      'supportIssues': '访问 GitHub，提 Issue',
+      'supportWechat': '交流群',
+      'supportWechatHint': '扫码添加，进入交流群',
+      'supportCopy': '复制地址',
+      'supportCopied': '已复制到剪贴板',
+      'supportOpen': '打开',
+      'supportQrMissing': '二维码待放置：assets/support/wechat.png',
+      'supportClose': '关闭',
       'portScript': '剧本',
-      'portPrev': '衔接上一镜（尾镜）',
-      'portTail': '尾镜（供下一分镜衔接）',
+      'portPrev': '衔接上一镜',
+      'portTail': '尾镜输出',
       'aiScript': 'AI 生成剧本',
       'aiStoryboard': 'AI 生成分镜',
       'expand': '铺开到画布',
@@ -643,6 +657,20 @@ window.__ModuleLoader__.load({
       'nScript': 'Script',
       'portScript': 'script',
       'vendorLabel': 'Vendor format (then just Base URL + model id)',
+      'showKey': 'Show key',
+      'hideKey': 'Hide key (masked)',
+      'supportBtn': 'Help & feedback',
+      'supportTitle': 'Help & feedback',
+      'supportNote': 'Found a bug or have an idea? File an issue or join the group.',
+      'supportGithub': 'GitHub repository',
+      'supportIssues': 'Visit GitHub & file an issue',
+      'supportWechat': 'Community group',
+      'supportWechatHint': 'Scan to join the group',
+      'supportCopy': 'Copy URL',
+      'supportCopied': 'Copied to clipboard',
+      'supportOpen': 'Open',
+      'supportQrMissing': 'QR not added yet: assets/support/wechat.png',
+      'supportClose': 'Close',
       'portPrev': 'Continue prev tail',
       'portTail': 'Tail shot (for next)',
       'aiScript': 'AI write script',
@@ -1039,6 +1067,8 @@ window.__ModuleLoader__.load({
 .dshic-port:hover,.dshic-port.is-active{background:var(--dsw-alias-brand-primary);border-color:var(--dsw-alias-brand-primary);
   box-shadow:0 0 0 3px color-mix(in srgb,var(--dsw-alias-brand-primary) 25%,transparent);}
 .dshic-port-wrap{position:absolute;width:0;height:0;}
+/* 角点端口（分镜尾镜输出/衔接输入）：显式以锚点为中心，保证连线正好从点位中心垂直穿出 */
+.dshic-port.is-corner{left:-5.5px;top:-5.5px;}
 .dshic-port-label{position:absolute;font-size:9px;color:var(--dsw-alias-label-secondary);white-space:nowrap;pointer-events:none;opacity:0;transition:opacity .12s;}
 .dshic-node:hover .dshic-port-label{opacity:1;}
 .dshic-marquee{position:absolute;border:1px solid var(--dsw-alias-brand-primary);
@@ -1432,8 +1462,9 @@ window.__ModuleLoader__.load({
     // @ 引用（mention）：提示词里写 @张山 → 自动带上该实体的设定集描述与其参考图资产
     // 以下为纯函数（无副作用），供 scripts/test-mentions.mjs 抽取单测
     // <<<MENTION_PURE_BEGIN>>>
-    /** @名称 的词法：到空白或常见标点为止（支持中英文名与 - _ ·） */
-    const MENTION_RE = /@([^\s@，。；：、,.;:!?！？()（）\[\]【】"'“”<>《》/\\|]{1,24})/g;
+    /** @资产名@ 的词法（双 @ 精确包裹）：终止符是闭合 @，绝不可能把后文吞进名称；
+     *  名称内禁止 @、空白与常见标点。前端渲染时隐藏两个 @，名称显示为蓝色加粗。 */
+    const MENTION_RE = /@([^@\s，。；：、,.;:!?！？()（）\[\]【】"'“”<>《》/\\|]{1,64}?)@/g;
     /** 解析提示词里的 @名称（含位置，按出现顺序）。 */
     function parseMentions(text) {
       const out = [];
@@ -1451,7 +1482,7 @@ window.__ModuleLoader__.load({
         .replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
         .replace(/"/g, '&quot;').replace(/'/g, '&#39;');
     }
-    /** 把提示词转成高亮 HTML：@名称 用 .dshic-mention（蓝色加粗）标记。 */
+    /** 把提示词转成高亮 HTML：@资产名@ 两个 @ 隐藏（占位但不可见），名称显示为蓝色加粗。 */
     function highlightMentions(text) {
       const src = String(text || '');
       let out = '';
@@ -1460,16 +1491,31 @@ window.__ModuleLoader__.load({
       let m;
       while ((m = re.exec(src)) !== null) {
         out += escapeHtml(src.slice(last, m.index));
-        out += '<span class="dshic-mention">' + escapeHtml(m[0]) + '</span>';
+        out += '<span style="visibility:hidden">@</span><span class="dshic-mention">' + escapeHtml(m[1]) + '</span><span style="visibility:hidden">@</span>';
         last = m.index + m[0].length;
       }
       out += escapeHtml(src.slice(last));
       return out === '' ? '' : out + '\n'; // 末尾补换行，保证背景层与 textarea 行高对齐
     }
-    /** 送给模型前去掉 @ 标记（保留名称本体）。 */
+    /** 送给模型前去掉 @ 包裹标记（保留名称本体）。 */
     function stripMentionMarks(text) {
       return String(text || '').replace(new RegExp(MENTION_RE.source, 'g'), '$1');
     }
+    /** 展示用：把 @资产名@ 渲染为「蓝色加粗资产名」（隐藏两个 @，前后各留 2px 视觉空隙）。 */
+    function mentionNodes(text) {
+      const src = String(text || '');
+      const out = [];
+      const re = new RegExp(MENTION_RE.source, 'g');
+      let m;
+      let last = 0;
+      while ((m = re.exec(src)) !== null) {
+        if (m.index > last) out.push(src.slice(last, m.index));
+        out.push(h('span', { className: 'dshic-mention', style: { margin: '0 2px' } }, m[1]));
+        last = m.index + m[0].length;
+      }
+      if (last < src.length) out.push(src.slice(last));
+      return out.length ? out : [src];
+    }
     function entityLabelOf(kind) {
       return kind === 'character' ? '角色' : kind === 'scene' ? '场景' : kind === 'prop' ? '道具' : '元素';
     }
@@ -3398,6 +3444,11 @@ window.__ModuleLoader__.load({
       const nodes = { ...((live && live.nodes) ? live.nodes : local.nodes) };
       for (const [nid, n] of Object.entries(full.nodes || {})) {
         if (deadNodes.has(nid)) continue;
+        const cur = nodes[nid];
+        // 生成产物保护：本地分镜已有 shots 而主机副本没有 → 主机副本是竞态过期数据，保留本地
+        // （否则刚生成完的分镜会被一次过期合并清空，客户端再推回去就永久丢失）
+        if (cur && cur.type === 'storyboard' && Array.isArray(cur.data && cur.data.shots) && cur.data.shots.length
+          && !(n && n.data && Array.isArray(n.data.shots) && n.data.shots.length)) continue;
         nodes[nid] = n; // Host 为准（Agent 写入是有意的）
       }
       const deadEdges = new Set([...(local.edgeTombstones || []), ...(full.edgeTombstones || []), ...((live && live.edgeTombstones) || [])]);
@@ -3816,6 +3867,7 @@ window.__ModuleLoader__.load({
         '- **每个场景必须以「【场N】场景名（地点·时间）」单独一行开头**（如【场1】城市街头（夜））——这是后续自动铺开到分镜的分场标记，格式不可省略或改写；',
         '- 每场容量 10-15 秒成片（约 60-150 字，含该场全部对白）；全部场景时长之和 ≈ 1-2 分钟；',
         '- 场景头之后：可视化动作描写 + 对白（角色：台词，单独成行）；需要的声音（环境音/旁白）标注在括号里；',
+        '- **【资产锚定·硬性】正文中所有角色/场景/道具名称一律写成 @名称@ 引用形式**（前后各一个 @ 精确包裹，名称与设定集逐字一致，如「@陈拾@ 在 @城市街头@ 的 @铁皮围挡@ 旁」）——下游分镜生成靠这些锚点识别资产并挂接参考图；叙述性文字正常书写，不要把动作描述包进 @…@；',
         '- 结尾单独一行「人物：」与「场景/道具：」清单，便于后续资产制作。',
       ].join('\n') : [
         `Idea / source:\n${String(idea ?? '').trim()}`,
@@ -3824,6 +3876,7 @@ window.__ModuleLoader__.load({
         '- **Every scene MUST start with its own line "【SCENE N】name (location · time)"** — this marker drives the automatic per-scene expansion and must not be omitted;',
         '- Each scene holds 10-15 seconds of screen time (≈60-150 words incl. dialogue); all scenes sum to ≈1-2 minutes;',
         '- After each scene header: visual action + dialogue ("Character: line" on its own lines); mark sounds in brackets;',
+        '- **[ASSET ANCHORING - HARD] wrap every character/scene/prop name as @Name@** (an @ on each side, names verbatim from the bible, e.g. "@Chen@ stands by @Wall@ at @Street@") - downstream storyboard generation relies on these anchors to attach references; keep narration text normal, never wrap action descriptions inside @...@;',
         '- End with "Characters:" and "Locations/Props:" lists for asset production.',
       ].join('\n');
       return await aiCompleteStream({
@@ -3867,7 +3920,7 @@ window.__ModuleLoader__.load({
             '只输出一个 JSON 对象：{"shots":[{"title":"…","visual":"…","motion":"…","characters":["…"],"scene":"…","props":["…"],"duration":3,"dialogue":[{"role":"陈拾","line":"收件时间，1999……"}],"sfx":"邮包搭扣声、撕纸声"}]}。',
             '规则：',
             '- visual 是本镜画面描述（景别、人物外观与站位、场景、光线、构图，60 字内）；',
-            '- **visual 与 motion 里的角色/场景/道具必须写成 @名称 引用形式**（如 `@张山`、`@褶皱巷`），插件会自动带上该实体的设定描述与其参考图资产，保证跨镜一致；',
+            '- **visual 与 motion 里的角色/场景/道具必须写成 @资产名@ 引用形式**（前后各一个 @ 精确包裹，如「@陈拾@ 在 @城市街头@ 的围挡旁拿起 @奇怪快递件@」）；名称必须与设定集/资产**逐字一致**；剧本原文里已出现的 @资产名@ 锚点要在镜头中原样保留（名称逐字一致）；名称内不得含 @、空格或标点；@ 后绝不允许直接跟其他文字（必须以 @ 闭合）——系统会隐藏两个 @ 并把名称显示为蓝色加粗，未登记的 @名称@ 会被一致性检查提示补充；',
             '- motion 是本镜动作与运镜（主体动作节拍、机位运动方向与速度、情绪节奏，50 字内）；与 visual 不重复；',
             '- characters/scene/props 使用剧本与设定集中的名称（不带 @），便于匹配资产；无道具给空数组；',
             '- **dialogue 是本镜的角色台词**：把剧本中落在这一镜的对白逐行搬进来（{"role":"角色名","line":"台词原文"}），台词必须**逐字来自剧本**、不新写不改写；本镜无台词给空数组；一镜尽量只放一个角色的台词（单说话人镜头利于声音参考提取）；',
@@ -3884,7 +3937,7 @@ window.__ModuleLoader__.load({
             'Output only one JSON object: {"shots":[{"title":"…","visual":"…","motion":"…","characters":["…"],"scene":"…","props":["…"],"duration":3,"dialogue":[{"role":"Chen","line":"…"}],"sfx":"zipper snap, paper tear"}]}.',
             'Rules:',
             '- visual = the shot\'s frame description (shot size, wardrobe, staging, light, framing, <=60 words);',
-            '- **characters/scenes/props inside visual and motion must be written as @name references** (e.g. `@ZhangSan`); the plugin then attaches that entity\'s bible description and reference images automatically;',
+            '- **characters/scenes/props inside visual and motion must be written as @Name@ references** (an @ on each side, e.g. "@Chen@ picks up @Parcel@ by @Street@"); names must match the bible/assets VERBATIM, with no @, space or punctuation inside; an @ must never be followed directly by other text (always close with @) - the UI hides the @s and shows the name in blue bold; unregistered @Name@ is flagged by the consistency check;',
             '- motion = action & camera for the shot (action beats, camera move, emotional rhythm, <=50 words); do not repeat visual;',
             '- characters/scene/props arrays must use plain names from the script and series bible (no @) so assets match; empty props array if none;',
             '- **dialogue = the character lines that fall in this shot**, moved verbatim from the script ({"role":"Name","line":"exact line"}); never rewrite lines; empty array if none; keep one speaker per shot when possible (helps voice-reference extraction);',
@@ -4028,11 +4081,9 @@ window.__ModuleLoader__.load({
         for (const nm of (sh.characters || [])) check(title, T('catCharacter'), nm);
         check(title, T('catScene'), sh.scene);
         for (const nm of (sh.props || [])) check(title, T('catProp'), nm);
-        // visual/motion 文本里的 @提及 同样纳入检查（数组外的实体也要登记，杜绝检查漏）
+        // visual/motion 文本里的 @资产名@ 提及同样纳入检查（未登记的会提示补充资产——这是检查的价值所在）
         const text = String(sh.visual || '') + ' ' + String(sh.motion || '');
-        for (const m of (text.match(/@[^\s@，。；、！？:：（）"'）)]+/g) || [])) {
-          check(title, T('catMention'), m.slice(1).replace(/[）)]+$/, ''));
-        }
+        for (const mm of parseMentions(text)) check(title, T('catMention'), mm.name);
       }
       return warnings;
     }
@@ -4457,15 +4508,28 @@ window.__ModuleLoader__.load({
     function portWorldPos(nodeId, portId, dir) {
       const n = S.graph.nodes[nodeId];
       if (!n) return { x: 0, y: 0 };
+      // 分镜承接端口专属位置（用户设计）：tail=节点底部右侧（输出）、prev=节点顶部右侧（输入）
+      if (n.type === 'storyboard' && portId === 'tail') return { x: n.x + n.w - 48, y: n.y + n.h };
+      if (n.type === 'storyboard' && portId === 'prev') return { x: n.x + n.w - 48, y: n.y };
       const list = dir === 'out' ? (PORTS[n.type].outputs || []) : (PORTS[n.type].inputs || []);
       const i = list.findIndex((p) => p.id === portId);
-      const y = n.y + 38 + Math.max(0, i) * 22;
+      const stack = (n.type === 'storyboard' && dir === 'in' && i > 0) ? i - 1 : i; // prev 是角点不占常规队列
+      const y = n.y + 38 + Math.max(0, stack) * 22;
       return { x: dir === 'out' ? n.x + n.w : n.x, y };
     }
     function edgeGeom(e) {
       const a = portWorldPos(e.fromNode, e.fromPort, 'out');
       const b = portWorldPos(e.toNode, e.toPort, 'in');
-      const dx = Math.max(42, Math.abs(b.x - a.x) * 0.5);
+      const off = Math.abs(b.x - a.x);
+      // 端口横向对齐（同一列上下相接，如分镜承接链）：直接连直线，不再外扩控制点画弯线
+      if (off < 12 && Math.abs(b.y - a.y) > 24) {
+        return {
+          d: `M ${a.x} ${a.y} L ${b.x} ${b.y}`,
+          mx: (a.x + b.x) / 2,
+          my: (a.y + b.y) / 2,
+        };
+      }
+      const dx = Math.max(42, off * 0.5);
       const c1x = a.x + dx, c2x = b.x - dx;
       return {
         d: `M ${a.x} ${a.y} C ${c1x} ${a.y}, ${c2x} ${b.y}, ${b.x} ${b.y}`,
@@ -5278,6 +5342,10 @@ window.__ModuleLoader__.load({
       script: 'M6 3h9l4 4v14H6zM15 3v4h4M9 12h7M9 16h7M9 8h3',
       board: 'M4 4h16v16H4zM4 9h16M9 4v5M15 4v5M9 13h6M9 17h6',
       expandAll: 'M4 12h6M4 12l3-3M4 12l3 3M20 12h-6M20 12l-3-3M20 12l-3 3M12 4v6M12 4l-3 3M12 4l3 3M12 20v-6M12 20l-3-3M12 20l3-3',
+      eye: 'M2.5 12S6 6.5 12 6.5 21.5 12 21.5 12 18 17.5 12 17.5 2.5 12 2.5 12zM12 15a3 3 0 100-6 3 3 0 000 6z',
+      eyeOff: 'M4 4l16 16M9.9 5.1A9.6 9.6 0 0112 5c6 0 9.5 7 9.5 7a17 17 0 01-3.3 4.2M6.2 7.4A17 17 0 002.5 12S6 19 12 19a9.4 9.4 0 003.9-.8M10 10a3 3 0 004 4',
+      help: 'M12 21a9 9 0 100-18 9 9 0 000 18zM9.4 9.4a2.6 2.6 0 114.2 2.1c-.9.7-1.6 1.2-1.6 2.3M12 17h.01',
+      link: 'M10 13a5 5 0 007.1 0l2.4-2.4a5 5 0 00-7.1-7.1L11 4.9M14 11a5 5 0 00-7.1 0L4.5 13.4a5 5 0 007.1 7.1L13 19.1',
     };
     function Ic(name, size) { return h(Icon, { d: ICONS[name], size: size || 14 }); }
 
@@ -5322,7 +5390,7 @@ window.__ModuleLoader__.load({
       return () => ro.disconnect();
     }
 
-    function PortEl({ n, port, dir }) {
+    function PortEl({ n, port, dir, corner }) {
       const isActive = drag.mode === 'link' && drag.linkFrom && drag.linkFrom.node.id === n.id && drag.linkFrom.port === port.id;
       let compat = false;
       const link = drag.mode === 'link' ? drag.linkFrom : null;
@@ -5332,7 +5400,7 @@ window.__ModuleLoader__.load({
       }
       return h('button', {
         type: 'button',
-        className: cls('dshic-port', 'k-' + port.kind, isActive && 'is-active', compat && 'is-compat'),
+        className: cls('dshic-port', 'k-' + port.kind, corner && 'is-corner', isActive && 'is-active', compat && 'is-compat'),
         'data-node-id': n.id,
         ...(dir === 'out' ? { 'data-port-out': port.id } : { 'data-port-in': port.id }),
         'data-kind': port.kind,
@@ -5499,14 +5567,19 @@ window.__ModuleLoader__.load({
         h('div', { className: 'dshic-rs dshic-rs-s', title: T('resizeHeightHint'), onPointerDown: (e) => startResize(e, 's'), onDoubleClick: resetHeight }),
         h('div', { className: 'dshic-rs dshic-rs-n', title: T('resizeHint'), onPointerDown: (e) => startResize(e, 'n') }),
         h('div', { className: 'dshic-rs dshic-rs-se', title: T('resizeHint'), onPointerDown: (e) => startResize(e, 'se') }),
-        ...(PORTS[n.type].inputs || []).map((p, i) =>
-          h('div', { key: 'in-' + p.id, style: { position: 'absolute', left: -5.5, top: 32.5 + i * 22 }, className: 'dshic-port-wrap' },
-            h(PortEl, { n, port: p, dir: 'in' }),
-            h('span', { className: 'dshic-port-label', style: { left: 14, top: 0 } }, portLabel(p.id)))),
-        ...(PORTS[n.type].outputs || []).map((p, i) =>
-          h('div', { key: 'out-' + p.id, style: { position: 'absolute', right: -5.5, top: 32.5 + i * 22 }, className: 'dshic-port-wrap' },
-            h(PortEl, { n, port: p, dir: 'out' }),
-            h('span', { className: 'dshic-port-label', style: { right: 14, top: 0 } }, portLabel(p.id)))),
+        ...(PORTS[n.type].inputs || []).map((p, i) => {
+          const isCorner = n.type === 'storyboard' && p.id === 'prev'; // 分镜承接：顶部右侧角点
+          const stack = (n.type === 'storyboard' && i > 0) ? i - 1 : i;
+          return h('div', { key: 'in-' + p.id, style: { position: 'absolute', left: isCorner ? undefined : -5.5, right: isCorner ? 48 : undefined, top: isCorner ? 0 : 32.5 + stack * 22 }, className: 'dshic-port-wrap' },
+            h(PortEl, { n, port: p, dir: 'in', corner: isCorner }),
+            h('span', { className: 'dshic-port-label', style: isCorner ? { right: -6, top: -22 } : { left: 14, top: 0 } }, portLabel(p.id)));
+        }),
+        ...(PORTS[n.type].outputs || []).map((p, i) => {
+          const isCorner = n.type === 'storyboard' && p.id === 'tail'; // 分镜尾镜：底部右侧角点
+          return h('div', { key: 'out-' + p.id, style: { position: 'absolute', right: isCorner ? 48 : -5.5, bottom: isCorner ? 0 : undefined, top: isCorner ? undefined : 32.5 + i * 22 }, className: 'dshic-port-wrap' },
+            h(PortEl, { n, port: p, dir: 'out', corner: isCorner }),
+            h('span', { className: 'dshic-port-label', style: isCorner ? { right: -6, top: 12 } : { right: 14, top: 0 } }, portLabel(p.id)));
+        }),
       );
     }
 
@@ -6223,11 +6296,12 @@ window.__ModuleLoader__.load({
     }
 
     function TextNodeBody({ n }) {
-      return h('textarea', {
-        className: 'dshic-textarea', value: n.data.text || '',
+      // 文本节点同样走高亮输入层：输入 @资产名@ 自动显示为蓝色加粗（两个 @ 隐藏），与资产库强绑定
+      return h(PromptArea, {
+        value: n.data.text || '',
         placeholder: T('textPlaceholder'),
-        onChange: (e) => update((s) => { const nd = s.graph.nodes[n.id]; if (nd) nd.data.text = e.target.value; }),
-        onPointerDown: (e) => e.stopPropagation(),
+        minHeight: 96,
+        onChange: (v) => update((s) => { const nd = s.graph.nodes[n.id]; if (nd) nd.data.text = v; }),
       });
     }
 
@@ -6409,10 +6483,12 @@ window.__ModuleLoader__.load({
       const listH = Math.max(80, Math.min(1200, Number(n.data.shotsListH) || 180));
       const startResize = (e) => {
         e.stopPropagation(); e.preventDefault();
-        const startY = e.clientY; const startH = listH;
+        const startY = e.clientY; const startH = listH; const startNodeH = Number(n.h) || 0;
         const onMove = (ev) => {
           const nh = Math.max(80, Math.min(1200, startH + (ev.clientY - startY)));
-          update((s) => { const nd = s.graph.nodes[n.id]; if (nd) nd.data.shotsListH = nh; });
+          const dh = nh - startH;
+          // 节点高度随列表一起向下生长（不是内部挤压上面内容）
+          update((s) => { const nd = s.graph.nodes[n.id]; if (nd) { nd.data.shotsListH = nh; if (startNodeH > 0) nd.h = Math.max(120, startNodeH + dh); } });
         };
         const onUp = () => { window.removeEventListener('pointermove', onMove); window.removeEventListener('pointerup', onUp); flushSave(); };
         window.addEventListener('pointermove', onMove);
@@ -6481,7 +6557,7 @@ window.__ModuleLoader__.load({
           ? h('div', { key: 'listwrap', style: { position: 'relative', alignSelf: 'stretch' } },
               h('div', { key: 'list', className: 'dshic-shot-list', style: { maxHeight: listH + 'px' } },
                 shots.map((sh, i) => h('div', { key: i, className: 'dshic-shot-item', onPointerDown: (e) => e.stopPropagation() },
-                  h('strong', {}, `${sh.title} · ${sh.duration}s `), sh.visual,
+                  h('strong', {}, `${sh.title} · ${sh.duration}s `), ...mentionNodes(sh.visual),
                   (sh.dialogue || []).length
                     ? h('div', { className: 'dshic-shot-label', style: { marginTop: 3 } }, '台词 ' + sh.dialogue.map((d) => `${d.role}：${d.line}`).join('；'))
                     : null,
@@ -6952,6 +7028,8 @@ window.__ModuleLoader__.load({
           : h('button', { type: 'button', className: 'dshic-btn', style: { fontWeight: 600, maxWidth: 180, overflow: 'hidden' }, onDoubleClick: () => setNaming(true), title: T('renameHint') },
               h('span', { style: { overflow: 'hidden', textOverflow: 'ellipsis' } }, proj ? proj.name : '')),
         h('div', { className: 'dshic-toolbar-sep' }),
+        h(Btn, { onClick: () => update((s) => { s.supportOpen = true; }), title: T('supportBtn') }, Ic('help', 13), T('supportBtn')),
+        h('div', { className: 'dshic-toolbar-sep' }),
         h('button', {
           type: 'button', className: cls('dshic-btn'), style: { fontSize: 12, color: 'var(--dsw-alias-label-secondary)', gap: 4 },
           title: T('updateBtn') + ((S.updateInfo && S.updateInfo.runningVersion) ? '（当前 v' + S.updateInfo.runningVersion + '）' : ''), disabled: S.updateChecking,
@@ -7538,13 +7616,35 @@ window.__ModuleLoader__.load({
 
     /** 图片/视频模型多配置列表：名称 / 地址 / Key / 模型（/模式），可增删、设默认。 */
     function Field({ label, value, onChange, placeholder, password }) {
+      // 敏感字段（API Key）：默认脱敏，点击小眼睛切换明文显示
+      const [reveal, setReveal] = useState(false);
+      if (!password) {
+        return h('div', { className: 'dshic-field' },
+          h('span', { className: 'dshic-field-label' }, label),
+          h('input', {
+            className: 'dshic-input', type: 'text', value, placeholder: placeholder || '',
+            onChange: (e) => onChange(e.target.value),
+            onPointerDown: (e) => e.stopPropagation(),
+          }));
+      }
       return h('div', { className: 'dshic-field' },
         h('span', { className: 'dshic-field-label' }, label),
-        h('input', {
-          className: 'dshic-input', type: password ? 'password' : 'text', value, placeholder: placeholder || '',
-          onChange: (e) => onChange(e.target.value),
-          onPointerDown: (e) => e.stopPropagation(),
-        }));
+        h('div', { style: { position: 'relative', display: 'flex', alignItems: 'center' } },
+          h('input', {
+            className: 'dshic-input', type: reveal ? 'text' : 'password', value, placeholder: placeholder || '',
+            style: { paddingRight: 30 },
+            onChange: (e) => onChange(e.target.value),
+            onPointerDown: (e) => e.stopPropagation(),
+          }),
+          h('button', {
+            type: 'button', className: 'dshic-iconbtn',
+            title: reveal ? T('hideKey') : T('showKey'),
+            'aria-label': reveal ? T('hideKey') : T('showKey'),
+            style: { position: 'absolute', right: 3, top: '50%', transform: 'translateY(-50%)', width: 22, height: 22 },
+            onPointerDown: (e) => e.stopPropagation(),
+            onClick: () => setReveal((v) => !v),
+          }, reveal ? Ic('eyeOff', 12) : Ic('eye', 12)),
+        ));
     }
     /** ⓘ 悬停说明：界面简洁化——长解释一律收进悬停提示（原生 title），不再平铺文字。 */
     function InfoTip(text) {
@@ -8136,6 +8236,17 @@ window.__ModuleLoader__.load({
         h(ModelProviderEditor, { key: 'imglist', kind: 'image' }),
         h(ModelProviderEditor, { key: 'vidlist', kind: 'video' }),
         h(ApiListEditor, { key: 'ttslist', kind: 'tts' }),
+        // 帮助与反馈：一行入口（点开弹窗看二维码与提 Issue）
+        h('div', {
+          key: 'support', className: 'dshic-card', style: { cursor: 'pointer' },
+          onClick: () => update((s) => { s.supportOpen = true; }),
+        },
+          h('div', { className: 'dshic-row' },
+            Ic('help', 12),
+            h('strong', { style: { fontSize: 12, flex: 1, minWidth: 0 } }, T('supportBtn')),
+            h('span', { className: 'dshic-hint', style: { flex: 'none' } }, T('supportIssues') + ' / ' + T('supportWechat') + ' ›'),
+          ),
+        ),
         h('div', { key: 'note', className: 'dshic-hint' }, 'DeepSeek Harness · dsh-infinite-canvas' + ((S.updateInfo && S.updateInfo.runningVersion) ? ' v' + S.updateInfo.runningVersion : '')),
       ];
     }
@@ -8634,6 +8745,7 @@ window.__ModuleLoader__.load({
         ),
         S.menu ? h(ContextMenu, { menu: S.menu }) : null,
         S.lightbox ? h(Lightbox) : null,
+        S.supportOpen ? h(SupportDialog) : null,
         S._toast ? h('div', {
           style: {
             position: 'fixed', bottom: 22, left: '50%', transform: 'translateX(-50%)', zIndex: 70,
@@ -8671,6 +8783,50 @@ window.__ModuleLoader__.load({
       );
     }
 
+    // ============================================================
+    // 帮助与反馈：GitHub 仓库/Issue + 微信交流群二维码（插件静态资源）
+    // ============================================================
+    const SUPPORT_GITHUB = 'https://github.com/NINKCH/dsh-infinite_canvas';
+    const SUPPORT_ISSUES = 'https://github.com/NINKCH/dsh-infinite_canvas/issues/new';
+    const SUPPORT_QR_URL = '/' + NS + '/api/plugin-asset?rel=' + encodeURIComponent('assets/support/wechat.png');
+    function copyText(text, okMsg) {
+      try {
+        if (navigator.clipboard && navigator.clipboard.writeText) { navigator.clipboard.writeText(text).then(() => toast(okMsg)).catch(() => toast(text)); return; }
+      } catch { /* 降级 */ }
+      toast(text);
+    }
+    function SupportDialog() {
+      const [qrFailed, setQrFailed] = useState(false);
+      const close = () => update((s) => { s.supportOpen = false; });
+      useEffect(() => {
+        const onKey = (e) => { if (e.key === 'Escape') close(); };
+        window.addEventListener('keydown', onKey);
+        return () => window.removeEventListener('keydown', onKey);
+      }, []);
+      return h('div', { className: 'dshic-modal-overlay', onPointerDown: (e) => { if (e.target === e.currentTarget) close(); } },
+        h('div', { className: 'dshic-modal', style: { width: 300, alignItems: 'center', textAlign: 'center' } },
+          h('div', { className: 'dshic-modal-title' }, T('supportTitle')),
+          h('div', { className: 'dshic-modal-warn', style: { marginTop: 6 } }, T('supportNote')),
+          h('div', { style: { marginTop: 10 } },
+            qrFailed
+              ? h('div', { className: 'dshic-hint' }, T('supportQrMissing'))
+              : h('img', {
+                  src: SUPPORT_QR_URL, alt: 'WeChat group QR', draggable: false,
+                  style: { width: 180, height: 180, objectFit: 'contain', borderRadius: 8, background: '#fff', padding: 6 },
+                  onError: () => setQrFailed(true),
+                })),
+          h('div', { className: 'dshic-hint', style: { marginTop: 6 } }, T('supportWechatHint')),
+          h('button', {
+            type: 'button', className: 'dshic-mini is-ghost', style: { marginTop: 10 },
+            onPointerDown: (e) => e.stopPropagation(),
+            onClick: () => { try { window.open(SUPPORT_ISSUES, '_blank'); } catch { copyText(SUPPORT_ISSUES, T('supportCopied')); } },
+          }, T('supportIssues') + ' ↗'),
+          h('div', { className: 'dshic-modal-actions', style: { marginTop: 8, justifyContent: 'center' } },
+            h('button', { type: 'button', className: 'dshic-mini', onPointerDown: (e) => e.stopPropagation(), onClick: close }, T('supportClose')),
+          ),
+        ));
+    }
+
     // ============================================================
     // 侧栏图标
     // ============================================================

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, rmSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
+import { createReadStream, createWriteStream, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, renameSync, rmdirSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -110,6 +110,23 @@ async function ensureBundleEntry(profileDir, pkg) {
 // 配置存在 ~/.dsh/infinite-canvas/config.json：跨重装/重启稳定，绝不放进包目录。
 const CONFIG_PATH = process.env.DSH_IC_CONFIG_PATH || path.join(os.homedir(), '.dsh', 'infinite-canvas', 'config.json');
 
+/** 安全递归删除目录。
+ *  **禁止用 fs.rmSync(recursive)**：本机 Node（24.x / Windows）在**中文路径**上会原生崩溃
+ *  （STATUS_STACK_BUFFER_OVERRUN，直接把宿主进程带走——删一个中文名项目就能打崩 DSH）。
+ *  这里逐层 readdir + unlink/rmdir，走的是不同的系统调用路径，实测稳定。 */
+function rmrf(target) {
+  let st;
+  try { st = lstatSync(target); } catch { return; } // 不存在 = 已删干净
+  if (!st.isDirectory()) {
+    try { unlinkSync(target); } catch { /* 被占用则残留，无碍 */ }
+    return;
+  }
+  let names = [];
+  try { names = readdirSync(target); } catch { return; }
+  for (const name of names) rmrf(path.join(target, name));
+  try { rmdirSync(target); } catch { /* 被占用则残留，无碍 */ }
+}
+
 function readIcConfig() {
   try { return JSON.parse(readFileSync(CONFIG_PATH, 'utf8')) || {}; } catch { return {}; }
 }
@@ -284,9 +301,7 @@ function removeDataRootProject(pid) {
   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 { /* 占用时残留，无碍 */ }
-  }
+  if (entry) rmrf(path.join(root, 'projects', entry.folder));
 }
 /** 一次性迁移/对齐数据目录布局：旧 pid 文件夹 → 项目名文件夹，并镜像全部项目文档。 */
 function dataRootMigrate() {
@@ -321,7 +336,7 @@ function dataRootMigrate() {
             if (!existsSync(to)) { renameSync(from, to); filesMoved++; }
           }
         }
-        rmSync(oldDir, { recursive: true, force: true });
+        rmrf(oldDir);
       } catch { /* 目录被占用：保留旧目录，下轮再试 */ }
     }
     mirrorProjectToDataRoot(id, doc);
@@ -597,6 +612,17 @@ async function projectsPut(args) {
     if (!dead.has(nid)) merged[nid] = n;
     else delete merged[nid];
   }
+  // 竞态防护：客户端推来的分镜表没有 shots，而 Host 上已有 shots → 保留 Host 的 shots
+  // （客户端旧快照推送会覆盖刚生成的分镜，导致"跑下一个时上一个被清空"）
+  for (const [nid, n] of Object.entries(merged)) {
+    if (!n || n.type !== 'storyboard') continue;
+    const hasNew = Array.isArray(n.data && n.data.shots) && n.data.shots.length;
+    if (hasNew) continue;
+    const prevN = (prev.nodes || {})[nid];
+    if (prevN && prevN.type === 'storyboard' && Array.isArray(prevN.data && prevN.data.shots) && prevN.data.shots.length) {
+      n.data = { ...(n.data || {}), shots: prevN.data.shots, warnings: prevN.data.warnings || [] };
+    }
+  }
   const edgeOk = (e) => e && !deadEdges.has(e.id) && merged[e.fromNode] && merged[e.toNode];
   const clientEdges = (doc.edges || []).filter(edgeOk);
   const prevEdges = (prev.edges || []).filter(edgeOk);
@@ -749,11 +775,37 @@ function agentNode(kind, text, x, y, label) {
   if (label) data.label = String(label).slice(0, 40);
   return { id, type: isText ? 'text' : 'script', x, y, w: isText ? 260 : 320, h: 100, data };
 }
-function nextNodePos(doc) {
-  let maxX = 0;
-  let maxY = 40;
-  for (const n of Object.values(doc.nodes || {})) { if ((n.x || 0) + (n.w || 240) > maxX) { maxX = (n.x || 0) + (n.w || 240); maxY = n.y || 40; } }
-  return { x: maxX + 60, y: maxY };
+/** 新节点布局（用户设计）：
+ *  1) 有 connectFrom 源 → 放在源节点右侧同一行（串联节点横向成对）；
+ *  2) 无连线 → 同类型竖向成列（排在该类型最后一个节点下方，新起一行）；
+ *  3) 碰撞检测：候选位置与任何现有节点（含最小间距 28px）相交 → 自动下移到该节点下方，绝不重叠。 */
+function nextNodePos(doc, type, connectFromId) {
+  const GAP_X = 60, GAP_Y = 40, MIN_GAP = 28;
+  const H = (n) => Number(n && n.h) || 160;
+  const W = (n) => Number(n && n.w) || 280;
+  const nodes = Object.values(doc.nodes || {});
+  const EST_H = { storyboard: 420, 'video-gen': 320, 'image-gen': 260, script: 300, finalcut: 300, text: 200 };
+  const estH = EST_H[type] || 220;
+  const estW = type === 'finalcut' ? 300 : 280;
+  let x = 80;
+  let y = 40;
+  if (connectFromId && doc.nodes && doc.nodes[connectFromId]) {
+    const src = doc.nodes[connectFromId];
+    x = (src.x || 0) + W(src) + GAP_X;
+    y = src.y || 40;
+  } else {
+    const same = nodes.filter((n) => n.type === type);
+    if (same.length) {
+      x = Math.min(...same.map((n) => n.x || 0));
+      y = Math.max(...same.map((n) => (n.y || 0) + H(n))) + GAP_Y;
+    }
+  }
+  const hit = (yy) => nodes.find((n) => (n.x || 0) < x + estW + MIN_GAP && (n.x || 0) + W(n) + MIN_GAP > x
+    && (n.y || 0) < yy + estH + MIN_GAP && (n.y || 0) + H(n) + MIN_GAP > yy);
+  let blocker = hit(y);
+  let guard = 0;
+  while (blocker && guard++ < 80) { y = (blocker.y || 0) + H(blocker) + MIN_GAP; blocker = hit(y); }
+  return { x, y };
 }
 // ---------- 内置技能（操作规程 + 创作方法论，约束并提升对话的画布创作）----------
 // canvas-studio＝操作硬约束；canvas-craft＝剧本/分镜/提示词创作方法论
@@ -1042,10 +1094,10 @@ function canvasCreateNode(args) {
   if (!['script', 'text', 'image-gen', 'video-gen', 'storyboard', 'finalcut'].includes(type)) throw new Error('不支持的节点类型: ' + type);
   const label = args && args.name ? String(args.name).slice(0, 40) : '';
   const prompt = String((args && args.prompt) || '');
-  const pos = nextNodePos(doc);
+  const connectFrom = String((args && args.connectFrom) || '');
+  const pos = nextNodePos(doc, type, connectFrom);
   let connected = null;
   let autoConnected = null;
-  const connectFrom = String((args && args.connectFrom) || '');
   let node;
   if (type === 'image-gen') {
     node = agentNode('text', '', pos.x, pos.y, label || '图片生成');
@@ -1099,11 +1151,14 @@ function canvasCreateNode(args) {
   const explicitConnect = Boolean(connectFrom);
   if (connectFrom) {
     if (!doc.nodes[connectFrom]) throw new Error('connectFrom 指向的节点不存在: ' + connectFrom);
-    const edge = connectEdge(doc, connectFrom, node.id, args && args.connectFromPort, args && args.connectToPort);
+    // 分镜表默认连「剧本来源」口（script），而不是输入队列里的第一个口（prev）——场景文本是剧本来源，不是承接来源
+    const srcType = doc.nodes[connectFrom] && doc.nodes[connectFrom].type;
+    const defaultToPort = (type === 'storyboard' && (srcType === 'text' || srcType === 'script')) ? 'script' : undefined;
+    const edge = connectEdge(doc, connectFrom, node.id, args && args.connectFromPort, (args && args.connectToPort) || defaultToPort);
     connected = edge.id;
   } else if (autoConnected && (type === 'storyboard' || type === 'video-gen')) {
     // 未指定连线但上游已存在（分镜表→剧本 / 视频生成→分镜表）→ 默认自动连线（工作流的默认形态，不依赖 Agent 记得）
-    const edge = connectEdge(doc, autoConnected.from, node.id);
+    const edge = connectEdge(doc, autoConnected.from, node.id, undefined, type === 'storyboard' ? 'script' : undefined);
     connected = edge.id;
   }
   doc.updatedAt = Date.now();
@@ -1119,6 +1174,62 @@ function canvasCreateNode(args) {
   return { ok: true, projectId: id, nodeId: node.id, type: node.type, label: (node.data && node.data.label) || '', edgeId: connected || undefined, note: note || undefined };
 }
 
+/** 一键重排：按「行」布局——横向数据流决定列，竖向端口（prev/frame）不参与分列；
+ *  每行 = 一个横向连通分量（如「场N文本 ↔ 场N分镜表」），行内同 y 横向配对，
+ *  行高取行内最高节点、行间保留间距，绝不重叠。 */
+function canvasRelayout(args) {
+  const id = String((args && args.projectId) || '');
+  const doc = readDoc(id);
+  const nodes = Object.values(doc.nodes || {});
+  if (!nodes.length) return { ok: true, projectId: id, moved: 0, rows: 0 };
+  const VERT = new Set(['prev', 'frame']);
+  const byId = new Map(nodes.map((n) => [n.id, n]));
+  const depth = new Map(nodes.map((n) => [n.id, 0]));
+  for (let i = 0; i < 12; i++) {
+    for (const e of (doc.edges || [])) {
+      if (VERT.has(String(e.toPort))) continue;
+      if (!byId.has(e.fromNode) || !byId.has(e.toNode)) continue;
+      const d = (depth.get(e.fromNode) || 0) + 1;
+      if ((depth.get(e.toNode) || 0) < d) depth.set(e.toNode, d);
+    }
+  }
+  const parent = new Map(nodes.map((n) => [n.id, n.id]));
+  const find = (x) => { let y = x; while (parent.get(y) !== y) y = parent.get(y); return y; };
+  for (const e of (doc.edges || [])) {
+    if (VERT.has(String(e.toPort))) continue;
+    if (!byId.has(e.fromNode) || !byId.has(e.toNode)) continue;
+    const a = find(e.fromNode); const b = find(e.toNode);
+    if (a !== b) parent.set(b, a);
+  }
+  const rows = new Map();
+  for (const n of nodes) {
+    const r = find(n.id);
+    if (!rows.has(r)) rows.set(r, []);
+    rows.get(r).push(n);
+  }
+  const rowList = [...rows.values()]
+    .map((ids) => ({ ids, minY: Math.min(...ids.map((n) => Number(n.y) || 0)) }))
+    .sort((a, b) => a.minY - b.minY);
+  const colW = new Map();
+  for (const n of nodes) {
+    const d = depth.get(n.id) || 0;
+    colW.set(d, Math.max(colW.get(d) || 280, Number(n.w) || 280));
+  }
+  const colX = new Map();
+  let cx = 80;
+  for (const d of [...colW.keys()].sort((a, b) => a - b)) { colX.set(d, cx); cx += (colW.get(d) || 280) + 60; }
+  let cy = 40;
+  let moved = 0;
+  for (const row of rowList) {
+    const rowH = Math.max(200, ...row.ids.map((n) => Number(n.h) || 200));
+    for (const n of row.ids) { n.x = colX.get(depth.get(n.id) || 0); n.y = cy; moved++; }
+    cy += rowH + 40;
+  }
+  doc.updatedAt = Date.now();
+  writeIcDoc(id, doc);
+  markDocChanged(id);
+  return { ok: true, projectId: id, moved, rows: rowList.length };
+}
 async function canvasDeleteProject(args) {
   const id = String((args && args.projectId) || '');
   const f = projectFile(id);
@@ -1198,10 +1309,14 @@ function storyboardConsistencyWarnings(bible, shots, extraNames) {
     for (const nm of (sh.characters || [])) check(title, '角色', nm);
     check(title, '场景', sh && sh.scene);
     for (const nm of (sh.props || [])) check(title, '道具', nm);
-    // visual/motion 文本里的 @提及 同样纳入检查（数组外的实体也要登记，杜绝检查漏）
+    // visual/motion 文本里的 @资产名@ 提及同样纳入检查（未登记的提示补充——与客户端 parseMentions 词法一致）
     const text = String((sh && sh.visual) || '') + ' ' + String((sh && sh.motion) || '');
-    for (const m of (text.match(/@[^\s@，。；、！？:：（）"'）)]+/g) || [])) {
-      check(title, '提及', m.slice(1).replace(/[）)]+$/, ''));
+    const seenMention = new Set();
+    for (const m of (text.match(/@([^@\s，。；：、,.;:!?！？()（）[\]【】"'“”<>《》/\\|]{1,64}?)@/g) || [])) {
+      const nm = m.replace(/^@/, '').replace(/@$/, '');
+      if (seenMention.has(nm)) continue;
+      seenMention.add(nm);
+      check(title, '提及', nm);
     }
   }
   return warnings;
@@ -1302,8 +1417,15 @@ function connectEdge(doc, fromId, toId, fromPort, toPort) {
   if (fromId === toId) throw new Error('不能把节点连到自己');
   const outs = (PORT_TABLE[from.type] && PORT_TABLE[from.type].outputs) || [];
   const ins = (PORT_TABLE[to.type] && PORT_TABLE[to.type].inputs) || [];
-  const fp = String(fromPort || outs[0].id);
-  const tp = String(toPort || ins[0].id);
+  const fp = String(fromPort || (outs[0] && outs[0].id) || '');
+  // 目标端口缺省时按语义选择，而不是死板取第一个输入口：
+  // 剧本/文本 → 分镜表 = 剧本来源（script）；分镜表 → 分镜表 = 承接上一镜（prev）；其余取第一个输入口
+  let tp = String(toPort || '').trim();
+  if (!tp) {
+    if (to.type === 'storyboard' && (from.type === 'text' || from.type === 'script')) tp = 'script';
+    else if (to.type === 'storyboard' && from.type === 'storyboard') tp = 'prev';
+    else tp = String((ins[0] && ins[0].id) || '');
+  }
   const outDef = outs.find((p) => p.id === fp);
   const inDef = ins.find((p) => p.id === tp);
   if (!outDef) throw new Error('源节点没有输出端口 ' + fp);
@@ -1924,6 +2046,22 @@ export function apply(ctx) {
             return { ok: true, projectId: r.projectId, nodeId: r.nodeId, text: '🗑 已删除节点 ' + r.nodeId + '。' };
           },
         });
+        reg({
+          name: 'canvas_relayout',
+          description: '一键重排画布节点布局（消除重叠）：按「行」排列——横向数据流决定列（文本→分镜表→视频→资产），竖向关系（衔接 prev / 首帧 frame）不参与分列；每行 = 一个横向连通组（如「场N文本 ↔ 场N分镜表」同行对齐），行高取行内最高节点、行间保留间距。节点重叠、或批量建点后布局混乱时调用。',
+          parameters: {
+            type: 'object',
+            properties: { projectId: { type: 'string', description: '项目 id' } },
+            required: ['projectId'],
+            additionalProperties: false,
+          },
+          output: textOutput,
+          timeoutMs: 30000,
+          async execute(args) {
+            const r = canvasRelayout(args);
+            return { ok: true, projectId: r.projectId, text: '✅ 已重排 ' + r.moved + ' 个节点（' + r.rows + ' 行，无重叠）。' };
+          },
+        });
         reg({
           name: 'canvas_delete_project',
           description: '删除无限画布上的一个项目（含其全部节点）。用户明确要求删除项目、或清理误创建的空项目时使用；删除前请先用 canvas_list_projects 确认 id。',
@@ -2249,6 +2387,32 @@ export function apply(ctx) {
           }
         },
       }),
+      // 插件自带静态资源（帮助与反馈用的微信群二维码等）：白名单 assets/ 目录，拒绝路径穿越
+      ctx.webServer.register({
+        kind: 'exact',
+        path: `/${NAME}/api/plugin-asset`,
+        async handler(req, res) {
+          try {
+            if (req.method !== 'GET') { res.statusCode = 405; res.end('仅接受 GET'); return; }
+            const u = new URL(req.url, 'http://localhost');
+            const rel = String(u.searchParams.get('rel') || '').replace(/\\/g, '/').replace(/^\/+/, '');
+            if (rel.includes('..') || !/^assets\/[\w.\u4e00-\u9fa5/-]+$/.test(rel)) { res.statusCode = 400; res.end('非法路径'); return; }
+            const assetsDir = path.join(HERE, 'assets');
+            const abs = path.resolve(path.join(HERE, rel));
+            if (!abs.startsWith(assetsDir)) { res.statusCode = 400; res.end('非法路径'); return; }
+            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; }
+            res.setHeader('content-type', mimeOf(abs));
+            res.setHeader('cache-control', 'no-cache');
+            res.setHeader('content-length', String(st.size));
+            pipeFile(abs, {}, res);
+          } catch (e) {
+            res.statusCode = 500;
+            res.end(String((e && e.message) || e));
+          }
+        },
+      }),
     ];
     return () => {
       for (const off of registrations) { try { if (off) off(); } catch { /* 忽略 */ } }

package/package.json

@@ -1,56 +1,57 @@
 {
-  "name": "@ninkch/dsh-infinite-canvas",
-  "version": "0.17.13",
-  "description": "Node-based short-drama studio for DeepSeek Harness: script → storyboard → assets → shots → voiced, subtitled final cut on an infinite canvas.",
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "plugin",
-    "infinite-canvas",
-    "storyboard",
-    "short-drama",
-    "ai-video",
-    "image-generation",
-    "video-generation",
-    "seedance",
-    "photocraft",
-    "filmcraft"
-  ],
-  "license": "Apache-2.0",
-  "author": "NINKCH",
-  "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/NINKCH/dsh-infinite_canvas.git"
-  },
-  "type": "module",
-  "icon": "./icon.svg",
-  "exports": {
-    ".": "./index.js",
-    "./client": "./client.js",
-    "./package.json": "./package.json",
-    "./locale/*.json": "./locale/*.json"
-  },
-  "files": [
-    "index.js",
-    "client.js",
-    "icon.svg",
-    "cordis.patch.yml",
-    "locale/*.json",
-    "assets/*/SKILL.md",
-    "README.md",
-    "README.zh-CN.md",
-    "docs/*.md"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "immediately": true
-    }
-  }
-}
+    "name":  "@ninkch/dsh-infinite-canvas",
+    "version":  "0.17.14",
+    "description":  "Node-based short-drama studio for DeepSeek Harness: script → storyboard → assets → shots → voiced, subtitled final cut on an infinite canvas.",
+    "keywords":  [
+                     "dsh",
+                     "deepseek-harness",
+                     "plugin",
+                     "infinite-canvas",
+                     "storyboard",
+                     "short-drama",
+                     "ai-video",
+                     "image-generation",
+                     "video-generation",
+                     "seedance",
+                     "photocraft",
+                     "filmcraft"
+                 ],
+    "license":  "Apache-2.0",
+    "author":  "NINKCH",
+    "publishConfig":  {
+                          "registry":  "https://registry.npmjs.org/"
+                      },
+    "repository":  {
+                       "type":  "git",
+                       "url":  "git+https://github.com/NINKCH/dsh-infinite_canvas.git"
+                   },
+    "type":  "module",
+    "icon":  "./icon.svg",
+    "exports":  {
+                    ".":  "./index.js",
+                    "./client":  "./client.js",
+                    "./package.json":  "./package.json",
+                    "./locale/*.json":  "./locale/*.json"
+                },
+    "files":  [
+                  "index.js",
+                  "client.js",
+                  "icon.svg",
+                  "cordis.patch.yml",
+                  "locale/*.json",
+                  "assets/*/SKILL.md",
+                  "assets/support/*",
+                  "README.md",
+                  "README.zh-CN.md",
+                  "docs/*.md"
+              ],
+    "dsh":  {
+                "bundle":  {
+                               "patch":  "./cordis.patch.yml"
+                           },
+                "client":  {
+                               "platform":  "web",
+                               "immediately":  true
+                           }
+            }
+}