dsh-drawai 0.4.3 → 0.4.4

package/README.md

@@ -24,10 +24,10 @@ DrawAI 在右侧栏提供画布，也向对话中的模型提供读图、改图
 
 ```powershell
 # DeepSeek Harness 桌面版
-dsh plugin --profile desktop add dsh-drawai@0.4.3
+dsh plugin --profile desktop add dsh-drawai@0.4.4
 
 # 使用 dsh web 时，安装到 web profile
-dsh plugin --profile web add dsh-drawai@0.4.3
+dsh plugin --profile web add dsh-drawai@0.4.4
 ```
 
 桌面版和 Web 分别管理插件，只需运行需要的命令。安装完成后**完全重启对应的宿主**，然后在右侧栏找到「DrawAI 画布」。
@@ -44,6 +44,7 @@ dsh plugin --profile desktop update dsh-drawai@latest
 > 0.4.1 将视频渲染依赖放到独立运行环境，安装插件时无需为 esbuild 授权构建脚本。首次使用某些视频功能时需要联网初始化，详见下文。
 > 0.4.2 修了画布工具注册、渲染预览一直 pending、子目录画布打不开、整片风格 demo 缺依赖等一批问题，详见 [发布说明](docs/release.md)。
 > 0.4.3 把内嵌技能拆成「画布」与「视频」两条，做视频不必先被读写画布那句挡住，详见 [发布说明](docs/release.md)。
+> 0.4.4 新增 `diagram_export`，没有画布侧栏的通道也能在宿主侧导成 SVG / PNG；同时修了拐弯连线在预览里糊成黑块，整片风格增至 15 种，详见 [发布说明](docs/release.md)。
 
 ## 第一次使用
 
@@ -63,7 +64,7 @@ dsh plugin --profile desktop update dsh-drawai@latest
 
 画布支持形状、独立文字、表格、SVG 和位图节点，以及直线、折线、曲线、自环和悬空连线。可用多选、图层、顺序、对齐和页面切换整理内容；双击文字或表格编辑。
 
-模型通过 `diagram_read` 读取结构、样式、选区与文件版本，通过 `diagram_apply` 增删或修改节点和边。对于并发编辑，`expectRevision` 可在文件版本不匹配时阻止写入。
+模型通过 `diagram_read` 读取结构、样式、选区与文件版本，通过 `diagram_apply` 增删或修改节点和边。对于并发编辑，`expectRevision` 可在文件版本不匹配时阻止写入。要成品图时用 `diagram_export` 在宿主侧直接导成 SVG / PNG —— 不需要打开画布，QQ、CLI 这类没有侧栏的通道也能用。
 
 例如可以继续对话：
 
@@ -137,7 +138,7 @@ FFmpeg 按显式路径、系统 PATH、缓存及自动下载的顺序查找，
 | 文档 | 内容 |
 |---|---|
 | [原生画布与兼容说明](docs/native-canvas.md) | `.drawai`、媒体目录与 `.drawio` 迁移 |
-| [画布 AI 工具参考](docs/diagram-tools.md) | `diagram_read`、`diagram_apply` 和图片矢量化 |
+| [画布 AI 工具参考](docs/diagram-tools.md) | `diagram_read`、`diagram_apply`、`diagram_export` 和图片矢量化 |
 | [视频节点说明](docs/video-nodes.md) | 视频导入、复刻、后台任务和导出 |
 | [动效视频说明](docs/motion-video.md) | 分镜、工程、素材、预览、渲染与回填 |
 | [声音制作说明](docs/motion-audio.md) | 音轨、音效、旁白和节拍 |

package/lib/client.js

