codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/30./345/272/224/347/224/250/347/224/237/345/221/275/345/221/250/346/234/237/347/256/241/347/220/206/112./345/272/224/347/224/250/345/256/241/350/256/241/346/227/245/345/277/227.md

@@ -0,0 +1,136 @@
+# 应用审计日志
+
+## 功能概述
+
+为满足企业级安全审计需求，平台支持应用审计日志能力，针对应用开发全流程进行详细记录，可以精准地了解到`哪个用户在什么时间对应用执行了什么操作`。
+
+支持按操作人、时间区间、IP地址、操作类型等多维度精准查询。日志涵盖了页面、实体、逻辑、等全方位的的编辑操作，以及应用发布、权限调整等操作，详细记录具体变更内容，助力企业轻松应对内部审计，快速定位数据变更源头，保障应用开发过程的可追溯性与安全性。
+
+<img src="../assets/yingyongshenjirizhi_202508272038_1.png" class="imgStyle" style="" />
+
+## 功能介绍
+
+### 功能入口权限
+
+功能入口位于“应用详情 > 审计日志”，如果没有找到审计日志的入口，则说明当前登录用户没有查看这个应用的审计日志的权限，需要应用的管理员在应用授权中赋予对应的权限，权限开启方式如下。
+
+1. 应用管理员在应用详情的基本信息页签下点击“授权开发”。
+
+    <img src="../assets/yingyongshenjirizhi_202508272038_2.png" class="imgStyle" style="" />
+
+2. 将没有权限的用户添加到开启了“查看操作日志”权限的角色下，admin角色默认开启了该权限，developer角色默认未开启该权限，可以编辑角色的权限来激活操作日志入口。
+
+    <img src="../assets/yingyongshenjirizhi_202508272038_3.png" class="imgStyle" style="" />
+
+### 参数说明
+
+可通过各类条件筛选操作记录，操作记录各字段释义：
+
+- 操作时间：应用代码（NASL）的变更时间，不是指制品应用源代码更新时间。
+- 操作人：执行该操作的平台用户。
+- 客户端IP：执行该操作时的IP地址。
+- 结果：操作是否执行成功。
+- 操作描述：由系统自动生成，如“实体改名”、“删除逻辑”。
+- 查看快照：点击可下载变更的NASL数据文件。
+
+<img src="../assets/yingyongshenjirizhi_202508272038_4.png" class="imgStyle" style="" />
+
+### 日志记录范围
+
+应用会被记录到日志中的操作分为两大类：
+
+- 应用开发：指在IDE内对应用代码所执行的各类操作，例如对页面、逻辑、流程、配置的各类变更操作以及发布与导出部署等。
+- 应用管理：指在IDE外部对应用执行的管理操作，例如编辑应用信息、编辑应用角色、启停应用等。
+
+包括但不限于以下清单中的操作，由于应用开发中的操作较多，此处未列举完整。
+
+<table>
+  <thead>
+    <tr>
+      <th></th>
+      <th>操作分类</th>
+      <th>具体操作</th>
+    </tr>
+  </thead>
+  <tbody>
+    <!-- 应用开发 -->
+    <tr>
+      <td rowspan="10">应用开发</td>
+      <td rowspan="4">应用数据编辑</td>
+      <td>操作页面</td>
+    </tr>
+    <tr>
+      <td>操作服务端逻辑</td>
+    </tr>
+    <tr>
+      <td>操作数据（实体/数据结构/枚举）</td>
+    </tr>
+    <tr>
+      <td>操作连接器</td>
+    </tr>
+    <tr>
+      <td rowspan="6">应用发布及配置</td>
+      <td>修改偏好设置</td>
+    </tr>
+    <tr>
+      <td>修改应用配置</td>
+    </tr>
+    <tr>
+      <td>发布应用</td>
+    </tr>
+    <tr>
+      <td>导出应用</td>
+    </tr>
+    <tr>
+      <td>远程部署</td>
+    </tr>
+    <tr>
+      <td>发布为依赖库、局部模板、应用模板</td>
+    </tr>
+    <!-- 应用管理 -->
+    <tr>
+      <td rowspan="9">应用管理</td>
+      <td rowspan="7">应用管理</td>
+      <td>应用的创建、编辑、删除</td>
+    </tr>
+    <tr>
+      <td>新增备份、还原备份、删除备份</td>
+    </tr>
+    <tr>
+      <td>启用应用、停用应用、重启应用</td>
+    </tr>
+    <tr>
+      <td>修改副本数</td>
+    </tr>
+    <tr>
+      <td>修改数据库白名单</td>
+    </tr>
+    <tr>
+      <td>修改地图组件参数</td>
+    </tr>
+    <tr>
+      <td>应用角色的新建、删除、编辑</td>
+    </tr>
+    <tr>
+      <td rowspan="2">应用权限授权</td>
+      <td>应用角色添加用户、移除用户</td>
+    </tr>
+    <tr>
+      <td>应用角色编辑权限</td>
+    </tr>
+  </tbody>
+</table>
+
+
+### 日志清理规则
+
+由于“应用开发”类日志数量较多，系统会自动清理开发类日志，只保留最多7天的开发类操作日志。
+
+应用管理类日志不会自动清理。
+
+<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年08月27日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/30./345/272/224/347/224/250/347/224/237/345/221/275/345/221/250/346/234/237/347/256/241/347/220/206/120./345/244/232/344/272/272/345/215/217/344/275/234/345/274/200/345/217/221/10./345/244/232/344/272/272/345/215/217/344/275/234/346/246/202/345/277/265/344/273/213/347/273/215.md

