@pippit-dev/cli 1.0.48 → 1.0.50

package/scripts/canvas-command.js

@@ -674,6 +674,17 @@ function createDefinitions(sdk, runtime, allocateNodeId, queryMediaAsset) {
 }
 
 function ensureNodeRuntimeGlobals() {
+  if (typeof globalThis.DOMException !== "function") {
+    // Node 16 exposes its native DOMException through AbortSignal.reason,
+    // while newer Node versions also expose the constructor as a global.
+    const controller = new AbortController();
+    controller.abort();
+    Object.defineProperty(globalThis, "DOMException", {
+      configurable: true,
+      value: controller.signal.reason.constructor,
+      writable: true,
+    });
+  }
   if (typeof globalThis.structuredClone !== "function") {
     const { deserialize, serialize } = require("v8");
     Object.defineProperty(globalThis, "structuredClone", {

package/skills/xyq-nest-skill/commands/canvas.md

@@ -27,7 +27,8 @@
 | 读取画布和资产 | `get_snapshot`、`get_asset`、`get_permissions` | 取得真实节点/资产 ID，不用名称猜 ID |
 | 创建业务节点 | `create_biz_node` | 支持类型和初始字段用 `--node-kind` 查看；不要手拼业务节点结构 |
 | 节点位置、大小、样式、布局、分组 | `move_nodes`、`resize_node`、`set_node_style`、`align_nodes`、`arrange_nodes`、`group_nodes` 等 | 先查询目标和归属；删除与重排仅限用户请求范围 |
-| 连线和画布配置 | `create_edge`、`reconnect_edge`、`delete_edges`、`set_title`、`set_cover` 等 | 连线两端来自当前画布查询 |
+| 节点引用 | `create_biz_node`、`update_node_data` | 创建时用 `references: ["source-node-id"]`；更新时在 `generation.references` 声明 `{ "sourceNodeId": "source-node-id" }`，SDK 自动同步连线 |
+| 画布配置 | `set_title`、`set_cover` 等 | 参数以当前命令 schema 为准 |
 | 角色与场景资料 | `xyq.role.updateDescription/updateAppearance/updateSourceInfos`、`xyq.scene.updateDescription` | 用完整命令名分别 describe，遵守具体字段 |
 | 图片/视频节点提示词和已有引用 | `xyq.generation.update_prompt` | 先读 `guide prompt-references`；保留其他生成参数，不触发生成 |
 | 3D 导演台对象、摄像机、关键帧、动作 | `xyq.scene3d.query` / `xyq.scene3d.apply` | 先读 `guide scene3d` 和 `guide time` |
@@ -51,3 +52,7 @@ node "CANVAS_ENTRY" canvas command guide
 - 目前没有公开的故事板镜头增删排序、脚本保存、指定镜头生成领域命令；`guide storyboard` 是说明，不是执行能力。底层补丁不能替代这些业务流程。
 - 3D 和多轨命令编辑文档，不提供截图、渲染或最终视频导出。多轨时间为整数微秒，3D 动画时间区分帧和源动画秒；先查字段 schema。
 - 编辑后按 [画布查询、编辑与验证](../workflows/canvas-edit.md) 回读确认；无需使用媒体异步查询来判断画布写入成功。只有实际取得图片/视频文件时才进入媒体交付标准。
+
+图片和视频空节点会按 `initialData.generation.ratio` 预留尺寸，再参与排版。先创建节点、设置生成比例和引用，再布局，避免产物回填后挤占间距。已有媒体优先使用真实尺寸。
+
+替换 `generation` 时必须同时携带完整的 `references` 列表；空数组表示清空引用。仅修改提示词可用 `xyq.generation.update_prompt`。不再使用独立的创建、重连或删除连线命令；批量创建时让引用源节点排在目标节点之前。