# 检查点会话回退最佳实践
软件系统完成基础核心版本开发后，通常会在迭代中持续新增各类扩展功能，以不断丰富产品能力、满足多样化业务场景。但部分非核心扩展功能在实际验证后，会出现与业务需求不匹配、增加系统性能损耗、导致交互冗余复杂等问题，影响整体稳定性与使用体验。在不破坏核心业务、不残留冗余代码与配置的前提下，通过会话级检查点机制实现系统状态自动存档与精准回滚，可一键还原至初始基础版本，高效解决无效迭代带来的问题。
本实践通过**轻量化咖啡点单系统**，演示检查点（Checkpoint）在会话编辑过程中的状态存档、精准回滚、界面还原能力。
#### 准备工作
在使用华为云码道代码智能体前，您需要先创建一个项目，用于集中存放工程中的各类文件。
1. 参考[快速启动](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0002.html)中操作，登录华为云码道代码智能体。
2. 创建一个项目，用于存放工程中的文件。 
   1. 在IDE工具顶部菜单栏中，单击"文件(F)"，选择"新建 \> 新建项目"，进入新建项目页面。
   
   2. 选择项目存放位置，输入项目名称（如coffee-order-demo），单击"确定"。 **项目名称必须以字母开头，可包含字母、数字、中划线或下划线，且总长度不能超过64个字符。**
      图1新建项目
      ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002573651273.png "点击放大")
      项目创建完成后，在"资源管理器"中可以查看到已创建的"COFFEE-ORDER-DEMO"项目。
      
   
   
   
   
3. （可选）选择智能体运行模式并授权自动化操作。 
   1. 单击华为云码道代码智能体IDE右上角的设置图标 ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002583370762.png)，进入全局设置页面。
   
   2. 在"对话流 \> 智能体 \> 终端命令运行模式"中，选择智能体执行终端命令的运行策略，本实践使用默认运行策略，即沙箱运行。
   
   3. 在"对话流 \> 智能体 \> 自动批准"中，单击 ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002613730529.png)以开启所需的自动批准项目。
      **授权自动化操作后，复杂工程级代码生成流程中的各项任务可自动执行。** **如果您未开启自动化操作授权，在使用华为云码道代码智能体进行编码时，部分操作将需要您手动确认。**
      ![](https://support.huaweicloud.com/bestpractice-codeartsagent/public_sys-resources/caution_3.0-zh-cn.png)
      开启自动批准存在操作风险，请在开启前充分评估风险，并在安全可信环境中使用。
      表1自动批准参数说明 
      | 参数     | 说明                                          | 示例 |
      |:---|:---|:---|
      | 编辑     | 允许智能体调用edit、write、deleteFile等工具来编辑您计算机上的文件。 | 开启 |
      | 使用浏览器  | 允许智能体在浏览器中访问网站。                             | 开启 |
      | 网页抓取工具 | 允许智能体访问并抓取指定网页的内容。                          | 开启 |
         
      
   
   
   
   
 
#### 生成基础咖啡点单系统
点单系统首期采用轻量化建设思路，聚焦核心点餐业务流程，暂不扩展非必需的营销及增值功能，确保核心链路简洁、可用、可靠。
1. 在聊天界面的输入框中，输入如下提示词，创建咖啡点单系统。 
   ```
   HTML+CSS+JavaScript创建一个基础的咖啡点单系统。
   功能要求：
   - 菜单展示：静态展示一个包含至少三种咖啡（如：美式、拿铁、卡布奇诺）的列表，每种咖啡标明名称、价格以及通用图标
   - 加入购物车：每个咖啡旁边有一个“加入购物车”按钮。
   - 订单预览：页面上有一个区域实时显示当前购物车中的商品、数量和计算出的总价。
   - 样式：界面要求简洁、干净、温暖色系
   ```
   执行完成后，在资源管理器的"COFFEE-ORDER-DEMO"目录下会生成一个名为"index.html"的文件。
   
   
2. 在"index.html"文件上，单击鼠标右键选择"在浏览器中预览"，查看网站。 
   当前展示的效果图仅是示例，请以最终实际生成的效果为准。
   图2咖啡点单系统   
   ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002631172474.png "点击放大")
   
   
 
#### 增加个性化推荐功能
团队提出了一个想法：增加一个"每日特调"推荐功能，用于阶段性营销活动，吸引客户下单。这类功能非系统基础核心功能，活动周期结束后将下线并恢复原有界面逻辑。
1. 在聊天界面的输入框中，输入如下提示词，优化咖啡点单系统。 
   ```
   基于之前的咖啡点单系统，现在为其增加一个“每日特调”推荐功能。
   功能要求:
   - 在菜单顶部增加一个“今日特调”区域。
   - 这个区域会动态展示一款咖啡作为特价推荐，并附带一个简单的推荐理由。
   - 例如：“今日特调：冰摇柠檬茶（8折优惠！）”，并附上一个独立的“购买特调”按钮。
   ```
   执行完成后，会同步更新资源管理器中"COFFEE-ORDER-DEMO"目录下的"index.html"文件。
   
   
2. 在"index.html"文件上，单击鼠标右键选择"在浏览器中预览"，查看网站。 
   当前展示的效果图仅是示例，请以最终实际生成的效果为准。
   图3增加每日特调推荐   
   ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002631335240.png "点击放大")
   
   
 
#### 回退到基础版本
经团队讨论评估，"每日特调"推荐功能模块视觉干扰强、功能重复、日常维护成本高，对现阶段网站弊大于利。因此暂不实现该功能，回归简洁基础的核心点单版本。
1. 在聊天界面中，回退对话。 
   将鼠标悬浮在待回退版本对话上，单击 ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002583424333.png)，弹出恢复确认对话框，显示待恢复的文件名。
   图4单击回退图标   
   ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002661415047.png "点击放大")
   图5恢复确认对话框   
   ![](https://support.huaweicloud.com/bestpractice-codeartsagent/zh-cn_image_0000002631335806.png "点击放大")
   
   
2. 单击"确定"，回退对话。 
   文件会回退至历史代码状态，且当前对话中该时间点及之后的对话消息消失。咖啡点单系统同步回退到基础版本。
   
   
 
#### 总结
通过上面的实践，可以清晰地看到检查点的核心价值：
- **版本安全兜底**：为华为云码道代码智能体生成的基础系统提供可还原的基准版本。
- **无效迭代快速撤销**：追加功能不符合预期时，无需手动删除代码，一键回退。
- **降低开发试错成本**：允许自由尝试扩展功能，不破坏初始稳定系统。
- **提升运维效率**：无需重新生成项目，快速恢复到最符合需求的版本。