@@ -0,0 +1,165 @@
+# 多人协作概念介绍
+
+## 1. 功能概述
+
+CodeWave智能开发平台提供多人协作功能，可满足团队多人同时开发同一应用的需求。多人协作的全过程都是以可视化的方式进行操作，无论是使用过git或svn的用户，还是没有多人协作开发经验的新手，都可以直接快速上手进行协作开发。
+
+多人协作功能具备以下特点：
+
+- **强大的副本管理**: 每个开发者在自己独立的副本应用上进行并行开发，避免相互干扰。
+- **灵活的分支管理**: 开发者可依据不同的特性或定制化需求快捷的创建和管理子分支。
+- **组件级别合并**: 开发过程中可以基于精细化的组件级别进代码合并，确保形成一个功能齐全的主应用。
+- **应用全生命周期管理**: 通过CodeWave的多人协作功能，可以覆盖一个应用从开发阶段、上线阶段到运维阶段的全生命周期管理。
+
+## 2. 使用场景
+
+在面对大型复杂项目或紧急项目时，多人协作开发已成为一种必要的工程实践，常用于以下场景：
+
+- **大型项目**: 单个开发者难以承担全部任务，需要团队的力量合作完成。
+- **紧急项目**: 项目时间比较紧急时，多人协作能够加快开发进度，确保项目的准时交付。
+- **复杂项目**: 不同的功能模块可能需要不同领域的专家来协同完成。
+- **提高应用质量**: 通过团队成员之间的代码审查和反馈，可以提高应用质量、减少潜在问题。
+
+## 3. 名词解释
+
+- **副本应用**：为确保协作者之间的操作互不影响，平台支持为应用创建副本应用，让每个协作者拥有独立的工作空间，每个副本应用都有独享的数据源。协作者创建副本应用时，可从主应用选择一个分支，创建副本后会拉取该分支上的代码。
+
+  <img src="../assets/duorenxiezuogainianjieshao_1.png" alt="0" style="width:400px" />
+- **分支**：是指从主干分支派生出来的一个独立的开发路径，可以在该分支上独立开发，不会影响主干分支和其他分支。在分支中，开发者可以在不影响主干分支和其他分支的情况下进行实验性的开发，尝试新的功能、修复 bug 等等。当开发者认为新的分支已经足够稳定时，可以将其合并回主干分支，将各个协作者的工作整合到一起。
+
+  <img src="../assets/duorenxiezuogainianjieshao_2.png" alt="0" style="width:400px" />
+
+使用CodeWave的多分支管理功能，可以实现CodeWave应用的多分支并行开发，包括但不限于以下需求场景：
+
+- 需要多个迭代版本并行开发的场景。例如6月版本未开发完毕即要开启7月版本进行开发，可通过对每个迭代版本创建发布分支实现。
+- 需要缺陷修复与功能开发独立的场景。例如应用正在进行新功能开发但新功能开发未完成，此时线上环境发现缺陷需要修复，但又不能把未完成的功能发布到线上，可通过创建独立的缺陷修复分支实现。
+- 需要多个定制版本共存的场景。例如相同的应用为多个客户开发了各自的定制版本，可通过创建多个定制分支实现。
+
+## 4. 视频教程
+
+<video controls style="width:90%;">
+  <source src="https://video.nos.lcap.163yun.com/tutorial/%E5%AD%A6%E4%B9%A0%E4%B8%AD%E5%BF%83%E8%A7%86%E9%A2%91/3.x%E4%B8%93%E9%A2%98%E8%AF%BE%E7%A8%8B/%E5%A4%9A%E4%BA%BA%E5%8D%8F%E4%BD%9C%E4%B8%93%E9%A2%98.mp4">
+</video>
+
+## 5. 推荐使用方案
+
+### 阶段1：产品从0-1开发
+
+项目在刚开始开发时，并不存在线上稳定版本的代码运行问题，往往只需要考虑一个代码主分支，多位开发者在一个主分支上协作开发，进行推送/拉取/合并。
+
+![](../assets/duorenxiezuogainianjieshao_3.png)
+
+### 阶段2：产品已上线
+
+当软件的1.0版本开发完成上线后，后续有了新的项目需求，就需要针对这个项目创建一个专门的开发分支，开发者在这个开发分支上继续进行协作开发和测试，和在主分支上的协作模式类似，分支开发完成后合并到主分支上。
+
+使用分支进行开发有以下作用：
+
+- 确保主分支的代码质量。新项目开发的过程代码肯定是无法持续保证质量了，必须要在开发分支上完成开发和测试验证，才可以合并回主分支。
+- 确保线上产品的运维和新功能开发可以并行。当应用已经在线上运行，可能发现bug需要紧急修复，此时可以直接在主分支上快速的修复bug，而不受到其他分支的影响。
+- 如果有多个项目需要并行开发，还可以再从主分支上拉取不同的项目开发分支，以确保多项目的并行开发，且代码相互隔离，互不影响。
+
+这也是目前大型互联网公司主流的协作开发模式。
+
+![](../assets/duorenxiezuogainianjieshao_4.png)
+
+当开发分支上包含多个需求需要并行开发时，可以基于开发分支再创建子分支，功能开发完成后依次合并到开发分支和主分支上，与传统高代码的分支开发方式一样。
+
+![](../assets/duorenxiezuogainianjieshao_202503041847_1.png)
+
+### 阶段3：产品多版本并行
+
+当产品发展到一定阶段，可能需要面向不同客户交付不能兼容的功能，这些情况在前期不可预知，架构设计上难以覆盖，最终产品可能会被分化成多个不同的客户定制版本。
+
+在CodeWave平台中可以将应用导出为模板，并基于模版创建新的应用。通过模版，一个应用就可以复制成多个隔离的应用，以满足不同定制版本的软件长期升级与维护。
+
+![](../assets/duorenxiezuogainianjieshao_5.png)
+
+## 6. 协作流程
+
+### 6.1 协作流程图
+
+假设现有一个项目需要两位开发者协同开发完成，可参考以下开发流程。
+
+<img src="../assets/duorenxiezuogainianjieshao_6.png" style="max-width:450px" />
+
+### 6.2 开发设计阶段
+
+在应用开发之前应做好架构设计，防止后续出现BUG和返工。对于CodeWave多人协作应用开发而言，开发设计阶段应注意以下几点：
+
+- **做好数据建模**：开发之前一定要先做好数据建模，确定项目所涉及的实体和数据结构，类同于传统开发中的确认底层数据结构和表结构。建议提前在主应用中做好数据建模，特别是团队成员共同要使用的部分，以确保后续协作开发过程中所有开发者都可以在相同的实体和数据结构上进行开发，减少后续在数据结构层的冲突，避免开发过程中过于频繁的进行表结构变更。
+- **高内聚和低耦合的功能模块划分**：功能模块在设计时应符合高内聚低耦合的原则，边界清晰，方便团队成员理解和修改应用，有利于后续升级维护。
+- **人员分工职责清晰**：为避免解决冲突时可能出错，最好的冲突解决方案就是预防冲突，可以将功能模块清晰的指派到具体人员，协作者以页面为维度进行各自功能的开发，避免多人开发一个页面的情况，以降低CodeWave平台冲突概率，减少解决冲突的工作。
+
+### 6.3 协作准备阶段
+
+在多人协作开发的初始阶段，首先完成以下工作：
+
+1. 租户管理员需先添加所有开发者账号，具体操作可见[用户管理-创建用户](../../45.平台运维管理/10.用户管理.md)。
+2. 管理员为开发者授予应用权限，具体操作请参考[应用开发权限](../../30.应用生命周期管理/110.应用开发权限.md)。
+3. 开发者登录到CodeWave智能开发平台，创建该主应用的副本应用，具体操作可见[创建协作副本](#_1-1-创建协作副本)。
+
+说明：
+
+- 副本应用等于开发者在这个应用上的开发空间，在副本里可以开发不同代码分支的内容。
+- 每个开发者只能创建一个属于自己的副本应用，后续针对该应用的所有开发工作都在自己的副本里完成。
+- 需确保所有开发者的副本应用都使用同一版本的IDE，如要升级IDE，也需要统一升级。
+- 每个副本应用有一套独立的数据库，开发过程中用独立的数据库进行开发。
+
+### 6.4 开发阶段
+
+#### 6.4.1 具体步骤介绍
+
+1. 从主分支创建项目开发分支A。
+2. 所有开发者创建自己的副本，切换到项目开发分支A。
+3. 拉取分支A的全部内容。如首次创建副本，会自动拉取分支A的全部内容。拉取后出现冲突需要解决冲突。
+4. 开发者在各自的副本中进行开发。
+5. 定期开发的内容推送到分支A，并重复2-5步，直到需求开发完成。
+6. 在分支A上进行功能验证。
+7. 验证通过后，由在主分支上拉取分支A的内容，并进行冲突处理与内容合并。
+8. 各开发者将各自的副本都切换到主分支。
+9. 在主分支上进行测试验证。
+10. 删除分支A，准备新的需求开发。
+
+#### 6.4.2 注意事项
+
+- **确认拉取分支**：开发者在进入副本或在副本里切换分支后，需要先从分支仓库里拉取内容，以确保自己的开发工作是基于最新的分支内容进行的。如遇到冲突，需尽早解决。
+- **及时推送**：在开发过程中，要及时将开发内容推送到对应的分支仓库里。多人协同开发都是基于分支仓库里的内容进行。
+- **做好代码备份**：开发过程中应定期进行代码备份，这样可以在意外情况下恢复代码，保证代码的安全性。
+- **高频提交代码**：频繁地提交代码是保证团队协作顺利进行的关键。通过高频提交代码，可以及时发现问题并解决小冲突，避免大冲突的发生。同时，提交的代码也可以配合自动化测试，及早发现潜在的问题。
+- **仔细处理冲突**：当出现代码冲突时，需要仔细查看代码差异，认真处理。如果有疑问，一定要和相对应的开发者沟通确认，避免图省事的代码合并给后续带来更大隐患。
+
+### 6.5 应用发布阶段
+
+确保主应用上是主分支里最新的内容。
+将主应用发布到生产环境。
+
+## 7. 说明
+
+### 最佳实践
+
+需要进行多人协作的应用可参考以下最佳实践，以便开发更加顺畅。
+
+- 采用单一主工作分支和多副本协作模式：这种方法可以减少多工作分支和多副本可能带来的意外问题。创建其他分支可用来临时保存代码（推送快照里也有快照的代码）。
+- 避免大批量改动和需要频繁推送代码：建议进行小规模、频繁的提交，以保持代码库的最新状态并减少冲突。
+- 避免不必要的还原操作：在进行大批量改动并推送后，除非绝对必要，否则不要还原到推送前的备份，以避免操作记录的重复计算和混乱。
+- 提前备份在大批量改动合并前：在进行大规模的代码变更之前，请务必提前备份。如果出现不符合预期的情况，可以快速恢复到备份状态，确保开发的稳定性。
+
+通过遵循以上最佳实践，可以有效提升多人协作开发的效率和代码管理的顺畅度。
+
+### 为什么不是像在线文档一样的多人同时编辑？
+
+Codewave的多人协作能力是基于对分支的拉取推送以及建立副本应用来实现，为什么不做成类似于在线文档的功能使得多个开发者可以在一个网页中协同编辑，理由如下：
+
+- 应用的开发与文档编辑不同，由于应用代码有上下文相互依赖，严格的代码校验，不同代码之间相互影响，多人同时编辑一份代码可能会导致无法完成正确性验证和发布。例如，当一个成员正在编辑逻辑但未完成时，由于存在错误，导致其他成员无法发布应用。
+- 协同编辑需要为不同账号开放权限，为代码安全引入了风险。
+- 尽管在线文档这种协作模式更佳直观易于理解，但并不适合软件开发，多人同时编辑同一份代码很容易导致混乱和错误，团队成员可能会覆盖彼此的更改，或者在不了解其他人工作的情况下做出修改，而拉取/推送这种机制可以严格有序地合并不同成员的修改，从而避免了这种混乱。
+
+虽然Codewave协作模式与在线文档不同，但它提供了更强大的版本控制能力，能够追踪每一次改动历史并进行回滚，以及精准处理多人修改同一个内容带来的冲突，这种协作模式能更好的提升团队协作效率和项目质量。
+
+<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年08月25日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/30./345/272/224/347/224/250/347/224/237/345/221/275/345/221/250/346/234/237/347/256/241/347/220/206/120./345/244/232/344/272/272/345/215/217/344/275/234/345/274/200/345/217/221/20./345/244/232/344/272/272/345/215/217/344/275/234/346/223/215/344/275/234/344/270/216/345/256/236/350/267/265.md

@@ -0,0 +1,214 @@
+# 多人协作操作与实践
+
+## 1. 副本应用操作
+
+### 1.1 创建协作副本
+
+1、进入应用中心，单击如下图红框所示按钮，为应用创建协作副本。
+
+<img src="../assets/duorenxiezuocaozuo_0123_1.png" alt="0" style="width:400px" />
+
+2、配置协作副本相关应用信息，单击创建按钮，完成协作副本创建。可选择主应用的特定分支，让协作副本基于该分支进行创建。
+
+<img src="../assets/duorenxiezuocaozuo_0123_2.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 1.2 进入副本应用的可视化开发
+
+在应用中心单击如下图红框所示按钮，可快捷进入该副本应用的可视化开发界面。
+
+<img src="../assets/duorenxiezuocaozuo_0123_3.png" alt="0" style="width: 400px; border: 1px solid #ccc;" />
+
+### 1.3 修改副本应用信息
+
+在应用中心单击如下图红框所示按钮，可编辑该副本应用的应用信息。
+
+<img src="../assets/duorenxiezuocaozuo_0123_4.png" alt="0" style="width: 400px;border: 1px solid #ccc;" />
+
+### 1.4 进入副本应用的应用详情界面
+
+在应用中心单击如下图红框所示区域，可打开该副本应用的应用详情界面。
+
+<img src="../assets/duorenxiezuocaozuo_0123_5.png" alt="0" style="width: 400px; border: 1px solid #ccc;" />
+
+<img src="../assets/duorenxiezuocaozuo_05303_1.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 1.5 注意事项
+
+* 同一应用下每个开发者只能创建 1 个协作副本。
+* 副本应用的发布运行和数据库独立于主应用，不会共享数据库。
+* 副本应用可单独进行版本备份与还原。
+
+## 2. 分支操作
+
+### 2.1 创建分支
+
+1、进入应用中心，单击如下图所示按钮，为应用创建新分支。可以基于任意一个分支创建新分支。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202503041827_1.png" alt="0" style="width: 400px;border: 1px solid #ccc;" />
+
+2、如下图所示，在弹出框中输入分支名称和分支描述，单击确定按钮，完成分支创建。
+
+![0](../assets/duorenxiezuocaozuo_0123_8.png)
+
+### 2.2 编辑分支
+
+在应用中心点击如下图所示按钮，可修改分支名称和分支描述。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202503041827_3.png" alt="0" style="width: 400px;border: 1px solid #ccc;" />
+
+### 2.3 删除分支
+
+在应用中心点击如下图所示按钮，可删除该分支。
+
+注意：主分支不支持删除。当协作副本基于某分支正在进行应用开发时，不支持删除该分支。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202503041827_2.png" alt="0" style="width: 400px;border: 1px solid #ccc;" />
+
+### 2.4 查看分支操作日志
+
+在应用中心点击如下图所示按钮，可查看特定分支的拉取和推送日志。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202503041827_4.png" alt="0" style="width: 400px; border: 1px solid #ccc;" />
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_1.png" alt="0" style="border: 1px solid #ccc;" />
+
+也可在IDE中查看分支的推送记录。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_2.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 2.5 切换分支
+
+在应用IDE的顶部栏可选择分支并切换，如下图所示。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_3.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 2.6 从协作仓库拉取代码
+
+在应用IDE中点击底部栏的“协作”，点击分支上的“拉取”按钮，可从协作仓库中获取最新的提交，并将其合并到当前分支中。支持拉取不同分支上的代码。
+
+> 当拉取按钮出现感叹号提示时，则表示有代码变动可以拉取。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_4.png" alt="0" style="border: 1px solid #ccc;" />
+
+拉取后如果没有出现冲突项，可取消勾选“只看冲突项”或点击“查看改动项”，查看本次拉取的变更。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_5.png" alt="0" style="border: 1px solid #ccc;" />
+
+查看本次拉取的变更时，可切换标签查看不同的类别的变更，双击下方的元素可在画布中定位到该元素。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_6.png" alt="0" style="border: 1px solid #ccc;" />
+
+点击“确定更新”可完成代码的拉取合并，可选择备份应用后再执行拉取。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_7.png" alt="0" style="border: 1px solid #ccc;" />
+
+点击“取消”将撤销本次拉取的变更。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_8.png" alt="0" style="border: 1px solid #ccc;" />
+
+进行代码拉取有以下注意点：
+
+- 如果应用在拉取时既没有确定更新，也没有选择取消，当下次进入应用IDE时将出现如下弹窗提示，选择“强制结束”将取消上次未完成的拉取。
+
+  <img src="../assets/duorenxiezuocaozuoyushijian_202407072358_9.png" alt="0" style="width:500px;border: 1px solid #ccc;" />
+
+- 表单设计器、流程表单设计器将被视为一个整体组件，当表单设计器/流程表单设计器中发生一处修改后，整个组件视为发生编辑。
+
+  <img src="../assets/duorenxiezuocaozuoyushijian_202407072358_10.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 2.7 冲突检测和处理
+
+在执行拉取时可能会出现冲突，例如两个账号都对同一个组件进行了不同的修改，在一个账号进行推送之后，另一方拉取时会出现冲突项，需要解决冲突才能完成合并。
+
+1. 查看冲突：出现冲突时，可在协作栏下查看出现冲突的项。
+   
+    <img src="../assets/duorenxiezuocaozuoyushijian_202407072358_11.png" alt="0" style="border: 1px solid #ccc;" />
+
+2. 手动解决冲突：出现冲突的项将以红色标签提示，需要选择保留本地内容还是保留拉取分支上的内容，如图所示，可点击切换选择，切换后的内容可以在IDE中预览。
+
+    <p style="color:red;">当不确定该冲突要如何解决时，应与其他协作者沟通确认。</p>
+
+    <img src="../assets/duorenxiezuocaozuoyushijian_202407072358_12.gif" alt="0" style="border: 1px solid #ccc;" />
+
+3. 在解决完所有冲突后，点击“确定更新”，完成合并。
+
+### 2.8 将代码推送到协作仓库
+
+点击如下图所示的“推送”按钮，可将当前应用中的代码推送至协作仓库的指定分支容。若协作仓库中该分支已有更新内容，则要求应用先对该分支进行拉取后再推送。
+
+> 当推送按钮出现感叹号提示时，表示当前有代码变动可以推送。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_13.png" alt="0" style="border: 1px solid #ccc;" />
+
+推送时可输入提交说明，提交说明将展示在推送记录和操作日志中。推送版本号为自动生成。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_14.png" alt="0" style="border: 1px solid #ccc;" />
+
+### 2.9 选择性推送部分代码
+
+在开发时常遇到部分代码需及时推送、而另一部分仍在编辑尚未完成的情况，这种场景下可以使用“部分推送”，只勾选部分需要推送的代码即可。
+
+![](../assets/duorenxiezuocaozuoyushijian_202511191033_1.png)
+
+![](../assets/duorenxiezuocaozuoyushijian_202511191033_2.png)
+
+### 2.10 多人协作中的参数配置管理
+
+在多个成员使用不同的副本应用来参与协作开发时，不同的副本应用中可能需要使用不同的参数配置，为了管理这种场景下的参数配置，多人协作提供了“默认参数配置”功能，它决定了应用里的参数配置在拉取或推送时的处理规则。
+
+![](../assets/duorenxiezuocaozuoyushijian_202511191033_3.png)
+
+![](../assets/duorenxiezuocaozuoyushijian_202511191033_4.png)
+
+在执行代码合并时，系统将默认遵循上述处理规则，但也仍保留了手动选择的权力，可以在拉取代码时手动选择是否保留本地参数配置，或者保留拉取的参数配置。
+同样的，在推送的时候可以使用“部分推送”来选择个别参数进行推送。
+
+![](../assets/duorenxiezuocaozuoyushijian_202511211542_1.png)
+
+
+### 2.10 分支版本管理
+
+每一次进行分支推送，都会在该分支下生成一个推送版本。点击分支上的推送记录按钮后，可查看该分支的历史推送记录，包含推送时间、IDE版本、推送说明、操作人等信息。
+
+> 分支版本的最大数量为500个，当使用数量达到上限进行推送时，本次推送的内容将覆盖保存在最近一次保存的版本上，建议对历史推送版本进行删除之后再操作推送。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_15.png" alt="0" style="border: 1px solid #ccc;" />
+
+点击版本号上的图标，可编辑版本备注。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_16.png" alt="0" style="border: 1px solid #ccc;" />
+
+推送记录提供以下操作：
+
+- **查看**：用于查看分支历史版本的代码。在推送记录弹窗中点击“查看”后，将从新窗口打开应用IDE，以只读模式浏览该版本的应用，可在顶部栏切换推送版本查看该应用的其他历史版本。
+  
+    <img src="../assets/duorenxiezuocaozuoyushijian_202407072358_17.png" alt="0" style="border: 1px solid #ccc;" />
+
+- **对比**：用于将本地代码与特定推送版本的代码进行对比。在推送记录弹窗中点击“对比”后，将展示本地内容与所选推送版本的差异，开发者可选择需要拉取的远端内容，操作方式与冲突合并相同，适用于需要查看并还原历史内容的情况。
+
+    <img src="../assets/duorenxiezuocaozuoyushijian_202407072358_18.png" alt="0" style="border: 1px solid #ccc;" />
+
+- **覆盖**：用所选版本的内容覆盖掉当前本地内容，适用于需要回退到特定推送版本的情况。
+
+    <img src="../assets/duorenxiezuocaozuoyushijian_202407072358_19.png" alt="0" style="width:650px;border: 1px solid #ccc;" />
+
+- **删除**：删除该推送版本的记录。
+
+    <img src="../assets/duorenxiezuocaozuoyushijian_202407072358_20.png" alt="0" style="width:650px;border: 1px solid #ccc;" />
+
+### 2.11 查看最近一次操作记录
+
+选中IDE目录树中的内容，例如页面、逻辑等，可以查看该内容最近的一次分支推送记录，包含提交人、推送说明、提交时间等信息。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_21.png" alt="0" style="border: 1px solid #ccc;" />
+
+在页面组件的属性面板右上角可查看该组件的最近一次操作记录。
+
+<img src="../assets/duorenxiezuocaozuoyushijian_202407072358_22.png" alt="0" 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);">2025年11月21日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/30./345/272/224/347/224/250/347/224/237/345/221/275/345/221/250/346/234/237/347/256/241/347/220/206/120./345/244/232/344/272/272/345/215/217/344/275/234/345/274/200/345/217/221/30./345/244/232/344/272/272/345/215/217/344/275/234/344/275/277/347/224/250/345/270/270/350/247/201/351/227/256/351/242/230.md

