- 入门指南
- 面向 Administrator
- RPA 工作流项目
- 应用程序项目
- 智能体流程
- Maestro 案例
- Maestro 流程
- Agents (智能体)
- Solutions (解决方案)
- API 工作流
- 测试
在 Studio Web 中启用和使用解决方案的版本控件,以跟踪、还原和协作处理解决方案版本,而不会覆盖团队成员的工作。
版本控制允许多个用户随时查看、跟踪和还原解决方案的不同版本,从而增强团队协作。这使开发者能够构建和测试自动化,而不会覆盖彼此的工作。
Studio Web 中版本控制的工作方式因 WorkSpace 类型而异:
- Cloud Workspace :通过“更改历史记录”面板中的快照管理版本控制。
- 本地工作区(本地) :通过“版本控制”面板中的 Git 管理版本控制。
Cloud 工作区中的版本控制
解决方案的版本控制通过“更改历史记录” 面板中的快照进行处理。您可以将快照视为解决方案“检查点”,即解决方案开发过程中的各个阶段。快照会保留整个解决方案状态,包括其自动化项目、资源和部署配置。
Snapshot types
快照有多种类型:
- 当前版本:解决方案的当前(最新)版本。它显示在“更改历史记录”面板中快照列表的顶部。
- 手动快照:由用户手动创建的快照。它们有名称和可选的说明。选择或将鼠标悬停在手动快照上,会显示其作者的姓名和创建时间。只能以只读模式打开。
- 自动快照:关闭解决方案时自动创建的快照,以及在打开解决方案时每 40 分钟创建的快照。自动快照具有基于时间戳的名称(例如,“Auto快照 - 2026-03-14 10:40 UTC”)。
- 发布快照:每次发布解决方案时自动创建的快照。它们的名称是已发布的解决方案版本。将鼠标悬停在发布快照上会显示其作者的姓名和创建时间。只能以只读模式打开。
备注:
有权访问解决方案的任何人都可使用所有快照,包括手动快照。
更改历史记录面板
“更改历史记录” 面板按时间顺序列出所有快照,并显示其:
- 版本号和说明(例如,“v1.1.0- 包括反馈表单”)。
- 作者和时间戳(例如,“2 个月前,作者:John Doe”)。
- (例如,“测试 NetSuite 集成之前进行稳定的内部版本”)。
您可以使用“筛选”按钮控制要在“更改历史记录”面板中显示的快照类型。
从面板中选择快照时,您将查看在该特定时间点存在的解决方案。浏览过去的快照时,系统会显示一条临时横幅消息,通知您正在以只读模式查看解决方案的过去版本。
自动快照具有保留限制,具体取决于您组织的权益,并且可能会因许可计划而异:
- “每个解决方案的限制”(默认数量):每个解决方案保留的自动快照存在最大数量。达到此限制时,系统会在添加新快照时自动删除最旧的快照。
- 基于时间的限制: 系统会自动删除超过配置的保留期的自动快照。
Creating a snapshot
要创建新的手动快照:
- Open the Change history panel. Ensure that the Current version snapshot is selected.
- 选择面板右上角的“创建快照”按钮。
- 输入快照的名称。
- (可选)按Tab键或选择“添加说明”字段以输入说明。
- Select anywhere in the Studio Web Designer or press the Enter key. The new snapshot is created and is added in the Change history panel.
Restoring from a snapshot
快照的主要功能之一是能够将解决方案还原到特定时间点。默认情况下,从快照还原解决方案会创建最新快照(即,当前版本)的副本以供参考。这可确保您不会丢失在最新版本的解决方案上所做的任何工作。
To restore a solution from a snapshot:
- Open the Change History panel.
- 将鼠标悬停在手动快照或发布快照上。
- 选择“还原”按钮。系统将显示“还原快照”窗口。
- 在“标题”字段下,输入最新快照副本的必填名称。
- (可选)输入对解决方案更新所做的说明。
- 选择“还原”按钮。此时将显示一条横幅消息,通知您解决方案已成功还原到该特定时间点。
- Alternatively, turn the Create a snapshot of the current version toggle off to discard the latest version of the solution.
Turning the Create a snapshot of the current version toggle off restores the solution without saving the latest snapshot (the Current version snapshot). This means that the latest version of your solution is deleted.
常见问题
自动快照会影响性能吗?
不会。自动快照在后台创建,不会阻碍或减慢您在设计器中的工作。
我可以删除单个自动快照吗?
不能。自动快照由 Studio Web 自动管理,无法单独删除。系统会根据保留策略自动删除旧的自动快照。
自动快照是否占用存储空间?
是的。自动快照使用云存储空间。保留限制可确保存储使用量受到限制。
自动快照是否对有权访问解决方案的所有人可见?
是的。与所有快照一样,自动快照可供任何有权访问该解决方案的人使用。
共享解决方案中的自动快照会怎样?
共享解决方案遵循与自有解决方案相同的自动快照策略。系统会为打开并使用解决方案的所有用户创建自动快照,所有有权访问的人均可查看所有快照。
我可以为本地解决方案创建自动快照吗?
否。自动快照仅适用于云解决方案。
本地工作区中的版本控制
Studio Web 与 Git 集成,可为计算机上本地保存的解决方案启用高效的版本控制。
作为先决条件,请确保您正在使用本地保存的解决方案:
- 打开 Studio Web。
- 导航至“本地工作区”页面。
- 通过“打开解决方案” 按钮打开现有的本地解决方案,或使用“新建” 按钮创建一个新的解决方案。您还可以从先前打开的解决方案列表中选择现有解决方案。
- 选择在本地保存现有解决方案的文件夹,或指定应用于创建新解决方案的文件夹。此时将打开新的本地解决方案。
重要提示:
当浏览器提示时,允许 Studio Web 编辑文件。
- 打开至版本控制面板。
首次打开该面板时,系统会指示您初始化本地 Git 存储库。此为必要步骤,选择“初始化存储库”按钮后系统会自动执行此步骤。在初始化本地 Git 存储库时,Studio Web:
- 创建一个
.gitignore文件。 - 使用解决方案中的当前文件进行初始提交。
- 创建一个名为“main”的本地分支。
main分支名称仅适用于通过 Studio Web 初始化的存储库。如果您连接到现有存储库(手动创建或从远程克隆),Studio Web 将使用该存储库的现有默认分支。您可以随时手动重命名任何本地分支。
您可以通过“版本控制”面板标头中的专用开关启用或禁用 Git 版本控制。您可以为某些解决方案启用版本控制,并对其他人禁用版本控制。如果初始化新的存储库,则会自动启用版本控制。
.gitignore
当您初始化本地 Git 存储库时,Studio Web 会自动创建一个.gitignore文件,其中包含以下条目:
| 文件 | 描述 |
|---|---|
.agent-builder | 临时捆绑的智能体工件。 |
.DS_Store | macOS Finder 元数据文件;不是源代码的一部分。 |
*_UiCache.zip | 生成的用户界面缓存存档;临时输出。 |
**/.local | 任意深度的本地缓存和临时数据目录。 |
*.crswap | 在崩溃恢复期间创建的临时交换文件。 |
**/.entities/EntitiesBundle.*.zip | 生成的实体捆绑包存档。 |
remote-repository.config.json | 用于远程存储库连接的 Studio Web 本地配置。 |
.sw-path-marker | 用于工作区路径跟踪的 Studio Web 标记文件。 |
venv/ | Python 虚拟环境目录。 |
.venv/ | 备用 Python 虚拟环境目录。 |
__pycache__/ | Python 字节码缓存目录。 |
创建和管理分支
从版本控制面板的左上角选择分支名称,以:
- 通过“创建新分支”按钮创建新分支。输入分支名称,然后选择“创建” 。该分支将添加到可用分支列表中。
- 通过从本地分支下的列表中选择分支名称来切换分支。切换分支时,解决方案将重新加载。
Branches are grouped under local branches and remote branches. When you switch to a tracked remote branch, Studio Web checks whether your local branch has diverged from the remote:
- If your local branch is up to date, or can fast-forward cleanly, the switch happens immediately with no confirmation required.
- If the switch would discard unpushed local commits or uncommitted changes, a confirmation dialog appears before the switch happens.
连接到远程存储库
要将现有的本地存储库连接到远程存储库,请执行以下操作:
- 选择版本控制面板右上角的选项图标。
- 选择“连接到 GitHub”按钮。系统将显示 GitHub 身份验证窗口。
- 使用GitHub Integration Service 连接器对 GitHub 进行身份验证。
- 成功进行身份验证后,在“存储库 URL”字段中输入远程存储库的 URL。
- 选择“保存配置”按钮。
- 或者,也可以选择“返回”以返回到“版本” 控制面板。
提交并推送更改
创建解决方案时,您所做的更改将记录在“版本”控制面板中的“更改”下。选择列表中的每项更改,即可并排查看更改情况。更改已突出显示,如下所示:
- 绿色和 + 图标表示项目文件中已添加某些内容。
- 橙色和 / 图标表示该文件已被修改。
- 红色和 - 图标表示某些内容已从项目文件中删除。
要提交对解决方案所做的更改并将其推送到您当前所在的分支,请执行以下操作:
-
选择“版本” 控制面板中的“提交”按钮。
-
输入提交消息。提交中包含的更改显示在“更改”部分下。
-
选择“提交” ,以提交更改而不推送更改。您的新提交将显示在“提交历史记录”部分中。
-
选择“提交并强制推送” ,以提交更改并强制推送。仅在连接到远程存储库后,此选项才可用。您的提交将推送到已配置远程存储库中的当前分支。
如果您有未推送的提交,请选择“版本”控制面板中“提交”按钮旁边的“强制推送”图标。
强制推送会使用本地历史记录覆盖远程存储库的提交历史记录,从而绕过 Git 的常规安全检查:
- 重写远程历史记录:它将远程分支上的提交替换为本地提交。
- 放弃提交:远程上任何不属于本地分支的提交都将从远程中删除。
- 更新分支指针:将远程分支指向您的本地提交。
查看提交历史
“提交历史记录”部分按时间顺序包含从初始提交开始的所有提交内容。每次提交都会显示有关其作者和创建时间的信息。
从列表中选择一个提交版本,然后查看该特定提交版本的“更改”部分。
右键单击某个提交版本,然后选择:
- 从此提交开始创建分支,从此提交开始创建一个新的本地分支。为新分支命名,然后选择创建。新分支现已处于活动状态,并显示在可用分支列表中。
- 将本地分支重置为此提交,可将当前分支还原到创建提交时的状态。比本次提交新的提交会自动从“提交历史记录”中删除。