> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/convai-playground/get-started/character-versioning.md).

# 角色版本管理

## 简介

在本节中，我们将介绍角色版本管理，即维护角色的不同状态。这使用户能够在尝试更多更改之前保留之前的稳定状态。现在，你可以放心地进行实验，而不必担心丢失角色的旧状态；如果你想放弃当前更改并返回到之前的版本，现在也可以恢复该版本并继续在此基础上工作。我们把这些已保存的状态称为 **快照** 的角色。

我们将在本节中介绍这些功能以及如何使用它们。

{% hint style="info" %}
……的概念 **快照** 和 **版本** 在文中被交替使用；不过，它们指的是同一个概念：在特定时间点定义该角色的状态/内容。
{% endhint %}

***

## 概述

角色版本管理选项位于角色编辑器区域右上角，旁边是 **Update** 按钮

<figure><img src="/files/4763cb0e55ae8646a95b3ee3f1bc96d0ed594063" alt=""><figcaption></figcaption></figure>

。点击后，你会看到所有之前保存的修订列表，并按日期排序。

<figure><img src="/files/d0e7258c937d47eb5fe5c0d90e13b7dd03f52d9e" alt=""><figcaption><p>角色版本管理部分。这里还没有快照。</p></figcaption></figure>

我们将在下一节从零开始讲解创建和维护快照的步骤

***

## 创建版本

让我们从一个已经保存好的角色开始。当我们打开与某个角色相关的详情时，看到的数据表示 **当前快照** 。当你与角色交互时，你本质上是在引用这里的所有数据 **当前快照** 的角色。

1. 要创建新版本，首先打开 **角色版本管理** 部分，并点击 **+ 添加快照** 符号。<br>

   <figure><img src="/files/a5e4fa5fe259603a7f51d8961364e5771660ad20" alt=""><figcaption><p>让我们创建第一个快照。</p></figcaption></figure>
2. 会出现一个弹窗，要求你为快照命名并填写一些描述。请注意， **快照名称** 是创建新版本的必填字段。填写完详细信息后，点击 **提交** 按钮。<br>

   <figure><img src="/files/1924aa41aeb47eec6d54a2da9ab18cd18f031f19" alt=""><figcaption><p>我们提供一个名称和简短描述。</p></figcaption></figure>
3. 现在，你可以在快照列表中看到新版本。那这个版本实际上代表什么呢？\
   这个快照存储了该时间点与角色相关的所有数据。关于角色的一切，从角色描述、具身，到知识库文件、叙事设计结构以及其他细节。<br>

   <figure><img src="/files/fc6e8ae357738571fbb267aa94b8408f69c32d49" alt=""><figcaption><p>快照会出现在列表中</p></figcaption></figure>

***

## 恢复版本

假设你已经继续对角色进行了一些工作，但你对结果不满意，想返回并从之前的版本重新开始。这时，你就可以将旧快照恢复为当前状态，并再次基于它继续工作。以下是需要遵循的步骤：

1. 要恢复版本，请打开 **角色版本管理** 部分并选择你想要恢复的快照。你会看到下面的 **恢复版本** 按钮开始可用。<br>

   <figure><img src="/files/b79bf2423cf2204b755fa481975c4a12b92cf737" alt=""><figcaption><p>我们将恢复第一个快照中的数据。</p></figcaption></figure>
2. 点击 **恢复版本** 按钮后，会出现一个弹窗，询问你是要将当前更改保存为新的快照，还是直接放弃。你可以选择将当前更改存为某个测试版本，并稍后再回头参考。<br>

   <figure><img src="/files/78e786bcf8ea8943ee83c18bc6f2e68555dbd781" alt=""><figcaption><p>我们直接将快照中的数据恢复到当前快照</p></figcaption></figure>
3. 目前我们更愿意放弃这些更改，所以我们将点击 **恢复** 按钮。这会将所选版本中的数据带到 **当前快照** 的角色。
4. 要保存这些更改，你也可以随时 **取消** ，然后返回，带着你的进度创建一个新的快照，再进行恢复。

***

## 删除快照

你也可以继续删除你不再需要的快照。为此，你可以点击角色版本列表中对应快照旁边的三个点，并选择 **删除版本**

<figure><img src="/files/018deb8792a54d9e9c118d6f01a02faea5db84e0" alt=""><figcaption><p>点击快照旁边的三个点，查看所有选项。</p></figcaption></figure>

### 一些需要记住的重要事项

在任何时候，你都可以与该 **当前快照** 角色交互。如果你有任何公开可用、使用该角色的应用，你的用户将只能与这个当前版本交互。

{% hint style="info" %}
我们目前正在开发一项功能，帮助开发者拥有与该 **当前快照**.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.convai.com/api-docs/zh/convai-playground/get-started/character-versioning.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.