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/05./346/225/260/346/215/256/345/273/272/346/250/241/05./346/225/260/346/215/256IDE/344/273/213/347/273/215.md

@@ -0,0 +1,221 @@
+# 数据IDE介绍
+
+## 1. 功能概述
+
+数据IDE是对应用数据展示以及对自定义数据编辑的主要界面。以下操作通常在数据IDE界面执行：
+
+* 配置数据源
+* 创建实体、数据结构、枚举等自定义数据类型
+* 编辑实体、数据结构、枚举等自定义数据类型
+* 创建实体并批量导入实体数据
+* 检测实体结构与数据库是否同步
+* 查看导入的依赖库的配置信息
+
+![](../assets/sjide_update1.png)
+
+## 2. 功能介绍
+
+### 2.1 功能入口
+
+进入IDE界面后，单击界面最左侧的“**数据**”按钮即可进入数据IDE。
+
+![](../assets/sjide_update2.png)
+
+### 2.2 数据列表
+
+对数据进行分类管理，包括自定义类型，依赖库，页面组件，认证与权限，异常处理，基础类型和集合类型。
+
+#### 2.2.1 数据的分类
+
+* 自定义类型：支持自定义添加数据，包括实体、数据结构、枚举。
+* 依赖库：应用自动生成，罗列当前应用已导入的依赖库。
+* 页面组件：应用自动生成，罗列当前应用中组件的参数列表。具体说明请参考下文补充说明。
+* 认证与权限：应用自动生成，罗列用于认证与权限操作的数据，包含当前登录用户数据。
+* 异常处理：应用自动生成，罗列应用所支持的异常处理类型，包含Error。
+* 基础类型：应用自动生成，罗列应用所支持的基本数据类型，包含Boolean、Integer、Decimal、String、Date、Time、DateTime。
+* 集合类型：应用自动生成，罗列应用所支持的集合类型，包含`List<T>`和`Map<K,V>`。
+
+#### 2.2.2 数据的使用场景
+
+* 定义变量的数据类型。
+
+  <img src="../assets/sjide_update3.png" style="width:350px;" />
+* 定义数据属性的数据类型。
+
+  <img src="../assets/sjide_update4.png" style="width:350px;" />
+
+### 2.3 数据编辑区
+
+查看或编辑数据的详细信息。
+
+![](../assets/sjide_update5.png)
+
+### 2.4 数据属性区
+
+查看或编辑数据的属性信息。
+
+![](../assets/sjide_update6.png)
+
+## 3. 补充说明
+
+### 页面组件（类型）
+
+页面组件的参数具体说明如下：
+
+#### Current\<T>
+
+当前行的数据。参数属性如下：
+
+<img src="../assets/sjIDE_new6.png" style="width:350px;" />
+
+* item：当前数据的对象，即Current中的T。
+* index：当前数据的索引。
+* rowIndex：当前数据的行索引。
+* columnIndex：当前数据的列索引。
+* value：当前数据的值。
+
+使用场景：获取数据表格组件当前行的数据。
+
+相关文档：[如何使用懒加载实现树状表格展示](../../80.常见场景案例/40.组件场景/20.表格场景/100.如何使用懒加载实现树状表格展示.md)
+
+#### DataSourceParams
+
+组件调用前端逻辑作为组件的数据源时，前端逻辑的传参。参数属性如下：
+
+<img src="../assets/sjIDE_new7.png" style="width:350px;" />
+
+* page：组件开启“分页”时，分页的当前页数。
+* size：组件开启“分页”时，每页记录数据数量。
+* sort：组件开启“排序”时，排序的属性。
+* order：组件开启“排序”时，排序的顺序。
+* filterText：组件开启“筛选”时，筛选的内容。
+
+使用场景：在页面中创建页面逻辑并将页面逻辑作为数据源时，作为页面逻辑的入参。
+
+#### ValidateResult
+
+验证事件的参数。参数属性如下：
+
+<img src="../assets/shujuIDEjieshao_202409201039_1.png" style="width:350px;" />
+
+* rawValue：用户输入的原始值。
+* value：验证修复的值。
+* trigger：验证的触发方式。
+* muted：验证后是否无提示。
+* valid：验证是否通过。
+* touched：用户是否触碰。
+* dirty：用户是否修改值。
+* firstError：第一个错误的提示信息。
+
+使用场景：
+
+* 使用验证器组件，触发验证后事件、失焦验证通过后事件、失焦验证不通过后事件时，作为事件的入参。
+* 使用表单组件，触发验证后事件时，作为事件的入参。
+* 使用数字输入组件，触发验证时事件时，作为事件的入参。
+* 调用表单组件或验证器组件的组件逻辑validate时，作为调用逻辑的出参。
+
+相关文档：[表单](../10.页面设计/20.PC端Vue2组件说明（默认）/60.表单/010.表单.md)、[验证器](../10.页面设计/20.PC端Vue2组件说明（默认）/60.表单/160.验证器.md)、[验证规则](../10.页面设计/35.验证规则.md)
+
+#### Poilnfo
+
+地理位置上的特定点（POI）的参数。参数属性如下：
+
+<img src="../assets/sjIDE_new9.png" style="width:350px;" />
+
+* source：信息来源。
+* id：POI点的id。
+* name：POI点的名称。
+* location：POI点的经纬度。
+* address：POI点的地址。
+
+使用场景：使用扩展组件中的地图选点组件，触发选择后事件时，作为事件的入参。
+
+#### File
+
+上传文件的参数。参数属性如下：
+
+<img src="../assets/sjIDE_new10.png" style="width:350px;" />
+
+* status：文件上传的状态。
+* url：文件的链接。
+* name：文件的名称。
+* size：文件的大小。
+* type：文件的类型。
+
+使用场景：使用文件上传组件上传文件后，作为文件信息的参数。
+
+相关文档：[文件上传](../10.页面设计/20.PC端Vue2组件说明（默认）/60.表单/158.文件上传.md)
+
+#### HttpCookie
+
+请求头中Cookie字段的信息，参数属性如下：
+
+<img src="../assets/sjIDE_new11.png" style="width:350px;" />
+
+* name：Cookie的名称。
+* value：存储在Cookie中的具体信息。
+* domain：指定Cookie可以发送到哪个域名下的服务器。
+* cookiePath：指定Cookie可以发送到哪个路径下的服务器。
+* sameSite：指定跨站点请求是否发送Cookie，支持填写Strict（严格模式）、Lax（宽松模式）、Null（无）。
+* httpOnly：指示浏览器是否禁止通过JavaScript脚本访问Cookie。
+* secure：指示浏览器是否仅在使用HTTPS安全连接时才发送Cookie。
+* maxAge：指定Cookie的有效期，单位为秒。
+
+#### HttpResponse\<T>
+
+HTTP响应信息，参数属性如下：
+
+<img src="../assets/sjIDE_new12.png" style="width:350px;" />
+
+* status：返回的状态码。例如200、400、500。
+* body：返回的响应体，即HttpResponse中的T。
+* headers：返回的响应头。
+* cookies：返回的Cookie。
+
+使用场景：在服务端逻辑中，使用服务端全局变量httpResponse向客户端写cookie。
+
+<img src="../assets/sjIDE_new13.png" style="width:600px;" />
+
+#### HttpRequest\<T>
+
+HTTP请求信息，参数属性如下：
+
+<img src="../assets/shujuidejieshao_0207_1.png" style="width:350px;" />
+
+* requestURL：请求的URL。
+* remotelp：发起请求的客户端的IP地址。
+* requestMethod：请求方法。例如POST、GET、DELETE、PUT等。
+* body：请求体。即HttpRequest中的T。
+* headers：请求头。
+* pathParams：路径参数。
+* queryParams：查询参数。
+* cookies：请求cookie。
+
+使用场景：在服务端逻辑中，使用服务端全局变量httpRespose获取请求header参数。
+
+<img src="../assets/shujuidejieshao_0207_2.png" style="width:600px;" />
+
+### 国际化（类型）
+
+#### i18nEnum
+
+枚举类型，在应用实现国际化多语言时会用到该类型。
+
+<img src="../assets/shujuIDEjieshoa_202409051924_1.png" class="imgStyle" style="width:350px;" />
+
+使用示例：公共变量中的i18nInfo.currentLocale为以上枚举类型，代表了系统当前语言，可使用匹配组件判断该变量的枚举值，根据不同的语言做不同的逻辑处理。
+
+<img src="../assets/guojihuaduoyuyan_0108_29.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 异常处理（类型）
+
+系统内置了一些列的异常类型，需要结合[异常处理](../15.逻辑功能实现/45.逻辑编辑/85.异常处理.md)功能使用。
+
+<img src="../assets/yichangchuli_202412042115_18.png" class="imgStyle" style="width:350px;" />
+
+<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年04月23日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/05./346/225/260/346/215/256/345/273/272/346/250/241/10./345/217/230/351/207/217.md

