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/40./346/234/215/345/212/241/347/253/257/344/276/235/350/265/226/345/272/223FAQ.md

@@ -0,0 +1,220 @@
+# **服务端依赖库常见问题与故障排查**
+
+## 依赖库怎样打印日志
+
+依赖库可引入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)。
+
+输出日志注意事项：
+
+- 依赖库中只引入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>
+
+## **如果依赖库使用了额外的依赖项，怎么进行引入**
+
+### **平台版本低于3.0版本**
+
+添加maven-assembly-plugin，在进行打包时会将额外的依赖项都打入到当前依赖库jar包中，这样在上传jar包时只需要将此jar包进行上传。为了防止依赖传递，项目的真实pom文件不需要进行上传，通过nexus自动生成即可（或上传一个空dependency的pom文件，只声明GAV）。
+
+```
+<plugin>
+    <groupId>org.apache.maven.plugins</groupId>
+    <artifactId>maven-assembly-plugin</artifactId>
+    <version>3.3.0</version>
+    <configuration>
+        <descriptorRefs>
+            <descriptorRef>jar-with-dependencies</descriptorRef>
+        </descriptorRefs>
+        <appendAssemblyId>false</appendAssemblyId>
+    </configuration>
+    <executions>
+        <execution>
+            <id>make-assembly</id>
+            <phase>package</phase>
+            <goals>
+                <goal>single</goal>
+            </goals>
+        </execution>
+    </executions>
+</plugin>
+```
+
+### **平台版本高于3.0版本**
+
+平台上传时，需要上传压缩包。codeWave提供了依赖库的maven插件，可以一键生成压缩包。压缩包中会包括当前依赖库的所有依赖包，无需进行额外配置。
+
+## **依赖库已经上传了，但是应用中无法找到**
+
+检查下依赖库IDE版本及应用版本，应用只可以搜索到小于等于当前应用版本的依赖库（比如应用版本为2.22，无法引入IDE版本为3.0的依赖库）。
+
+依赖库IDE版本可以在依赖库详情中看到
+
+![image-20230131135749320](../assets/ylkcjsywtPC0.png)
+
+## **maven仓库中怎么进行上传jar包（以nexus为例）**
+
+1. 登陆nexus
+
+   ![image-20230131135749320](../assets/ylkcjsywtPC1.png)
+2. 点击Upload
+
+   ![image-20230131135749320](../assets/ylkcjsywtPC2.png)
+3. 选择要上传的repo
+
+   ![image-20230131135749320](../assets/ylkcjsywtPC3.png)
+4. 上传文件
+
+   ![image-20230131135749320](../assets/ylkcjsywtPC4.png)
+
+   - **File**：选择待上传的jar包
+   - **Group ID**：pom文件中的**groupId**
+   - **Artifact ID**：pom文件中的**artifactId**
+   - **Version**：pom文件中的**version**
+
+> **如果jar包是通过打全包的方式进行生成，则填写完GAV后勾选“Generate a POM file with these coordinates”即可。如果jar包不是通过打全包的方式进行生成，需要点击“Add another asset”，选择pom文件并且在Extension中填写pom，则下面的GAV会置灰，无法进行填写。**
+
+## **怎样打全包进行上传**
+
+1. 添加apache maven插件
+
+   ```
+   <plugin>
+       <groupId>org.apache.maven.plugins</groupId>
+       <artifactId>maven-assembly-plugin</artifactId>
+       <version>3.3.0</version>
+       <configuration>
+           <descriptorRefs>
+               <descriptorRef>jar-with-dependencies</descriptorRef>
+           </descriptorRefs>
+           <appendAssemblyId>false</appendAssemblyId>
+       </configuration>
+       <executions>
+           <execution>
+               <id>make-assembly</id>
+               <phase>package</phase>
+               <goals>
+                   <goal>single</goal>
+               </goals>
+           </execution>
+       </executions>
+   </plugin>
+   
+   ```
+2. 添加nasl-metadata-maven-plugin插件，确保其在apache maven插件后
+   设置属性jarWithDependencies为true
+
+   ```
+   <plugin>
+       <groupId>com.netease.lowcode</groupId>
+       <artifactId>nasl-metadata-maven-plugin</artifactId>
+       <version>1.7.4</version>
+       <configuration>
+           <jarWithDependencies>true</jarWithDependencies>
+       </configuration>
+       <executions>
+           <execution>
+               <goals>
+                   <goal>archive</goal>
+               </goals>
+           </execution>
+       </executions>
+   </plugin>
+   
+   ```
+
+## **低版本systempath产生的问题**
+
+由于添加了systempath会导致依赖不会进行传递，**一个项目的pom.xml如果使用了scope为system的dependency后，会导致传递依赖中断，即所有其他依赖本项目的项目都无法传递依赖。**在低版本的平台中（平台版本小于3.0），由于需要在nexus上自己将pom文件进行上传，在上传pom文件时可以手动将依赖库脚手架的依赖项nasl-metadata-collector进行删除（如果是通过scope为system的方式进行引入）。高版本的平台是上传依赖库压缩包，在生成压缩包的maven插件nasl-metadata-maven-plugin中会将nasl-metadata-collector依赖项自动进行删除。
+
+## **通过spring-boot-maven-plugin打包后引入发布报错**
+
+通过spring-boot-maven-plugin打包后的jar包是**一个特殊格式的可执行jar**，引入此jar包并不会解析到此jar包中的class文件，所以不能通过此插件进行打包。
+
+## **依赖库上传后，发现IDE中的逻辑或jar包与上传的不一致**
+
+需要确认依赖库是否上传之后进行了删除，又上传了相同版本的依赖库，而两个相同版本的依赖库实现不一致。如果依赖库有改动的话，需要进行版本的升级，相同版本的依赖库jar包不会被覆盖。
+
+## **依赖库上传后，发现依赖的jar包无法进行拉取**
+
+1. 检查是否为通过打全包的方式进行的打包，但未设置nasl-metadata-maven-plugin插件属性jarWithDependencies为true。
+2. pom文件中是否使用到了scope为runtime的依赖项，请参考maven官方文档（https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#dependency-scope）。
+
+## 引入jar包后，通过idea进行Build Project而未通过maven进行编译报错
+
+报错信息：`java: The class java.lang.IllegalArgumentException may be caused by the wrapped ProcessingEnvironment object.`
+
+解决方式：Preferences->Build, Execution, Deployment->Compiler修改Shared build process VM options添加参数`-Djps.track.ap.dependencies=false`
+
+## 使用nasl-metadata-collector包中的类导致运行时异常
+
+开发依赖库时请勿使用nasl-metadata-collector包中的工具类，插件nasl-metadata-maven-plugin在打包时会将nasl-metadata-collector包删掉。
+
+如下图所示，在依赖库声明为逻辑的方法中调用了nasl-metadata-collector包中的方法，调用该逻辑后出现运行时异常。
+
+![](../assets/fuwuduanyilaikuFAQ_0124_1.png)
+
+<img src="../assets/fuwuduanyilaikuFAQ_0124_2.png" style="border: 1px solid #CCC;" />
+
+## 依赖库spring-boot-starter-parent使用注意事项
+
+spring-boot-starter-parent版本号不一致时，若依赖库中引用的包在主项目parent中dependencyManagement有被声明，则依赖库指定的版本号会无效，最终生效的版本号是主项目parent中dependencyManagement中的版本号。
+
+尽量保持spring-boot-starter-parent版本号与主项目一致（导出源码可看到当前环境parent版本号）。
+
+spring-boot-starter-parent的版本号一致时，会以依赖库指定的版本号为准。
+若引用的包想跟主项目原代码和其他依赖库保持一致，需要设置scope=provided。
+
+<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年03月15日</span>
+</div>

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/50./344/276/235/350/265/226/345/272/223dependency/347/211/210/346/234/254/351/227/256/351/242/230.md

