检查点会话回退最佳实践

应用场景

软件系统完成基础核心版本开发后，通常会在迭代中持续新增各类扩展功能，以不断丰富产品能力、满足多样化业务场景。但部分非核心扩展功能在实际验证后，会出现与业务需求不匹配、增加系统性能损耗、导致交互冗余复杂等问题，影响整体稳定性与使用体验。在不破坏核心业务、不残留冗余代码与配置的前提下，通过会话级检查点机制实现系统状态自动存档与精准回滚，可一键还原至初始基础版本，高效解决无效迭代带来的问题。

本实践通过轻量化咖啡点单系统，演示检查点（Checkpoint）在会话编辑过程中的状态存档、精准回滚、界面还原能力。

准备工作

在使用华为云码道前，您需要先创建一个项目，用于集中存放工程中的各类文件。

1. 参考IDE中操作，登录华为云码道。
2. 创建一个项目，用于存放工程中的文件。
   1. 在IDE工具顶部菜单栏中，单击“文件(F)”，选择“新建 > 新建项目”，进入新建项目页面。
   2. 选择项目存放位置，输入项目名称（如coffee-order-demo），单击“确定”。

      项目名称必须以字母开头，可包含字母、数字、中划线或下划线，且总长度不能超过64个字符。

      图1 新建项目

      

      项目创建完成后，在“资源管理器”中可以查看到已创建的“COFFEE-ORDER-DEMO”项目。

3. （可选）开启自动批准功能。
   开启自动批准功能后，AI将自动处理相关操作，无需人工干预。

   

   开启自动批准存在操作风险，请在开启前充分评估风险，并在安全可信环境中使用。本实践不开启自动批准功能。

   1. 在华为云码道聊天界面的输入框下方选择“智能体”，切换到智能体模式。

      如果没有正常显示华为云码道的聊天窗口，请在顶部菜单栏的右上方，单击展开AI侧栏图标 ，即可打开华为云码道。

   2. 将鼠标放置在“智能体”这一行，单击右侧的智能体设置图标 ，进入设置页面。
      图2 单击设置图标
      
   3. 在“智能体 > 自动批准”中，单击对应操作后的 ，开启自动批准功能。
   4. 在“智能体 > 命令执行方式”中，设置智能体执行终端命令的策略。
   5. 单击顶部的返回图标 ，完成授权操作。

生成基础咖啡点单系统

点单系统首期采用轻量化建设思路，聚焦核心点餐业务流程，暂不扩展非必需的营销及增值功能，确保核心链路简洁、可用、可靠。

1. 在聊天界面的输入框中，输入如下提示词，创建咖啡点单系统。

   HTML+CSS+JavaScript创建一个基础的咖啡点单系统。
   功能要求：
   - 菜单展示：静态展示一个包含至少三种咖啡（如：美式、拿铁、卡布奇诺）的列表，每种咖啡标明名称、价格以及通用图标
   - 加入购物车：每个咖啡旁边有一个“加入购物车”按钮。
   - 订单预览：页面上有一个区域实时显示当前购物车中的商品、数量和计算出的总价。
   - 样式：界面要求简洁、干净、温暖色系

   执行完成后，在资源管理器的“COFFEE-ORDER-DEMO”目录下会生成一个名为“index.html”的文件。

2. 在“index.html”文件上，单击鼠标右键选择“在浏览器中预览”，查看网站。
   图3 咖啡点单系统
   
   

   当前展示的效果图仅是示例，请以最终实际生成的效果为准。

增加个性化推荐功能

团队提出了一个想法：增加一个“每日特调”推荐功能，用于阶段性营销活动，吸引客户下单。这类功能非系统基础核心功能，活动周期结束后将下线并恢复原有界面逻辑。

1. 在聊天界面的输入框中，输入如下提示词，优化咖啡点单系统。

   基于之前的咖啡点单系统，现在为其增加一个“每日特调”推荐功能。
   功能要求:
   - 在菜单顶部增加一个“今日特调”区域。
   - 这个区域会动态展示一款咖啡作为特价推荐，并附带一个简单的推荐理由。
   - 例如：“今日特调：冰摇柠檬茶（8折优惠！）”，并附上一个独立的“购买特调”按钮。

   执行完成后，会同步更新资源管理器中“COFFEE-ORDER-DEMO”目录下的“index.html”文件。

2. 在“index.html”文件上，单击鼠标右键选择“在浏览器中预览”，查看网站。
   图4 增加每日特调推荐
   
   

   当前展示的效果图仅是示例，请以最终实际生成的效果为准。

回退到基础版本

经团队讨论评估，“每日特调”推荐功能模块视觉干扰强、功能重复、日常维护成本高，对现阶段网站弊大于利。因此暂不实现该功能，回归简洁基础的核心点单版本。

1. 在聊天界面中，回退对话。
   将鼠标悬浮在待回退版本对话上，单击 ，弹出恢复确认对话框，显示待恢复的文件名。

   图5 单击回退图标
   
   图6 恢复确认对话框
   

2. 单击“确定”，回退对话。

   文件会回退至历史代码状态，且当前对话中该时间点及之后的对话消息消失。咖啡点单系统同步回退到基础版本。

总结

通过上面的实践，可以清晰地看到检查点的核心价值：

• 版本安全兜底：为华为云码道生成的基础系统提供可还原的基准版本。
• 无效迭代快速撤销：追加功能不符合预期时，无需手动删除代码，一键回退。
• 降低开发试错成本：允许自由尝试扩展功能，不破坏初始稳定系统。
• 提升运维效率：无需重新生成项目，快速恢复到最符合需求的版本。