✨ 增加逻辑节点：SEARCH_CONTENT，搜索全部匹配的节点内容

Author: Littlefean

app/src/core/service/dataGenerateService/autoComputeEngine/functions/nodeLogic.tsx

@@ -581,6 +581,42 @@ export namespace NodeLogic {
     return [`替换了${replacedCount}处内容`];
   }
 
+  /**
+   * 搜索内容
+   * @param fatherNodes 被搜索字符串，是否大小写敏感
+   * @param _childNodes
+   */
+  export function searchContent(
+    fatherNodes: ConnectableEntity[],
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    _childNodes: ConnectableEntity[],
+  ): string[] {
+    if (fatherNodes.length !== 2) {
+      return ["输入数量不正确，第一个参数为被搜索字符串，第二个是否大小写敏感（0/1）"];
+    }
+    if (fatherNodes[0] instanceof TextNode && fatherNodes[1] instanceof TextNode) {
+      const searchString = fatherNodes[0].text;
+      const isCaseSensitive = parseInt(fatherNodes[1].text);
+      if (!(isCaseSensitive === 0 || isCaseSensitive === 1)) {
+        return ["第二个参数只能输入 0/1"];
+      }
+      const searchResultNodes: TextNode[] = [];
+      for (const node of StageManager.getTextNodes()) {
+        if (isCaseSensitive) {
+          if (node.text.includes(searchString)) {
+            searchResultNodes.push(node);
+          }
+        } else {
+          if (node.text.toLowerCase().includes(searchString.toLowerCase())) {
+            searchResultNodes.push(node);
+          }
+        }
+      }
+      return searchResultNodes.map((node) => node.uuid);
+    }
+    return ["输入的节点格式必须都是TextNode"];
+  }
+
   export function deletePenStrokeByColor(
     fatherNodes: ConnectableEntity[],
     // eslint-disable-next-line @typescript-eslint/no-unused-vars

app/src/core/service/dataGenerateService/autoComputeEngine/logicNodeNameEnum.tsx

@@ -95,6 +95,7 @@ export enum LogicNodeNameEnum {
   CREATE_TEXT_NODE_ON_LOCATION = "#CREATE_TEXT_NODE_ON_LOCATION#",
   IS_HAVE_ENTITY_ON_LOCATION = "#IS_HAVE_ENTITY_ON_LOCATION#",
   REPLACE_GLOBAL_CONTENT = "#REPLACE_GLOBAL_CONTENT#",
+  SEARCH_CONTENT = "#SEARCH_CONTENT#",
   DELETE_PEN_STROKE_BY_COLOR = "#DELETE_PEN_STROKE_BY_COLOR#",
 }
 export const LogicNodeNameToRenderNameMap: {
@@ -179,6 +180,7 @@ export const LogicNodeNameToRenderNameMap: {
   [LogicNodeNameEnum.CREATE_TEXT_NODE_ON_LOCATION]: "在指定位置创建节点",
   [LogicNodeNameEnum.IS_HAVE_ENTITY_ON_LOCATION]: "判断某位置是否存在实体",
   [LogicNodeNameEnum.REPLACE_GLOBAL_CONTENT]: "全局替换内容",
+  [LogicNodeNameEnum.SEARCH_CONTENT]: "搜索内容",
   [LogicNodeNameEnum.DELETE_PEN_STROKE_BY_COLOR]: "删除画笔颜色的笔画",
 
   [LogicNodeNameEnum.SET_VAR]: "设置变量",
@@ -269,6 +271,7 @@ export const LogicNodeNameToArgsTipsMap: {
   [LogicNodeNameEnum.CREATE_TEXT_NODE_ON_LOCATION]: "a0: x, a1: y, a2: text, a3: 0/1",
   [LogicNodeNameEnum.IS_HAVE_ENTITY_ON_LOCATION]: "a0: x, a1: y",
   [LogicNodeNameEnum.REPLACE_GLOBAL_CONTENT]: "a0: 被替换内容, a1: 新内容",
+  [LogicNodeNameEnum.SEARCH_CONTENT]: "a0: 被搜索内容, a1: 是否大小写敏感0/1",
   [LogicNodeNameEnum.DELETE_PEN_STROKE_BY_COLOR]: "a0: red, a1: green, a2: blue, a3: alpha",
 
   [LogicNodeNameEnum.SET_VAR]: "a0: name, a1: value",

app/src/core/service/dataGenerateService/autoComputeEngine/mainTick.tsx

@@ -153,6 +153,7 @@ const MapOtherFunction: OtherFunctionMap = {
   [LogicNodeNameEnum.CREATE_TEXT_NODE_ON_LOCATION]: NodeLogic.createTextNodeOnLocation,
   [LogicNodeNameEnum.IS_HAVE_ENTITY_ON_LOCATION]: NodeLogic.isHaveEntityOnLocation,
   [LogicNodeNameEnum.REPLACE_GLOBAL_CONTENT]: NodeLogic.replaceGlobalContent,
+  [LogicNodeNameEnum.SEARCH_CONTENT]: NodeLogic.searchContent,
   [LogicNodeNameEnum.DELETE_PEN_STROKE_BY_COLOR]: NodeLogic.deletePenStrokeByColor,
 };
 

app/src/core/service/dataManageService/copyEngine/pasteImage.tsx

@@ -7,6 +7,12 @@ import { StageManager } from "../../../stage/stageManager/StageManager";
 import { ImageNode } from "../../../stage/stageObject/entity/ImageNode";
 import { v4 as uuidv4 } from "uuid";
 
+/**
+ * 把粘贴板中的PNG图片读取并写入到磁盘和舞台上
+ * @param item
+ * @param mouseLocation
+ * @returns
+ */
 export async function copyEnginePasteImage(item: ClipboardItem, mouseLocation: Vector) {
   // 图片在草稿情况下不能粘贴
   if (Stage.path.isDraft()) {

docs/src/zh_CN/guide/features/compute-engine.md

@@ -142,6 +142,7 @@
 - `#CREATE_TEXT_NODE_ON_LOCATION#`: 在特定位置创建一个文本节点，第一个输入x值，第二个输入y值，第三个输入节点文本内容，第四个输入0/1代表是否创建（1代表创建，0代表不创建，可以在上游增加一个瞬时脉冲电路来防止按下x后创建很多重叠的重复节点）。
 - `#IS_HAVE_ENTITY_ON_LOCATION#`: 检测某位置是否存在实体，输入一个x值和y值，输出一个0/1的节点，如果在该位置有实体，则输出值为1
 - `#REPLACE_GLOBAL_CONTENT#`: 输入两个节点，第一个是原字符串，第二个是新字符串，运行后将舞台上全部的文本节点中的文字中，含有原字符串的部分替换为新字符串。
+- `#SEARCH_CONTENT#`: 输入两个节点，第一个是搜索的关键字，第二个是数字0或1，0代表不开启大小写敏感，1代表开启大小写敏感，运行后将所有匹配的节点的UUID输出。注意如果更换了关键字，需要手动删除所有子节点。否则可能造成干扰。
 - `#DELETE_PEN_STROKE_BY_COLOR#`: 输入 r,g,b,a 四个值，运行后删除舞台上所有颜色相同的涂鸦笔画。主要用于讲课、录制视频教程的场景使用。注：在没有自动上色时，且为黑色主题下，涂鸦颜色看上去是略微暗一点点的白色，和节点的边框一个颜色，但实际上在数据层面，涂鸦颜色为 (0,0,0,0)。这是一个特殊规定，当涂鸦颜色为 (0,0,0,0) 时，渲染的颜色会自动跟随当前颜色主题下的（实体边框颜色）。这样就能够在切换成白色或者其他主题颜色的时候，自动更改这些涂鸦的颜色了。
 - `#GET_NODE_UUID#`: 输入一个节点，输出该节点的UUID。
 - `#SET_LOCATION_BY_UUID#`: 输入 UUID，x，y 三个值，运行后，将指定 UUID 的节点的移动到 (x,y)位置上。