codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/15./351/200/273/350/276/221/345/212/237/350/203/275/345/256/236/347/216/260/40./351/200/273/350/276/221/347/273/204/344/273/266/344/275/277/347/224/250/25./350/260/203/347/224/250.md

@@ -0,0 +1,205 @@
+# 调用
+
+<img src="../assets/diaoyong_202408081740_1.png" class="imgStyle" style="" />
+
+## 内置函数
+
+对指定数据的处理，完成特定的操作。例如，数据的转换和格式化、字符串的处理和操作。
+
+<img src="../assets/diaoyong_202408081740_2.png" class="imgStyle" style="" />
+
+**使用说明**：
+
+1.  内置函数组件通常配合其他组件在逻辑中使用，其中无返回值的组件逻辑需要直接在逻辑中使用。
+
+      <img src="../assets/diaoyong_202408081740_3.png" class="imgStyle" style="width:500px;" />
+
+      <img src="../assets/diaoyong_202408081740_4.png" class="imgStyle" style="" />
+
+1.  根据处理的数据类型和使用功能对内置函数进行划分有如下分类：
+
+      具体各内置函数的使用可以参考文档：[内置函数使用说明](../../15.逻辑功能实现/50.内置函数使用/03.内置函数使用说明.md)。
+
+      - [类型转换与格式化函数](../../15.逻辑功能实现/50.内置函数使用/05.类型转换与格式化函数.md)
+      - [字符串函数](../../15.逻辑功能实现/50.内置函数使用/10.字符串函数.md)
+      - [日期与时间函数](../../15.逻辑功能实现/50.内置函数使用/15.日期与时间函数.md)
+      - [列表（List）函数](../../15.逻辑功能实现/50.内置函数使用/20.列表（List）函数.md)
+      - [映射（Map）函数](../../15.逻辑功能实现/50.内置函数使用/25.映射（Map）函数.md)
+      - [枚举函数](../../15.逻辑功能实现/50.内置函数使用/30.枚举函数.md)
+      - [数学函数](../../15.逻辑功能实现/50.内置函数使用/35.数学函数.md)
+      - [其他函数](../../15.逻辑功能实现/50.内置函数使用/40.其他函数.md)
+
+      <img src="../assets/diaoyong_202408081740_5.png" class="imgStyle" style="" />
+
+## 调用逻辑
+
+用于调用服务端逻辑、页面逻辑、系统逻辑。
+
+> 具体服务端逻辑、页面逻辑、系统逻辑的基本概念和使用可以参考文档：[逻辑的分类](../../15.逻辑功能实现/10.逻辑IDE/15.逻辑分类/10.逻辑的分类.md)。
+
+<img src="../assets/diaoyong_202412042105_1.png" class="imgStyle" style="" />
+
+**使用说明**：
+
+1.  逻辑搜索：调用逻辑组件支持通过逻辑名称、描述、依赖库名称、标识等关键信息，搜索来自IDE的逻辑和资产中心、资产市场的依赖库资产逻辑。
+
+点击查看：逻辑搜索操作说明
+
+1.  输入逻辑关键信息如，逻辑名称。
+
+    <img src="../assets/diaoyong_202412042105_2.png" class="imgStyle" style="" />
+
+1.  IDE内的逻辑可直接点击下方展示区域过滤结果进行调用，来自资产中心/资产市场的依赖库逻辑可通过查询结果或搜索输入区域右侧固定按钮“搜资产”切换至资产搜索模块进行查询调用。
+
+    <img src="../assets/diaoyong_202412042105_3.png" class="imgStyle" style="" />
+
+1.  来自资产中心/资产市场的依赖库逻辑，可选择查看依赖库详情后，导入使用。
+
+    <img src="../assets/diaoyong_202412042105_4.png" class="imgStyle" style="" />
+
+    **导入依赖库**：
+
+    方式一：查看依赖库详情后，从依赖库管理页依赖库信息右侧“导入依赖库”按钮。
+
+    <img src="../assets/diaoyong_202412042105_5.png" class="imgStyle" style="" />
+
+    方式二：点击下方搜索结果逻辑名称右侧“导入”，直接导入。
+
+    <img src="../assets/diaoyong_202412042105_6.png" class="imgStyle" style="" />
+
+    **调用从依赖库导入的逻辑**：
+
+    在调用逻辑弹出框的系统逻辑文件下，找到刚导入的依赖库，选择所需逻辑即可。
+
+    <img src="../assets/diaoyong_202412042105_7.png" class="imgStyle" style="" />
+
+1.  **高级设置**：调用逻辑组件，提供高级设置，可用于处理异常信息。仅支持输出参数类型包含Error类型的逻辑以及部分实体逻辑。
+
+    <img src="../assets/diaoyong_202412042105_8.png" class="imgStyle" style="" />
+
+    - **异常处理**：以下仅简述调用逻辑时异常处理的使用姿势，有关IDE其他异常处理相关的详细介绍可参见：[异常处理](../../15.逻辑功能实现/45.逻辑编辑/85.异常处理.md)。
+
+        - 手动处理Error：使用调用逻辑组件时，可在高级设置中开启“手动处理Error”，逻辑的返回结果类型将为Union联合类型（例如实体Product类型或DatabaseDuplicateKeyErro类型），可以使用匹配组件判断逻辑调用结果的数据类型，在不同的分支中做不同的处理。
+
+            <img src="../assets/diaoyong_202412042105_9.png" class="imgStyle" style="" />
+
+        - 异常提示信息：使用调用逻辑组件时，可在高级设置中输入自定义的异常提示信息，默认不填时表示使用原始的Error信息。只有关闭“手动处理Error”时才允许编辑异常提示信息。
+
+            如下图所示，在调用逻辑组件时，手动编辑了异常提示信息，在出现异常后，记录的日志中将输出对应的提示信息。
+
+            <img src="../assets/diaoyong_202412042105_10.png" class="imgStyle" style="" />
+
+2.  **定位至该逻辑**：平台提供快捷的方式定位到该逻辑，当调用逻辑组件所调用逻辑支持查看时，可通过点击逻辑组件右侧的按钮，直接跳转至对应的逻辑页面。
+
+    <img src="../assets/diaoyong_202412042105_11.png" class="imgStyle" style="" />
+
+**补充说明**：
+
+1.  当调用逻辑需要输入参数时，输入参数可以是变量、逻辑、接口、内置函数等有返回值且与所需参数类型一致的表达式。
+
+    <img src="../assets/diaoyong_202412042105_12.png" class="imgStyle" style="" />
+
+1.  调用逻辑组件在前端逻辑和服务端逻辑所调用的逻辑有所不同：
+
+    - 在前端逻辑中使用调用逻辑组件，支持调用服务端逻辑、页面逻辑、系统逻辑。通常是针对单个或少量数据的简单操作，例如查询一条记录、更新一条记录或者更改某页面组件的状态。
+    - 在服务端逻辑中使用调用逻辑组件，支持调用服务端逻辑、系统逻辑。通常是针对大量或复杂数据的操作，例如批量查询、数据处理、数据转换等。
+
+    <img src="../assets/diaoyong_202412042105_13.png" class="imgStyle" style="" />
+
+**示例**：
+
+**前端逻辑**
+
+1.  在前端逻辑中调用页面组件逻辑，如刷新数据表格组件。
+
+    <img src="../assets/diaoyong_202412042105_14.png" class="imgStyle" style="" />
+
+1.  在前端逻辑中调用服务端逻辑，根据UserId获取用户资源。
+
+    <img src="../assets/diaoyong_202412042105_15.png" class="imgStyle" style="" />
+
+**服务端逻辑**
+
+在服务端逻辑中调用[系统逻辑-generateUserId](../../15.逻辑功能实现/10.逻辑IDE/15.逻辑分类/50.组件逻辑.md)，根据Md5算法生成用户唯一标识。
+
+<img src="../assets/diaoyong_202412042105_16.png" class="imgStyle" style="" />
+
+## 调用接口
+
+用于调用第三方接口。与外部系统集成：在平台中，应用程序需要与其他系统进行集成，例如调用短信、地图等服务接口。调用接口组件可以实现应用程序与外部系统的数据交互。常见应用场景参考：[在逻辑中调用第三方接口](../../../80.常见场景案例/50.逻辑场景/50.在逻辑中调用第三方接口.md)。
+
+在使用调用接口组件前，需要已获取第三方API接口文档，并完成第三方API接口导入。具体第三方API接口导入方式可以参考文档：[第三方API导入](../../../40.扩展与集成/20.集成开发方式/30.应用API集成/20.第三方API导入案例.md)。
+
+<img src="../assets/diaoyong_202412042105_17.png" class="imgStyle" style="" />
+
+**使用说明**：
+
+1.  **快捷搜索**：调用接口组件支持快捷搜索。
+
+    **搜索API分组**：选择了接口来源后再选择需要调用的接口，可在搜索框中输入API分组名称或标识进行搜索。
+
+    <img src="../assets/diaoyong_202412042105_18.png" class="imgStyle" style="" />
+
+    **搜索API**：当分组下的API数量比较多时，可点击API分组右侧的搜索框，输入API名称信息进行搜索。
+
+    <img src="../assets/diaoyong_202412042105_19.png" class="imgStyle" style="" />
+
+1.  **高级设置**：调用接口组件，提供高级设置，可用于设置接口鉴权（服务端）或处理异常信息。
+
+    <img src="../assets/diaoyong_202412042105_20.png" class="imgStyle" style="" />
+
+    - **鉴权方式**：
+
+        - 平台默认不设置鉴权。
+        - akSkAuth为平台自带鉴权方式，如需设置该鉴权方式，请参考：[akSkAuth鉴权方式怎么使用](../../../40.扩展与集成/20.集成开发方式/30.应用API集成/30.接口鉴权/20.akSkAuth鉴权方式怎么使用.md)
+        - 支持添加鉴权方式，如需添加鉴权方式，请参考：[如何自定义一种鉴权方式。](../../../40.扩展与集成/20.集成开发方式/30.应用API集成/30.接口鉴权/30.如何自定义一种鉴权方式.md)
+
+        <img src="../assets/diaoyong_202412042105_21.png" class="imgStyle" style="" />
+
+    - **异常处理**：以下仅简述调用接口时异常处理的使用姿势，有关IDE其他异常处理相关的详细介绍可参见：[异常处理](../../15.逻辑功能实现/45.逻辑编辑/85.异常处理.md)。
+
+        - 手动处理Error：使用调用接口组件时，可在高级设置中开启“手动处理Error”，接口的返回结果类型将为Union联合类型（接口Body类型+InterfaceError类型），可以使用匹配组件判断接口调用结果的数据类型，在不同的分支中做不同的处理。
+
+            <img src="../assets/diaoyong_202412042105_22.png" class="imgStyle" style="" />
+
+        - 异常提示信息：使用调用逻辑组件或调用接口组件时，可在高级设置中输入自定义的异常提示信息，默认不填时表示使用原始的Error信息。只有关闭“手动处理Error”时才允许编辑异常提示信息。
+
+            如下图所示，在调用外部接口时，手动编辑了异常提示信息，在出现异常后，记录的日志中将输出对应的提示信息。
+
+            <img src="../assets/diaoyong_202412042105_23.png" class="imgStyle" style="" />
+
+            <img src="../assets/diaoyong_202412042105_24.png" class="imgStyle" style="" />
+
+
+## 连接器
+
+用于连接第三方服务、系统或数据源的工具。通过CodeWave平台的连接器，开发者可以轻松地访问其他系统中的数据和功能，从而实现不同系统之间的数据交换和应用集成。仅支持在服务端逻辑中使用。
+
+> 具体连接器组件的相关详细的概念介绍及使用方式，可参考文档：[什么是连接器](../../../40.扩展与集成/20.集成开发方式/20.连接器集成/10.什么是连接器.md)。
+
+<img src="../assets/diaoyong_202408081740_22.png" class="imgStyle" style="" />
+
+**示例**：
+
+根据输入城市查询天气预报。
+
+<img src="../assets/diaoyong_202408081740_23.png" class="imgStyle" style="width:500px;" />
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">小白</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2024年08月08日</span>
+</div>
+
+<style>
+ .highlight {
+      border: 1px solid #679CF8; /* 添加边框 */
+      border-radius: 6px;
+      background-color: #F8FCFF; /* 添加底色 */
+      padding: 10px 20px 10px 20px;
+      margin-bottom:20px;
+      margin-top:20px;
+      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+  }
+</style>   

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/15./351/200/273/350/276/221/345/212/237/350/203/275/345/256/236/347/216/260/40./351/200/273/350/276/221/347/273/204/344/273/266/344/275/277/347/224/250/35./350/257/255/345/217/245.md

