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/45./351/200/273/350/276/221/347/274/226/350/276/221/60./345/256/232/346/227/266/344/273/273/345/212/241.md

@@ -0,0 +1,294 @@
+# 定时任务
+
+## 1. 功能概述
+
+CodeWave智能开发平台支持为服务端逻辑的自定义定时任务，通过可视化设置Cron表达式，约定逻辑的自动执行时间和间隔，从而实现周期性执行该服务端逻辑。
+
+## 2. 使用场景
+
+定时任务功能适用于以下场景：
+
+* 自动化报告生成：定时生成报告并将其发送给相关人员。
+* 数据清洗和转换：在特定时间点执行数据清洗、转换或整合操作。
+* 定时通知和提醒：定时向用户发送通知或提醒，例如会议提醒、生日祝福等。
+* 系统集成和数据同步：定时执行系统集成操作，确保不同系统间的数据同步。
+
+> 具体应用场景请参见：[如何实现定时任务](../../../80.常见场景案例/50.逻辑场景/90.如何实现定时任务.md)。
+
+## 3. 使用说明
+
+
+### 操作步骤
+
+1. 选择一个需要定时执行的逻辑，右键”设置定时任务“。
+
+   <img src="../assets/dsrw_20240429_174231_001.png" alt="0" style="width:300px;" />
+2. 在弹出窗口中填写定时任务的规则表达式
+
+   规则表达式常用说明见界面，完整说明参考后续Cron表达式规则说明。
+
+   ![0](../assets/dsrw_20240429_174231_002.png)
+
+   **小技巧**：可以通过左下角“导入规则模板”，选择一个较为相似的场景模板，稍加修改即可使用。
+
+   ![0](../assets/dsrw_20240429_174231_003.png)
+
+   **注意！！请谨慎使用秒级触发的定时任务，可能会影响应用性能。**
+
+   ![0](../assets/dsrw_20240429_174231_004.png)
+3. 表达式设置完成后，右侧会出现模拟最近10次运行时间，可以确认表达式设置是否准确。
+
+   <img src="../assets/dsrw_20240429_174231_005.png" alt="0" style="" />
+4. 当表达式出现问题时，会提示错误信息，请根据Cron规则检查表达式。
+
+   <img src="../assets/dsrw_20240429_174231_006.png" alt="0" style="" />
+
+   <img src="../assets/dsrw_20240429_174231_007.png" alt="0" style="" />
+5. 点击右下角“保存”，则可以保存表达式设置，但此时定时任务并未生效，需要发布后才能生效。
+
+   <img src="../assets/dsrw_20240429_174231_008.png" alt="0" style="" />
+6. 已设置定时任务的逻辑，会出现小图标。
+
+   <img src="../assets/dsrw_20240429_174231_009.png" alt="0" style="width:300px;" />
+7. 右键该逻辑，可以取消定时任务，同样也是发布后生效。
+
+   <img src="../assets/dsrw_20240429_174231_010.png" alt="0" style="width:300px;" />
+
+   ![0](../assets/dsrw_20240429_174231_011.png)
+
+### 注意事项
+
+1. 已有输入参数的服务端逻辑下不支持设置定时任务。
+2. 设置了定时任务的服务端逻辑不支持添加输入参数。
+3. 定时任务在开发环境和生产环境都生效。例如，通过定时任务发送通知时的，开发环境和生产环境都会发送。
+
+## 4. Cron表达式规则说明
+
+Cron表达式是一个字符串，是由空格隔开的6或7个域组成，每一个域对应一个含义（*秒 分 时 每月第几天 月 星期 年）*其中年是可选字段，CodeWave平台中暂时不支持年的设置。**输入规则表达式时需使用英文符号。**
+
+### 各域支持的字符类型
+
+秒：可出现", - * /"四个字符，有效范围为0-59的整数。
+
+分：可出现", - * /"四个字符，有效范围为0-59的整数。
+
+时：可出现", - * /"四个字符，有效范围为0-23的整数。
+
+每月第几天：可出现", - * / ? L W C"八个字符，有效范围为0-31的整数。
+
+月：可出现", - * /"四个字符，有效范围为1-12的整数或JAN-DEC。
+
+星期：可出现", - * / ? L C #"四个字符，有效范围为1-7的整数或SUN-SAT两个范围。1表示星期天，2表示星期一， 依次类推。
+
+### 特殊字符含义
+
+\* : 表示匹配该域的任意值，比如在秒*, 就表示每秒都会触发事件。
+
+? : 只能用在每月第几天和星期两个域。表示不指定值，当2个子表达式其中之一被指定了值以后，为了避免冲突，需要将另一个子表达式的值设为“?”。
+
+\- : 表示范围，例如在分域使用5-20，表示从5分到20分钟每分钟触发一次。
+
+/ : 表示起始时间开始触发，然后每隔固定时间触发一次，例如在分域使用5/20,则意味着5分，25分，45分，分别触发一次。
+
+, : 表示列出枚举值。例如：在分域使用5,20，则意味着在5和20分时触发一次。
+
+L : 表示最后，只能出现在星期和每月第几天域，如果在星期域使用1L,意味着在最后的一个星期日触发。
+
+W : 表示有效工作日(周一到周五),只能出现在每月第几日域，系统将在离指定日期的最近的有效工作日触发事件。注意一点，W的最近寻找不会跨过月份。
+
+LW : 这两个字符可以连用，表示在某个月最后一个工作日，即最后一个星期五。
+
+\# : 用于确定每个月第几个星期几，只能出现在“星期”域。例如在1#3，表示某月的第三个星期日。
+
+
+## 5. 定时任务表字段说明
+
+定时任务基于Java的[Quartz](https://www.quartz-scheduler.org/)框架实现，使用了定时任务的应用会自动创建一系列相关的表。这些表用于存储与定时任务相关的各类信息。
+
+进入WebSQL界面，可查看定时任务表。
+
+<img src="../assets/dingshirenwu_202411111815_1.png" class="imgStyle" style="" />
+
+<img src="../assets/dingshirenwu_202411111815_2.png" class="imgStyle" style="" />
+
+<div class="yellowBlock">
+
+有关表字段的解释请自行搜索Quartz文档，以下表字段解释仅供参考。
+
+### BLOB\_TRIGGERS表
+
+自定义触发器表。
+
+| 列名             | 类型      | 字段说明         |
+| :------------- | :------ | :----------- |
+| SCHED\_NAME    | varchar | 调度器名称        |
+| TRIGGER\_NAME  | varchar | 触发器名称        |
+| TRIGGER\_GROUP | varchar | 触发器分组        |
+| BLOB\_DATA     | blob    | 与触发器相关的二进制数据 |
+
+### CALENDARS表
+
+以 Blob 类型存储存放日历信息。
+
+| 列名             | 类型      | 字段说明         |
+| :------------- | :------ | :----------- |
+| SCHED\_NAME    | varchar | 调度器名称        |
+| CALENDAR\_NAME | varchar | 日历名称         |
+| CALENDAR       | blob    | 存储日历定义的二进制数据 |
+
+### CRON\_TRIGGERS表
+
+存储触发器的cron表达式表。
+
+| 列名               | 类型      | 字段说明     |
+| :--------------- | :------ | :------- |
+| SCHED\_NAME      | varchar | 调度器名称    |
+| TRIGGER\_NAME    | varchar | 触发器名称    |
+| TRIGGER\_GROUP   | varchar | 触发器分组    |
+| CRON\_EXPRESSION | varchar | Cron 表达式 |
+| TIME\_ZONE\_ID   | varchar | 时区ID     |
+
+### FIRED\_TRIGGERS表
+
+存储与已触发的 Trigger 相关的状态信息，以及相联 Job 的执行信息。
+
+| 列名             | 类型      | 字段说明   |
+| :------------- | :------ | :----- |
+| SCHED\_NAME    | varchar | 调度器名称  |
+| ENTRY\_ID      | varchar | 触发记录ID |
+| TRIGGER\_NAME  | varchar | 触发器名称  |
+| TRIGGER\_GROUP | varchar | 触发器分组  |
+| INSTANCE\_NAME | varchar | 实例名称   |
+| FIRED\_TIME    | bigint  | 触发时间   |
+| SCHED\_TIME    | bigint  | 计划执行时间 |
+| PRIORITY       | int     | 优先级    |
+| STATE          | varchar | 状态     |
+
+### JOB\_DETAILS表
+
+存储每个任务的详细信息。
+
+| 列名                 | 类型      | 字段说明        |
+| :----------------- | :------ | :---------- |
+| SCHED\_NAME        | varchar | 调度器名称       |
+| JOB\_NAME          | varchar | 作业名称        |
+| JOB\_GROUP         | varchar | 作业分组        |
+| DESCRIPTION        | varchar | 描述          |
+| JOB\_CLASS\_NAME   | varchar | 作业类名        |
+| IS\_DURABLE        | varchar | 是否持久化       |
+| IS\_NONCONCURRENT  | varchar | 是否非并发执行     |
+| IS\_UPDATE\_DATA   | varchar | 是否更新数据      |
+| REQUESTS\_RECOVERY | varchar | 是否请求恢复      |
+| JOB\_DATA          | blob    | 与作业相关的二进制数据 |
+
+### LOCKS表
+
+存储程序的悲观锁的信息。
+
+| 列名          | 类型      | 字段说明  |
+| :---------- | :------ | :---- |
+| SCHED\_NAME | varchar | 调度器名称 |
+| LOCK\_NAME  | varchar | 锁名称   |
+
+### PAUSED\_TRIGGER\_GRPS表
+
+存储已暂停的 Trigger 组的信息。
+
+| 列名             | 类型      | 字段说明  |
+| :------------- | :------ | :---- |
+| SCHED\_NAME    | varchar | 调度器名称 |
+| TRIGGER\_GROUP | varchar | 触发器分组 |
+
+### SCHEDULER\_STATE
+
+存储集群中的实例信息，定时任务会定时读取该表的信息判断集群中每个实例的当前状态。
+
+| 列名                  | 类型      | 字段说明   |
+| :------------------ | :------ | :----- |
+| SCHED\_NAME         | varchar | 调度器名称  |
+| INSTANCE\_NAME      | varchar | 实例名称   |
+| LAST\_CHECKIN\_TIME | bigint  | 上次检查时间 |
+| CHECKIN\_INTERVAL   | bigint  | 检查间隔时间 |
+
+### SIMPLE\_TRIGGERS表
+
+存储简单的触发器，包括重复次数，间隔，以及触发次数。
+
+| 列名               | 类型      | 字段说明                             |
+| :--------------- | :------ | :------------------------------- |
+| SCHED\_NAME      | varchar | 调度器名称                            |
+| TRIGGER\_NAME    | varchar | qrtz\_triggers表trigger\_ name的外键 |
+| TRIGGER\_GROUP   | varchar | qrtz\_triggers表trigger\_group的外键 |
+| REPEAT\_COUNT    | bigint  | 重复次数                             |
+| REPEAT\_INTERVAL | bigint  | 重复间隔时间                           |
+| TIMES\_TRIGGERED | bigint  | 已触发次数                            |
+
+### SIMPROP\_TRIGGERS表
+
+存储与简单触发器关联的属性。
+
+| 列名             | 类型      | 字段说明                             |
+| :------------- | :------ | :------------------------------- |
+| SCHED\_NAME    | varchar | 调度器名称                            |
+| TRIGGER\_NAME  | varchar | qrtz\_triggers表trigger\_ name的外键 |
+| TRIGGER\_GROUP | varchar | qrtz\_triggers表trigger\_group的外键 |
+| STR\_PROP\_1   | varchar | String类型的trigger的第一个参数           |
+| STR\_PROP\_2   | varchar | String类型的trigger的第二个参数           |
+| STR\_PROP\_3   | varchar | String类型的trigger的第三个参数           |
+| INT\_PROP\_1   | int     | int类型的trigger的第一个参数              |
+| INT\_PROP\_2   | int     | int类型的trigger的第二个参数              |
+| LONG\_PROP\_1  | bigint  | long类型的trigger的第一个参数             |
+| LONG\_PROP\_2  | bigint  | long类型的trigger的第二个参数             |
+
+### TRIGGERS表
+
+存储触发器的基本信息。
+
+| 列名               | 类型      | 字段说明                             |
+| :--------------- | :------ | :------------------------------- |
+| SCHED\_NAME      | varchar | 调度名称                             |
+| TRIGGER\_NAME    | varchar | 触发器的名字                           |
+| TRIGGER\_GROUP   | varchar | 触发器所属组的名字                        |
+| JOB\_NAME        | varchar | qrtz\_job\_details表job\_name的外键  |
+| JOB\_GROUP       | varchar | qrtz\_job\_details表job\_group的外键 |
+| DESCRIPTION      | varchar | 详细描述信息                           |
+| NEXT\_FIRE\_TIME | bigint  | 下一次触发时间（毫秒）                      |
+| PREV\_FIRE\_TIME | bigint  | 上一次触发时间（毫秒）           |
+| PRIORITY         | int     | 优先级                              |
+| TRIGGER\_STATE   | varchar | 当前触发器状态                          |
+
+</div>
+
+<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月25日</span>
+</div>
+
+<style>
+
+  table td:first-child {
+    width: 200px; 
+  }
+
+  table td:nth-child(2) {
+    width: 200px; 
+  }
+  
+  table td:nth-child(3) {
+    width: 300px;
+  }
+</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/45./351/200/273/350/276/221/347/274/226/350/276/221/80./351/200/273/350/276/221/350/260/203/350/257/225.md

@@ -0,0 +1,135 @@
+# 逻辑调试
+
+## 1. 功能概述
+
+调试（debug）是传统开发过程中常见的排障手段，通过设置断点，可以观测每一步程序的运行结果。
+
+在CodeWave 3.0以上版本中增加了全栈逻辑调试能力，为开发者排查逻辑故障提供简单、高效的工具。
+
+**调试的基本概念**
+
+- **调试**：应用的某个功能搭建完成，对可能存在的逻辑错误、数据问题进行排查定位的过程。传统开发中的debug，就是其中的一种方法。
+
+
+
+- **断点**：在逻辑块上可以设置一个断点，当调试模式启动后，应用一旦执行到这个逻辑块，就会停在这里，等待下一步调试操作。
+- **调试模式（调试发布）**：同一般的预览发布过程，让应用在开发环境中运行起来，同时IDE进入调试模式，当应用执行到断点时会在IDE中显示断点位置和可见范围内的变量取值。
+- **执行**：调试模式下，可进行的调试操作，点击后，逻辑执行到下一个断点处。
+- **下一步**：调试模式下，可进行的调试操作，点击后，逻辑执行到下一个逻辑块，无论其是否设置了断点。
+- **断点失效/生效**：点击后，可以使所有断点失效或者生效，失效的断点变为灰色，执行到时，不再会停住。
+- **调试请求**：当IDE处于调试模式时，可能会接到多个调试请求，如应用页面某个按钮触发的调试请求，或者定时任务触发的调试请求，或者导出的接口被调用触发的请求，点击调试请求，可以切换到当前请求正在执行的断点。
+- **停止调试**：退出调试模式，如果需要重新走断点调试，则需要再次进行调试发布。
+
+## 2. 使用场景
+
+当无法通过逻辑阅读和理解来排查定位问题时，可以考虑使用断点调试，跟随每个逻辑块执行一遍，查看变量的值，可能会帮助开发者定位到错误。
+
+当逻辑本身无误，但有可能是运行时的某个数据才会导致错误发生时，使用断点调试能更直观地观测取值，定位问题。
+
+## 3. 操作步骤
+
+### 3.1 打开调试功能
+
+在IDE顶部“**更多**”菜单栏，点击“**系统偏好设置**”。
+
+<img src="../assets/luojitiaoshi_202408161429_1.png" class="imgStyle" style="" />
+
+开启“**调试功能**”，并点击“**保存**”按钮。
+
+<img src="../assets/luojitiaoshi_202408161429_2.png" class="imgStyle" style="" />
+
+保存成功后，IDE顶部会出现“**调试**”按钮，底部也会出现“**调试**”选项卡。
+
+<img src="../assets/luojitiaoshi_202408161429_3.png" class="imgStyle" style="" />
+
+### 3.2 设置断点
+
+打开需要排查的逻辑，页面逻辑、组件事件逻辑、服务端逻辑均可进行断点调试，在逻辑组件右键菜单中，有“**添加断点**”，点击后即可出现断点。
+
+<img src="../assets/luojitiaoshi_202408161429_4.png" class="imgStyle" style="" />
+
+再次点击右键，可以禁用或移除断点。
+
+<img src="../assets/luojitiaoshi_202408161429_5.png" class="imgStyle" style="" />
+
+### 3.3 启动调试模式（调试发布）
+
+点击顶部调试按钮，会提示“调试会进行开发环境发布，是否继续？”，如果点击“**继续**”，则会进行发布，发布完成后，开发环境应用运行起来，IDE就进入调试模式了。
+
+<img src="../assets/luojitiaoshi_202408161429_6.png" class="imgStyle" style="" />
+
+<img src="../assets/luojitiaoshi_202408161429_7.png" class="imgStyle" style="" />
+
+### 3.4 触发断点
+
+当调试发布完成后，应用运行起来，此时在页面进行会触发断点的操作。
+
+如，当你把断点设置在按钮点击事件的逻辑中，就从应用运行的页面上，去点击这个按钮，点击事件就会触发这个逻辑，断点会在IDE中停住。
+
+触发断点有三种情况：
+
+- 页面事件逻辑触发
+- 定时任务触发
+- 接口调用触发
+
+当应用运行时页面出现“Paused in debugger”标识时，此时去IDE中查看，已经有请求停在了前端逻辑断点处。
+
+<img src="../assets/luojitiaoshi_202408161429_8.png" class="imgStyle" style="" />
+
+绿色箭头即程序执行到此，并且代表当前逻辑块尚未被执行，点击“**下一步**”就会执行。
+
+<img src="../assets/luojitiaoshi_202408161429_9.png" class="imgStyle" style="" />
+
+### 3.5 调试面板
+
+当断点停住时，底部的调试面板可以让开发者进行操作和观测。
+
+**操作**：可以进行“**执行**”、“**下一步**”操作。
+
+**观测**：可以查看当前逻辑中变量的取值。
+
+<img src="../assets/luojitiaoshi_202408161429_10.png" class="imgStyle" style="" />
+
+**浮动调试面板**
+
+当开发者感觉底部栏目太占用空间，将它最小化折叠时，浮动调试面板出现，可以拖放到任意位置，也可以进行调试操作和变量观测。
+
+<img src="../assets/luojitiaoshi_202408161429_11.png" class="imgStyle" style="" />
+
+### 3.6 停止调试
+
+点击调试面板上的红色停止按钮，即可结束调试模式，回到正常的开发模式。
+
+<img src="../assets/luojitiaoshi_202408161429_12.png" class="imgStyle" style="" />
+
+## 4. 常见问题
+
+### 增加断点设置，是否需要重启调试？
+
+仅增加断点设置，不需要重启调试，直接在调试模式下增减断点即可；
+
+但是修改逻辑内容需要重新进行调试发布。修改逻辑后，在顶部调试按钮上也有重新发布的提示图标。
+
+<img src="../assets/luojitiaoshi_202408161429_13.png" class="imgStyle" style="" />
+
+### 断点是否参与多人协作的拉取和推送？
+
+断点和调试仅仅是IDE提供的排障方式，不参与应用编程，不会写入代码仓库，所以不会参与多人协作、备份还原、发布模板等功能。
+
+### 调试发布成功了，但是断点没有停住，怎么办？
+
+从以下几个方面排查：
+
+- 检查是否在想要调试的逻辑中已经设置好断点？是否在应用运行的页面触发了断点所在的事件？
+- 发布完成后，应用页面是否刷新过？可以刷新后尝试触发断点所在的事件；
+- 是否开启了多个应用页面，目前只有一个页面会连接调试模式，尝试关闭所有应用页面，确保仅打开一个应用页面，再次尝试；
+- 是否修改了应用，如果修改应用后，需要重新调试发布；
+- 检查断点是否为灰色失效的状态？失效状态的断点也不会停住；
+- 检查是否调试发布过，如果是预览发布，则不会有断点被触发停住；
+
+### 有些逻辑组件之间嵌套调用，没有用变量接收，怎么看到某个逻辑块的返回值或者输出值？
+
+在调试模式下，当某个逻辑块下一步执行过后，可以鼠标悬浮在逻辑块上，左侧会浮动展示它的输出值。
+
+<img src="../assets/luojitiaoshi_202408161429_14.png" class="imgStyle" 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/45./351/200/273/350/276/221/347/274/226/350/276/221/85./345/274/202/345/270/270/345/244/204/347/220/206.md

@@ -0,0 +1,204 @@
+# 异常处理
+
+## 功能概述
+
+### 什么是异常
+
+异常是指程序执行过程中遇到的意外情况或错误，常见的异常如：
+
+- 接口异常：调用的外部接口网络不通或响应状态码不为200。
+- 索引越界异常：访问List中的越界元素，长度为3的列表试图访问第5个元素。
+- 类型转换异常：转换类型时参数不合法，例如使用内置函数Convert将字符串转换为整数时，如果字符串不是整数则会抛出类型转换异常。
+
+默认情况下应用框架会自动处理异常，记录原始错误日志，但出现异常时可能会带来一些体验问题：
+
+- 开发者可能难以理解出现错误时输出的信息，例如后端日志中的Java堆栈错误、浏览器控制台中的JS报错，并且因为缺少足够的上下文信息而无法快速定位问题所在。
+- 发生异常时是被动停止调用，中断了业务逻辑的执行。
+
+### 应用中如何处理异常
+
+3.12及以上版本的应用支持使用异常处理功能，在异常发生时实现自定义的灵活处理策略，从而更方便地排查运行时故障、提高应用的稳健性。
+
+使用异常处理功能可以实现以下能力：
+
+- 自定义发生异常时的错误信息，显示更友好的报错提示。
+- 在逻辑中可能出现报错的地方预先进行异常捕获，从而在发生错误时可以执行另一套操作，而不是被动中止调用。
+- 在逻辑中可以主动抛出异常。
+- 前端可以统一设置调用服务端逻辑出现异常后的处理方式。
+
+本文指导开发者了解异常处理功能在不同场景下的使用姿势。
+
+### 功能入口
+
+支持使用捕获异常的逻辑组件包括：API调用、连接器、返回值类型中包含Error类型的逻辑（含实体逻辑、依赖库逻辑、自定义逻辑）。需要捕获异常时点击逻辑组件下方的“高级设置”即可看到功能入口。
+
+<img src="../assets/yichangchuli_202511181531_1.png" class="imgStyle" style="width:400px;" />
+
+## 功能介绍
+
+### 异常提示信息
+
+使用调用逻辑组件或调用接口组件时，可在高级设置中输入自定义的异常提示信息，默认不填时表示使用原始的报错信息。
+
+> 注：在使用调用逻辑组件时，只有当该逻辑的返回结果中包含Error类型时，才可以在高级设置中展示异常处理的选项，调用接口组件则默认支持异常处理。
+
+如下图所示，在调用外部接口时，手动编辑了异常提示信息，在出现异常后，记录的日志中将输出对应的提示信息。
+
+<img src="../assets/yichangchuli_202412042115_1.png" class="imgStyle" style="" />
+
+<img src="../assets/yichangchuli_202412042115_2.png" class="imgStyle" style="" />
+
+### 手动处理API、连接器异常
+
+使用调用接口组件或连接器组件时，可在下方的“高级设置 > 异常处理”中开启“手动”，接口的返回结果类型将为Union联合类型（接口Body类型+InterfaceError类型），可以使用匹配组件判断接口调用结果的数据类型，在不同的分支中做不同的处理。
+
+- 分支1：类型为接口对应的ResponseBody类型，代表接口成功响应时执行的分支。
+- 分支2：类型为InterfaceError，代表接口未正常响应，出现异常时执行的分支。
+
+<img src="../assets/yichangchuli_202412042115_3.png" class="imgStyle" style="" />
+
+可以直接将调用接口组件作为匹配组件的参数，无需通过创建变量来接收接口返回结果，如下图所示，在分支下可以使用it变量表示被匹配的表达式的值。
+
+异常分支下的it变量代表了出现接口异常时的关键信息，包含的四个字段如下：
+
+- errorType：异常类型，例如`nasl.error.InterfaceError`
+- errorMsg：异常提示信息。
+- responseBody：响应体Body内容。
+- statusCode：HTTP状态码，例如404、401等。
+- responseHeaders：响应头信息。
+
+> 注：当匹配组件的参数是Union联合类型时，会根据不同的类型自动生成不同的分支，在应用运行时会根据实际的类型执行特定的分支。匹配组件内部的“it” 变量用于指代被匹配的表达式的值。关于匹配组件的更多介绍请参考文档[逻辑组件使用 - 分支](../40.逻辑组件使用/10.分支.md)
+
+<img src="../assets/yichangchuli_202502081006_1.png" class="imgStyle" style="" />
+
+使用示例：
+
+在某调用外部接口时出现错误，接口的响应状态码可能不为200，希望能够根据不同的http状态码执行不同的操作，这种情况下可以为接口开启手动处理Error，在异常分支下判断异常信息中的statusCode字段（http状态码），如下图所示。
+
+<img src="../assets/yichangchuli_202502081006_2.png" class="imgStyle" style="" />
+
+### 逻辑主动抛出异常
+
+开发者可以主动将逻辑输出参数的数据类型设置为包含异常的联合类型，当输出参数中包含异常类型时，在调用该逻辑时便可以在高级设置中开启“手动处理异常”，并使用匹配组件判断是否出现异常。
+
+主动抛出异常的逻辑如下图所示。可以使用新建组件选择Error相关类型，并自定义错误信息。
+
+<img src="../assets/yichangchuli_202412042115_6.png" class="imgStyle" style="" />
+
+调用上图的逻辑时，手动处理Error的使用方式与处理接口异常相同，异常分支下可以使用it变量代表异常信息，包含两个字段：
+
+- errorType：错误类型
+- errorMsg：异常提示信息
+
+<img src="../assets/yichangchuli_202412042115_7.png" class="imgStyle" style="" />
+
+### 实体逻辑捕获异常
+
+对于数据库可能会操作失败的场景，可手动处理实体逻辑的异常。
+
+使用方式同上，开启手动处理Error后使用匹配组件判断输出类型，在异常分支下执行数据库操作失败的自定义操作。
+
+<img src="../assets/yichangchuli_202412042115_8.png" class="imgStyle" style="" />
+
+| **实体异常类型**                 | **说明**                                                     |
+| -------------------------------- | ------------------------------------------------------------ |
+| SystemIllegalArgumentError       | 存在不符合系统规则的参数。                                   |
+| DatabaseDuplicateKeyError        | 执行插入或更新操作时，违反了数据库表的唯一约束（如主键、唯一索引），导致出现 “重复键” 错误。例如：向用户表插入一条已存在的用户ID时，会抛出此异常。 |
+| DatabaseConstraintViolationError | 执行数据库操作时，违反了表的非唯一约束（区别于上面的唯一键约束），例如：<br>- 外键约束：插入的记录引用了不存在的外键值；<br>- 非空约束：向定义为不为空的字段插入了NULL值； |
+
+### 依赖库逻辑捕获异常
+
+依赖库逻辑的异常使用姿势与上述场景相同，开启高级设置中的“手动”即可。但依赖库是否会抛出异常、抛出什么类型异常、异常时的错误信息，这些都由依赖库自身的代码决定。
+
+依赖库的开发者可以在标注为`@NaslLogic`的方法签名上`throws`异常，在应用IDE中便可以手动处理这个依赖库逻辑异常。
+
+### 异常的传递
+
+在使用匹配组件判断是否出现异常时，可以选择将异常传递给调用方，或者不向外传递而是在本逻辑中处理。
+
+- **不向外传递**：异常信息it变量不赋值给输出参数，当前逻辑的result中不包含异常类型。例如，在发生异常后，打印错误日志并使用中止组件结束执行过程。
+
+    <img src="../assets/yichangchuli_202412042115_9.png" class="imgStyle" style="" />
+
+- **向外传递**：让当前逻辑的result中也包含异常类型，在异常分支下将异常变量it赋值给输出参数，则其他逻辑中调用该逻辑时便可以手动处理Error。
+
+    <img src="../assets/yichangchuli_202412042115_10.png" class="imgStyle" style="" />
+
+### 捕获任意异常
+
+可以将逻辑的输出参数类型设为包含了Error类型的联合类型，便可以对该逻辑进行整体捕获异常。
+
+适用于以下情况：
+
+- 调用的逻辑组件没有返回值。
+- 调用的逻辑组件的返回值的类型中没有Error类型。
+- 希望直接对整个逻辑设置容错处理，而不是单独针对某个逻辑组件。
+
+示例：JSON反序列化的来源文本不一定符合json格式，该组件可能会失败，可以将JSON序列化单独包装成一个逻辑，逻辑的result中包含Error类型，在调用该逻辑时便可以判断是否调用成功。
+
+<img src="../assets/yichangchuli_202511181531_2.png" class="imgStyle" style="" />
+
+<img src="../assets/yichangchuli_202511181531_3.png" class="imgStyle" style="" />
+
+
+
+### 捕获不同类型的异常
+
+如果希望更精准地捕获到不同类型的服务端异常，可以在设置result类型时选择多种异常类型。
+
+例如，调用的服务端逻辑中可能会出现数组越界异常，也可能会有数据库约束异常，则result的数据类型可以设置为包含两种异常类型。
+
+<img src="../assets/yichangchuli_202412042115_16.png" class="imgStyle" style="" />
+
+调用该逻辑时便可以使用匹配组件判断输出结果的异常类型，根据不同的异常分支执行不同的操作。
+
+<img src="../assets/yichangchuli_202412042115_17.png" class="imgStyle" style="" />
+
+系统支持的异常类型如下图，在**数据IDE目录树>异常处理**下可以看到。
+
+<img src="../assets/yichangchuli_202412042115_18.png" class="imgStyle" style="width:350px;" />
+
+希望使用具体的异常类型时，可以从报错日志中确定所需的异常类型，如下图所示。**直接使用Error类型可以匹配到各类异常**。
+
+<img src="../assets/yichangchuli_202412042115_19.png" class="imgStyle" style="" />
+
+### 页面事件：调用服务端逻辑后
+
+在应用的页面IDE下预置了一个“调用服务端逻辑后”事件，开发者可在此逻辑上做修改，在页面调用服务端出现异常情况时执行特定的操作。
+
+预置的逻辑内容释义：
+
+- 如果页面调用服务端逻辑后存在异常，则输出控制台日志，并使用匹配组件判断异常类型，根据不同的异常执行不同的分支。
+
+  开发者可以自行定义不同异常分支下的行为，例如，当出现AuthUnAuthorizedError异常时，表示用户未登录，可以使其跳转到login登录页面。在匹配组件上可点击添加额外的异常类型。
+
+    <img src="../assets/yichangchuli_202412042115_20.png" class="imgStyle" style="" />
+
+- 如果未存在异常，则判断http状态码是否为200，如果不为200则弹出消息提示错误信息，并输出日志。开发者可自行修改非200时需要执行的操作。
+
+    <img src="../assets/yichangchuli_202412042115_21.png" class="imgStyle" style="" />
+
+## 补充说明
+
+### it变量的作用域
+
+当使用匹配组件判断是否出现异常时，如果异常分支下还有异常分支，则代表异常关键信息的it变量遵从就近原则，取值为最邻近匹配组件对应的异常信息，如下图所示。
+
+> 该特性为匹配组件的特性，关于匹配组件的更多介绍请参考文档[逻辑组件使用 - 分支](../40.逻辑组件使用/10.分支.md)
+
+<img src="../assets/yichangchuli_202412042115_22.png" class="imgStyle" style="" />
+
+### 输出参数为异常时无法开放为接口
+
+服务端逻辑的输出参数包含异常类型时，禁止开放为接口。如需开放接口则需要移除result的异常类型，可以在逻辑内部做好发生异常时的处理，避免异常向外传递。
+
+如果希望输出异常的同时也要开放接口，建议分为两个逻辑来实现相同的业务。
+
+<img src="../assets/yichangchuli_202412042115_23.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年11月18日</span>
+</div>