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/10./351/200/273/350/276/221IDE/15./351/200/273/350/276/221/345/210/206/347/261/273/60./347/263/273/347/273/237/351/200/273/350/276/221.md

@@ -0,0 +1,913 @@
+# 系统逻辑
+
+## 1. 功能概述
+
+系统逻辑是平台提供的一系列扩展功能，可使用「调用逻辑」组件进行调用。系统逻辑包含流程逻辑、浏览器、认证与权限、应用信息、国际化、事件逻辑和文件处理相关逻辑。这些逻辑提供了特定的功能和使用方式，可用于实现复杂的应用逻辑和交互行为。
+
+<img src="../assets/xitongluoji_202411271740_1.png" class="imgStyle" style="width:550px;" />
+
+在H5端、PC端，以及前端、服务端逻辑中，可调用的系统逻辑存在部分差异，如下：
+
+<table id="type1" style=" text-align: center;">
+    <tr>
+      <th></th>
+      <th style="width:650px;">前端可调用</th>
+      <th style="width:650px;">服务端可调用</th>
+    </tr>
+    <tr>
+      <td style="width:120px;">H5端</td>
+      <td><img src="../assets/xitongluoji_202411271740_2.png" class="imgStyle" style="width:450px;" /></td>
+      <td><img src="../assets/xitongluoji_202411271740_3.png" class="imgStyle" style="width:450px;" /></td>
+    </tr>
+    <tr>
+      <td>PC端</td>
+      <td><img src="../assets/xitongluoji_202411271740_4.png" class="imgStyle" style="width:450px;" /></td>
+      <td><img src="../assets/xitongluoji_202411271740_3.png" class="imgStyle" style="width:450px;" /></td>
+    </tr>
+</table>
+
+逻辑总览：
+
+<table id="type2" style="text-align: center;">
+    <tr>
+        <th style="width:120px;">分类</th>
+        <th style="width:150px;">适用端</th>
+        <th style="width:100px;">适用逻辑</th>
+        <th>名称</th>
+        <th>描述</th>
+    </tr>
+    <tr>
+        <td rowspan="8">浏览器</td>
+        <td rowspan="4">PC端、H5端</td>
+        <td rowspan="8">前端</td>
+        <td><a href="#requestfullscreen">requestFullscreen</a></td>
+        <td>开启浏览器全屏显示，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#exitfullscreen">exitFullscreen</a></td>
+        <td>关闭浏览器全屏显示，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#back">back</a></td>
+        <td>返回上一页，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#go">go</a></td>
+        <td>后退n页，无输出参数。</td>
+    </tr>
+    <tr>
+        <td rowspan="1">PC端</td>
+        <td><a href="#comparekeyboardinput">compareKeyboardInput</a></td>
+        <td>比较应用用户的键盘输入与目标键位是否一致。适用于键盘按下时（keyDown）或键盘松开（keyUp）事件逻辑。</td>
+    </tr>
+    <tr>
+        <td rowspan="3">H5端</td>
+        <td><a href="#getlsminiapp">getlsMiniApp</a></td>
+        <td>判断当前H5页面是否在微信小程序中。</td>
+    </tr>
+    <tr>
+        <td><a href="#getlocation">getLocation</a></td>
+        <td>用于获取当前位置信息。</td>
+    </tr>
+    <tr>
+        <td><a href="#getdistance">getDistance</a></td>
+        <td>计算两点之间的距离。</td>
+    </tr>
+    <tr>
+        <td rowspan="9">认证与权限</td>
+        <td rowspan="8">PC端、H5端</td>
+        <td rowspan="4">前端</td>
+        <td><a href="#hasauth">hasAuth</a></td>
+        <td>判断当前登录用户是否拥有该资源路径的访问权限。</td>
+    </tr>
+    <tr>
+        <td><a href="#logout">logout</a></td>
+        <td>退出当前登录状态，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#encryptbyaes">encryptByAES</a></td>
+        <td>将输入的字符串使用AES算法进行加密。</td>
+    </tr>
+    <tr>
+        <td><a href="#decryptbyaes">decryptByAES</a></td>
+        <td>对加密的字符串使用AES算法进行解密。</td>
+    </tr>
+    <tr>
+        <td rowspan="4">服务端</td>
+        <td><a href="#getcurrentuser">getCurrentUser</a></td>
+        <td>获取当前登录应用用户信息，需在登录后使用。</td>
+    </tr>
+    <tr>
+        <td><a href="#generateuserid">generateUserId</a></td>
+        <td>根据Md5算法生成用户唯一标识。</td>
+    </tr>
+    <tr>
+        <td><a href="#validatepassword">validatePassword</a></td>
+        <td>使用Bcrypt算法校验明文密码与密文是否匹配。</td>
+    </tr>
+    <tr>
+        <td><a href="#encryptpassword">encryptPassword</a></td>
+        <td>将输入的字符串使用Bcrypt算法进行加密，输入的字符串通常特指密码。</td>
+    </tr>
+    <tr>
+        <td rowspan="1">PC端</td>
+        <td rowspan="1">前端</td>
+        <td><a href="#getuserlist">getUserList</a></td>
+        <td>根据输入参数筛选当前应用用户，适用于2.20版本前租户公有用户认证应用的前端逻辑。</td>
+    </tr>
+    <tr>
+        <td rowspan="2">应用信息</td>
+        <td rowspan="2">PC端、H5端</td>
+        <td rowspan="1">服务端</td>
+        <td><a href="#getcustomconfig">getCustomConfig</a></td>
+        <td>获取配置管理中参数名称对应的取值，开发环境和生产环境支持配置不同的值。</td>
+    </tr>
+    <tr>
+        <td rowspan="1">前端</td>
+        <td><a href="#getcurrentip">getCurrentIp</a></td>
+        <td>获取当前登录用户IP地址。</td>
+    </tr>
+    <tr>
+        <td rowspan="3">国际化</td>
+        <td rowspan="3">PC端、H5端</td>
+        <td rowspan="3">前端</td>
+        <td><a href="#getuserlanguage">getUserLanguage</a></td>
+        <td>获取用户浏览器语言。</td>
+    </tr>
+    <tr>
+        <td><a href="#getl18nlist">getL18nList</a></td>
+        <td>获取已配置的多语言列表。通常，在启用国际化的应用中，如果需要向终端用户提供可选的语言列表，可以调用此逻辑以获取完整的可选语言列表。</td>
+    </tr>
+    <tr>
+        <td><a href="#setl18nlocale">setL18nLocale</a></td>
+        <td>切换语言。当语言环境发生切换时，必须通过调用此方法来通知系统修改全局语言，当触发此方法的调用时，系统会自动切换应用语言为目标语言且刷新整个页面。</td>
+    </tr>
+    <tr>
+        <td rowspan="2">事件逻辑</td>
+        <td rowspan="2">PC端</td>
+        <td rowspan="2">前端</td>
+        <td><a href="#preventdefault">preventDefault</a></td>
+        <td>阻止浏览器默认行为，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#stoppropagation">stopPropagation</a></td>
+        <td>阻止事件向上传递，无输出参数。</td>
+    </tr>
+    <tr>
+        <td rowspan="2">文件处理</td>
+        <td rowspan="2">PC端、H5端</td>
+        <td rowspan="2">前端</td>
+        <td><a href="#downloadfile">downloadFile</a></td>
+        <td>下载单个文件。</td>
+    </tr>
+    <tr>
+        <td><a href="#downloadfiles">downloadFiles</a></td>
+        <td>下载多个文件并打包为zip压缩包。</td>
+    </tr>
+    <tr>
+        <td rowspan="10">微信</td>
+        <td rowspan="10">H5端</br>（微信小程序）</td>
+        <td rowspan="10">前端</td>
+        <td><a href="#navigatetolocation">navigateToLocation</a></td>
+        <td>跳转到微信定位页面，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#navigatetoscancode">navigateToScanCode</a></td>
+        <td>跳转到微信扫一扫页面，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#navigatetouserphone">navigateToUserPhone</a></td>
+        <td>跳转到微信手机号获取页面，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#navigatetouserinfo">navigateToUserinfo</a></td>
+        <td>跳转到微信昵称头像获取页面，无输出参数。</td>
+    </tr>
+    <tr>
+        <td><a href="#getwechatscancode">getWeChatScanCode</a></td>
+        <td>获取微信二维码内容。</td>
+    </tr>
+    <tr>
+        <td><a href="#getwechatlocation">getWeChatLocation</a></td>
+        <td>获取微信定位。</td>
+    </tr>
+    <tr>
+        <td><a href="#getwechatheadimg">getWeChatHeadimg</a></td>
+        <td>获取微信头像。</td>
+    </tr>
+    <tr>
+        <td><a href="#getwechatphone">getWeChatPhone</a></td>
+        <td>获取微信手机号。</td>
+    </tr>
+    <tr>
+        <td><a href="#getwechatnickname">getWeChatNickName</a></td>
+        <td>获取微信昵称。</td>
+    </tr>
+    <tr>
+        <td><a href="#getwechatopenid">getWeChatOpenid</a></td>
+        <td>获取微信openid。</td>
+    </tr>
+</table>
+
+## 2. 功能介绍
+
+### 2.1 流程逻辑
+
+**逻辑概述**
+
+流程逻辑用于执行流程相关的操作，例如查询所有流程定义、根据条件查询任务实例、执行审批操作等。具体各流程逻辑的接口文档请参考：[流程2.0 - 流程逻辑使用说明](../../../../20.应用开发/20.流程设计/20.流程2.0/70.流程逻辑使用说明.md)。
+
+<img src="../assets/liuchengluojishiyongshuoming_202407221002_1.png" class="imgStyle" style="width:450px;" />
+
+### 2.2 浏览器
+
+#### requestFullscreen
+
+**逻辑概述**
+
+开启浏览器全屏显示。当触发该逻辑时，应用程序的界面将切换到全屏模式，填满整个屏幕，隐藏浏览器的地址栏、工具栏和其他界面元素。无输入、输出参数，适用于PC端应用的前端逻辑。
+
+**使用场景**
+
+用于需要最大化视觉空间的应用场景，如媒体播放、演示文稿或游戏等。
+
+<img src="../assets/xitongluoji_202411271740_7.png" class="imgStyle" style="" />
+
+#### exitFullscreen
+
+**逻辑概述**
+
+关闭浏览器全屏显示。当触发该逻辑时，应用程序将从全屏模式返回到正常的窗口模式，恢复浏览器的地址栏、工具栏和其他界面元素的显示。无输入、输出参数，适用于PC端应用的前端逻辑。
+
+<img src="../assets/xitongluoji_202411271740_8.png" class="imgStyle" style="" />
+
+#### compareKeyboardInput
+
+**逻辑概述**
+
+比较应用用户的键盘输入与目标键位是否一致。适用于PC端应用的键盘按下时（keyDown）或键盘松开（keyUp）事件逻辑。
+
+**使用场景**
+
+可以用来检测应用用户是否按下特定的功能键，然后根据不同的键盘输入执行不同的逻辑。它可以与其他逻辑和条件结合使用，用于创建自定义的键盘快捷方式、或定制化的用户交互功能。
+
+<img src="../assets/xitongluoji_202411271740_9.png" class="imgStyle" style="" />
+
+**输入参数**
+
+- keyboardEvent：keyDown或者keyUp事件的event参数。
+
+<img src="../assets/xitongluoji_202411271740_10.png" class="imgStyle" style="" />
+
+- target：目标键位，直接通过键盘输入。
+
+**输出参数**
+
+输出参数为Boolean布尔类型，若应用用户的键盘输入与目标键位一致输出true，否则输出false。
+
+<img src="../assets/xitongluoji_202411271740_11.png" class="imgStyle" style="" />
+
+#### back
+
+**逻辑概述**
+
+实现返回上一页的功能操作。无输入输出参数，适用于PC、H5端应用的前端逻辑。当用户希望回到刚刚浏览过的上一个页面内容时，就可以通过调用此逻辑来实现页面回退操作。
+
+<img src="../assets/xitongluoji_202411271740_12.png" class="imgStyle" style="" />
+
+注意：在[发布为微信小程序](../../../../30.应用生命周期管理/050.应用发布与访问/20.H5应用发布为微信小程序.md)的应用中，仅在逻辑分支中使用[跳转页面](../../40.逻辑组件使用/35.语句.md)组件跳转的页面支持使用back逻辑回退至上个页面。
+
+<img src="../assets/xitongluoji_202411271740_13.png" class="imgStyle" style="" />
+
+#### go
+
+**逻辑概述**
+
+实现根据指定的页数进行前进或后退页面。无输出参数，适用于 PC、H5 端应用的前端逻辑。
+
+**使用场景**
+
+用于一些需要精准控制页面前进或回退步数的应用场景，例如，在电子书籍阅读应用中，用户可能在快速翻阅多页内容后，想要回到前面某一章节开头的几页位置，便可以利用该逻辑并设置准确的后退页数来实现。
+
+**输入参数**
+
+- delta：指定需要前进或后退的页数，Integer 整数类型。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为 Integer 整数的表达式。此参数为非必填参数，当参数未填写时，则默认执行后退一页的操作。若填写的数值为正数，则表示在 PC、H5 端前进相应的页数；若填写的数值为负数，则表示后退相应的绝对值的页数。例如，填写 “3” 表示在 PC、H5 端前进 3 页，填写 “-2” 表示后退 2 页。在[微信小程序](../../../../30.应用生命周期管理/050.应用发布与访问/20.H5应用发布为微信小程序.md)中，由于仅支持后退操作，填写正整数时逻辑不生效。
+
+<img src="../assets/xitongluoji_202411271740_14.png" class="imgStyle" style="" />
+
+getlsMiniApp
+
+**逻辑概述**
+
+判断当前H5页面是否在微信小程序中。无输入参数，适用于H5端应用的前端逻辑。
+
+**输出参数** 
+
+输出参数为Boolean布尔类型。获取[Openid](#getwechatopenid)和[昵称](#getwechatnickname)[头像](#getwechatheadimg)时，调用该逻辑，输出 true 时，则表示在小程序中访问，输出为 false 则为普通浏览器访问。如果不在小程序中访问，可以给出其他的处理方式或提示。
+
+<img src="../assets/xitongluoji_202411271740_15.png" class="imgStyle" style="" />
+
+#### getLocation
+
+**逻辑概述**
+
+用于获取当前位置信息。无输入参数，适用于H5端应用的前端逻辑。
+
+**使用场景**
+
+在周边商家推荐、附近活动推送等应用场景中，可通过获取用户位置，可以向用户展示附近的商家、活动场所等信息。
+
+**输出参数**
+
+输出参数为 String类型，代表的是地理位置的经纬度数值。输出参数示例：114.1516,22.2477
+
+<img src="../assets/xitongluoji_202411271740_16.png" class="imgStyle" style="" />
+
+#### getDistance
+
+**逻辑概述**
+
+计算两点之间的距离。适用于H5端应用的前端逻辑。
+
+**输入参数**
+
+- Point1 ：经纬度坐标，String类型。例如，坐标（45.7597,126.6336），经度为 126.6336，纬度为 45.7597，通常用来精确地定位地球上的一个位置。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+- Point2 ：经纬度坐标，String类型。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+
+**输出参数**
+
+输出Decimal 小数类型的计算结果。当输入参数中的经纬度地区坐标不存在时，输出参数为NaN。
+
+输出参数示例：1566229.9890244962
+
+<img src="../assets/xitongluoji_202411271740_17.png" class="imgStyle" style="" />
+
+### 2.3 认证与权限
+
+#### hasAuth
+
+**逻辑概述**
+
+判断当前登录用户是否拥有该资源路径的访问权限，适用于PC、H5端应用的前端逻辑。
+
+**输入参数**
+
+- authPath：指定完整的资源路径，String类型，如/dashboard/test。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+
+**输出参数**
+
+输出参数为Boolean布尔类型，若拥有该资源路径的访问权限输出true，否则输出false。
+
+<img src="../assets/xitongluoji_202411271740_18.png" class="imgStyle" style="" />
+
+#### logout
+
+**逻辑概述**
+
+退出当前登录状态，无输入、输出参数。适用于PC、H5端应用的前端逻辑。
+
+具体应用详情请参考：[如何退出当前登录状态](../../../../80.常见场景案例/50.逻辑场景/70.如何退出当前登录状态.md)
+
+<img src="../assets/xitongluoji_202411271740_19.png" class="imgStyle" style="" />
+
+#### encryptByAES
+
+**逻辑概述**
+
+将输入的字符串使用AES算法进行加密，适用于PC、H5端应用的前端逻辑。
+
+<details>
+    <summary title="点击查看 什么是ASE算法">
+         点击查看 什么是ASE算法
+    </summary>
+
+ASE是一种对称加密算法。ASE算法具有以下特点：
+
+对称加密：ASE算法使用相同的密钥进行加密和解密，因此加密和解密的过程都采用相同的算法。对称加密简化了算法的实现和使用，但也要求密钥的安全性得到保护。
+
+ASE算法被广泛用于保护敏感数据的传输和存储，例如加密通信、数据库加密。
+
+</details>
+
+**输入参数**
+
+- string：指定需要加密的字符串，String类型。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+
+**输出参数**
+
+输出参数为一个加密后的字符串，即一个经过AES加密算法处理的密文。例如，当输入参数string，即input局部变量内容为“12345678”时，输出结果为“gxFUdROEgCJNA7AreDvP8A==”。
+
+<img src="../assets/xitongluoji_202411271740_20.png" class="imgStyle" style="" />
+
+#### decryptByAES
+
+**逻辑概述**
+
+对加密的字符串使用AES算法进行解密，适用于PC、H5端应用的前端逻辑。
+
+**输入参数**
+
+- string：指定需要解密的字符串，String类型。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+
+**输出参数**
+
+输出参数为一个解密后的字符串，即原始明文。例如，当输入参数string，即input局部变量内容为“gxFUdROEgCJNA7AreDvP8A==”时，输出结果为“12345678”。
+
+<img src="../assets/xitongluoji_202411271740_21.png" class="imgStyle" style="" />
+
+#### getCurrentUser
+
+**逻辑概述**
+
+获取当前登录应用用户信息，需在登录后使用，无输入参数，适用于服务端逻辑。
+
+**输出参数**
+
+输出参数为一个包含当前登录应用用户信息的数据，类型为平台自带的认证与权限数据类型LCAPCurrentUserInfo。
+
+<img src="../assets/xitongluoji_202411271740_22.png" class="imgStyle" style="" />
+
+输出参数示例：
+
+```json
+LCAPCurrentUserInfo {
+    status: "Normal",
+    nickName: "DEVACC-jy",
+    userName: "DEVACC-jy",
+    email: （空）,
+    userId: "30708c9d4dfcaf5226503f21ea64dc7f",
+    phone: （空）,
+    createTime: 1698308001000,
+    updateTime: 1698308001000,
+    source: "Normal"
+}
+```
+
+#### generateUserId
+
+根据Md5算法生成用户唯一标识，适用于服务端逻辑。
+
+<details>
+    <summary title="点击查看：什么是Md5算法？">
+         点击查看：什么是Md5算法？
+    </summary>
+
+Md5是一种常用的哈希算法，用于将任意长度的信息转换为固定长度的哈希值。Md5算法具有以下特点：
+
+1.  不可逆性：无法通过哈希值反推出原始数据。
+2.  唯一性：不同的输入数据会产生不同的哈希值，且相同的输入数据始终会产生相同的哈希值。
+3.  快速性：计算速度相对较快。
+
+Md5作为一种较弱的哈希算法，容易受到攻击，因此不推荐用于存储密码或敏感数据的加密。在实际应用中，Md5算法可以用于验证文件完整性、生成校验码等非安全性要求的场景。
+
+</details>
+
+**输入参数**
+
+- userName：指定需要生成唯一标识的用户名，String类型。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+- source：认证源，String类型。非必填，但影响逻辑的输出结果。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+
+**输出参数**
+
+输出参数为一个加密后的字符串，即一个经过Md5加密算法处理的密文。
+
+<img src="../assets/xitongluoji_202411271740_23.png" class="imgStyle" style="" />
+
+#### validatePassword
+
+**逻辑概述**
+
+使用Bcrypt算法校验明文密码与密文是否匹配，适用于服务端逻辑。
+
+**输入参数**
+
+- plainText：明文密码，String类型。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+- hashedText：经过Bcrypt加密算法处理的密文，一般指储存在数据库的密文密码，String类型。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+
+**输出参数**
+
+输出参数为一个明文密码与密文是否匹配的判断结果，Boolean类型。通常用于判断用户输入密码是否正确。
+
+<img src="../assets/xitongluoji_202411271740_24.png" class="imgStyle" style="" />
+
+#### encryptPassword
+
+**逻辑概述**
+
+将输入的字符串使用Bcrypt算法进行加密，输入的字符串通常特指密码，适用于服务端逻辑。
+
+<details>
+    <summary title="点击查看：什么是Bcrypt算法？">
+         点击查看：什么是Bcrypt算法？
+    </summary>
+
+Bcrypt是一种密码哈希算法，它使用随机盐和可配置的迭代次数来加密密码，并且对常见的密码攻击具有较高的抵抗力。Bcrypt算法具有以下特点：
+
+1.  盐值：每个密码哈希都使用不同的盐值，这样即使两个用户使用相同的密码，其哈希值也会不同，增加了猜测哈希值的难度。
+2.  自包含：Bcrypt哈希值中包含了盐值等信息，因此在验证密码时不需要额外的存储空间。
+
+Bcrypt作为一种安全性和灵活性兼备的哈希算法，被广泛用于密码存储和认证系统。
+
+</details>
+
+**输入参数**
+
+- password：指定需要加密的明文密码，String类型。参数插槽中可以放置变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+
+**输出参数**
+
+输出参数为一个加密后的随机字符串，即一个经过Bcrypt加密算法处理的密文。
+
+<img src="../assets/xitongluoji_202411271740_25.png" class="imgStyle" style="" />
+
+### 2.4 应用信息
+
+#### getCustomConfig
+
+**逻辑概述**
+
+获取配置管理中参数名称对应的取值，开发环境和生产环境支持配置不同的值。
+
+<img src="../assets/xitongluoji_202411271740_26.png" class="imgStyle" style="" />
+
+<img src="../assets/xitongluoji_202502201527_1.png" class="imgStyle" style="" />
+
+**输入参数**
+
+- name：应用配置管理中参数名称。
+
+**输出参数**
+
+输出参数为自定义参数配置的开发或生产环境取值，String类型。（发布开发环境时使用的是开发环境取值，发布生产环境时使用的是生产环境取值。）
+
+示例：
+
+<img src="../assets/xitongluoji_202502201527_2.png" class="imgStyle" style="" />
+
+<img src="../assets/xitongluoji_202502201527_3.png" class="imgStyle" style="" />
+
+#### getCurrentIp
+
+**逻辑概述**
+
+获取当前登录用户IP地址，无输入参数，适用于PC、H5端应用的前端逻辑。
+
+**输出参数**
+
+输出参数为当前登录用户的IP地址，String类型。
+
+<img src="../assets/xitongluoji_202411271740_32.png" class="imgStyle" style="" />
+
+### 2.5 国际化
+
+> 国际化的逻辑仅适用于前端逻辑。具体应用详情请参考[国际化多语言](../../../../20.应用开发/60.可视化开发界面/70.更多设置/50.国际化多语言.md)。
+
+#### getUserLanguage
+
+**逻辑概述**
+
+获取用户浏览器语言。开发者可以利用此逻辑，根据终端用户的浏览器默认语言友好地提供不同的语言环境，为用户提供最合适的语言。无输入参数，适用于PC、H5端应用的前端逻辑。
+
+**输出参数**
+
+输出参数为当前浏览器的默认语言，String类型，例如"zh-CN"。
+
+<img src="../assets/xitongluoji_202411271740_33.png" class="imgStyle" style="" />
+
+#### getL18nList
+
+**逻辑概述**
+
+获取已配置的多语言列表。通常，在启用国际化的应用中，如果需要向终端用户提供可选的语言列表，可以调用此逻辑以获取完整的可选语言列表。无输入参数，适用于PC、H5端应用的前端逻辑。
+
+**输出参数**
+
+输出参数为获取到的应用中已经设置的多语言列表，类型为List<{id: String 文本,name: String 文本,title: String文本}>
+
+<img src="../assets/xitongluoji_202411271740_34.png" class="imgStyle" style="" />
+
+输出参数示例：
+
+```json
+[
+{
+        id: "zh-CN", // 语言ID，标准国际语言编码
+        name: "中文 (简体)", // 语言自称
+        title: "中文(简体)" // 语言中文名称
+    },{
+    id："en-US",
+    name："English (United States)",
+    title："英语（美国）",
+}
+]
+```
+
+#### setL18nLocale
+
+**逻辑概述**
+
+切换语言。当语言环境发生切换时，必须通过调用此方法来通知系统修改全局语言，当触发此方法的调用时，系统会自动切换应用语言为目标语言且刷新整个页面。无输入参数，适用于PC、H5端应用的前端逻辑。
+
+**输入参数**
+
+- locale：用户选择的语言，入参类型为字符串，例如“zh-CN”，即上方获取已配置的多语言列表逻辑中的 id。
+
+<img src="../assets/xitongluoji_202411271740_35.png" class="imgStyle" style="" />
+
+### 2.6 事件逻辑
+
+事件逻辑仅在PC端组件部分事件逻辑内部使用「[调用逻辑](../../40.逻辑组件使用/25.调用.md)」组件时可见。
+
+#### preventDefault
+
+**逻辑概述**
+
+阻止浏览器默认行为，无输入、输出参数。适用于PC端应用的点击、双击、鼠标按下、鼠标移入、鼠标移出、右键点击、键盘按下（keyDown）、键盘松开（keyUp）等事件逻辑。
+
+<img src="../assets/xitongluoji_202411271740_36.png" class="imgStyle" style="" />
+
+<details>
+    <summary title="点击查看：什么是浏览器的默认行为？">
+         点击查看：什么是浏览器的默认行为？
+    </summary>
+
+浏览器的默认行为是指在特定的交互情况下，浏览器自动执行的操作，旨在提供一致的体验和标准化的交互行为。然而，根据特定需求，可能需要定制交互行为或避免与默认行为产生冲突。为了实现需求定制或冲突解决，可以在相应的事件逻辑中调用preventDefault 来阻止浏览器的默认行为。这可以控制交互行为的细节，以满足特定需求。
+
+以下是一些常见的浏览器默认行为示例：
+
+1.  键盘事件（Keyboard Events）：
+
+    - 按下空格键会导致页面向下滚动。
+    - Ctrl+C会触发复制操作。
+    - Ctrl+V会触发粘贴操作。
+
+2.  鼠标事件（Mouse Events）：
+
+    - 点击链接时，浏览器会加载链接指向的 URL，并跳转到相应的页面。
+    - 在大多数浏览器中，右键点击页面会弹出上下文菜单，其中包含一些常用的操作选项。
+  
+**使用示例**
+
+阻止链接的右键点击浏览器默认行为。
+
+**实现思路**：
+
+页面已有两个普通链接，阻止其中一个链接的右键点击的浏览器默认动作，另一个作为参照不做任何处理。
+
+<img src="../assets/xitongluoji_202411271740_37.png" class="imgStyle" style="" />
+
+操作步骤：
+
+1.  选中需阻止浏览器的默认动作的链接，并添加右键点击事件
+
+    <img src="../assets/xitongluoji_202411271740_38.png" class="imgStyle" style="" />
+
+2.  编辑需阻止浏览器的默认动作链接的右键点击事件逻辑
+
+    拖入调用逻辑组件选择preventDefault ，用于阻止链接右键点击的浏览器默认行为。
+
+    拖入弹出消息组件，消息内容填入“以阻止浏览器的默认动作！”，用于标识该链接已阻止浏览器的默认动作。
+
+    <img src="../assets/xitongluoji_202411271740_39.png" class="imgStyle" style="" />
+
+3.  发布预览并查看效果。
+
+    <img src="../assets/xitongluoji_202411271740_40.gif" class="imgStyle" style="" />
+
+</details>
+
+
+#### stopPropagation
+
+**逻辑概述**
+
+阻止事件向上传递，无输入、输出参数。适用于PC端应用的点击、双击、鼠标按下、鼠标移入、鼠标移出、右键点击、键盘按下（keyDown）、键盘松开（keyUp）等事件逻辑。
+
+具体应用详情请参考：[如何阻止事件向上传递](../../../../80.常见场景案例/50.逻辑场景/80.如何阻止事件向上传递.md)。
+
+<img src="../assets/xitongluoji_202411271740_41.png" class="imgStyle" style="" />
+
+### 2.7 文件处理
+
+#### downloadFile
+
+**逻辑概述**
+
+下载单个文件，无输入参数，适用于PC、H5端应用的前端逻辑。
+
+**输入参数**
+
+- url：文件地址，String类型。参数插槽中可以放置文本、变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+  注意：输入参数url不能包含中文字符，若包含会报错400。
+  <img src="../assets/xitongluoji_202411271740_43.png" class="imgStyle" style="" />
+- fileName：文件名称，String类型。参数插槽中可以放置文本、变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+
+<img src="../assets/xitongluoji_202411271740_42.png" class="imgStyle" style="" />
+
+
+#### downloadFiles
+
+**逻辑概述**
+
+下载多个文件并打包为zip压缩包，无输出参数，适用于PC、H5端应用的前端逻辑。
+
+**输入参数**
+
+- fileName：压缩包名称，String类型。参数插槽中可以放置文本、变量、逻辑、接口、内置函数等返回值为String类型的表达式。
+- urlList：各文件地址集合， List类型。参数插槽中可以放置文本、变量、逻辑、接口、内置函数等返回值为List类型的表达式。
+
+<img src="../assets/xitongluoji_202411271740_44.png" class="imgStyle" style="" />
+
+### 2.8 微信
+
+在微信相关的开发或应用场景中可调用的逻辑，适用于设置了[发布为微信小程序](../../../../30.应用生命周期管理/050.应用发布与访问/20.H5应用发布为微信小程序.md)的应用前端逻辑。
+
+<img src="../assets/xitongluoji_202411271740_45.png" class="imgStyle" style="" />
+
+#### navigateToLocation
+
+**逻辑概述**
+
+跳转到微信“获取位置信息”页面（该页面为微信小程序原生页面）。无输入、输出参数，适用于H5端应用的前端逻辑。
+
+**示例**
+
+在“查看当前位置”按钮点击事件中调用该逻辑，可实现点击按钮后跳转至为微信“获取位置信息”页面。
+
+<img src="../assets/xitongluoji_202411271740_46.png" class="imgStyle" style="" />
+
+实现效果：
+
+<img src="../assets/xitongluoji_202411271740_47.gif" class="imgStyle" style="width:300px;" />
+
+#### navigateToScanCode
+
+**逻辑概述**
+
+跳转到微信“扫一扫”页面（该页面为微信小程序原生页面），用于扫描各类二维码。无输入、输出参数，适用于H5端应用的前端逻辑。
+
+**示例**
+
+在“扫一扫”按钮点击事件中调用该逻辑，可实现点击按钮后跳转至为微信“扫一扫”页面。
+
+<img src="../assets/xitongluoji_202411271740_48.png" class="imgStyle" style="" />
+
+实现效果：
+
+<img src="../assets/xitongluoji_202411271740_49.gif" class="imgStyle" style="width:300px;" />
+
+#### navigateToUserPhone
+
+**逻辑概述**
+
+跳转到微信手机号获取页面（该页面为微信小程序原生页面）。无输入、输出参数，适用于H5端应用的前端逻辑。
+
+**使用场景**
+
+可在需要用户手机号进行业务操作，如注册、登录、身份验证等场景中使用，通过微信获取手机号可以提高用户操作的便捷性，减少用户手动输入的麻烦，但需注意获取手机号的权限和用户隐私问题。
+
+**示例**
+
+在“跳转到微信手机号获取页面”按钮点击事件中调用该逻辑，可实现点击按钮后跳转至为微信“获取手机号”页面。
+
+<img src="../assets/xitongluoji_202411271740_50.png" class="imgStyle" style="" />
+
+实现效果：
+
+<img src="../assets/xitongluoji_202411271740_51.gif" class="imgStyle" style="width:300px;" />
+
+#### navigateToUserinfo
+
+**逻辑概述**
+
+跳转到微信昵称头像获取页面（该页面为微信小程序原生页面）。无输入、输出参数，适用于H5端应用的前端逻辑。
+
+<img src="../assets/xitongluoji_202411271740_52.png" class="imgStyle" style="" />
+
+**使用场景**
+
+在社交分享类 H5 应用中，用户可以直接使用微信昵称和头像进行个性化的分享和互动。
+
+**示例**
+
+以获取微信头像昵称场景为例，需要在微信用户信息页获取。
+
+注意：获取微信头像昵称需要本应用中任意一个未开启权限控制的页面上的存在一个文件上传组件，如本案例在demo页面放置了一个文件上传组件。
+
+<img src="../assets/xitongluoji_202411271740_53.png" class="imgStyle" style="" />
+
+操作步骤：
+
+1.  唤起微信用户信息页：在前端逻辑中，如个人信息页点击头像时，可以设置点击事件，在点击事件中调用系统逻辑 navigateToUserInfo。
+
+    <img src="../assets/xitongluoji_202411271740_54.png" class="imgStyle" style="" />
+
+2.  在页面进入时事件逻辑中，使用[getWeChatHeadImg](#getwechatheadimg)和[getWeChatNickName](#getwechatnickname)获得数据。
+
+    <img src="../assets/xitongluoji_202411271740_55.png" class="imgStyle" style="" />
+
+3.  更改用户名称及头像图片动态绑定地址为进入页面时获取的微信昵称和头像。
+
+    <img src="../assets/xitongluoji_202411271740_56.png" class="imgStyle" style="" />
+
+实现效果：
+
+<img src="../assets/xitongluoji_202411271740_57.gif" class="imgStyle" style="width:300px;" />
+
+#### getWeChatScanCode
+
+**逻辑概述**
+
+在调用[navigateToScanCode](#navigatetoscancode)逻辑，扫描二维码后，调用该逻辑可获取，通过[扫一扫](#navigatetoscancode)操作扫描的微信二维码内容，其中可能是网址、文字、数字等二维码支持存储的信息。无输入参数，适用于H5端应用的前端逻辑。
+
+**输出参数**
+
+输出参数为String文本类型。
+
+<img src="../assets/xitongluoji_202411271740_58.png" class="imgStyle" style="" />
+
+#### getWeChatLocation
+
+**逻辑概述**
+
+获取微信用户当前的定位信息。无输入参数，适用于H5端应用的前端逻辑。
+
+**输出参数**
+
+输出参数为String文本类型，包含用户的经度和纬度等位置信息。
+
+输出参数示例：30.190884,120.192727
+
+<img src="../assets/xitongluoji_202411271740_59.png" class="imgStyle" style="" />
+
+#### getWeChatHeadimg
+
+**逻辑概述**
+
+获取微信头像url，无输入参数，适用于H5端应用的前端逻辑。
+
+**输出参数**
+
+输出参数为String文本类型。
+
+<img src="../assets/xitongluoji_202411271740_60.png" class="imgStyle" style="" />
+
+#### getWeChatPhone
+
+**逻辑概述**
+
+获取微信绑定的手机号，无输入参数，适用于H5端应用的前端逻辑。
+
+**输出参数**
+
+输出参数为String文本类型。
+
+<img src="../assets/xitongluoji_202411271740_61.png" class="imgStyle" style="" />
+
+#### getWeChatNickName
+
+**逻辑概述**
+
+获取微信的昵称，无输入参数，适用于H5端应用的前端逻辑。
+
+**输出参数**
+
+输出参数为String文本类型。
+
+<img src="../assets/xitongluoji_202411271740_62.png" class="imgStyle" style="" />
+
+#### getWeChatOpenid
+
+**逻辑概述**
+
+获取微信 openid，微信用户在小程序场景下的唯一标识。通过 openid，可以实现用户身份的识别和数据的关联，为用户提供个性化的服务和数据管理。
+
+**输出参数**
+
+输出参数为String文本类型，即用户的微信 openid。
+
+<img src="../assets/xitongluoji_202411271740_63.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年02月20日</span>
+</div>
+
+<style>
+
+#type1 tr:nth-child(2n),
+#type2 tr:nth-child(2n) {
+background: rgba(255, 255, 255, 0.5);
+}
+
+#type2 tr td:nth-last-child(-n + 2) {
+    background-color: rgba(255, 255, 255, 0.5); /* 设置默认背景色 */
+}
+
+#type2 tr:nth-child(even) td:nth-last-child(-n + 2) {
+    background-color: #f6f8fa; /* 设置偶数行最后一列的斑马色 */
+}
+
+</style>