@@ -0,0 +1,254 @@
+# 语句
+
+<img src="../assets/yuju_202408091404_1.png" class="imgStyle" style="" />
+
+## 赋值
+
+将右侧表达式的值赋予左侧变量，用于存储和传递数据。
+
+<img src="../assets/yuju_202501221859_1.png" class="imgStyle" style="" />
+
+**使用说明**：
+
+1.  在平台中，使用赋值组件时，左侧可以选择当前应用中已经定义好的变量或直接为当前逻辑添加变量。右侧的表达式支持数字、文本、变量、常量、内置函数、自定义、接口输出数据等多种有返回值的组件。
+
+    > 注意：赋值组件左右两侧表达式数据类型需保持统一。
+
+    <img src="../assets/yuju_202501221859_2.png" class="imgStyle" style="" />
+
+1.  赋值：对单个变量/属性进行赋值。
+
+    <img src="../assets/yuju_202501221859_3.png" class="imgStyle" style="" />
+
+    <img src="../assets/yuju_202501221859_4.png" class="imgStyle" style="" />
+
+1.  批量赋值：单击赋值组件的下拉框可切换为批量赋值模式。批量赋值模式下，可以对同一变量下的多个属性进行同时赋值。
+
+    <img src="../assets/yuju_202501221859_5.png" class="imgStyle" style="" />
+
+      - 快捷操作：包含多个属性的变量可一键全选或取消全选。
+      - 自动连线：批量赋值支持对当前未连线项按照指定规则触发自动连线，例如当填入初始化数据时，右侧提供的数据在名称和类型上与左侧选择的组件属性相匹配，系统会自动建立连接。
+
+        自动连线规则说明：
+
+        - 按名称匹配：左右两侧属性名称一致时，自动建立连线。
+        - 按类型匹配：左右两侧属性类型一致时，自动建立连线。
+        - 按名称&类型匹配：左右两侧属性名称和类型都一致时，自动建立连线。
+        - 按自上而下匹配：左右两侧属性按照自上而下的顺序，自动建立连线。
+
+        <img src="../assets/yuju_202501221859_6.png" class="imgStyle" style="" />
+
+        当批量赋值变更右侧变量，新变量存在与替换对象一致的属性时，原有连线状态保持不变。
+
+        <img src="../assets/yuju_202501221859_7.gif" class="imgStyle" style="" />
+
+      - 排序：批量赋值支持两种排序规则，包括默认排序（按暗属性默认定义顺序展示）和减少交叉（按连线节点优先排序，以减少交叉），同时允许手动拖拽调整顺序。
+
+          排序规则说明：
+          - 默认顺序：按属性默认定义的顺序展示。
+          - 减少交叉：按连线节点优先排序，以减少交叉。
+
+          <img src="../assets/yuju_202501221859_8.png" class="imgStyle" style="" />
+
+      - 移除：批量赋值支持快捷移除报错连线、所有连线以及未连线项。
+
+        <img src="../assets/yuju_202501221859_9.png" class="imgStyle" style="" />
+
+      - 全部展开/折叠：批量赋值支持全部展开和折叠。在逻辑设计时，批量赋值的属性较多，界面容易杂乱。点击“全部展开”，能查看编辑所有内容；点击“全部折叠”，可收起属性，节省画布空间，让布局更简洁，提升操作效率。
+
+        <img src="../assets/yuju_202501221859_10.png" class="imgStyle" style="" />
+
+## 输出日志
+
+用于记录应用程序运行时的各种调试信息，如变量值、函数返回值、异常信息等，以便开发者进行调试。
+
+> 常见应用场景可参考：[在服务端逻辑中打印日志](../../../80.常见场景案例/50.逻辑场景/60.如何在服务端逻辑中打印日志.md)。
+
+<img src="../assets/yj_202407091621_8.png" class="imgStyle" style="" />
+
+**使用说明**：
+
+1. 输出日志组件支持定义日志级别。平台提供了 INFO、DEBUG、WARN、ERROR 四个级别，默认级别为 INFO：
+   - INFO：表示提示性的信息，例如系统的启动、配置加载等一般性的运行状态。
+   - DEBUG：用于调试目的，包含详细的变量值、函数执行步骤等。
+   - WARN：当出现可能会影响系统正常运行但并非严重错误的情况时使用，比如资源使用接近阈值。
+   - ERROR：表示严重的错误，如系统崩溃、关键功能无法执行等。
+
+   <img src="../assets/yj_202407091621_9.png" class="imgStyle" style="" />
+
+2. 输出日志组件右侧可以直接输入文本或拖入变量、逻辑、接口、内置函数等有返回值的表达式。
+
+   <img src="../assets/yj_202407091621_10.gif" class="imgStyle" style="" />
+
+3. 平台还提供了便捷的日志查看途径，使得开发者能够快速定位和分析问题。
+
+   - 开发环境的前端或服务端逻辑日志，可以直接在 IDE的信息台中进行查看。
+
+      <img src="../assets/yj_202407091621_11.png" class="imgStyle" style="" />
+
+      <img src="../assets/yj_202407091621_12.png" class="imgStyle" style="" />
+
+   - 开发环境和生产环境的前端或服务端逻辑日志，可以在日志详情页中查看。
+
+      日志详情页位于“**应用详情**”-> “**运维管理**”-> “**查看日志**”。
+
+      <img src="../assets/yj_202407091621_13.png" class="imgStyle" style="" />
+
+      这里一般可以看到应用运行中的一些日志，包括部分异常日志、自己打印的逻辑日志等信息。
+
+      <img src="../assets/yj_202407091621_14.png" class="imgStyle" style="" />
+
+   <details>
+       <summary title="点击查看：平台中前端日志与服务端日志的区别">
+        点击查看：平台中前端日志与服务端日志的区别
+       </summary>
+       
+   - 前端日志：内容相对较为直观和贴近用户交互。比如，当用户在网页上进行操作，如点击按钮、填写表单或者加载页面元素时，所产生的相关信息都会被记录在前端日志中。这些日志可以通过输出日志组件展示在IDE 信息台和运维详情页，还**会直接在浏览器控制台里打印**出来。开发者在调试前端页面时，可以实时地在IDE 信息台和浏览器控制台中查看这些日志，快速定位和解决可能出现的界面交互问题。
+
+   - 服务端日志：更多地关注于后台的处理逻辑和数据操作。比如数据库的查询与更新、服务器的请求处理以及与其他服务的交互等。服务端日志同样会在 IDE 信息台和运维详情页中展示，但其**不会在浏览器控制台里打印**。这是因为服务端的运行环境与前端浏览器是相互独立的，服务端的操作对于用户来说是不可见的，其日志主要用于后台的运维和开发人员进行系统的监控、优化以及问题排查。
+
+   在控制台输出：
+
+   <img src="../assets/yj_202407091621_15.png" class="imgStyle" style="" />
+
+   </details>
+
+## 弹出消息
+
+在页面上弹出一条消息提示。弹出消息是前端逻辑特有的组件。
+
+<img src="../assets/yj_202407091621_16.png" class="imgStyle" style="" />
+
+**使用说明**
+
+在某个页面逻辑中调用弹出消息组件，指定消息内容，可以直接输入文本或拖入变量、逻辑、接口、内置函数等有返回值的表达式。平台默认为文本组件，可根据需求自行更改组件内容。发布预览进行相关操作后即可弹出消息。如下图所示:
+
+<img src="../assets/yj_202407091621_17.png" class="imgStyle" style="" />
+
+预览效果：
+
+<img src="../assets/yj_202407091621_18.gif" class="imgStyle" style="" />
+
+## 跳转页面
+
+允许通过点击按钮、链接等组件，实现从一个页面跳转到另一个页面的功能。可手动选择需要跳转的页面名称，也可以动态绑定其他网站或应用程序的链接。跳转页面是前端逻辑特有的组件。
+
+<img src="../assets/yuju_202411281507_1.png" class="imgStyle" style="" />
+
+**使用说明**
+
+1.  页面跳转到
+
+    - 直接选择跳转：直接在下拉选项中选择应用内的页面实现跳转。
+
+      <img src="../assets/yuju_202501201907_1.png" class="imgStyle" style="" />
+
+    - 编辑表达式跳转：点击页面选择右侧按钮，可切换至编辑表达式模式。支持通过动态绑定变量或其他返回内容为链接地址的String类型的表达式，实现应用内部或外部页面跳转。
+  
+      <div class="yellowBlock">
+      
+      注意：这类通过动态绑定表达式跳转的页面，不支持设置“覆盖当前页记录”功能项。有关“覆盖当前页记录”功能项的详细介绍可参见下文：高级设置-覆盖当前页记录。
+
+      </div>
+      
+      <img src="../assets/yuju_202501201907_2.gif" class="imgStyle" style="" />
+
+    - 根路径快捷跳转：切换编辑表达式模式后，在插槽中拖入文本组件，输入“/”。当逻辑运行至此，系统会自动将页面跳转至应用根路径，即应用的默认跳转页。
+
+      <img src="../assets/yuju_202501201907_3.png" class="imgStyle" style="" />
+
+
+2.  高级设置
+
+    - 锚点：跳转页面可以设置锚点，可以帮助应用用户快速定位到指定部分的页面内容。锚点插槽支持放置变量、文本、内置函数、调用逻辑、调用接口等返回值数据类型为String字符串的表达式。常见应用场景可参考：[如何使用锚点组件实现页内跳转](../../../80.常见场景案例/40.组件场景/40.其他组件场景/095.如何使用锚点组件实现页内跳转.md)。
+
+      <img src="../assets/yuju_202411281507_4.png" class="imgStyle" style="" />
+
+    - 打开方式：跳转的页面支持在新窗口、当前窗口、父级窗口以及顶级窗口打开，其中在父级窗口和顶级窗口打开仅适用于[Iframe组件](../../10.页面设计/20.PC端Vue2组件说明（默认）/30.容器/02.Iframe.md)嵌套的情况，若不存在嵌套，则打开方式同当前窗口。平台默认打开方式为当前窗口。
+
+      <img src="../assets/yuju_202411281507_5.png" class="imgStyle" style="" />
+
+      - 新窗口：点击链接或按钮后，在新的浏览器窗口或标签页中打开目标页面；
+      - 当前窗口：点击链接或按钮后，直接在当前页面中打开目标页面，覆盖当前页面；
+      - 父级窗口：点击链接或按钮后，在不关闭原始页面的情况下，在当前页面的父级窗口中打开新的页面；
+      - 顶级窗口：点击链接或按钮后，在不关闭原始页面的情况下，在同一浏览器窗口中打开新的页面；
+
+      不同的打开方式适用于不同的使用场景：
+
+      - 在新窗口打开适用于需要打开一个全新页面的场景，例如打开一个新的文档或查看一个详细的报告；
+      - 当前窗口打开适用于单页面应用或流程式应用，例如，需要在不同的页面中填写表单或进行不同的操作。
+  
+   - 覆盖当前页记录：若勾选此选项，浏览器将不保留当前页面的历史记录。当制品应用用户跳转至其他页面后，在PC、H5（微信小程序除外）环境下，都无法借助回退功能返回跳转前的页面。用于规避用户通过浏览器的返回按钮返回到当前页面，避免小程序页面过多导致的堆栈溢出以及失效信息重复展示等问题，优化页面跳转链路。
+  
+     <div class="yellowBlock">
+
+      注意：通过动态绑定表达式跳转的页面，不支持设置“覆盖当前页记录”功能项。
+
+     </div>
+
+     <img src="../assets/yuju_202411281507_6.png" class="imgStyle" style="" />
+
+     <img src="../assets/yuju_202411281507_7.png" class="imgStyle" style="" />
+
+**其他说明**
+
+跳转页面操作完成后，其后续虚线分支上的逻辑会继续正常执行。
+
+<img src="../assets/yuju_202411281507_8.png" class="imgStyle" style="" />
+
+效果演示：
+
+<img src="../assets/yuju_202411281507_9.gif" class="imgStyle" style="" />
+
+
+## JS 代码块
+
+用于执行 JavaScript 代码。JS 代码块是前端逻辑特有的组件。详情请参见：[JS代码块](../45.逻辑编辑/50.JS代码块.md)。
+
+<img src="../assets/yj_202407091621_24.png" class="imgStyle" style="" />
+
+**使用说明**：
+
+代码块可以通过编写 JavaScript 代码，实现对逻辑的扩展增强。例如，以下代码会延时1秒后执行后续逻辑：
+
+```js
+await new Promise((res) => setTimeout(res, 1000));
+```
+<img src="../assets/yj_202407091621_25.png" class="imgStyle" style="" />
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">小白</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2025年01月20日</span>
+</div>
+                
+<style>
+/* 折叠块加边框、背景色、边距 */
+  details {
+      border: 1px solid #679CF8; /* 添加边框 */
+      border-radius: 6px;
+      background-color: #F8FCFF; /* 添加底色 */
+      padding: 10px 40px 10px 40px;
+      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+  }
+
+  /* 折叠块标题不需要内边距 */
+  details summary {  
+    margin: 0 0 0 -20px;
+    font-weight: bold;
+    color: #679CF8;
+    cursor: pointer;
+  }
+</style>
+<style>
+  .yellowBlock {
+    /* color: #FFFFFF; */
+    border-left-width: 0.5rem;
+    border-left-style: solid;
+    padding: 0.1rem 1.5rem;
+    margin:1rem 0;
+    background-color: #fcf5e1;
+    border-color: #eaaa08;
+  }
+  </style>

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/15./351/200/273/350/276/221/345/212/237/350/203/275/345/256/236/347/216/260/40./351/200/273/350/276/221/347/273/204/344/273/266/344/275/277/347/224/250/37./346/225/260/346/215/256/346/237/245/350/257/242/30./346/225/260/346/215/256/346/237/245/350/257/242.md

