codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/25./346/231/272/350/203/275/345/274/200/345/217/221/090./346/231/272/350/203/275/344/276/235/350/265/226/345/272/223/350/265/204/344/272/247/347/224/237/346/210/220/020./350/265/204/344/272/247/346/216/245/345/205/245AI/345/212/251/346/211/213/344/275/277/347/224/250/346/214/207/345/215/227.md

@@ -0,0 +1,200 @@
+# 什么是资产接入AI助手？
+
+资产接入AI编助手依托大于模型构建的代码辅助创作工具，能够助力用户生成适配多台的依赖库资产，包括前端组件和服务端逻辑。
+
+## 适用场景
+
+| **适用场景**  | **操作说明**  | **输入示例**   |
+| :---------- | :------------------------------------------------------ | :-------------------------------------------------------------------------------------------------------------------------- |
+| 创建新的组件资产    | 资产类型选择“前端组件”，直接描述前端组件需求，可上传截图作为参考                       | <img src="../assets/zhushou_202511241114_1.png" class="imgStyle" style="" /> |
+| 官方组件二次改造    | 资产类型选择“前端组件”，选择需要二次改造的官方组件并描述需求，可上传截图作为参考               | <img src="../assets/zhushou_202511241114_2.png" class="imgStyle" style="" /> |
+| 基于本地资产创建组件  | 资产类型选择“前端组件”，上传使用 `npm pack` 命令构建后的本地项目包并描述需求，可上传截图作为参考 | <img src="../assets/zhushou_202511241114_3.png" class="imgStyle" style="" /> |
+| 创建新的服务端逻辑资产 | 资产类型选择“服务端逻辑”，直接描述逻辑需求，可上传截图作为参考                        | <img src="../assets/zhushou_202511241114_4.png" class="imgStyle" style="" /> |
+
+## 操作步骤
+
+### 1. 需求描述
+
+尽量将所需实现的功能描述得更加具体明确。
+
+以前端组件为例，通常我们需要从以下几个角度来描述组件：组件标题、组件属性、组件事件、组件方法，并且若想确保AI助手严格依照指定文本内容进行生成，你可以借助Markdown语法里的反引号来包裹目标文案。例如：
+
+```markdown
+创建一个开关组件。
+组件标题：`开关`
+组件属性：
+1.`值`，开关是否开启，数据类型为boolean类型。
+2.`禁用`，开关是否禁用，数据类型为boolean类型。
+3.`开关打开的背景色`，开关开启时的背景颜色，默认值为`#409EFF`。
+4.`开关关闭的背景色`，开关关闭时的背景颜色，默认值为`#C0CCDA`。
+组件事件：
+`change`，开关状态发生变化时出触发。
+组件方法：
+`transform`，转换开关状态。
+```
+
+如果需求表述比较模糊，可以由 AI 帮忙完成提示词优化。
+
+<img src="../assets/zhushou_202511241114_5.png" class="imgStyle" style="" />
+
+### 2. 代码评审
+
+向AI助手描述需求后，即触发代码变更。AI助手会详细罗列出实现的功能和发生代码变更的文件，请对代码进行评审，在评审后确认或取消代码变更。评审途径如下：
+
+- 大致浏览代码变更的文件，通过创建前端组件资产的“预览”或创建服务端逻辑资产“调试”功能验证功能是否实现，支持“全部取消”或“全部确认”代码变更操作；
+- 依次查看代码变更文件内容，支持对所有文件依次进行“取消”或“确认”代码变更操作。
+
+<img src="../assets/zhushou_202511241114_6.png" class="imgStyle" style="" />
+
+确认代码后，代码替换为AI助手生成的代码；取消代码后，文件将恢复到AI助手生成代码前的状态。未操作确认或取消时默认基于AI助手生成的代码继续编程。
+
+### 3. 继续编程
+
+接下来，你可以继续向AI助手描述你的需求，AI助手将基于上下文进行处理。
+
+你还可以按照下述方法提升AI助手的理解能力：
+
+- 明确指定需要修改代码的文件路径和文件名称，例如：src/components/u-switch/api.ts
+- 明确技术方案
+- 提供参考示例和模块
+- ...
+
+
+```markdown
+    修改 src/components/u-switch/api.ts，添加新的属性：`开启动画效果`，开关是否在状态切换时呈现过渡动画，数据类型为boolean类型。
+    修改 src/components/u-switch/index.vue，当`开启动画效果`属性为true时，开关切换动画采用时长200ms的ease-out曲线，通过CSS3 `transition` 技术，同时绑定 `transform: translateX()` 和 `background-color` 属性实现双动画同步执行；其中滑动动画利用 `transform` 控制滑块水平位移，颜色渐变通过定义的`开关打开的背景色`和`开关打开的背景色`属性中的背景色过渡实现，确保动画连贯呈现视觉反馈。 
+```
+
+<img src="../assets/zhushou_202511241114_7.png" class="imgStyle" style="" />
+
+### 4. 撤销代码变更
+
+当你在代码评审环节已经发现代码变更存在问题，你可以直接取消文件更改，系统会自动将文件恢复到修改前的状态。
+
+若你已完成代码确认提交，但后续需要操作回溯、撤销特定更改，可以通过自然语言指令与AI助手交互，例如发送“取消上一次修改”。
+
+<img src="../assets/zhushou_202511241114_8.png" class="imgStyle" style="" />
+
+### 5. 反馈报错修复代码
+
+AI助手生成的代码可能在首次测试中无法顺利通过。不过，AI助手拥有错误修复能力，支持将任意开发阶段的报错反馈给AI助手。目前，我们已经支持自动收集安装依赖阶段、编译阶段和构建阶段的报错。
+
+<img src="../assets/zhushou_202511241114_9.png" class="imgStyle" style="width:300px" />
+
+不同开发阶段的报错说明如下：
+
+| **阶段名称** | **阶段说明**                |
+| :------- | :------------------------ |
+| 安装依赖阶段   | 执行 npm install 命令后发生的报错   |
+| 编译阶段     | 执行 tsc 命令后发生的报错           |
+| 构建阶段     | 执行 npm build 命令后发生的报错     |
+| 运行时阶段    | 在浏览器控制台的 Console 面板中显示的报错 |
+
+## 最佳实践
+
+AI 编程代理虽然是一个强大的工具，但如果传达的指令缺乏规范性和准确性，可能导致模型输出偏离预期语义，继而引发代码逻辑错乱，严重时甚至对整个代码仓库造成不可逆的损害。为此，本文将列举一些常用的实践技巧，帮助用户构建与AI助手交互的标准化范式。
+
+请将AI助手视为一个**技能满分但思维跳跃的初级工程师**：由你提供清晰的规范和持续性指导，使其发挥最大价值。
+
+### 优化提示词避免语义模糊
+
+为帮助用户的需求描述更贴合最佳实践，每次执行对话之前都可以借助AI的"优化提示词"功能对需求描述进行结构化拓展。具体可涵盖对需求本身的细化展开、相关功能点的深入阐述、涉及的属性与事件的详细说明，以及对措辞的规范修正等方面，从而使需求描述更精准、全面。
+
+<img src="../assets/zhushou_202511241114_10.png" class="imgStyle" style="width:300px" />
+
+### 使用反引号避免文案改写
+
+在实际项目中，UI 文案往往要求“一字不差”地标准化呈现，但是AI助手却常因为自然语言处理的灵活性产生自主改写行为。为了确保生成文案的一致性，可以使用 Markdown 语法中的反引号对目标文案进行包裹，强制AI助手输出固定内容。
+
+使用反引号示例如下：
+
+```markdown
+创建一个二维码组件，可以用三方库。
+组件标题：`二维码`
+组件属性：
+1、`二维码内容`，扫描后的文本，使用文本输入框来设置，默认值为`https://www.baidu.com`
+2、`中心图片地址`，二维码中心的图片地址，支持用图片上传的方式来设置
+3、`中心图片尺寸`，二维码中心的图片尺寸，下拉选项，值为大、中、小
+```
+
+### 指定文件名增准代码召回
+
+AI助手具备代码文件智能召回功能，但其召回结果无法完全避免误差。为提升召回准确度，建议在提示词中明确包含相关代码文件名。无需顾虑大小写格式，AI助手均可有效识别。
+
+输入@时，支持唤起快捷引入面板，选择需要引用的文件名。
+
+<img src="../assets/zhushou_202511241114_11.png" class="imgStyle" style="" />
+
+指定文件名示例如下：
+
+```markdown
+给 src/index.ts 添加注释
+修改 src/components/hello/index.vue, 增加一个副标题属性
+```
+
+### 描述技术方案引导AI理解
+
+在需求场景较为简单、逻辑清晰的情况下，AI助手凭借需求描述即可自主完成技术方案设计与代码生成工作。但面对复杂业务场景，仅依赖需求描述往往难以准确地传达业务逻辑和技术要求，建议细化技术方案，有效引导AI助手全面理解业务全流程和技术边界。
+
+技术方案描述示例如下：
+
+```markdown
+实现一个数字渐变组件，用vue的transition，每次数字变化修改top值，进入阶段从下往上滚动到视野内，离开阶段从视野内向上滚动到视野外，在上面渲染一个按钮点击触发数字变化
+```
+
+> 如果你不是专业开发者，可以拉取我们的值班人员寻求帮助。
+
+### 补充三方库文档引导AI理解
+
+其一，由于训练数据的局限性，AI助手在处理国际上使用范围较窄的小众三方库时，因缺乏充足的学习样本，代码生成效果往往差强人意；其二，面对主流库的较新版本，AI助手在尚未完成对应内容训练时，同样难以输出适配的代码方案。针对此类问题，建议手动补充第三方库文档，帮助其快速理解库特性与使用规范。
+
+<img src="../assets/zhushou_202511241114_12.png" class="imgStyle" style="" />
+
+## 常见问题
+
+### AI助手如何答疑
+
+AI默认为编程模式，支持根据用户输入内容生成代码，若在输入框右下角切换**对话模式**，则AI专注于对话聊天。
+
+<img src="../assets/zhushou_202511241114_13.png" class="imgStyle" style="width:300px" />
+
+### AI助手生成调试示例
+
+完成需求描述后，通常需要通过预览效果来确认AI助手生成的代码是否符合预期。AI助手可能会主动生成一些示例，我们也可以向其传达指令，明确所需示例的具体要求。
+
+以前端组件为例，生成示例后，便可在**预览->运行态预览**下查看实际效果。并且在传达指令时，我们可以指定“修改src/components/组件名称/stories/examples.stories.js”——该文件是组件文件夹中默认用于规整示例的文件；也可以直接由AI助手自主创建新的示例文件。
+
+<img src="../assets/zhushou_202511241114_14.png" class="imgStyle" style="" />
+
+## 注意事项
+
+### 认真评审变更
+
+如果你是专业开发者，请注意AI助手生成的代码变更可能存在潜在风险，建议在每次修改代码后进行严谨的代码评审与逻辑校验。若缺乏规范审查，日积月累下可能导致代码仓库架构混乱、难以维护。
+
+如果你是非专业开发者，建议优先使用AI助手处理简单、明确的开发需求。若涉及复杂业务，可以联系专业开发者值班团队介入指导，共同协作完成开发工作。
+
+### 善用历史会话
+
+我们的AI助手能够理解多轮会话，历史会话对于整个开发流程来说非常有用：
+
+1.  AI助手支持通过历史会话识别已完成功能，有效规避重复开发。
+2.  AI助手支持追踪上下文，无需重复阐述需求。
+3.  AI助手支持操作回溯和错误分析，便于用户进行错误反馈。
+
+此外，每次开启新对话都会生成独立的对话历史，用以记录会话内容。因此，建议**不要轻易删除历史对话**，以便后续进入历史对话继续此前的会话。
+
+历史对话入口一：开启新对话界面，点击左上角“历史对话”按钮。
+
+<img src="../assets/zhushou_202511241114_15.png" class="imgStyle" style="" />
+
+历史对话入口二：创建资产界面，点击AI助手右上角“历史对话”图标。
+
+<img src="../assets/zhushou_202511241114_16.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月24日</span>
+</div>

package/skills/smart-customer-service/docs/codewave/25./346/231/272/350/203/275/345/274/200/345/217/221/100./346/231/272/350/203/275/347/224/237/346/210/220/345/272/224/347/224/250/010./346/231/272/350/203/275/347/224/237/346/210/220/345/272/224/347/224/250/346/223/215/344/275/234/346/211/213/345/206/214.md

@@ -0,0 +1,102 @@
+# 智能生成应用操作手册
+
+## 1. 功能介绍
+
+在创建 CodeWave 智能开发应用时，支持用户选择“智能生成应用”，仅需通过自然语言描述需求，即可自动生成全栈 NASL 代码；代码生成后支持一键导入 CodeWave 平台，直接转化为可交互的可视化应用。
+
+这一功能彻底简化了 CW 应用开发流程，大幅缩短从 0 到 1 的创建周期，同时支持通过对话式交互持续调整功能细节，让开发效率显著提升。
+
+<div class="yellowBlock">
+
+后期发展预告：全流程智能生成，打通 “需求 - 原型 - 应用” 链路，把 “一句话生成产品蓝图、竞品分析报告、PRD 文档、产品原型” 的全流程融入平台。目前该功能已进入研发阶段，计划于9 月 30 日完成上线准备，10 月起将逐步开放对外体验。
+
+</div>
+
+
+
+## 2. 前提条件
+
+在SaaS登录后，点击创建应用，如果可以看到“智能生成应用”按钮，说明功能已经开通成功。
+
+<img src="../assets/zhinengyingyong_202509081549_1.png" class="imgStyle" style="" />
+
+## 3. 功能实现
+
+### 3.1 创建智能应用
+
+1.  点击“智能生成应用”按钮后，即可进入如下界面。
+
+    <img src="../assets/zhinengyingyong_202509081549_2.png" class="imgStyle" style="" />
+
+1.  从左侧输入需求。目前支持的输入方式包括：
+
+    - 简洁文本输入：可直接输入一句话需求，传递核心诉求；
+    - 详细描述输入：可提交包含详细功能说明的段落文本，支持包含数据库设计，精准定义需求细节；
+    - 图片输入：点击图片图标，可上传系统架构图、Excel截图、界面截图等，多模态大语言模型将自动解析图片内容，结合视觉信息完成功能设计与生成；若辅以文字描述，可能会使生成更贴近用户想要的结果。
+
+    <img src="../assets/zhinengyingyong_202509081549_3.png" class="imgStyle" style="width:300px" />
+
+    > 需求描述可参考[智能生成应用提示词写法](020.智能生成应用提示词写法.md)。
+
+2.  生成和调整完成后，可以点击右上角的“创建应用”按钮，进入到创建应用loading界面。
+
+    <img src="../assets/zhinengyingyong_202509081549_4.png" class="imgStyle" style="" />
+
+1.  点击应用链接，可以跳转到CodeWave可视化开发界面，点击右上角关闭，可以回到应用生成的聊天界面。
+
+    <img src="../assets/zhinengyingyong_202509081549_5.png" class="imgStyle" style="" />
+
+### 3.2 智能应用的迭代更新
+
+1.  已经创建的应用，在应用详情页会有“智能生成应用”按钮，点击进入后，会看到之前对话和生成的记录，可以继续聊天生成。
+
+    <img src="../assets/zhinengyingyong_202509081549_6.png" class="imgStyle" style="" />
+
+1.  继续聊天后，可以点击右上角“更新应用”，将最新内容更新到 IDE 中。
+
+    <img src="../assets/zhinengyingyong_202509081549_7.png" class="imgStyle" style="" />
+
+**注意**：目前“更新应用”后为全量覆盖，IDE内已经手动编辑的内容也会被覆盖。增量更新和diff更新正在开发中，后期会上线支持。
+
+## 4. 使用说明
+
+**打开缓存**
+
+开启缓存后，若输入与历史记录完全一致的提示词，系统将直接调用上一次的生成结果；若希望每次生成差异化内容，可关闭此开关，系统会针对相同提示词重新执行生成逻辑。
+
+<img src="../assets/zhinengyingyong_202509081549_8.png" class="imgStyle" style="width:300px" />
+
+**打开编辑器**
+
+开启编辑器后，可以看到生成的NASL代码，包括数据实体、枚举、逻辑。目前暂不允许用户手动调整NASL代码，若不熟悉语法规则，修改后可能造成IDE中较严重的问题。
+
+<img src="../assets/zhinengyingyong_202509081549_9.png" class="imgStyle" style="" />
+
+**预览缩放**
+
+应用预览页面支持缩放或快速1:1比例呈现，为小屏浏览器提供最佳的预览效果。
+
+<img src="../assets/zhinengyingyong_202509081549_10.png" class="imgStyle" style="" />
+
+**页面地址栏**
+
+页面地址栏支持手动切换页面、查看页面名称。
+
+<img src="../assets/zhinengyingyong_202509081549_11.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年09月08日</span>
+</div>
+  <style>
+  .yellowBlock {
+    background-color: #fcf5e1 !important;
+    border-color: #eaaa08 !important;
+    border-left-width: 0.2rem !important;
+    border-left-style: solid !important;
+    padding: 1rem 1rem 1rem 1rem !important;
+    margin: 1rem 0px !important;
+}
+  </style>