@@ -0,0 +1,154 @@
+# 变量
+
+## 功能概述
+
+变量是用于存储数据并在程序执行期间代表可变的值，在CodeWave平台中，变量有下列几种出现形式：
+
+- 作为逻辑的输入参数
+- 作为逻辑的输出参数
+- 作为逻辑的局部变量
+- 页面变量
+- 作为页面的输入参数
+- 前端全局变量
+- 服务端全局变量
+- 公共变量
+- 作为ForEach、Filter 等组件的一种特殊组成成分
+
+无论哪一种，变量名都必须满足如下规则：只允许使用字母、数字、下划线，且必须以字母开头，最大长度63个字符。无论哪一种，都可以为变量添加至多 255 个字符的描述。
+
+## 变量的不同出现形式
+
+### 作为逻辑的输入参数
+
+逻辑的输入参数用于调用逻辑时传递参数，如下图logic1逻辑有两个输入参数，调用该逻辑时需要提供实际参数值。
+
+<img src="../assets/bianliang_0613_1.png" class="imgStyle" style="width: 600px;" />
+
+添加逻辑的输入参数：在页面逻辑/服务端逻辑上单击右键或点击右侧纵点，在弹出的菜单中选择“添加输入参数”，即可创建一个输入参数变量。
+
+<img src="../assets/bianliang_0613_2.png" class="imgStyle" style="width: 400px;" />
+
+逻辑的输入参数具有以下规则：
+
+- 必须为输入参数指定一个数据类型，默认的数据类型是String。
+- 支持设置默认值，数据类型为Date、Time、DateTime时，分别使用时间选择、时间选择、日期选择器选择，其他数据类型可编辑表达式进行设置。
+- 逻辑的输入参数可在整个逻辑的内部引用，在逻辑外部不可被引用。
+
+### 作为逻辑的输出参数
+
+逻辑需要向调用方返回一个值时，便需要定义逻辑的输出参数。如下图logic1逻辑有Date类型输出参数，则调用该逻辑时可以接收返回的值。
+
+<img src="../assets/bianliang_0613_3.png" class="imgStyle" style="width: 600px;" />
+
+添加逻辑的输出参数：在页面逻辑/服务端逻辑上单击右键或点击右侧纵点，在弹出的菜单中选择“添加输出参数”，即可创建输出参数变量。
+
+<img src="../assets/bianliang_0613_4.png" class="imgStyle" style="width: 400px;" />
+
+逻辑的输出参数具有以下规则：
+
+- 可以指定变量的数据类型，也可以留空让系统自动推断类型。
+- 支持设置默认值，数据类型为Date、Time、DateTime时，分别使用时间选择、时间选择、日期选择器选择，其他数据类型可编辑表达式进行设置。
+- 逻辑的输出参数可在整个逻辑的内部引用，在逻辑外部不可被引用。
+
+### 作为逻辑的局部变量
+
+在一个值需要被多次用到或者经过复杂的步骤算出时，通常会使用局部变量来存储这个值。例如定义一个叫sum的局部变量，来承接一个求和结果。逻辑局部变量的规则与作为输出参数的变量的规则相同。
+
+添加逻辑的局部变量：在页面逻辑/页面事件逻辑/服务端逻辑上单击右键或点击右侧纵点，在弹出的菜单中选择“添加局部变量”，即可创建一个局部变量。
+
+<img src="../assets/bianliang_0613_5.png" class="imgStyle" style="width: 400px;" />
+
+### 页面变量
+
+页面变量是一种局部变量，规则与逻辑局部变量的规则相同，但它在页面中、页面逻辑、页面事件逻辑中都可以使用。
+
+目前页面变量在（当前页面的）子页面中不可用。
+
+添加页面变量：选择页面单击右键或点击右侧纵点，在弹出的菜单中选择“添加局部变量”。
+
+<img src="../assets/bianliang_0613_6.png" class="imgStyle" style="width: 400px;" />
+
+### 作为页面的输入参数
+
+页面的输入参数也是一种页面局部变量，添加之后可在跳转该页面时传递实际的参数值。
+
+如下图所示，A页面添加了输入参数name，在跳转A页面时可以传递实际的name参数值。
+
+<img src="../assets/bianliang_0613_7.png" class="imgStyle" style="width: 600px;" />
+
+注意：页面输入参数的数据类型只允许使用基础数据类型。
+
+### 前端全局变量
+
+前端全局变量的规则与页面变量的规则相同，但它在整个前端都可见，包括页面、页面逻辑、事件逻辑、子页面、子页面逻辑、子页面事件逻辑。
+
+前端全局变量可开启本地缓存，数据将缓存在本地浏览器中。
+
+详细使用说明请参考：[前端全局变量](../../20.应用开发/10.页面设计/50.前端全局变量.md)
+
+添加方式：在页面目录树下找到前端全局变量分组，点击加号或菜单项即可添加。
+
+<img src="../assets/bianliang_0613_8.png" class="imgStyle" style="width: 400px;" />
+
+### 服务端全局变量
+
+可以在不同的服务端逻辑中使用，通常用于存储需要在多个逻辑之间共享的数据。通过服务端全局变量还可以可读写网络请求信息（Request）和响应信息（Respose）。
+
+详细使用说明请参考：[服务端全局变量](../../20.应用开发/15.逻辑功能实现/90.服务端全局变量.md)
+
+添加方式：在逻辑目录树下找到服务端全局变量分组，点击加号或菜单项即可添加。
+
+<img src="../assets/bianliang_0613_9.png" class="imgStyle" style="width: 400px;" />
+
+### 公共变量
+
+公共变量在整个前端都可见，存储了一些公共信息。
+
+<img src="../assets/bianliang_0613_10.png" class="imgStyle" style="width: 800px;" />
+
+目前提供两个公共变量：
+
+#### userInfo
+
+存放当前登录的用户信息，详细使用说明可参考：[如何获取当前登录的用户信息](../../80.常见场景案例/80.业务场景/096.如何获取当前登录的用户信息.md)。
+
+#### i18Local
+
+存放当前页面的语言环境，页面使用到国际化多语言功能时可能会使用该变量。详细使用说明可参考：[国际化多语言 - 公共变量：获取系统记录的语言](../../20.应用开发/60.可视化开发界面/70.更多设置/50.国际化多语言.md)
+
+### 作为组件的特殊组成成分
+
+如下图所示，ForEach 逻辑组件会引入每一项item和索引index两个变量，它们仅可在该循环体中使用。
+
+<img src="../assets/bianliang_0613_11.png" class="imgStyle" style="width: 600px;" />
+
+部分“List 内置函数”会引入代表 list 每一项的item变量，部分“Map 内置函数”会引入代表 map 每一项键值对的key、value两个变量。
+
+<img src="../assets/bianliang_0613_12.png" class="imgStyle" style="width: 600px;" />
+
+表格类组件会引入代表每个单元格的current变量。
+
+<img src="../assets/bianliang_0613_13.png" class="imgStyle" style="" />
+
+## 变量的数据类型与推断规则
+
+变量的数据类型可以从所有平台支持的类型中选择，或让系统自动推断其类型。
+
+- **手动选择数据类型**：
+
+  选中变量后，可在右侧属性面板中选择数据类型，勾选多个时为联合类型。关于数据类型的介绍可参考文档：[数据类型](../../20.应用开发/05.数据建模/35.数据类型.md)。
+
+  <img src="../assets/bianliang_0613_14.png" class="imgStyle" style="width: 400px;" />
+
+- **系统自动推断**：
+
+  变量被赋值时，赋值号右侧表达式的类型即为变量的类型。如下图所示，variable1变量未设置数据类型，将Integer类型数据赋值给variable1后，系统自动推断它的类型为Integer。
+
+  <img src="../assets/bianliang_0613_15.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);">2024年06月13日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/05./346/225/260/346/215/256/345/273/272/346/250/241/20./345/256/236/344/275/223/010./345/256/236/344/275/223/344/273/213/347/273/215.md