@@ -0,0 +1,156 @@
+# 数据查询
+
+数据查询组件是服务端逻辑特有的组件。用于通过可视化的方式查询数据源的数据。
+
+<img src="../assets/shujuchaxun_20260204154638_1.png" class="imgStyle" style="width:300px" />
+
+数据查询组件不可单独在逻辑中使用，需配合其他组件使用。例如，将查询结果赋值给输出变量result，如下图：
+
+<img src="../assets/shujuchaxun_20260204154638_2.png" class="imgStyle" style="" />
+
+## 使用说明
+
+### 查询数据源
+
+支持拖拽实体列表中的实体到此面板进行关联查询。
+
+<img src="../assets/shujuchaxun_20260204154638_3.png" class="imgStyle" style="" />
+
+支持数据源中的连接（join）功能，以将数据源中的两个或多个表组合起来。支持以下的连接关系：
+
+* 内部（inner join）：即内连接，只返回那些在两个表之间具有匹配值的行，即只返回满足条件的行。
+* 左侧（left join）：即左连接，返回左表中所有的行，以及右表中匹配的行，如果右表中没有匹配的行，则右表的部分返回 null。
+* 右侧（right join）：即右连接，与左连接相反，返回右表中所有的行，以及左表中匹配的行，如果左表中没有匹配的行，则左表的部分返回null。
+* 完全外部（full join）：即外连接，无论是否满足连接条件，返回左表和右表中的所有行。
+* 两表的关联关系需要通过关联条件进行串联，关联条件说明如下：
+  * 关联条件（on）：左右表各填入一个类型匹配的属性并定义其关系，支持的关联关系有等于、不等于、小于、小于等于、大于、大于等于。
+  * 支持单击添加。
+
+当仅查询数据源且为数据源为单一实体时，返回值默认数据类型为 List<{entity: Entity}>，Entity 即具体的实体数据结构；支持在右上角勾选“简化”，将返回值数据类型直接简化为 List，便于数据结果的读取和后续业务逻辑处理。
+
+<img src="../assets/shujuchaxun_20260204154638_4.png" class="imgStyle" style="" />
+
+### 筛选条件
+
+支持拖拽原子项、逻辑运算、比较运算、算术运算、数据筛选以及它们的组合来构造查询的筛选条件。数据查询中使用数据筛选、比较运算等组件时，左侧需放置实体中的属性。
+
+> 常见应用场景参考：[如何为列表添加查询条件](../../../../80.常见场景案例/55.数据查询场景/20.如何为列表添加查询条件.md)
+
+<img src="../assets/shujuchaxun_20260204154638_5.png" class="imgStyle" style="" />
+
+#### 起始匹配
+
+在数据查询中用于查找以某个字符串开头的记录。例如，查找一个实体中某姓氏的人员信息。
+
+> 提示：起始匹配组件左侧表达式必须是查询数据源所对应的实体变量，且数据类型必须是String字符串，右侧可以变量或文本等返回值为String字符串类型的表达式。
+
+<img src="../assets/shujuchaxun_20260204154638_6.png" class="imgStyle" style="width:300px" />
+
+如下图，可在实体Product中根据逻辑输入参数filter.name起始匹配实体属性Product.name。
+
+<img src="../assets/shujuchaxun_20260204154638_7.png" class="imgStyle" style="width:300px" />
+
+#### 结尾匹配
+
+在数据查询中用于查找以某个字符串结尾的记录。例如，查找一个实体中所有网址中以“.com”结尾的网址。使用方式与起始匹配组件一致。
+
+> 提示：结尾匹配组件左侧表达式必须是查询数据源所对应的实体变量，且数据类型必须是String字符串，右侧可以变量或文本等返回值为String字符串类型的表达式。
+
+<img src="../assets/shujuchaxun_20260204154638_8.png" class="imgStyle" style="width:300px" />
+
+#### 范围内匹配
+
+在数据查询中用于查找某个字段值在指定范围内的记录。例如，在采购管理系统可以使用范围内匹配查询来展示已选采购商品。
+
+<img src="../assets/shujuchaxun_20260204154638_9.png" class="imgStyle" style="width:300px" />
+
+范围内匹配组件左侧表达式必须是查询数据源所对应的实体变量，右侧表达式必须有返回值，且数据类型为List，其中T须与in左侧表达式数据类型保持一致。
+
+<img src="../assets/shujuchaxun_20260204154638_10.png" class="imgStyle" style="width:300px" />
+
+> 常见应用场景参考：[如何进行范围内匹配查询](../../../../80.常见场景案例/55.数据查询场景/50.如何进行范围内匹配查询.md)。
+
+#### 模糊匹配
+
+在数据查询中用于查找包含特定关键字或关键词的记录。例如，查找一个实体中所有名字中包含“Tom”的记录。使用方式与起始匹配组件一致。
+
+> 提示：模糊匹配组件左侧表达式必须是查询数据源所对应的实体变量，且数据类型必须是String字符串，右侧可以变量或文本等返回值为String字符串类型的表达式。
+
+<img src="../assets/shujuchaxun_20260204154638_11.png" class="imgStyle" style="width:300px" />
+
+> 常见应用场景参考：[如何进行文本模糊查询](../../../../80.常见场景案例/40.组件场景/20.表格场景/063.如何进行文本模糊查询.md)。
+
+#### 空值匹配
+
+在数据查询中用于查找某个字段值为空的记录。例如，查找一个实体中所有地址为空的记录。
+
+> 提示：空值匹配组件表达式必须是查询数据源所对应的实体变量。
+
+<img src="../assets/shujuchaxun_20260204154638_12.png" class="imgStyle" style="width:300px" />
+
+如下图，可在数据中筛选实体属性Product.price为null的数据。
+
+<img src="../assets/shujuchaxun_20260204154638_13.png" class="imgStyle" style="width:300px" />
+
+### 分组聚合
+
+分组聚合功能是指将数据按照一定的规则进行分组，然后对每组数据进行聚合操作，也可单独使用聚合功能。例如求和、求平均值、计数、最大值、最小值等，最终返回聚合结果。
+
+> 常见应用场景参考：[如何使用聚合功能将查询结果进行汇总](../../../../80.常见场景案例/55.数据查询场景/10.如何使用聚合功能将查询结果进行汇总.md)。
+
+<img src="../assets/shujuchaxun_20260204154638_14.png" class="imgStyle" style="" />
+
+平台支持的分组聚合操作包括：
+
+**分组属性（Group by）**
+
+* 支持按一个或多个属性进行分组。通过按照不同的属性进行分组，可以更好地了解数据在不同维度上的情况。例如，可以按照时间、地区、产品类型等属性进行分组，以便更好地了解销售情况。
+* 支持为数据源的列名添加别名即聚合函数名，返回的结果中的数据会优先使用别名，**别名不能为空**。
+
+<img src="../assets/shujuchaxun_20260204154638_15.png" class="imgStyle" style="" />
+
+**聚合属性**
+
+* 支持添加聚合属性，目前支持的聚合属性有：
+  * Count 计数：计算指定列或表中行的数量。
+  * CountD 去重计数：计算指定列或表中不同值的数量，即去重后的数量。
+  * Sum 求和：计算指定列或表中数值类型列的总和。
+  * Avg 平均值：计算指定列或表中数值类型列的平均值。
+  * Max 最大值：找出指定列或表中数值类型列的最大值。
+  * Min 最小值：找出指定列或表中数值类型列的最小值。
+
+>这些聚合函数在SQL中经常被应用于数据分析和报表制作等场景，能够对大量数据进行快速的统计和分析。
+
+* 支持聚合属性过滤（Having）:用于对聚合数据进行进一步筛选，可以是对分组后的数据进行统计，例如统计每个供应商的商品总金额，并只返回商品总金额大于1000的商品数据。支持使用原子项、逻辑运算、比较运算、算术运算、数据筛选以及它们的组合表达式来构造Having的过滤条件。Having支持返回值类型为Boolean布尔值的表达式。
+
+<img src="../assets/shujuchaxun_20260204154638_16.png" class="imgStyle" style="" />
+
+### 排序规则
+
+排序规则指的是在执行查询语句时，按照指定方式对查询结果进行排序。排序功能通常用于处理大量数据，以便更容易地阅读和处理数据。常见的排序方式包括按照数字大小、字母顺序或日期先后等规则对数据进行升序或降序排列。排序规则可根据具体需求进行定制，从而更有效地展示数据或满足特定的查询需求。
+
+<img src="../assets/shujuchaxun_20260204154638_17.png" class="imgStyle" style="" />
+
+平台支持的排序操作包括：
+
+支持添加、删除排序规则，将查询数据按一个或多个属性进行排序。例如当需要对一个在线商店的商品进行排序时，通常可以根据商品的价格、销量、评分等多个因素进行排序，如将商品按照销量进行asc（升序）排列。
+
+<img src="../assets/shujuchaxun_20260204154638_18.png" class="imgStyle" style="width:300px" />
+
+### 调试
+
+平台为可视化查询提供了调试功能。
+
+筛选条件中使用到的变量，会在“调试输入”中出现。填写变量的值，点击开始调试，会显示查询结果。可根据查询结果来判断查询是否正确，并做相应的调整。
+
+<img src="../assets/shujuchaxun_20260204154638_19.png" class="imgStyle" style="" />
+
+<img src="../assets/shujuchaxun_20260204154638_20.png" class="imgStyle" style="" />
+
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">有鲤</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2026年02月04日</span>
+</div>