# 检查点
检查点（Checkpoint）是华为云码道代码智能体内置的代码状态自动快照与回退机制。系统会自动跟踪智能体运行期间的文件编辑操作，在每次AI编辑前自动保存当前代码与对话状态，用于快速撤销、回退和历史版本恢复。此功能适用于需要快速试错、安全编辑和一键回退的AI辅助开发场景。
#### 约束与限制
表1约束与限制 
| 限制类别      | 具体限制                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|
| 时间限制      | **检查点有效期为15天**，过期后将自动清除，界面不再显示回退按钮，无法恢复历史版本。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| 模型限制      | 仅支持在**智能体** 、**自定义智能体**模式下使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| 文件大小和类型限制 | 检查点不跟踪图片、视频、压缩包、exe和PDF等二进制文件，同时忽略单文件大小超过10MB的文本文件；大于2MB的文本文件，在版本回退预览场景下不提供差异对比视图。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| 功能限制      | - 系统会在每次AI编辑前自动生成检查点，仅跟踪当前对话内由**AI文件编辑工具**产生的文件修改。  - 通过**Bash命令** 或**外部编辑器**产生的文件修改不会被跟踪。  - 多会话里所有AI对同一文件的修改，会汇总至该文件的检查点跟踪；不同文件的AI修改，检查点跟踪相互隔离；但用户手动修改、其他软件修改文件，不会被系统跟踪、不生成检查点。  - 检查点用来快速撤销、回退当前对话里的修改，只做临时恢复，不可替代Git等专业版本控制系统。  - 对于项目外文件，检查点仅支持回退对话记录，不支持回退文件内容。   |
   
#### 自动跟踪
华为云码道代码智能体的自动跟踪功能如下：
- **跟踪所有编辑**：自动跟踪AI文件编辑工具产生的文件修改。
- **按提示词创建检查点**：用户每次提交提示词，系统均会在AI执行编辑前创建检查点，保存当前代码状态。
- **持久化**：您可以在历史会话中选择恢复到某一个检查点的历史代码，每一检查点的有效期为15天。
 
#### 回退对话
1. 参考[快速启动](https://support.huaweicloud.com/usermanual-codeartsagent/codeartsagent_ug_0002.html)操作，登录华为云码道代码智能体IDE。
2. 在聊天界面的输入框下方选择"内置 \> 智能体"，切换到**智能体** 模式。右侧显示当前选用的模型，您可在下拉框中切换不同大语言模型。
   
   ![](https://support.huaweicloud.com/usermanual-codeartsagent/public_sys-resources/note_3.0-zh-cn.png)
   如果没有正常显示华为云码道代码智能体的聊天窗口，请在顶部菜单栏的右上方，单击**展开AI侧栏** 图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002608066869.png)，即可打开华为云码道代码智能体。
   
   
3. 在华为云码道代码智能体聊天界面中，回退对话。 
   ![](https://support.huaweicloud.com/usermanual-codeartsagent/public_sys-resources/caution_3.0-zh-cn.png)
   回退操作不可撤销，请谨慎操作。
   在历史对话中回退指定对话
   1. 单击右上角的对话历史图标 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002608141831.png)，进入近期对话页面。
   
   2. 单击待回退的对话名称，进入对话详情页面。
   
   3. 将鼠标悬浮在待回退对话上，单击 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002608141841.png)，弹出恢复确认对话框。
      - 若存在文件修改，则显示待恢复的文件名。
      
      - 若未修改文件，则显示为空。
      
      
      图1恢复确认对话框（已修改文件）   
      ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002687359177.png "点击放大")
      图2恢复确认对话框（未修改文件）   
      ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002657321364.png "点击放大") 
   
   4. （可选）若存在文件修改，单击待恢复的文件名，在编辑区域查看回退前后的差异对比视图。
      图3差异对比视图   
      ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002629897730.png "点击放大") 
   
   5. 单击"确定"，回退对话。
      - 若存在文件修改，文件回退至历史代码状态，且当前对话中该时间点及之后的对话消息消失。
      
      - 若未修改文件，当前对话中此时间点及之后的对话消息消失。
       
    
   在当前对话中回退指定对话
   1. 将鼠标悬浮在待回退对话上，单击 ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002608141841.png)，弹出恢复确认对话框。
      - 若存在文件修改，则显示待恢复的文件名。
      
      - 若未修改文件，则显示为空。
      
      
      图4恢复确认对话框（已修改文件）   
      ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002687359177.png "点击放大")
      图5恢复确认对话框（未修改文件）   
      ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002657321364.png "点击放大") 
   
   2. （可选）若存在文件修改，单击待恢复的文件名，在编辑区域查看回退前后的差异对比视图。
      图6差异对比视图   
      ![](https://support.huaweicloud.com/usermanual-codeartsagent/zh-cn_image_0000002629897730.png "点击放大") 
   
   3. 单击"确定"，回退对话。
      - 若存在文件修改，文件回退至历史代码状态，且当前对话中该时间点及之后的对话消息消失。
      
      - 若未修改文件，当前对话中此时间点及之后的对话消息消失。
       
    
   
   
 
#### 相关文档
如果您需要了解检查点的端到端使用示例，请参见[检查点会话回退最佳实践](https://support.huaweicloud.com/bestpractice-codeartssnap/codeartsdoer_bp_0007.html)。本实践通过轻量化咖啡点单系统，演示检查点在会话编辑过程中的状态存档、精准回滚、界面还原能力。