@@ -0,0 +1,79 @@
+# 实体介绍 4.0
+
+## 1. 实体核心概念
+
+在Codewave平台中，实体是构建应用程序与数据库交互的核心概念。实体代表了业务中的具体对象或概念，比如教师、学生、班级、学科等，每个实体对应着数据库中的一张表。实体的属性是指描述实体特征的数据字段，例如“学生”实体有姓名、性别、年龄、所属班级等属性，实体的属性对应着数据库表的列。
+
+通过创建实体，开发者可以轻松定义数据库表的结构，无需掌握复杂的数据库语言和技术。在应用发布后，数据库中会创建与实体相对应的表，在应用中可以对实体进行新增数据、删除数据、修改数据，查询数据，本质上就是对数据库表的增删改查。
+
+以下是关于CodeWave平台中实体功能的系统化总结，旨在帮助开发者高效理解和使用该功能：
+
+**定义**：
+
+- 实体 = 数据库表，代表业务对象（如教师、学生、课程）
+- 属性 = 表字段（如学生实体的姓名、年龄、班级）
+
+**核心价值**：
+
+- 零SQL操作：通过可视化配置实现数据库表管理
+- 快速开发：自动生成实体逻辑，减少重复逻辑
+
+<img src="../assets/shitijieshao40_202505201350_1.png" class="imgStyle" style="" />
+
+## 2. 实体创建方式
+
+| 创建途径    | 适用场景               | 优势       |
+| :------ | :----------------- | :------- |
+| IDE手动创建 | 全新业务对象设计           | 灵活定义字段类型 |
+| 数据源导入   | 已有数据库迁移            | 自动映射表结构  |
+| SQL文件导入 | 数据库管理员（DBA）提供表结构脚本 | 保留完整约束条件 |
+| Excel导入 | 业务部门提供的初始数据        | 自动推断字段类型 |
+
+<img src="../assets/shitijieshao40_202505201350_2.png" class="imgStyle" style="" />
+
+## 3. 实体属性配置
+
+在属性层面，实体包含系统属性与自定义属性。系统属性如记录主键的id、标记创建与更新时间的createdTime和updatedTime等，是保障数据完整性与可追溯性的关键；而自定义属性则能充分满足多样化的业务需求，实现对实体特征的深度拓展。关于属性的分类、配置以及更多特性，可在[实体属性](http://111)详解中深入探索。
+
+<figure style="text-align: center;">
+<img src="../assets/shitijieshao40_202505201350_3.png" class="imgStyle" style="" />
+<figcaption>
+<p>实体属性分类</p>
+</figcaption>
+</figure>
+
+<figure style="text-align: center;">
+<img src="../assets/shitijieshao40_202505201350_4.png" class="imgStyle" style="" />
+<figcaption>
+<p>用户与角色关联实体</p>
+</figcaption>
+</figure>
+
+## 4. 实体关系建模
+
+| 关系类型 | 数据库表现   | 示例            |
+| :--- | :------ | :------------ |
+| 一对一  | 外键+唯一约束 | 用户 ↔ 身份证      |
+| 一对多  | 外键      | 班级 → 学生（1:N） |
+| 多对多  | 中间关联表   | 学生 ↔ 课程（选课系统） |
+
+可视化工具：实体关系图自动生成ER图，支持拖拽调整
+
+<img src="../assets/shitijieshao40_202505201350_5.png" class="imgStyle" style="" />
+
+## 5. 典型应用场景
+
+快速页面生成-[拖拽实体生成页面组件](../../05.数据建模/20.实体/040.实体应用场景.md)
+
+- 列表页（带分页/筛选）
+- 详情页（字段自动布局）
+- 表单页（包含校验规则）
+
+<img src="../assets/shitijieshao40_202505201350_6.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年05月20日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/05./346/225/260/346/215/256/345/273/272/346/250/241/20./345/256/236/344/275/223/020./345/256/236/344/275/223/345/210/233/345/273/272/346/226/271/345/274/217.md

@@ -0,0 +1,166 @@
+# 实体创建方式
+
+## 1. 概述
+
+实体的创建分为以下四种方式：
+  
+| 创建途径    | 适用场景               | 优势       |
+| :------ | :----------------- | :------- |
+| IDE手动创建 | 全新业务对象设计           | 灵活定义字段类型 |
+| 数据源导入   | 已有数据库迁移            | 自动映射表结构  |
+| SQL文件导入 | 数据库管理员（DBA）提供表结构脚本 | 保留完整约束条件 |
+| Excel导入 | 业务部门提供的初始数据        | 自动推断字段类型 |
+
+<img src="../assets/shitijieshao40_202505201350_2.png" class="imgStyle" style="" />
+
+## 2. 创建方式
+
+### 方式一：在IDE中创建
+
+1. 打开**数据模块**。
+
+   <img src="../assets/shiti_v333_2.png" alt="image" style="Width:350px;" />
+2. 单击图示红框按钮或右键单击数据源选择**添加实体**，或直接点击“**+**”按钮。点击数据源右侧“+”按钮时在对应数据源下生成实体，点击右上方蓝色“**+**”时在默认数据源下生成实体。
+
+   <img src="../assets/shiti_v333_3.png" alt="image" style="Width:350px;" />
+3. 填写合法的实体名。建议规范实体的命名规则，有利于数据表的理解和查询。
+
+### 方式二：从数据源导入
+
+当需要根据数据库中已存在的表或视图来反向生成实体时，可参考以下步骤操作。
+
+> 如果是从视图生成实体，或者导入的数据库表没有主键，则生成的实体会存在一些限制，请参考下文的补充说明：数据库视图导入生成实体、无主键的表导入生成实体。
+
+1. 打开**数据模块**。
+
+   <img src="../assets/shiti_v333_4.png" alt="image" style="width:350px;" />
+2. 单击图示红框按钮或右键单击数据源选择**从数据源导入**。
+
+   <img src="../assets/shiti_v333_5.png" alt="image" style="width:350px;" />
+3. 在弹出窗口中选择导入环境，开发环境或生产环境，单击**下一步**。
+
+   <img src="../assets/shiti_v333_6.png" alt="image" style="width:350px;" />
+4. 选择需要导入的表，并编辑“生成实体的名称”，完成编辑后，单击**下一步**。
+
+   > 注意：导入的表需要有主键才能生成实体，否则实体会创建失败。
+   >
+
+   <img src="../assets/shiti_v333_7.png" alt="image" style="width:400px;" />
+5. 系统根据已有数据库表自动生成实体属性及属性类型，非主键属性类型支持修改。确认无误后，单击**导入**。
+
+   > 一些列类型会以相同的属性类型承接，如数据库中的 Integer、bigint(20) 都以 Integer整数来承接。
+   >
+
+   <img src="../assets/shiti_v333_8.png" alt="image" style="width:600px;" />
+6. 导入完成自动生成实体，且带有从数据源导入实体的标识。
+
+   <img src="../assets/shiti_20240821_2.png" alt="image" style="width:350px;" />
+
+### 方式三：从SQL文件导入
+
+1. 打开**数据模块**。
+
+   <img src="../assets/shiti_v333_10.png" alt="image" style="width:350px;" />
+2. 单击图示红框按钮或右键单击数据源选择**从SQL文件导入**。
+
+   <img src="../assets/shiti_v333_11.png" alt="image" style="width:350px;" />
+3. 选择 SQL 类型并上传SQL文件，平台支持 MySQL、Oracle、达梦、Db2 等类型的 SQL。
+
+   <img src="../assets/shiti_v333_12.png" alt="image" style="width:500px;" />
+4. 确定后自动创建对应的实体，实体默认在**默认数据源**中创建。
+
+**注意事项**：
+
+- 从SQL文件导入实体时会根据文件中对应的数据库表创建实体，但不会导入数据库表中的数据。
+- 不支持SQL文件中无主键的表导入生成实体。
+- SQL文件中只允许导入建表语句，不支持添加字段、删除字段、修改字段类型。
+- SQL文件中要创建的表已存在时，对应的实体会生成失败，请在IDE中编辑实体或者删除实体后重新导入SQL文件。
+
+### 方式四：从Excel文件导入
+
+1. 打开**数据模块**。
+
+   <img src="../assets/shiti_v333_13.png" alt="image" style="width:350px;" />
+2. 单击图示红框按钮或右键单击数据源选择**从Excel文件导入**。
+
+   <img src="../assets/shiti_v333_14.png" alt="image" style="width:350px;" />
+3. 阅读 Excel 文件导入相关限制说明，单击**继续导入**。
+    <div v-pre>
+    <details>
+    <summary title="点击查看Excel文件导入限制">
+        点击查看Excel文件导入限制
+    </summary>
+
+    示例如下：
+
+    <img src="../assets/shiti_202503030956_1.svg" alt="image" style="width:600px;" />
+
+    - Excel 文件需要为xlsx格式，至少包含一个工作表（sheet页）；
+    - Excel 文件的第一行应包含列标题，随后的行应包含要加载的数据；
+    - 列标题定义必须从 Excel 工作表的 A1 单元格开始，标题不能重复；
+    - 列标题必须以字母开头，并且仅包含大小写字母、下划线，不能包含其他特殊字符；
+    - 列标题不能和平台限制的关键字相同，具体关键字列表请查看[帮助文档](../../../94.常见问题解答/47.平台关键字说明.md)；
+    - Excel 文件必须未加密才能正确导入；
+    - 导入的Excel文件的大小≤10M，sheet数量限制≤20个。
+
+    </details>
+    </div>
+
+4. 在弹出框中选择对应的 Excel 文件，单击打开。
+5. 在弹出框中选择对应的 Sheet 页，并编辑"**生成实体的名称**"，编辑完成后，单击**下一步**。
+
+   <img src="../assets/shiti_v333_15.png" alt="image" style="width:400px;" />
+6. 系统会自动解析相关列的数据类型，若解析有误，请修改相关列的数据类型，检视无误后，单击**导入**。
+
+   > 如果在导入时没有勾选主键，应用将自动生成id作为该实体的主键。
+   >
+
+   <img src="../assets/shiti_v333_16.png" alt="image" style="width:550px;" />
+7. 导入后自动创建对应的实体，同时Excel表格中的数据将同步至开发环境中实体对应数据库表中。实体默认在**默认数据源**中创建。
+
+## 3. 特殊处理方案
+
+### 数据库视图导入生成实体
+
+平台3.10版本开始支持导入数据库视图生成实体，操作方式与导入普通表生成实体相同。
+
+操作步骤：
+
+- 右击数据源或者单击数据源的纵点，选择“从数据源导入”。
+
+  <img src="../assets/shiti_20240822_1.png" class="imgStyle" style="width:400px;" />
+
+- 弹窗中展示的表包括普通表和视图，勾选所需的视图，点击下一步即可。
+
+  <img src="../assets/shiti_20240822_2.png" class="imgStyle" style="width:400px;" />
+
+- 系统会根据视图的属性自动生成实体属性及属性类型，属性类型支持修改。确认无误后，单击导入。
+
+  <img src="../assets/shiti_20240822_3.png" class="imgStyle" style="width:600px;" />
+
+视图生成的实体需要注意以下几点：
+
+- 视图生成的实体只允许查询，不提供实体逻辑，无法调用get、create、update、delete等逻辑，无法使用实体的import（使用文件上传组件导入实体数据）。
+- 不支持拖拽视图实体生成页面组件。
+- 不允许新增、修改、删除视图实体的属性和索引。
+- 实体的属性名/属性类型需要与视图的字段名/字段类型保持一致。
+- 如果数据库视图被删除或重命名，发布应用时会报错，不会根据已有的实体生成数据库视图，必须先在数据库中创建同名同属性的视图后再进行发布。
+- 含有视图实体的模板创建出的应用，需要确保数据源中存在对应的数据库视图，否则会发布失败。
+
+### 无主键的表导入生成实体
+
+平台3.10版本开始支持导入无主键的表生成实体，操作方式与导入普通表生成实体相同。
+
+无主键实体需要注意以下几点：
+
+- 不支持拖拽实体生成页面组件。
+- 仅支持四种实体逻辑：create、updateBy、deleteBy、batchCreate。由于没有主键id，所以不支持一些依赖于id的实体逻辑，例如get、update、batchUpdate、delete、batchDelete、createOrUpdate、import。
+
+<img src="../assets/shiti_20240822_4.png" class="imgStyle" style="width:400px;" />
+
+<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月11日</span>
+</div>