@@ -2201,7 +2201,7 @@ window.__ModuleLoader__.load({
       "source": "https://github.com/Vincentwei1021/mg-styles-15",
       "commit": "49052d80bfaf9fa8412cc9710530e5e95a3b8d8c",
       "license": "MIT",
-      "note": "整片风格库：14 种 MG 视觉语言，每种由一份上游提示词 + 一支上游成片源码 + 一份 Remotion 移植 brief 组成。上游的 04-3d-render（Blender 离线渲的 CGI 质感）没有收录，需要那种质感请走外部渲染回灌。",
+      "note": "整片风格库：15 种 MG 视觉语言，每种由一份上游提示词 + 一支上游成片源码 + 一份 Remotion 移植 brief 组成。上游的 04-3d-render（Blender 离线渲的 CGI 质感）没有收录，需要那种质感请走外部渲染回灌。",
       "promptChars": 1258,
       "styles": [
         {
@@ -2293,7 +2293,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/01-flat-vector/index.html"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "02-line-art",
@@ -2386,7 +2387,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/02-line-art/film.js"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "03-isometric",
@@ -2500,7 +2502,8 @@ window.__ModuleLoader__.load({
               "demos/03-isometric/js/ui.js",
               "demos/03-isometric/js/world.js"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "05-cel-boil",
@@ -2595,7 +2598,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/05-cel-boil/js/scene.js"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "06-collage",
@@ -2689,7 +2693,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/06-collage/index.html"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "07-liquid",
@@ -2796,7 +2801,8 @@ window.__ModuleLoader__.load({
               "demos/07-liquid/js/shaders.js",
               "demos/07-liquid/js/type.js"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "08-morph",
@@ -2892,7 +2898,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/08-morph/index.html"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "09-bauhaus",
@@ -2984,7 +2991,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/09-bauhaus/film.js"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "10-synthwave",
@@ -3076,7 +3084,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/10-synthwave/index.html"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "12-aurora-glass",
@@ -3172,7 +3181,8 @@ window.__ModuleLoader__.load({
               "demos/12-aurora-glass/main.js",
               "demos/12-aurora-glass/shaders.js"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "18-hanazi",
@@ -3263,7 +3273,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/18-hanazi/index.html"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "19-paperclip",
@@ -3353,7 +3364,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/19-paperclip/index.html"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "20-pixel",
@@ -3442,7 +3454,8 @@ window.__ModuleLoader__.load({
             "files": [
               "demos/20-pixel/film.js"
             ]
-          }
+          },
+          "origin": null
         },
         {
           "slug": "22-hud",
@@ -3549,6 +3562,106 @@ window.__ModuleLoader__.load({
               "demos/22-hud/js/util.js",
               "demos/22-hud/js/v5.js"
             ]
+          },
+          "origin": null
+        },
+        {
+          "slug": "23-ink-wash",
+          "name": "水墨写意",
+          "en": "Chinese Ink Wash / Xieyi",
+          "heading": "水墨写意 Chinese Ink Wash / Xieyi",
+          "oneLiner": "宣纸是底、墨只加不铺：一笔一笔写出窗、竹、猫与人，墨分五色，留白是挖出来的，钤印收尾。",
+          "shot": "huashu 17_ink · 1920×1080 · 30 fps · 10 秒 · 单镜写意房间",
+          "tags": [
+            "水墨",
+            "写意",
+            "国风",
+            "宣纸",
+            "毛笔",
+            "墨分五色",
+            "留白",
+            "八大山人",
+            "齐白石",
+            "ink-wash",
+            "xieyi",
+            "chinese-ink"
+          ],
+          "signature": [
+            "纸是整幅唯一的底：#efe6d0 宣纸 + 2600 根纸纤维 + 四角暗角 α.22，没有纯白也没有纯黑背景",
+            "每一笔都是毛笔：4px 等弧长重采样，笔压起收，逐根笔毛按噪声断开出飞白，笔尾比笔头细 30–50%",
+            "墨只用一个色 [16,14,12]，靠 tone 分五色（焦 .9／浓 .8／重 .6／淡 .35／清 .15），全片不出现第二种黑",
+            "晕染是两遍 multiply（外晕 halo·(0.4+grow) + 本体 blur·(1.6−0.6grow)），grow 0→1 是「洇开」不是「淡入」",
+            "留白用 destination-out 从色层里挖掉露出纸色，不是画白色；钤印 1.5→1 倍压下去、multiply 盖上"
+          ],
+          "palette": {
+            "page": "#EFE6D0",
+            "surface": "#F7F1E2",
+            "field": "#6F8AA0",
+            "text": "#14120F",
+            "muted": "#8A7C64",
+            "accent": "#C4281E",
+            "border": "#C9B58C"
+          },
+          "paletteSource": "brief",
+          "colors": [
+            "#EFE6D0",
+            "#F7F1E2",
+            "#14120F",
+            "#C4281E",
+            "#D8553F",
+            "#C47A3C",
+            "#6F8AA0",
+            "#E2AA34"
+          ],
+          "fonts": {
+            "display": "\"Long Cang\",\"Noto Serif SC\",serif",
+            "text": "\"Noto Serif SC\",\"HarmonyOS Sans SC\",serif",
+            "mono": "\"IBM Plex Mono\",monospace"
+          },
+          "rhythm": {
+            "bpm": 60,
+            "fps": 30,
+            "duration": 10,
+            "aspect": "16:9",
+            "cutFrames": 30
+          },
+          "prompt": "prompts/23-ink-wash.md",
+          "demos": [
+            "demos/23-ink-wash/film.js",
+            "demos/23-ink-wash/brush.js"
+          ],
+          "brief": "briefs/23-ink-wash.md",
+          "engine": "canvas2d",
+          "engines": [
+            "canvas2d"
+          ],
+          "engineNote": "纯 Canvas2D：宣纸纤维、笔毛飞白、墨晕两遍 multiply 全在 2D 画布上画，没有 shader，也没有 DOM 或贴图合成。",
+          "engineFiles": [
+            "demos/23-ink-wash/brush.js"
+          ],
+          "motion": {
+            "motionBlur": null,
+            "transitions": "cut",
+            "impact": false,
+            "camera": false,
+            "grain": {
+              "size": null
+            },
+            "secondary": [],
+            "feather": false,
+            "files": [
+              "demos/23-ink-wash/film.js"
+            ]
+          },
+          "origin": {
+            "source": "https://github.com/alchaincyf/huashu-art-motion",
+            "license": "MIT",
+            "files": {
+              "prompts/23-ink-wash.md": "references/风格配方/17_ink.md",
+              "demos/23-ink-wash/film.js": "scripts/engine/scenes/17_ink.js",
+              "demos/23-ink-wash/brush.js": "scripts/engine/lib/brush.js"
+            },
+            "note": "场景为节选（少女段落未收），brush.js 逐字收录；依赖上游全局 U/KIT/PAINT，只作阅读参考。"
           }
         }
       ]
@@ -5191,7 +5304,7 @@ window.__ModuleLoader__.load({
         React.createElement('div', { style: { display: 'flex', flexDirection: 'column', height: '100%' } },
           React.createElement('header', { style: { padding: '20px 24px', borderBottom: '1px solid #8883', display: 'flex', justifyContent: 'space-between', gap: 16 } },
             React.createElement('div', null, React.createElement('strong', { style: { fontSize: 20 } }, props.replaceId ? '换一种整片风格' : '整片风格库'),
-              React.createElement('div', { style: { fontSize: 12, opacity: .65, marginTop: 6 } }, '14 种 MG 视觉语言 · 一种风格管一条片子的色板、字体、节奏与动效语法 · 不是单镜动效')),
+              React.createElement('div', { style: { fontSize: 12, opacity: .65, marginTop: 6 } }, '15 种 MG 视觉语言 · 一种风格管一条片子的色板、字体、节奏与动效语法 · 不是单镜动效')),
             button('关闭', props.onClose)),
           React.createElement('div', { style: { display: 'flex', padding: '16px 24px', gap: 12 } },
             React.createElement('input', { autoFocus: true, 'aria-label': '搜索风格', placeholder: '搜索风格，例如：包豪斯、像素、HUD、拼贴', value: query,
@@ -11697,7 +11810,20 @@ window.__ModuleLoader__.load({
           }
           return props
         }
-        const hitProps = edgeFace({ key: 'edge-hit-' + i, className: 'drawai-edge-hit', d: pathOf(pts, 6, edgeCurved) })
+        // 命中带的观感必须**内联**，不能只写在注入页面的 CSS（.drawai-edge-hit）里：
+        // 同一棵树除了画进 DOM，还要被序列化成独立 SVG 去光栅化（"看一眼"的预览图、
+        // 导出 PNG/SVG），而 SVG-as-image 不继承宿主页面的 CSS —— 缺省 fill 是黑的。
+        // 直线段的填充面积为 0，看不出来；**只要路径拐了弯**，围出来的那块就变成实心多边形
+        // （issue #32：预览里连线糊成一条黑色色带，线本身还在，只是被压在黑块底下）。
+        // stroke 也不能省：命中的是这条 12px 的透明带子，靠 CSS 的话它就又退回 1px 实心黑线。
+        const hitProps = edgeFace({
+          key: 'edge-hit-' + i,
+          className: 'drawai-edge-hit',
+          d: pathOf(pts, 6, edgeCurved),
+          fill: 'none',
+          stroke: 'transparent',
+          strokeWidth: 12,
+        })
         children.push(React.createElement('path', hitProps))
         // 连线的画法全部存在文档的 style 键里：dashed/dashPattern 决定线型、endArrow/startArrow
         // 决定箭头、strokeColor 决定颜色、rounded 决定拐角是否圆滑 —— 与 drawio 一致，缺省即"不画"。

package/lib/index.js

@@ -36,6 +36,7 @@ import { parseCanvas as parseMxfile, applyCanvas as applyDocToMxfile, buildCanva
 import { emptyDocument, normalizeDocument } from './document-core.js'
 import { createDocumentCommands } from './document-commands.js'
 import { createOrthogonalRouter } from './routing/router.js'
+import { buildExportSvg, rasterizeSvgToPng } from './svg-export.js'
 import { getRoutingRuntime } from './routing/node-runtime.js'
 import { motionInput, motionInputKey, assertMotionEditable, applyMotionResult, isMotionNode, motionNodeData, motionSettings, mergeMotionSettings, isAudioNode, audioNodeData, audioNodeSettings, motionReferenceEdges, motionReferenceRole, unlinkedShotCards } from './motion-core.js'
 import { createAudioService } from './audio-service.js'
@@ -4310,6 +4311,171 @@ function sanitizeNewName(raw) {
   return { ok: true, name: withExt }
 }
 
+  /**
+   * `diagram_export`：宿主侧把画布直接导成 SVG / PNG —— **不需要浏览器那一半**。
+   *
+   * 为什么单独开一个工具，而不是给 `diagram_read {render:true}` 加 fallback：
+   * `look` 状态里的 "ready" 含义是"浏览器真渲染过"，它的用途是看压线/重叠/观感；
+   * 把宿主这条简化渲染混进同一个状态，模型会拿它当"看过图了"的依据去下结论。
+   * issue #23 也说得很清楚：不改现有"画布优先"的行为，只补一条没有画布时的交付路径。
+   *
+   * 所以两条路分开：能开画布 → `render:true`；开不了（QQ/CLI）→ 这个工具出成品图。
+   */
+  const exportTool = defineTool({
+    name: 'diagram_export',
+    description:
+      '把画布**在宿主侧**导出成成品图：SVG（矢量、零依赖）或 PNG（`@resvg/resvg-js` 栅格化）——' +
+      '**不需要浏览器、不需要用户打开画布**。QQ / CLI 这类没有右侧栏的通道里，想要"把图发给用户"就用它。' +
+      '与 `diagram_read {render:true}` 的分工：render 由浏览器真渲染、保真度最高（判断压线/重叠/观感靠它）；' +
+      '这个工具是宿主按文档**重画的近似版本**（返回 fidelity="approximate"），用来交付成品图，别拿它判断像素级观感。' +
+      '几何照同一套规则算：形状/圆角/虚线/箭头、标签换行与"文字撑高节点"、正交走线（用文档里存的折点）、' +
+      '连线标签的落点与"字的位置不画线"；但文字量宽是按字符估算的（中文 1em、其余 0.55em），长标签可能差一行；' +
+      '视频/卡片/音频节点只画通用形状（它们的内容在浏览器组件里）。所有降级项都在 warnings 里列出。' +
+      '缺省写到画布旁边（同名，只换扩展名 .svg/.png），可用 out 指定；PNG 的 scale 缺省 2。',
+    parameters: {
+      path: {
+        type: 'string',
+        description: '画布路径（.drawio / .drawai）。不传 = 当前会话聚焦的画布。',
+      },
+      page: {
+        type: 'number',
+        description: '多页画布导哪一页（0 起）。不传 = 用户画布当前页（没上报过则第 1 页）。',
+      },
+      format: {
+        type: 'string',
+        enum: ['svg', 'png'],
+        description:
+          'svg = 矢量（零依赖、可再编辑、放大不糊）；png = 位图（发给用户 / 贴进文档 / 进PPT）。缺省 svg。',
+      },
+      scale: {
+        type: 'number',
+        description: 'PNG 的缩放倍数（缺省 2，1 = 1:1）。SVG 忽略这个参数。',
+      },
+      out: {
+        type: 'string',
+        description:
+          '输出文件路径（必须在工作区内；相对路径按**画布所在目录**解析）。缺省 = 与画布同名、只换扩展名。',
+      },
+      theme: {
+        type: 'string',
+        enum: ['light', 'dark'],
+        description: '配色：light 白纸黑线（缺省，适合交付）；dark 透明底 + 浅色字线。',
+      },
+      background: {
+        type: 'string',
+        description: '背景色：缺省 light 主题白底、dark 主题透明；也可给 #rrggbb 或 "transparent"。',
+      },
+      padding: {
+        type: 'number',
+        description: '内容四周留白（像素，缺省 24）。',
+      },
+    },
+    output: {
+      schema: {
+        type: 'object',
+        additionalProperties: false,
+        properties: {
+          summary: { type: 'string', required: true },
+          details: { type: 'string', required: true },
+          path: { type: 'string', required: true },
+          absolute: { type: 'string' },
+          format: { type: 'string', required: true },
+          width: { type: 'number', required: true },
+          height: { type: 'number', required: true },
+          bytes: { type: 'number' },
+          fidelity: { type: 'string', required: true },
+          nodes: { type: 'number' },
+          edges: { type: 'number' },
+          warnings: { type: 'array', items: { type: 'string' } },
+        },
+      },
+      render: (args, value) => [{ type: 'text', text: value.summary + '\n' + value.details }],
+    },
+    async execute(args, exec) {
+      const sessionId = sessionIdOf(exec)
+      const path =
+        typeof args.path === 'string' && args.path.trim().length > 0 ? args.path : focusedPathFor(sessionId)
+      if (!path) throw new Error('未指定画布路径且当前会话没有聚焦画布，请传入 path 或先打开目标画布')
+      assertCanvasPath(path)
+      // 导出会往工作区写文件：只读会话里不放行（与其它会写盘的工具同一道闸）。
+      if (policyFor(sessionId)?.mode === 'read-only') throw new Error('当前会话为只读，不能导出文件')
+      const pageArg = Number.isFinite(Number(args.page)) ? Number(args.page) : focusedPageFor(sessionId)
+      const loaded = await loadDoc(path, sessionId, pageArg)
+      if (!loaded.exists) throw new Error('画布不存在：' + loaded.absolute)
+      const format = String(args.format || 'svg').toLowerCase() === 'png' ? 'png' : 'svg'
+
+      const built = buildExportSvg(loaded.doc, {
+        theme: args.theme,
+        background: args.background,
+        padding: args.padding,
+      })
+      if (built.stats.nodes === 0 && built.stats.edges === 0) {
+        throw new Error('画布是空的（0 个节点、0 条连线），没有可导出的内容')
+      }
+
+      // 输出位置：缺省落在画布旁边、同名换扩展名 —— 用户找得到，也不污染工作区根目录。
+      const dir = dirnamePath(loaded.absolute)
+      const base = basenamePath(loaded.absolute).replace(/\.(drawio|drawai)$/i, '')
+      const outArg = typeof args.out === 'string' && args.out.trim().length > 0 ? args.out.trim() : ''
+      const target =
+        outArg.length === 0 ? joinPath(dir, base + '.' + format) : isAbsolute(outArg) ? outArg : resolvePath(dir, outArg)
+      // 导出写的是成品图：out 指到画布文件上等于把图覆盖掉（svg 覆盖 .drawio 之后画布就打不开了）。
+      if (/\.(drawio|drawai)$/i.test(target)) {
+        throw new Error('导出不能覆盖画布文件：' + target + '；out 请用 .svg / .png 结尾')
+      }
+      const root = await ctx.fs.resolve(workspaceRootOf(sessionId))
+      if (!ctx.fs.contains(root, target)) throw new Error('导出路径超出工作区：' + target)
+      await mkdir(dirnamePath(target), { recursive: true })
+
+      let width = built.width
+      let height = built.height
+      let bytes = 0
+      if (format === 'svg') {
+        await writeFile(target, built.svg, 'utf8')
+        bytes = Buffer.byteLength(built.svg, 'utf8')
+      } else {
+        const raster = await rasterizeSvgToPng(built.svg, { scale: args.scale })
+        await writeFile(target, raster.png)
+        width = raster.width
+        height = raster.height
+        bytes = raster.png.length
+      }
+
+      const rel = relativePath(root, target)
+      const warnings = built.warnings.slice(0, 20)
+      const warningCount = built.warnings.length
+      return {
+        summary:
+          '已导出 ' + format.toUpperCase() + '：' + rel + '（' + Math.round(width) + '×' + Math.round(height) + '）' +
+          (warningCount > 0
+            ? '，' + warningCount + ' 条降级提示见 details' + (warningCount > warnings.length ? '（只列前 ' + warnings.length + ' 条）' : '')
+            : ''),
+        details: JSON.stringify({
+          path: rel,
+          absolute: target,
+          format: format,
+          width: Math.round(width),
+          height: Math.round(height),
+          bytes: bytes,
+          fidelity: 'approximate',
+          nodes: built.stats.nodes,
+          edges: built.stats.edges,
+          warnings: warnings,
+        }),
+        path: rel,
+        absolute: target,
+        format: format,
+        width: Math.round(width),
+        height: Math.round(height),
+        bytes: bytes,
+        fidelity: 'approximate',
+        nodes: built.stats.nodes,
+        edges: built.stats.edges,
+        warnings: warnings,
+      }
+    },
+  })
+
   /**
    * 「画布聚焦」：记录每个会话当前**打开着**的画布路径。
    *
@@ -6511,7 +6677,7 @@ function sanitizeNewName(raw) {
   })))
   ctx.effect(() => registerHostTool(defineTool({
     name: 'mg_style',
-    description: 'DrawAI 内置的 14 种整片 MG 动效风格（mg-styles 库）：扁平矢量 / 线条动画 / 等轴 2.5D / 逐帧手绘 / 拼贴 / 液态 / 形变 / 包豪斯 / 80s 复古 / 玻璃拟态 / 综艺花字 / 粗描边贴纸科普 / 像素 / 赛博 HUD。上游那支 04-3d-render（C4D/Blender 质感的 CGI 软着陆）没有收录：画面是 Blender 离线渲的，插件里没有同等质感的等价物——用 CSS 滤镜凑出来的 CGI 只会更假，需要那种质感就外部渲好当素材回灌（motion_assets capture / 参考段）。这是「整片风格」（一种片子的整体视觉语言），与 shotcraft_search 的「单镜动效卡」互补、可同时用。action:"list" 列出全部；"search" 按关键词检索；"read" 读某个风格的施工包（可检验判据 + 色板 + 字体 + 节奏 + 效果配方 + 上游提示词 + Remotion 移植 brief）；"source" 读上游成片源码正文；**"frames" 从上游 demo 按 cue 时间点抽参考帧**——动态、转场、冲击、颗粒这些只有看帧才知道，写场景前先取。选中后 diagram_apply 加 shape:"mgstyle" 节点并连到视频节点，motion_project 会把风格写进工程主题与 STYLE.md。',
+    description: 'DrawAI 内置的 15 种整片 MG 动效风格（mg-styles 库）：扁平矢量 / 线条动画 / 等轴 2.5D / 逐帧手绘 / 拼贴 / 液态 / 形变 / 包豪斯 / 80s 复古 / 玻璃拟态 / 综艺花字 / 粗描边贴纸科普 / 像素 / 赛博 HUD / 水墨写意。上游那支 04-3d-render（C4D/Blender 质感的 CGI 软着陆）没有收录：画面是 Blender 离线渲的，插件里没有同等质感的等价物——用 CSS 滤镜凑出来的 CGI 只会更假，需要那种质感就外部渲好当素材回灌（motion_assets capture / 参考段）。这是「整片风格」（一种片子的整体视觉语言），与 shotcraft_search 的「单镜动效卡」互补、可同时用。action:"list" 列出全部；"search" 按关键词检索；"read" 读某个风格的施工包（可检验判据 + 色板 + 字体 + 节奏 + 效果配方 + 上游提示词 + Remotion 移植 brief）；"source" 读上游成片源码正文；**"frames" 从上游 demo 按 cue 时间点抽参考帧**——动态、转场、冲击、颗粒这些只有看帧才知道，写场景前先取。选中后 diagram_apply 加 shape:"mgstyle" 节点并连到视频节点，motion_project 会把风格写进工程主题与 STYLE.md。',
     parameters: { action: { type: 'string', enum: ['list', 'search', 'read', 'source', 'frames'], required: true },
       slug: { type: 'string', description: '风格 slug，如 09-bauhaus' },
       query: { type: 'string', description: 'search：关键词（中英文风格名、用途、视觉特征）' },
@@ -6622,6 +6788,8 @@ function sanitizeNewName(raw) {
     }
   })))
   ctx.effect(() => registerHostTool(readTool))
+  // 宿主侧导出：没有画布侧栏的通道（QQ/CLI）里，成品图只能这么拿。与 render:true 两条路。
+  ctx.effect(() => registerHostTool(exportTool))
   ctx.effect(() => registerHostTool(defineTool({
     name: 'motion_task',
     description: '画布视频节点的任务记录：list 列出任务、status 查某个任务、cancel 取消、focus 在面板定位、remove 移除记录。开始制作请走 motion_project → 改 scene-*.tsx → motion_preview → motion_render；成片回填节点用 motion_render apply。',
@@ -7200,7 +7368,7 @@ function sanitizeNewName(raw) {
   // 帧检：把"片子有没有毛病"变成一张带帧号的清单，而不是靠眼睛。
   ctx.effect(() => registerHostTool(defineTool({
     name: 'motion_qa',
-    description: '成片帧检：不靠眼睛，靠像素和响度。inspect 立刻检一遍（默认检工程里的 .out/film.mp4，也可以指定 file）：帧数对不对、有没有黑场、有没有静止太久、有没有单帧闪烁、有没有空白帧、画面有没有顶到边、音轨有没有削波。report 读上次的结果。每条问题都带帧号和镜头号，能直接回去改对应场景。',
+    description: '成片帧检：不靠眼睛，靠像素和响度。inspect 立刻检一遍（默认检工程里的 .out/film.mp4，也可以指定 file）：帧数对不对、有没有黑场、有没有静止太久、有没有整镜没在动（动能量，抓缓慢推镜式的翻页感）、有没有只剩底色没内容（边密度，抓空白帧抓不到的渐变空画面）、有没有单帧闪烁、有没有空白帧、画面有没有顶到边、音轨有没有削波。report 读上次的结果。每条问题都带帧号和镜头号，能直接回去改对应场景。',
     parameters: {
       action: { type: 'string', enum: ['inspect', 'report'], required: true },
       path: { type: 'string' }, nodeId: { type: 'string' }, page: { type: 'number' },