@@ -0,0 +1,68 @@
+# 服务端依赖库dependency版本问题
+
+## 背景
+
+依赖库使用nasl-metadata-maven-plugin打包成zip包。解压zip包后，可以看到两个文件夹：dependencies和library。其中，library文件夹中包含了本依赖库的代码打包成的jar包，而dependencies文件夹中则包含了所有本依赖库所依赖的jar包文件。
+
+在从CodeWave平台的资产中心上传依赖库或从资产市场安装依赖库时，所有包含在library和dependencies中的jar包都会被上传到CodeWave平台存储jar包的云存储空间（s3或maven）。一旦制品应用引用了这些依赖库，在启动时，它会从相应的云存储空间中获取jar包。
+
+## 现状
+
+依赖库打包时，所有依赖的包都被打包进了dependencies。
+
+![0](../assets/fuwuduanyilaikudependencybanbenwenti_0325_1.png)
+
+然而，当制品被上传并被引用后，应用启动时报错，指定的某个jar包不存在。经过仔细观察，发现dependencies中某个jar包的版本号与启动报错中指定的版本号不一致。
+
+![0](../assets/fuwuduanyilaikudependencybanbenwenti_0325_2.png)
+
+下载源码执行`mvn dependency:tree`，可以观察到依赖库中引的包和制品中引的包的版本号存在差异。
+
+依赖库中：
+
+![0](../assets/fuwuduanyilaikudependencybanbenwenti_0325_3.png)
+
+引了本依赖库的主项目中：
+
+![0](../assets/fuwuduanyilaikudependencybanbenwenti_0325_4.png)
+
+## 原因
+
+使用 Maven 或 Gradle 等构建工具时，如果主项目中已经定义了一个依赖的版本号，而在依赖库中指定的版本号和主项目默认版本号不同，那么构建工具会以主项目默认版本号为准。
+
+如：当前主项目默认引了父项目spring-boot-starter-parent，版本号为2.2.9.RELEASE。当依赖库引了httpclient，版本号为4.5.13时，由于spring-boot-starter-parent的父项目spring-boot-dependencies中定义了dependencyManagement，httpclient版本号被指定为4.5.12。最终制品启动时，使用的是4.5.12版本。
+
+## 解决方式
+
+### 一、以主项目为准
+
+1. 依赖库定义父包
+
+    ```    
+    <parent>    
+        <groupId>org.springframework.boot</groupId>        
+        <artifactId>spring-boot-starter-parent</artifactId>   
+        <version>2.2.9.RELEASE</version><!--与当前制品应用默认版本统一-->
+    </parent>
+    ```
+
+2. 不指定版本号，以父项目为准
+
+### 二、修改父项目的dependencyManagement
+
+需要使用到平台的工程模板概念，修改父项目的pom文件。重新在pom中定义dependencyManagement，声明依赖库需要的版本号。
+
+![0](../assets/fuwuduanyilaikudependencybanbenwenti_0325_5.png)
+
+## 存在默认版本号的包
+
+[点击下载pom.xml](https://static-vusion.nos-eastchina1.126.net/tutorial/%E6%96%87%E6%A1%A3%E4%B8%AD%E5%BF%83%E9%99%84%E4%BB%B6/%E5%90%8E%E7%AB%AF%E4%BE%9D%E8%B5%96%E5%BA%93dependency%E7%89%88%E6%9C%AC%E9%97%AE%E9%A2%98/pom.xml)
+
+说明：当前制品主项目的父包为spring-boot-starter-parent-2.2.9.RELEASE。定义的默认版本号与父包的版本强关联。若制品主项目版本变动时，默认版本号也会相应变动。
+
+<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年031月26日</span>
+</div>

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/60.JDK17/344/276/235/350/265/226/345/272/223/345/274/200/345/217/221.md

@@ -0,0 +1,89 @@
+# JDK17依赖库开发
+
+## 背景介绍
+
+codewave应用的Java源代码默认是基于JDK8，所开发的依赖库也需要使用JDK8，但当应用启用了[JDK17翻译器插件](../../../../50.平台配置管理/25.翻译器插件/40.源码升级JDK17.md)后，应用中的JDK8依赖库将可能存在不兼容的情况，在IDE中会出现报错。
+
+这种情况下必须将自行开发引入的依赖库适配JDK17，重新打包后在应用中引入新版依赖库，操作流程参考下文。
+
+
+## 操作步骤
+
+### 升级JDK、脚手架与maven插件
+
+打包适配JDK17应用的依赖库，必须满足以下条件：
+
+- JDK版本要求：17+
+- nasl-metadata-collector（脚手架依赖）版本要求：0.16.0及以上
+- nasl-metadata-maven-plugin（maven插件依赖）版本要求：1.7.4及以上
+
+### 代码适配
+
+代码升级至JDK17时，需要关注的点包括但不限于以下范围：
+
+- **Java包名与API变化**
+
+    JDK8转向JDK17后，个别包名需要迁移，部分API需要替换，通常Java IDE以及编译阶段会给出提示。
+
+    ```
+    //示例
+    // JDK8的包名
+    import javax.servlet.http.HttpServletRequest;
+
+    // JDK17的包名迁移
+    import jakarta.servlet.http.HttpServletRequest;
+    ```
+
+- **三方包升级**
+
+    即使代码本身没有改动，依赖库引用的第三方依赖也可能不兼容 JDK17。优先升级到官方声明支持 JDK17 的版本。若无法升级，需关注运行时异常。
+
+- **Spring生态升级**
+
+    如果使用到spring系列依赖，注意spring系列依赖需要升级到与主应用相同的版本。
+
+    例如，依赖库中使用到了spring-boot-starter-parent 2.x版本，由于JDK17翻译器升级了SpringBoot为3.x版本，所以依赖库中的springboot也需要升级到与主应用相同的3.x，具体版本可导出主应用源代码查看。示例如下。
+
+    JDK8：
+
+    ```
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>2.3.0.RELEASE</version>
+        <relativePath/>
+    </parent>
+    ```
+
+    JDK17：
+
+    ```
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>3.2.12</version>
+        <relativePath/>
+    </parent>
+    ```
+
+    若引用的包想跟主项目原代码和其他依赖库保持一致，可设置scope=provided。
+
+### 打包与使用
+
+完成代码适配后重新打包：mvn clean package
+
+编译失败时关注是否是兼容性问题。
+
+编译成功后，将依赖库文件上传到平台中，刷新应用web IDE后引入新版依赖库即可。
+
+## 注意事项
+
+依赖库打包成功、引入到应用后发布成功，都无法作为绝对成功适配JDK17的标志，部分兼容性错误可能在运行时才暴露，请仔细审查代码。
+
+
+<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月05日</span>
+</div>

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/20./346/211/251/345/261/225/351/200/273/350/276/221/345/274/200/345/217/221/10.Java/346/211/251/345/261/225/351/200/273/350/276/221/345/274/200/345/217/221.md

@@ -0,0 +1,80 @@
+# Java扩展逻辑开发
+
+Java扩展逻辑是面向Java专业开发者提供的一种扩展方式，即：可以在CodeWave平台IDE中编写Java方法作为逻辑调用。
+
+和[Java扩展依赖库](../10.依赖库开发/10.服务端依赖库开发快速入门.md)相比，它的优势是：可以将Java代码同CodeWave编程内容一起托管，而扩展依赖库则存在Java代码管理分散的问题，后续迭代需要找到当时开发的源码。
+
+而它也存在较明显的劣势，如：开发Java扩展逻辑时，输入参数、输出参数需要限定为CodeWave平台能够识别的数据类型，在引入三方jar包方面，操作也是比较麻烦，同时没有Java语法校验、不支持在线运行调试，开发者使用成本还是比较高的。
+
+<div class="yellowBlock">
+
+[Java扩展依赖库](../10.依赖库开发/10.服务端依赖库开发快速入门.md)不仅完全涵盖扩展逻辑的能力，且能力更强、可作为资产复用，扩展逻辑能够实现的能力都可以用扩展依赖库实现，推荐使用扩展依赖库实现复杂的Java代码功能，扩展逻辑建议仅用于开发一些较简单的方法。
+
+</div>
+
+## 如何启用Java扩展逻辑
+
+Java扩展逻辑功能入口默认关闭，有需要的用户可以按照如下步骤自行启用：
+
+1. 在IDE顶部“更多”菜单中，点击“系统偏好设置”，找到“使用扩展逻辑”，将开关打开，点击“保存”。
+2. 在逻辑IDE左侧树节点中，服务端逻辑最末尾出现“扩展逻辑”节点，点击右键可以添加扩展逻辑。
+3. 添加后立刻打开了Java扩展逻辑编辑区域，可以看到如同传统的Java文本编辑，并高亮显示Java语法关键字。
+4. 根据注释上的提示，就可以进行Java语言编程了。
+
+![image](../assets/java_kzlj_1.png)
+
+## 如何调用扩展逻辑
+
+在CodeWave逻辑中，使用“调用逻辑”组件，即可选中Java扩展逻辑，其操作同服务端逻辑，填写输入参数、调用后获得输出参数等。
+
+![image](../assets/java_kzlj_2.png)
+
+## 使用常见问题
+
+### 包名如何定义？能否更改？
+
+默认存放位置是`com.[租户名].[应用标识].javalogic`，和CodeWave生成的服务端逻辑目录是隔离的。
+
+开发者可以更新包名，生成源码时会按照包名存放.java源文件，修改包名、类名后，需要手动修改Java扩展逻辑的类名属性：如图位置需要保持一致
+
+![image](../assets/java_kzlj_3.png)
+
+import默认引入org.springframework.stereotype.Service，请勿删除或改动，删除可能会导致预览发布时编译失败。
+
+### 类名、入口方法和逻辑名的关系
+
+类名和逻辑名没有直接映射关系，只要包内名称不冲突即可，但修改包名类名后需要手动修改Java扩展逻辑的类名属性，参考上个问题截图。
+
+入口方法名称需要跟Java扩展逻辑名称保持大小写一致，类中可以定义多个方法，但是入口方法只有一个，也是被第一顺序调用的方法。
+
+### 入口方法的输入参数、输出参数如何设置？
+
+设置步骤：
+
+1. 在左侧树节点，点击右键添加输入参数、输出参数，并设置数据类型，操作同CodeWave服务端逻辑。
+2. 在Java入口方法参数括号中，填写对应名称、数据类型的参数，并且保持顺序一致。数据类型需要自行将Java数据类型和NASL进行匹配，参考注释中的说明。
+
+![image](../assets/java_kzlj_4.png)
+
+### 能否引入三方jar包？
+
+import位置可以追加引入其他包名，并确保引入的jar包存在于maven库中，判断方法：预览发布编译时如果缺包，发布日志中会有报错提示。
+
+但Java扩展逻辑中没有便捷引入三方jar包的功能。
+
+### 在Java扩展逻辑中如何使用CodeWave服务端逻辑和数据结构、实体？
+
+通过源码导出功能，可以看到生成Java代码后，CodeWave服务端逻辑、数据结构、实体的真实路径和类名、方法名，可以用源码名称调用。
+
+<style>
+
+  .yellowBlock {
+    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/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/20./346/211/251/345/261/225/351/200/273/350/276/221/345/274/200/345/217/221/20.AI/350/276/205/345/212/251/347/224/237/346/210/220Java/344/273/243/347/240/201.md

@@ -0,0 +1,40 @@
+# AI辅助生成Java代码
+
+## 1. 功能介绍
+
+在使用扩展逻辑编写Java代码时，可以使用自然语言描述需要的代码能力，生成所需的Java代码，可对生成的Java代码进行调整。
+
+## 2. 操作流程
+
+1. 在“系统偏好设置”中，开启“使用扩展逻辑”，并保存。
+
+   <img src="../assets/AIzJave_0530_1928_1.png" style="border: 1px solid #ccc;" />
+2. 在逻辑中，选择“扩展逻辑”，鼠标右键选择“添加扩展逻辑”。
+
+   <img src="../assets/AIzJave_0530_1928_2.png" style="border: 1px solid #ccc;" />
+3. 进入扩展逻辑代码编辑面板，点击右下角“AI 智能生成代码”。
+
+   <img src="../assets/AIzJave_0530_1928_3.png" style="border: 1px solid #ccc;" />
+4. 在对话框中，描述需要代码实现的功能，点击“发送”，等待AI生成代码。
+
+   对话示例：
+
+   请帮我生成一段 Java 代码，实现以下功能：
+
+   1. 文件下载到指定目录：目录地址；
+   2. 能够实现断点续传
+
+   <img src="../assets/AIzJave_0530_1928_4.png" style="border: 1px solid #ccc;" />
+5. 查看AI生成代码，可按需复制到代码编辑器中。
+
+   <img src="../assets/AIzJave_0530_1928_5.png" style="border: 1px solid #ccc;" />
+6. 代码生成采用最新2组对话，可以点击“开启新对话”，清除当前内容，开始新一轮代码生成。
+
+   <img src="../assets/AIzJave_0530_1928_6.png" style="border: 1px solid #ccc;" />
+
+<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年05月31日</span>
+</div>

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/40./345/211/215/345/220/216/347/253/257/344/276/235/350/265/226/345/272/223/345/220/210/345/271/266/346/211/223/345/214/205.md

@@ -0,0 +1,55 @@
+# 前后端依赖库合并打包
+
+## 概念介绍
+
+在一组业务需求中可能同时包含了[前端依赖库](../10.扩展开发方式/20.前端扩展开发/10.前端扩展开发概述.md)和[后端依赖库](../10.扩展开发方式/30.服务端扩展开发/10.依赖库开发/10.服务端依赖库开发快速入门.md)，可参考本文，将一个前端依赖库和一个后端依赖库进行合并，重新打包成一个包含两者的新依赖库。
+
+
+## 操作示例
+
+1. 下载合并程序library-merger：
+
+   - Windows amd64(x86_64):<https://static-vusion.nos-eastchina1.126.net/tutorial/%E6%96%87%E6%A1%A3%E4%B8%AD%E5%BF%83%E9%99%84%E4%BB%B6/%E6%89%A9%E5%B1%95%E4%BE%9D%E8%B5%96%E5%BA%93%E8%AF%B4%E6%98%8E/3.13/library-merger_Win_amd64.exe>
+
+   - Linux amd64(x86_64):<https://static-vusion.nos-eastchina1.126.net/tutorial/%E6%96%87%E6%A1%A3%E4%B8%AD%E5%BF%83%E9%99%84%E4%BB%B6/%E6%89%A9%E5%B1%95%E4%BE%9D%E8%B5%96%E5%BA%93%E8%AF%B4%E6%98%8E/3.13/library-merger_Linux_amd64>
+
+   - MacOS arm64(Apple Silicon):<https://static-vusion.nos-eastchina1.126.net/tutorial/%E6%96%87%E6%A1%A3%E4%B8%AD%E5%BF%83%E9%99%84%E4%BB%B6/%E6%89%A9%E5%B1%95%E4%BE%9D%E8%B5%96%E5%BA%93%E8%AF%B4%E6%98%8E/3.13/library-merger_MacOS_arm64>
+
+2. 准备好需要合并的前端依赖库和后端依赖库（已开发完成的依赖库zip文件），新建一个文件夹，将library-merger程序放到文件夹下，在文件夹下创建frontend-library文件夹并将前端依赖库文件放到文件夹下，在文件夹下创建backend-library文件夹并将后端依赖库文件放到文件夹下。
+
+3. 用命令行执行library-merger程序，即可在当前文件夹下生成合并后的依赖库zip文件。
+
+    ```
+    ./library-merger -s testMerge -v 1.1.0 -n 新依赖库
+    ```
+    
+    library-merger支持的命令行参数：
+    - `-n`、`--name`：合并后的依赖库Name
+    - `-s`、`--symbol`：合并后的依赖库Symbol
+    - `-v`、`--version`：合并后的依赖库Version
+
+    <img src="../assets/qianhouduanyilaikuhebingkaifa_202503191559_1.png" style="" />
+
+效果演示：
+
+<img src="../assets/qianhouduanyilaikuhebingkaifa_202503191559_2.png" style="width:700px;" />
+
+## 说明
+
+- 使用合并依赖库要求平台IDE版本>=3.13
+
+- 若未通过命令行参数指定name、symbol、version，则按照以下逻辑生成合并后依赖库的对应参数：
+    - Symbol：若未指定，则默认为 `{后端依赖库Symbol}_{前端依赖库Symbol}`。
+    - Version：若未指定，前后端依赖库Version需一致，否则报错。
+    - Name：若未指定，则以后端依赖库Name为准。
+- 其他字段合并策略：
+  - configuration：不能存在同名configuration，否则报错。
+  - description：以后端为准。
+  - 其他字段：若路径相同但值不同则报错。
+
+<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年03月14日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/20./351/233/206/346/210/220/345/274/200/345/217/221/346/226/271/345/274/217/10./344/273/200/344/271/210/346/230/257/351/233/206/346/210/220/345/274/200/345/217/221.md

@@ -0,0 +1,16 @@
+# 什么是集成开发
+
+在企业中，CodeWave应用一种常见的场景是作为多个存量系统的粘合剂使用，即在CodeWave应用中需要打通多个外部系统，承担数据融合、页面融合、流程融合等任务。CodeWave对此提供了多种集成能力，适用于不同的集成场景：
+
+* [连接器集成](../20.集成开发方式/20.连接器集成/10.什么是连接器.md)：将企业常见应用系统、中间件等，封装成连接器，可以通过简单配置就可以实现集成能力，封装实现细节，降低了开发者理解和使用的门槛。目前已经提供的连接器有Redis连接器、Kafka连接器、企微连接器、钉钉连接器等，还提供了自定义连接器，可以让CodeWave开发者自行定义使用，并沉淀为IT资产，共享到组织内部使用。
+* [应用API集成](../20.集成开发方式/30.应用API集成/10.应用API管理功能.md)：通过将HTTP、HTTPS等协议的接口注册到CodeWave中，即可在CodeWave应用的逻辑IDE中拖拽配置使用。目前已经实现了CodeWave应用开放接口、引入三方接口、接口鉴权、批量导入接口等功能。通过API接口方式进行的应用集成，覆盖场景广泛，几乎可以满足80%以上的集成需求。
+* [页面集成](../20.集成开发方式/40.页面集成/10.什么是微前端集成.md)：平台提供了一套专业的Iframe和微前端集成解决方案，支持包括乾坤、飞冰在内的多种微前端框架。这使得页面集成变得更加高效和专业，能够与企业的IT架构实现无缝对接。此外，还能够友好地支持跨应用的认证与鉴权等集成需求，确保了不同应用间的顺畅协作。
+* [登录认证与权限集成](../../40.扩展与集成/20.集成开发方式/50.登录认证与权限集成/010.登录认证和权限集成概述.md)：CodeWave支持集成第三方登录认证和自定义权限集成，通过使用依赖库和编写逻辑，对接已有的SSO或权限中心，以满足特定业务场景的需求。
+* [MCP集成](../20.集成开发方式/60.MCP集成/50.MCP能力介绍.md)：支持将逻辑导出为MCP服务，供外部的大模型调用，以满足AI时代的应用集成需求。
+
+<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年09月28日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/40./346/211/251/345/261/225/344/270/216/351/233/206/346/210/220/20./351/233/206/346/210/220/345/274/200/345/217/221/346/226/271/345/274/217/20./350/277/236/346/216/245/345/231/250/351/233/206/346/210/220/10./344/273/200/344/271/210/346/230/257/350/277/236/346/216/245/345/231/250.md

@@ -0,0 +1,63 @@
+# **什么是连接器**
+
+## 1. 连接器的概念
+
+CodeWave平台的连接器是一种用于连接第三方服务、系统或数据源的工具。通过CodeWave平台的连接器，开发者可以在轻松地访问其他系统中的数据和功能，从而实现不同系统之间的数据交换和应用集成。
+
+![](../assets/shenmeshilianjieqi_202505191603_1.png)
+
+## 2. 连接器的种类
+
+从开发方式上，可以通过低代码（在线IDE）的方式开发连接器，也可以通过编写Java代码来开发连接器。
+
+- **低代码开发的连接器**：本质上是对API调用的封装，封装好了接口信息、请求体及响应体、接口鉴权方式，调用此类连接器时本质上就是调用了接口。比较典型的有：
+
+  - [企业微信连接器](../20.连接器集成/40.连接器汇总/40.企微应用连接器.md)：用于与企业微信进行通信的工具，可以将企业微信中的组织架构，消息通知等信息传输到CodeWave平台应用中。企业微信连接器通常用于企业内部通信、消息通知和应用集成等场景。
+
+  - [钉钉连接器](../20.连接器集成/40.连接器汇总/50.钉钉应用连接器.md)：用于与钉钉进行通信的工具，可以将钉钉中的组织架构，消息通知等信息传输到CodeWave平台应用中。钉钉连接器通常用于企业内部沟通、任务管理和应用集成等场景。
+
+- **高代码开发的连接器**：能力较为灵活，类似于服务端依赖库，通过编写Java代码的方式来为低代码应用实现一些扩展能力。比较典型的有：
+
+  - [Redis连接器](../20.连接器集成/40.连接器汇总/20.Redis连接器.md)：用于与 Redis 数据库进行通信的工具，可以轻松地将 Redis 中的数据导入到其他系统中。Redis连接器通常用于实时数据分析、数据同步和缓存管理等场景。
+
+  - [Kafka连接器](../20.连接器集成/40.连接器汇总/30.Kafka连接器.md)：用于与 Kafka 消息队列进行通信的工具，可以将 Kafka 中的数据传输到其他系统中。Kafka连接器通常用于流式数据处理、数据管道和数据集成等场景。
+
+
+## 3. 如何使用连接器
+
+### 3.1 配置连接器
+
+1. 功能入口：IDE顶部集成中心
+
+   ![](../assets/shenmeshilianjieqi_202407151413_1.png)
+
+2. 选择要使用的连接器，点击**添加**。
+
+   ![](../assets/shenmeshilianjieqi_202407151413_2.png)
+
+3. 填写连接器需要的配置（每种连接器的配置可能不同，下图以钉钉连接器为例）。
+
+   ![](../assets/shenmeshilianjieqi_202407151413_3.png)
+
+4. 可通过“快捷填充开发环境配置”功能将开发环境配置复制填写到生产环境配置。
+
+   ![](../assets/shenmeshilianjieqi_202407151413_4.png)
+
+### 3.2 调用连接器
+
+**调用前请确保连接器配置已填写正确**。
+
+- 调用方式1：通过拖拽逻辑组件“连接器”调用连接器。
+
+  ![](../assets/shenmeshilianjieqi_0318_4.png)
+
+- 调用方式2：拖拽连接器下的连接配置调用连接器。
+
+  ![](../assets/shenmeshilianjieqi_0318_5.png)
+
+<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年05月19日</span>
+</div>