@@ -0,0 +1,107 @@
+# 多人协作常见问题解答
+
+| 常见问题清单 |
+| ------------ |
+| [副本应用与分支的差别是什么](#副本应用与分支的差别是什么)         |
+| [新建副本应用或分支均为空应用](#新建副本应用或分支均为空应用)         |
+| [创建协作副本之前看不到应用](#创建协作副本之前看不到应用)         |
+| [无法管理分支或创建副本应用](#无法管理分支或创建副本应用)         |
+| [多人协作中如何处理应用配置](#多人协作中如何处理应用配置)         |
+
+## 副本应用与分支的差别是什么
+
+**问题描述**
+
+副本应用和分支有什么差别，如何为每个分支发布独立的应用？
+
+**问题解答**
+
+多人协作中的副本应用与分支是两个不同的概念，在使用前务必先理解它们的作用和差异。
+
+副本应用的作用是为了创建多个“运行实例”，让每个参与协作的开发者都能发布自己的独立的应用，与其他开发者运行的应用相互隔离。
+
+分支的作用是能管理、编辑多套代码，但发布不同的分支并不会直接产生多个运行中的应用，在A分支上发布应用后，切换到B分支再发布应用，运行的应用将以B分支为准，不会创建多个运行实例。
+
+如果你的目的是希望同时存在多个运行实例，并且每个实例对应不同的分支，则应该有多个副本应用，不同的应用切换到不同的分支并发布。例如，副本应用1切换到A分支并发布，副本应用2切换到B分支并发布。
+
+## 新建副本应用或分支均为空应用
+
+**问题描述**
+
+开发者创建副本应用后，发现副本应用中内容为空，与主应用不一致。
+
+**问题原因**
+
+原有的主应用未进行推送，分支中内容为空，导致基于该分支创建的分支及副本应用内容均为空。
+
+**解决方案**
+
+登录主应用进行分支推送，副本应用拉取相应的分支。
+
+## 创建协作副本之前看不到应用
+
+**问题描述**
+
+参与协作的账号在应用中心里看不到目标应用，无法创建协作副本。
+
+<img src="../assets/duorenxiezuochangjianwentijieda_202407070031_1.png" class="imgStyle" style="" />
+
+**问题原因**
+
+参与协作的账号没有被授予该应用的开发权限，导致在应用中心看不到目标应用。
+
+**解决方案**
+
+由应用管理员将需要参与协作的账号添加到developer角色或admin角色中，或其他已经配置过权限的角色。
+
+应用开发权限的详细说明可参考：[应用开发权限](../110.应用开发权限.md)。
+
+<img src="../assets/duorenxiezuochangjianwentijieda_202407070031_2.png" class="imgStyle" style="" />
+
+<img src="../assets/duorenxiezuochangjianwentijieda_202407070031_3.png" class="imgStyle" style="" />
+
+## 无法管理分支或创建副本应用
+
+**问题描述**
+
+无法对应用创建协作副本，无法管理分支，按钮处于不可用状态。
+
+<img src="../assets/duorenxiezuochangjianwentijieda_202407070031_4.png" class="imgStyle" style="width:450px;" />
+
+**问题原因**
+
+当前账号没有该应用的创建协作副本权限或分支管理权限。
+
+**解决方案**
+
+应用管理员在**应用详情>授权**下将需要参与协作的账号添加到有相关权限的角色下，如下图所示，角色需要关联权限：创建协作副本权限、分支管理。
+
+<img src="../assets/duorenxiezuochangjianwentijieda_202407070031_5.png" class="imgStyle" style="" />
+
+## 多人协作中如何处理应用配置
+
+在使用多人协作功能时，分支合并涵盖的内容也包括“应用配置”模块中的修改。
+
+<img src="../assets/duorenxiezuoshiyongchangjianwenti_202411081735_1.png" class="imgStyle" style="" />
+
+示例：
+
+1. 在dev分支上添加了一个系统参数配置并进行推送。
+
+    <img src="../assets/duorenxiezuoshiyongchangjianwenti_202411081735_2.png" class="imgStyle" style="" />
+
+2. 从主分支拉取dev分支时，在IDE下方的“协作栏”中可以切换到“配置”标签页，取消勾选“只看冲突项”可以查看发生改动的应用配置。
+
+    <img src="../assets/duorenxiezuoshiyongchangjianwenti_202411081735_3.png" class="imgStyle" style="" />
+
+3. 在点击“确定更新”之前，可以进入到应用配置中预览即将更新的内容，但在完成代码合并或取消代码合并之前无法修改应用配置。
+
+    <img src="../assets/duorenxiezuoshiyongchangjianwenti_202411081735_4.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年12月30日</span>
+</div>