codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/10./346/211/251/345/261/225/345/274/200/345/217/221/346/226/271/345/274/217/30./346/234/215/345/212/241/347/253/257/346/211/251/345/261/225/345/274/200/345/217/221/10./344/276/235/350/265/226/345/272/223/345/274/200/345/217/221/10./346/234/215/345/212/241/347/253/257/344/276/235/350/265/226/345/272/223/345/274/200/345/217/221/345/277/253/351/200/237/345/205/245/351/227/250.md

@@ -0,0 +1,845 @@
+# 服务端依赖库开发快速入门
+
+## 1.概念介绍
+
+服务端扩展依赖库是指开发者使用Java编写的平台扩展能力库，用于满足定制化需求和功能扩展。
+
+开发者可开发规范自行编写Java代码，定制出平台中的逻辑、数据结构、自定义参数配置，打包成为扩展依赖库并导入到平台IDE中使用。详细概念相关介绍请参见[什么是扩展开发](../../10.什么是扩展开发.md)。
+
+<img src="../assets/kuozhankaifa.png" style="width:800px;" />
+
+## 2.如何开发依赖库
+
+### 2.1 开发流程
+
+开发依赖库的环境准备：maven3.0以上版本、JDK1.8。
+
+服务端扩展依赖库的开发步骤如下：
+
+&emsp;&emsp;一、 创建maven工程。
+
+&emsp;&emsp;二、添加开发依赖库所需的jar包。
+
+&emsp;&emsp;三、添加开发依赖库所需的maven插件。
+
+&emsp;&emsp;四、在pom文件中配置依赖库的基础信息。
+
+&emsp;&emsp;五、依赖库功能开发，编写代码，在方法或类上添加对应的注解。
+
+&emsp;&emsp;六、 生成依赖库zip包。
+
+推荐基于[依赖库脚手架](../10.依赖库开发/13.依赖库脚手架.md)进行开发，生成的工程文件中包含项目基础结构、配置信息、开发所需的依赖包：[https://libraryinitializr-community1.app.codewave.163.com/init](https://libraryinitializr-community1.app.codewave.163.com/init)
+
+<img src="../assets/yilaikujiaoshoujia_20240711_1.png" alt="0" style="border: 1px solid #ccc;width: 900px;" />
+
+### 2.2 开发环境准备
+
+#### 2.2.1 创建maven项目
+
+创建maven项目，确保maven使用3.0以上版本，JDK仅支持1.8。
+
+#### 2.2.2 引入开发所需的依赖包
+
+<a class="downloadButton" href="https://lcap-static-saas-private.nos-eastchina1.126.net/app/nasl-metadata-collector-0.16.1_fut1772777725764_ai504ee5f2-d5f3-4566-8b8e-abb7955c2c8f_conlcap_file_group_0.zip" style="">下载nasl-metadata-collector-0.16.1.zip</a>
+
+此jar包可以放在maven仓库上也可以放在本地工程中进行引用。
+
+- **maven仓库引用**
+  
+  若将jar包上传到maven仓库中，则在工程的pom.xml中配置如下：
+  
+  ```xml
+    <dependencies>
+        <dependency>
+            <artifactId>nasl-metadata-collector</artifactId>
+            <groupId>com.netease.lowcode</groupId>
+            <version>0.16.1</version>
+            <optional>true</optional>
+        </dependency>
+    </dependencies>
+  ```
+- **本地引用**
+  
+  <details>
+      <summary title="点击查看本地引用的pom配置" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+          点击查看本地引用的pom配置
+          </summary>
+
+
+    若项目路径如下：
+    ```
+    .
+    ｜── jar
+    ｜  ｜── nasl-metadata-collector-0.16.1.jar
+    ｜── pom.xml
+    ｜── src
+    ｜  ｜── main
+    ｜      ｜── java
+    ｜          ｜── *
+    ```
+    在对应的pom.xml中配置如下：
+    ```xml
+    <dependencies>
+        <dependency>
+            <artifactId>nasl-metadata-collector</artifactId>
+            <groupId>com.netease.lowcode</groupId>
+            <version>0.16.1</version>
+            <optional>true</optional>
+            <scope>system</scope>
+            <systemPath>${project.basedir}/jar/nasl-metadata-collector-0.16.1.jar</systemPath>
+        </dependency>
+    </dependencies>
+    ```
+
+  </details>
+
+  ![](../assets/fuwuduanyilaiku_0521_1.png)
+
+#### 2.2.3 引入依赖库maven插件
+
+扩展依赖库maven插件，用于编译后进行打包，会生成`library-<libraryName>-<version>.zip`格式的压缩包，该压缩包便是最终上传至平台的依赖库包。压缩包中会包括当前依赖库的描述文件和所有的依赖jar包，在上传到平台时，会自动将所有的依赖项一并进行上传以保证依赖库的可用性。一般情况下使用了本插件后，不需要再使用spring或maven的打包插件。
+
+1. 下载maven插件：
+
+    <a class="downloadButton" href="https://lcap-static-saas-private.nos-eastchina1.126.net/app/nasl-metadata-maven-plugin-1.7.4_fut1770344976409_ai504ee5f2-d5f3-4566-8b8e-abb7955c2c8f_conlcap_file_group_0.zip" style="">下载nasl-metadata-maven-plugin-1.7.1.zip</a>
+
+2. 部署方式可选择本地部署或上传到私服：
+
+    - **本地部署**
+
+      验证是否正确安装maven，查看Maven版本的命令行如下。
+
+      ```shell
+      mvn -version
+      ```
+
+      输出如下内容则表示maven已经安装成功，否则请参考[官方文档](https://maven.apache.org/install.html)进行安装。
+
+      ![](../assets/mavenplugin_1.png)
+
+      将插件的jar文件和pom文件下载到本地并安装到本地仓库。
+
+      ```shell
+      mvn install:install-file -Dfile="nasl-metadata-maven-plugin-1.7.4.jar" -DpomFile="nasl-metadata-maven-plugin-1.7.4.pom"
+      ```
+
+      也可使用下载的文件中提供的安装脚本。
+
+      ![](../assets/mavenchajiananzhuang.png)
+
+      输出如下内容则表示安装成功。
+      ![](../assets/mavenplugin_2.png)
+
+    - **上传到私服**
+
+        将jar文件和pom文件下载到本地并上传到私服，具体操作请参考[官方文档](https://maven.apache.org/guides/mini/guide-3rd-party-jars-remote.html)。
+        也可以通过图形化界面的方式进行上传。
+
+3. 使用方式
+
+    插件安装到本地仓库后，在项目的pom文件中添加该插件依赖，如下所示：
+
+    ```xml
+    <plugin>
+        <groupId>com.netease.lowcode</groupId>
+        <artifactId>nasl-metadata-maven-plugin</artifactId>
+        <version>1.7.4</version>
+        <executions>
+            <execution>
+                <goals>
+                    <goal>archive</goal>
+                </goals>
+            </execution>
+        </executions>
+    </plugin>
+    ```
+
+会在执行打包时，生成一个`library-<libraryName>-<version>.zip`格式压缩文件。
+
+<img src="../assets/mavenplugin_3.png" style="max-width: 350px;" />
+
+<details>
+    <summary title="点击查看maven插件的详细配置说明" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+         点击查看maven插件的详细配置说明
+        </summary>
+
+**配置项**
+
+**jarWithDependencies**
+
+在打包时是否已经将所有的依赖项打包到jar文件中，默认为false。
+如果设置为true的话，则会生成一个空的pom文件使依赖不会进行传递。
+
+```xml
+<plugin>
+   ...
+   <configuration>
+      <jarWithDependencies>false</jarWithDependencies>
+   </configuration>
+   ...
+</plugin>
+```
+
+**includes**
+
+需要打包的依赖项，如果不设置则会打包所有的依赖项。
+```xml
+<plugin>
+   ...
+   <configuration>
+      <includes>
+         <include>
+            <groupId>include-group-id</groupId>
+            <artifactId>include-artifact-id</artifactId>
+         </include>
+      </includes>
+   </configuration>
+   ...
+</plugin>
+```
+
+**includeGroupIds**
+
+需要打包的依赖项的groupId通过`,`进行分割，如果不设置则会打包所有的依赖项。
+```xml
+<plugin>
+   ...
+   <configuration>
+      <includeGroupIds>include-group-id1,include-group-id2</includeGroupIds>
+   </configuration>
+   ...
+</plugin>
+```
+
+**excludes**
+
+不需要打包的依赖项，如果不设置则会打包所有的依赖项。
+```xml
+<plugin>
+   ...
+   <configuration>
+      <excludes>
+         <exclude>
+            <groupId>exclude-group-id</groupId>
+            <artifactId>exclude-artifact-id</artifactId>
+         </exclude>
+      </excludes>
+   </configuration>
+   ...
+</plugin>
+```
+
+**excludeGroupIds**
+
+不需要打包的依赖项的groupId通过`,`进行分割，如果不设置则会打包所有的依赖项。
+```xml
+<plugin>
+   ...
+   <configuration>
+      <excludeGroupIds>exclude-group-id1,exclude-group-id2</excludeGroupIds>
+   </configuration>
+   ...
+</plugin>
+```
+
+**includeSystemScope**
+
+是否需要打包系统依赖项，默认为false。设置为true则会包含`<scope>system</scope>`的依赖项。
+```xml
+<plugin>
+   ...
+   <configuration>
+      <includeSystemScope>false</includeSystemScope>
+   </configuration>
+   ...
+</plugin>
+```
+
+**skip**
+
+是否跳过打包，默认为false。设置为true则会跳过打包。
+```xml
+<plugin>
+   ...
+   <configuration>
+      <skip>false</skip>
+   </configuration>
+   ...
+</plugin>
+```
+
+</details>
+
+### 2.3 配置依赖库的基础信息
+
+依赖库的基础信息（标识、名称、版本号、描述、适用IDE版本）依赖于maven工程中的pom.xml文件，maven工程中必须要存在groupId、artifactId、version字段。对于基础信息的收集会读取工程根路径中的pom.xml，如果为父子工程，则对子工程的打包会读取子工程下的pom.xml文件。
+
+<details>
+    <summary title="点击查看父子工程说明" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+         点击查看父子工程说明
+        </summary>
+
+如果是父子工程，可以只保留artifactId标签，如果当前项目未声明groupId、version则会查看parent标签内的groupId、version。
+
+  <img src="../assets/houduanyilaikukaifa_a19.png" style="max-width:750px;" />
+
+</details>
+
+#### 2.3.1 依赖库适用的IDE最低版本
+
+在pom.xml的`<properties>`标签中添加`<nasl.ide.version>`用于设置IDE最低版本。应用不能引入大于此版本的依赖库，例如应用的IDE版本为2.20，只能引入`<nasl.ide.version>`<=2.20的依赖库。
+`<nasl.ide.version>`标签使用示例：
+
+```xml
+<properties>
+    <maven.compiler.source>8</maven.compiler.source>
+    <maven.compiler.target>8</maven.compiler.target>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    
+    <nasl.ide.version>2.22</nasl.ide.version>
+    
+</properties>
+```
+
+目前支持的最低版本为2.14，即`<nasl.ide.version>`无法设置为小于2.14的值；支持的最高版本为3.8（只是此参数可设置的最高版本，并不限制3.8以上版本的平台IDE使用）。
+如果未配置`<nasl.ide.version>`，默认支持的版本为3.8。
+
+每个版本会包含一些新特性，各版本IDE支持的依赖库特性对照表如下：
+
+- 2.14: 初始版本，支持逻辑与数据结构
+- 2.17: 支持配置参数
+- 2.19: 支持回调
+- 2.21: 支持error
+- 2.22: 支持方法重写
+- 3.1: 支持Spring原生配置及设置别名
+- 3.3: 支持非static方法
+- 3.4: 支持开发连接器（文档可参考[数据连接器开发快速入门](../../../20.集成开发方式/20.连接器集成/30.自定义连接器/30.Java开发连接器/40.数据连接器开发快速入门.md)
+- 3.8: 支持[可变参数](#_2-4-5-可变参数)、[泛型](#_2-4-6-泛型)、[高阶函数](#_2-4-7-高阶函数)
+- 4.3：依赖库逻辑支持出入参为File类型；打包的依赖库文件包中将嵌入源代码包。
+  
+
+编写代码如果使用到了某版本的特性，应注意`<nasl.ide.version>`必须大于等于所用特性的版本，例如，代码中使用了非static方法，即3.3支持的特性，则`<nasl.ide.version>`不应小于3.3。
+
+#### 2.3.2 依赖库标识
+扩展依赖库的标识，由pom.xml文件中的`artifactId`字段决定。如果定义的`artifactId`包含-则会自动转换为_。
+
+  <img src="../assets/houduanyilaikukaifa_a21.png" style="max-width:750px;" />
+
+pom.xml配置示例：
+
+  <img src="../assets/houduanyilaikukaifa_a22.png" style="max-width:750px;" />
+
+#### 2.3.3 依赖库版本
+扩展依赖库的版本获取的是pom.xml文件中的`version`字段。版本号支持格式为x.y.z，如果定义的`version`包含`-SNAPSHOT`则会编译失败。
+
+  <img src="../assets/houduanyilaikukaifa_a23.png" style="max-width:750px;" />
+
+pom.xml配置示例：
+
+  <img src="../assets/houduanyilaikukaifa_a24.png" style="max-width:750px;" />
+
+#### 2.3.4 依赖库标题
+标题通过解析pom.xml中的`name`标签来生成，此标签为可选项，如果未声明`name`标签，则默认为`artifactId`标签对应的值。
+
+  <img src="../assets/houduanyilaikukaifa_a25.png" style="max-width:750px;" />
+
+pom.xml配置示例：
+
+  <img src="../assets/houduanyilaikukaifa_a26.png" style="max-width:750px;" />
+
+#### 2.3.5 依赖库描述
+描述是通过解析pom.xml中的`description`标签来生成，此标签为可选项，如果未声明`description`标签，则默认扩展依赖库描述为空字符串。
+
+  <img src="../assets/houduanyilaikukaifa_a27.png" style="max-width:750px;" />
+
+pom.xml配置示例：
+
+  <img src="../assets/houduanyilaikukaifa_a28.png" style="max-width:750px;" />
+
+### 2.4 依赖库功能开发
+
+
+项目中使用的NASL注解将被引入的jar包识别，将依赖库与平台融合，注解的功能如下：
+
+- 对方法使用`@NaslLogic`注解将方法声明为平台的服务端逻辑
+- 对类使用`@NaslStructure`注解将类声明为平台的数据结构，可作为方法的出入参对象。
+- 对类的成员变量使用`@NaslConfiguration`注解将成员变量声明为平台的参数配置。
+
+详细的配置说明请阅读下文各章节。
+
+<details>
+    <summary title="什么是NASL" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+         什么是NASL
+        </summary>
+网易自研的全栈编程语言NASL（NetEase Application Specific Language，描述CodeWave应用的特定领域语言），统一类型、语法、存储等语言的基本要素，抹平软件开发中前端和后端之间的壁垒。
+
+Java扩展依赖库使用nasl-metadata-collecter该jar包识别项目中使用的NASL注解，自动生成[NASL]语法树，最终输出到描述文件nasl-metadata.json中。描述文件中的[NASL]语法树将依赖库与平台融合，将依赖库与codewave中的制品应用结合，作为一个jar包被引用。
+
+</details>
+
+#### 2.4.1 声明为Logic（逻辑）
+使用注解可以将方法声明为Logic，即平台的逻辑，声明Logic有以下要求：
+
+- 必须为public方法，方法定义为非public则会编译失败
+
+- 静态方法需要在方法上添加`@NaslLogic`注解。非静态方法需要在类上添加Spring中的`@Component`（或`@Service`、`@Configuration`）注解，具体的代码示例请参考[依赖库开发基础案例](../10.依赖库开发/15.依赖库开发基础案例.md)。
+
+- 目前支持的java出入参类型为：Boolean、Integer、Long、Double、String、LocalDate、LocalTime、ZonedDateTime、BigDecimal、List、Map、声明的自定义数据结构，泛型的使用请参考[2.4.6 泛型](#_2-4-6-泛型)。
+
+- 可以根据方法的代码注释来生成逻辑的描述信息，需要代码注释遵守JavaDoc规约，如下图所示。
+
+    <img src="../assets/houduanyilaikukaifa_202409291508_1.png" style="" />
+    <img src="../assets/houduanyilaikukaifa_202409291508_2.png" style="" />
+
+#### 2.4.2 声明为Structure（数据结构）
+
+在类上添加`@NaslStructure`注解可以将类声明为Structure，即平台的数据结构，定义数据结构有以下要求：
+
+- 类中的成员变量必须是public。
+
+- 成员变量需要有对应的get和Set方法。
+
+- 类中如果提供了有参构造函数，则必须显式提供无参构造函数。
+
+- 数据结构必须有成员变量，否则无意义。
+
+- 可以根据class的代码注释来生成数据结构的描述信息，需要代码注释遵守JavaDoc规约，如下图所示。
+
+    <img src="../assets/houduanyilaikukaifa_202409291508_3.png" style="" />
+    <img src="../assets/houduanyilaikukaifa_202409291508_4.png" style="max-width:750px;" />
+
+
+#### 2.4.3 声明为Configuration（自定义参数配置）
+在类的成员变量上添加`@NaslConfiguration`注解可以将类声明为Configuration，即平台的自定义参数配置，可以设置参数在不同环境下的默认值，如果未指定的话则默认为空字符串。
+
+  ![](../assets/houduanyilaikukaifa_a8.png)
+
+  <img src="../assets/houduanyilaikukaifa_4.png" style="max-width:750px;" />
+
+依赖库加入spring环境后，可以使用Spring `@Value`的方式注入成员变量的值，具体代码案例请参考[依赖库开发基础案例](../10.依赖库开发/15.依赖库开发基础案例.md)。nasl-metadata-collecter会在打包的时候给对应的参数名称拼接上`extensions.<libraryName>`的前缀。如下文示例中的resName，最终会读取配置文件中的`extensions.resName`配置项。
+
+可以通过`@NaslConfiguration(systemScope = true)`设置为系统级别参数，系统级别的参数不会添加额外的前缀并且会使当前参数改写机制失效。
+如果想设置配置的别名可以通过`@NaslConfiguration(alias = "foo.bar")`设置，别名会覆盖默认的参数名称。
+
+#### 2.4.4 方法抛出异常
+
+方法抛出的异常可作为逻辑输出结果的数据类型，当前仅支持所有RuntimeException的子类（不包括java.lang.RuntimeException本身，包括自定义的RuntimeException的子类）。在依赖库方法代码中抛出异常后，在服务端逻辑中调用依赖库逻辑时，可以使用匹配组件判断返回结果的数据类型，根据不同的数据类型进行不同的逻辑处理。
+
+具体的使用案例请参考[依赖库开发基础案例](../10.依赖库开发/15.依赖库开发基础案例.md)下的【示例4：方法抛出异常时在平台的使用】。
+
+
+#### 2.4.5 可变参数
+
+开发依赖库逻辑支持使用可变参数，调用逻辑时可灵活添加入参。
+
+> 使用可变参数要求平台版本为3.8及以上版本，nasl-metadata-collector.jar依赖包使用0.10.0及以上版本。
+
+代码示例：
+
+该方法的入参使用可变参数`Integer... numbers`，可接收若干个Integer参数，返回求和结果。
+
+<img src="../assets/houduanyilaikukaifa_0508_2.png" style="border: 1px solid #ccc;width:70%;min-width: 600px;max-width: 900px;" />
+
+在平台IDE中使用该依赖库逻辑时，可点击【添加可变参数】按钮，追加输入参数。
+
+<img src="../assets/houduanyilaikukaifa_0508_3.gif" style="border: 1px solid #ccc;width:70%;min-width: 600px;max-width: 900px;" />
+
+使用可变参数的注意事项：
+
+* 可变参数可以和泛型、高阶函数混合使用。
+* 可变参数的本质是数组，必须作为方法的最后一个参数，且只能出现一次。例如该方法是不合法的：`void method(Integer... nums, String... strings)`
+
+#### 2.4.6 泛型
+
+定义为依赖库逻辑的方法，入参和返回值可以使用泛型，可以更灵活地编写通用代码。
+
+> 使用泛型要求平台版本为3.8及以上版本，nasl-metadata-collector.jar依赖包使用0.10.0及以上版本。
+
+代码示例：
+
+入参中使用泛型类型，返回值也使用该类型。当入参包含Class\<T>时，在平台IDE中调用该逻辑时可选择数据类型表示该Class。
+
+<img src="../assets/houduanyilaikukaifa_0508_4.png" style="border: 1px solid #ccc;width:70%;min-width: 600px;max-width: 900px;" />
+
+<img src="../assets/houduanyilaikukaifa_0508_5.png" style="border: 1px solid #ccc;width:500px;" />
+
+使用泛型的注意事项：
+
+* 泛型可以和高阶函数、可变参数混合使用。
+* List、Map中类型不能是Class\<T>。
+* List 、Map中不能是Function。
+* 参数列表T和Class\<T>不能共存，例如该方法是不合法的：`public static method (T t,Class<T> clazz)`
+* 定义为平台数据结构的Class不允许成员变量使用泛型，例如该class是不合法的：
+  ```java
+    @NaslStructure 
+      public class clazz <T> { 
+        public T data; 
+        public List<T> dataList; 
+        ...... 
+      }
+  ```
+
+#### 2.4.7 高阶函数
+
+依赖库开发支持高阶函数，编写声明为逻辑的方法时，允许使用Function作为入参，在平台IDE中使用该依赖库逻辑时，可将逻辑作为参数传递。
+
+> 使用Function要求平台版本为3.8及以上版本，nasl-metadata-collector.jar依赖包使用0.10.0及以上版本。
+
+目前支持0-8个入参的高阶函数，对应的类为Function0~Function8，类对应的包为`com.netease.cloud.nasl.java.definition.function`，基本使用方式如下图。
+
+<img src="../assets/houduanyilaikukaifa_202409291508_5.png" style="border: 1px solid #ccc;width:70%;min-width: 600px;max-width: 900px;" />
+
+<details>
+    <summary title="点击查看源代码" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+        点击查看源代码
+        </summary>
+
+  ```java
+  package com.test38;
+
+  import java.util.ArrayList;
+  import java.util.Arrays;
+  import java.util.List;
+
+  //请确认nasl-metadata-collector依赖包使用的是0.10.0及以上版本
+  import com.netease.cloud.nasl.java.definition.function.Function1;
+  import com.netease.lowcode.core.annotation.NaslLogic;
+  import com.netease.cloud.nasl.java.definition.function.Function0;
+  import com.netease.cloud.nasl.java.definition.function.Function8;
+
+  public class HigherOrderFunction {
+
+      /**
+      * 目前支持0~8个入参的Function,对应为Function0~Function8
+      *
+      * @param f0  无入参方法
+      * @param f8  8个入参方法
+      * @param <T> 返回值类型
+      */
+      @NaslLogic
+      public static <T> void testHigherOrderFunction1(Function0<String> f0, Function8<String, String, String, String, String, String, String, String, T> f8) {
+
+          //无入参的逻辑，使用get方法调用并获取返回值
+          String f0LogicResult = f0.get();
+
+          //有入参的逻辑，使用apply方法调用并获取返回值
+          T f8LogicResult = f8.apply("参数1", "参数2", "参数3", "参数4", "参数5", "参数6", "参数7", "参数8");
+
+      }
+
+
+      /**
+      * 测试高阶函数：处理List<String>
+      *
+      * @param getStrList         获取List<String>的逻辑
+      * @param stringChangeLogics 逻辑列表，用于处理字符串
+      * @return 修改后的List<String>
+      */
+      @NaslLogic
+      public static List<String> testHigherOrderFunction2(Function0<List<String>> getStrList, Function1<String, String>... stringChangeLogics) {
+
+          List<String> stringList = getStrList.get();
+          List<String> resultStringList = new ArrayList<>(stringList.size());
+
+          for (String str : stringList) {
+              for (Function1<String, String> stringChangeLogic : stringChangeLogics) {
+                  str = stringChangeLogic.apply(str);
+              }
+              resultStringList.add(str);
+          }
+
+          return resultStringList;
+      }
+
+  }
+
+  ```
+
+</details>
+
+
+代码示例：
+
+下图的依赖库方法中，对List\<String>中的每一项调用传入的逻辑进行修改，最终返回修改后的List\<String>。方法第一个入参Function代表获取初始List\<String>的逻辑，其他入参为可变参数，可传入多个处理字符串的逻辑。
+
+<img src="../assets/houduanyilaikukaifa_0508_7.png" style="border: 1px solid #ccc;width:70%;min-width: 600px;max-width: 900px;" />
+
+使用示例：
+
+在平台IDE中使用该依赖库逻辑时，需要将逻辑作为参数传递，入参逻辑的输入输出参数必须与Function的输入输出参数一致，鼠标悬停在“ⓘ”可预览所需的逻辑出入参类型。
+
+如下图的`(String)→String`代表该参数需要传入一个输入参数为String且输出参数为String的逻辑。
+
+<img src="../assets/houduanyilaikukaifa_0508_8.png" style="border: 1px solid #ccc;width:70%;min-width: 600px;max-width: 900px;" />
+
+选择逻辑作为入参时可快捷创建逻辑或子逻辑。
+
+<div class="A1" style="
+text-color: #FFFFFF;
+background-color: #fcf5e1;
+        border-color: #eaaa08;
+        border-left-width: 0.5rem;
+        border-left-style: solid;
+        padding: 0.1rem 1.5rem;
+        margin:1rem 0;">
+    <p>
+    <b>什么是子逻辑：</b>
+
+子逻辑是定义在逻辑内部的逻辑，需要将逻辑作为入参时可快捷创建子逻辑并进行修改。子逻辑可以使用父逻辑中的局部变量。
+
+<img src="../assets/houduanyilaikukaifa_0508_9.png" style="border: 1px solid #ccc;width:70%;min-width: 600px;max-width: 900px;" />
+    </p>
+</div>
+
+使用高阶函数的注意事项：
+
+* 在平台IDE中选择逻辑作为参数时，会按照输入输出参数进行过滤，仅展示与Function输入输出参数相同的逻辑。
+* 高阶函数可以和可变参数、泛型混合使用。
+* 不支持List\<void>、Map\<void,void>、Function\<void,?> ,支持Function的返回类型为void
+* Function支持嵌套
+* Function的返回值不能是Function
+
+#### 2.4.8 输出日志
+
+依赖库可引入slf4j进行日志打印，日志便会打印到制品应用中。
+
+1. 依赖库pom文件中引入slf4j依赖
+
+    ```
+    <dependency>
+        <groupId>org.slf4j</groupId>
+        <artifactId>slf4j-api</artifactId>
+        <version>1.7.30</version>
+        <scope>provided</scope>
+    </dependency>
+    ```
+
+2. 代码示例
+
+    ```java
+    //getLogger参数统一使用LCAP_EXTENSION_LOGGER
+    private static final Logger LCAP_LOGGER = LoggerFactory.getLogger("LCAP_EXTENSION_LOGGER");
+    ```
+
+    <img src="../assets/houduanyilaikukaifa_0527_1.png" style="" />
+
+3. 查看日志
+   
+   查看依赖库输出的日志，需进入**应用详情界面>运维管理>查看日志**，可参考：[查看制品应用日志-服务端日志](../../../../94.常见问题解答/20.应用开发/60.日志/10.查看制品应用日志.md)。
+
+<div class="yellowBlock">
+
+输出日志注意事项：
+- 依赖库中只引入slf4j，不引入日志的具体实现框架，目前制品使用的具体实现框架是log4j2
+- 依赖库不可以配置日志的配置文件，使用制品中的配置log4j2-spring.xml
+- 平台3.7及以下版本，依赖库中打印的日志在**运维管理>查看日志**下不可见，需要收集依赖库日志请确保应用为3.8及以上版本。
+- debug级别日志默认不会被平台收集（在**运维管理>查看日志**下不可见），如需要收集debug级别日志，需要在**应用配置>系统参数配置**中开启debug日志打印。
+
+    <details>
+    <summary title="点击查看如何开启debug日志打印" style="">
+            点击查看如何开启debug日志打印
+    </summary>
+
+    1. 点击IDE上方“更多”按钮，选择“应用配置”。
+
+        <img src="../assets/ruhechakanSQLzhixingrizhi_202407081530_1.png" class="imgStyle" style="width: 450px;" />
+
+    2. 在应用配置窗口中选择“系统参数配置”，点击添加系统参数。
+
+        <img src="../assets/ruhechakanSQLzhixingrizhi_202407081530_2.png" class="imgStyle" style="" />
+
+    3. 要添加的系统参数选择“debug日志打印”。
+
+        <img src="../assets/ruhechakanSQLzhixingrizhi_202407081530_3.png" class="imgStyle" style="" />
+
+    4. 添加该参数后，将开发环境取值修改为true即可（生产环境的该配置无效）。
+
+        <img src="../assets/ruhechakanSQLzhixingrizhi_202407081530_4.png" class="imgStyle" style="" />
+    
+    </details>
+
+
+</div>
+
+### 2.5 依赖库打包
+
+代码编写完毕后，使用maven的clean package，将在项目的target文件夹下生成依赖库zip压缩包。
+
+<img src="../assets/houduanyilaikukaifa_5.png" style="max-width:500px;" />
+
+<div class="yellowBlock">
+
+注意：打包时必须使用`clean package`，否则插件会报错。
+
+```
+[ERROR] If you want to generate a library zip file, please execute the clean compile phase at the same time, such as 'mvn clean package', or you can skip generating library zip file.
+// 如果希望生成一个依赖库压缩文件，请同时执行clean编译，例如‘mvn clean package’，或者可以选择跳过生成依赖库压缩文件。
+```
+
+</div>
+
+## 3. demo下载
+
+依赖库demo的github地址：[https://github.com/netease-lcap/libraryDemo](https://github.com/netease-lcap/libraryDemo)
+
+## 4.如何使用依赖库
+
+### 4.1 上传依赖库到资产中心
+
+依赖库需上传到资产中心后才可使用，在平台的**资产中心**-**依赖库**页面上传该压缩包。
+
+<img src="../assets/houduanyilaikukaifa_6.png" style="max-width:950px;" />
+
+### 4.2 在IDE中导入依赖库
+
+1. 依赖库成功上传至资产中心后，点击IDE右上方“更多”按钮，点击弹出框中的“依赖库管理”。
+
+    <img src="../assets/fuwuduankuozhan_a3.png" style="border: 1px solid #ccc;" />
+
+2. 在弹窗中切换到“资产中心”分类下，选择所需的依赖库，点击“导入依赖库”即可。
+
+    > “已导入依赖库”分类下展示当前应用已引入的依赖库，可选择移除。
+
+    ![](../assets/fuwuduanyilaiku_0625_1.png)
+
+3. 如果已经导入过依赖库，希望替换版本，导入时会提示是否覆盖已导入的依赖库，选择确定即可。
+
+    ![](../assets/fuwuduanyilaiku_0625_2.png)
+
+### 4.3 服务端逻辑的使用
+
+导入依赖库后在服务端逻辑下可查看并调用新增的依赖库逻辑。
+
+<img src="../assets/houduanyilaikukaifa_8_v1.png" style="max-width: 450px;border: 1px solid #ccc;" />
+
+### 4.4 依赖库参数配置的使用
+
+1. 点击IDE右上方的**更多 > 应用配置**。
+
+    <img src="../assets/houduanyilaikukaifa_202502111617_1.png" style="border: 1px solid #ccc;" />
+
+2. “依赖库配置”下选择对应的依赖库，可以查看从依赖库引入的参数配置，可修改开发环境取值和生产环境取值，但无法删除，移除相应的依赖库后参数配置才会移除。
+
+    ![](../assets/houduanyilaikukaifa_202502111617_2.png)
+
+## 5.如何删除依赖库
+
+可在资产中心-依赖库，删除库或者选择当前依赖库的某一个版本进行删除。依赖库只有一个版本时，直接删除库即可。
+
+<img src="../assets/shanchuyilaiku.png" style="border: 1px solid #ccc;" />
+
+## 6.注意事项
+
+
+- java版本只支持1.8。
+  
+- 需要CodeWave平台版本大于等于2.14。
+  
+- 支持方法的入参和返回值为void，也支持方法签名使用throws异常，但是不允许返回类型为 void 的函数抛异常，例如该方法是不合法的：`public void f() throws Exception { ... }`
+  
+- Class文件必须定义在命名的包内。
+  
+- 版本号支持格式为x.y.z，并且各个版本号区间为0-99。
+  
+- 依赖库的源代码发生变动后，应注意必须升级pom文件中的版本号后再打包上传至资产中心，而不是删除资产中心已有的依赖库再重新上传修改后的原版本号依赖库。
+  
+- 请勿使用nasl-metadata-collector包中的工具类，插件nasl-metadata-maven-plugin在打包时会将nasl-metadata-collector包删掉。
+
+- 本地编译打包时，使用`mvn clean package`打包，即package阶段需要识别到有clean，否则插件会报错。
+  
+## 7.数据类型的对应关系
+
+编写Java依赖库时，依赖库逻辑的出入参数据类型需要与CodeWave平台中支持的数据类型相对应，例如，希望依赖库逻辑入参类型为CodeWave平台中的Boolean类型时，Java代码中的参数类型需要为java.lang.Boolean。
+
+完整的对应关系如下表：
+
+| 依赖库方法出入参Java类型                | 平台类型     |
+| :----------------------- | :------- |
+| void        | 无  |
+| java.lang.Boolean        | Boolean  |
+| java.lang.Integer        | Integer  |
+| java.lang.Long           | Integer  |
+| java.lang.Double         | Decimal  |
+| java.math.BigDecimal     | Decimal  |
+| java.lang.String         | String   |
+| java.time.LocalDate      | Date     |
+| java.time.LocalTime      | Time     |
+| java.time.ZonedDateTime  | DateTime |
+| java.util.List           | List     |
+| java.util.map            | Map      |
+| java.io.File            | File      |
+| 带有@NaslStructure注解的Class | 数据结构     |
+
+- Java的Long和Integer统一识别为平台的的Integer类型，Java的Double和BigDecimal统一识别为平台的的Decimal类型。
+
+- Java中的基础数据类型必须使用对应的包装类，例如int类型需要使用Integer类型。列表中未包含的Java基础类型可以使用其他类型替代，例如使用Double替代Float。
+
+- 使用`@NaslStructure`注解的Class将被定义为平台的数据结构，Class属性的支持数据类型也限定在以上范围。
+
+- 泛型的使用方式请参考上文[2.4.6泛型](#_2-4-6-泛型)。
+
+## 8. 前后端依赖库合并打包
+
+在一组业务需求中可能同时包含了前端依赖库和后端依赖库，可以将两个依赖库进行合并，重新打包成一个包含两者的新依赖库。文档请参考：[前后端依赖库合并打包](../10.依赖库开发/../../40.前后端依赖库合并打包.md)。
+
+<img src="../assets/qianhouduanyilaikuhebingkaifa_202503191559_2.png" style="width:700px;" />
+
+<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年11月24日</span>
+</div>
+
+
+<style>
+  .downloadButton {
+      /* 设置按钮的基本外观 */
+      display: inline-block;
+      padding: 10px 20px;
+      /* font-size: 16px; */
+      text-align: center;
+      text-decoration: none;
+      color: #ffffff !important; /* 文本颜色 */
+      background-color: #93CDFF; /* 背景颜色 */
+      cursor: pointer; /* 改变鼠标指针形状 */
+      border-radius:6px;
+      /* 添加一些过渡效果，使按钮在鼠标悬停时更平滑 */
+      transition: background-color 0.5s ease;
+      border: 1px solid #42A7FF;
+  }
+
+  /* 鼠标悬停时改变背景色 */
+  .downloadButton:hover {
+      background-color: #42A7FF;
+      color: #ffffff !important; /* 文本颜色 */
+  }
+</style>
+
+<style>
+
+  /* 折叠块加边框、背景色、边距 */
+  details {
+      border: 1px solid #679CF8; /* 添加边框 */
+      border-radius: 6px;
+      background-color: #F8FCFF; /* 添加底色 */
+      padding: 10px 10px 10px 40px;
+      /* 可选：设置默认背景色，如果需要的话 */
+  }
+
+  /* 折叠块标题不需要内边距 */
+  details summary {  
+    margin: 0 0 0 -20px;
+  }
+
+  .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>