- 入门指南
- 面向 Administrator
- RPA 工作流项目
- 应用程序项目
- 智能体流程
- Maestro 案例
- Flow canvas in Maestro Orchestrate
- Agents (智能体)
- Solutions (解决方案)
- API 工作流
- 测试
解决方案的版本控制
在 Studio Web 中启用和使用解决方案的版本控件,以跟踪、还原和协作处理解决方案版本,而不会覆盖团队成员的工作。
版本控制允许多个用户随时查看、跟踪和还原解决方案的不同版本,从而增强团队协作。这使开发者能够构建和测试自动化,而不会覆盖彼此的工作。
Studio Web 中版本控制的工作方式因 WorkSpace 类型而异:
- 云端工作区:通过“更改历史记录”面板中的快照管理版本控制。
- Local Workspace: version control is managed via Git in the Version control panel.
Cloud 工作区中的版本控制
Version control for solutions is handled within the Change history panel through snapshots. You can think of snapshots as "checkpoints" of the solution at various stages in its development. Snapshots preserve the entire solution state, including its automation projects, resources, and deployment configuration.
快照类型
快照有多种类型:
- Current version: The current (latest) version of a solution. It appears at the top of the list of snapshots in the Change history panel.
- 手动快照: 由用户手动创建的快照。它们具有名称和可选的说明。选择或指向手动快照会显示作者姓名和创建时间。只能以只读模式打开。
- 自动快照:关闭解决方案时自动创建的快照,以及在打开解决方案时每 40 分钟创建的快照。自动快照具有基于时间戳的名称(例如,“Auto快照 - 2026-03-14 10:40 UTC”)。
- 发布快照:每次发布解决方案时自动创建的快照。他们的名称是已发布的解决方案版本。指向发布快照将显示其作者姓名和创建时间。只能以只读模式打开。
备注:
有权访问解决方案的任何人都可使用所有快照,包括手动快照。
自动快照具有保留限制,具体取决于您组织的权益,并且可能会因许可计划而异:
- “每个解决方案的限制”(默认数量):每个解决方案保留的自动快照存在最大数量。达到此限制时,系统会在添加新快照时自动删除最旧的快照。
- 基于时间的限制: 系统会自动删除超过配置的保留期的自动快照。
更改历史记录面板
“更改历史记录”面板按时间顺序列出所有快照,显示其:
- 版本号和说明(例如,“v1.1.0- 包括反馈表单”)。
- 作者和时间戳(例如,“2 个月前,作者:John Doe”)。
- (例如,“测试 NetSuite 集成之前进行稳定的内部版本”)。
You can use the Filter button to control which types of snapshots appear in the Change history panel.
从面板中选择快照时,您将查看在该特定时间点存在的解决方案。浏览过去的快照时,系统会显示一条临时横幅消息,通知您正在以只读模式查看解决方案的过去版本。
创建快照
要创建新的手动快照:
- 打开“更改历史记录”面板。确保选中了“当前版本快照”。
- 选择面板右上角的“创建快照”按钮。
- 输入快照的名称。
- (可选)按Tab键或选择“添加说明”字段以输入说明。
- Select anywhere in the designer or press the Enter key. The new snapshot is created and is added in the Change history panel.
从快照还原
快照的主要功能之一是将解决方案还原到特定时间点。默认情况下,从快照还原解决方案会创建最新快照(即当前版本)的副本以供参考。这可确保您不会丢失在最新版本解决方案上所做的任何工作。当其他人正在编辑解决方案时,您无法还原快照。
要从快照还原解决方案,请执行以下操作:
- 打开“更改历史记录”面板。
- Point to a manual, auto, or publish snapshot.
- 选择“还原”按钮。系统将显示“还原快照”窗口。
- 在“标题”字段下,输入最新快照副本的必填名称。
- (可选)输入对解决方案更新所做的说明。
- 选择“还原”按钮。此时将显示一条横幅消息,通知您解决方案已成功还原到该特定时间点。
To restore without saving the latest snapshot (the Current version snapshot), turn off the Create a snapshot of the current version toggle in the Restore snapshot window, and then select Restore. In the Discard current snapshot window, select Discard and restore to confirm. The latest version of your solution is deleted.
常见问题
自动快照会影响性能吗?
不会。自动快照在后台创建,不会阻碍或减慢您在设计器中的工作。
我可以删除单个自动快照吗?
不能。自动快照由 Studio Web 自动管理,无法单独删除。系统会根据保留策略自动删除旧的自动快照。
自动快照是否占用存储空间?
是的。自动快照使用云存储空间。保留限制可确保存储使用量受到限制。
自动快照是否对有权访问解决方案的所有人可见?
是的。与所有快照一样,自动快照可供任何有权访问该解决方案的人使用。
共享解决方案中的自动快照会怎样?
共享解决方案遵循与自有解决方案相同的自动快照策略。系统会为打开并使用解决方案的所有用户创建自动快照,所有有权访问的人均可查看所有快照。
我可以为本地解决方案创建自动快照吗?
否。自动快照仅适用于云解决方案。
本地工作区中的版本控制
Studio Web 与 Git 集成,可为计算机上本地保存的解决方案启用高效的版本控制。
As a prerequisite, make sure you are working on a locally saved solution:
- 打开 Studio Web。
- 导航至“本地工作区”页面。
- 通过“打开解决方案” 按钮打开现有的本地解决方案,或使用“新建” 按钮创建一个新的解决方案。您还可以从先前打开的解决方案列表中选择现有解决方案。
- Select the folder where an existing solution is saved locally or indicate a folder where the new solution is created. Your new local solution opens.
重要提示:
当浏览器提示时,允许 Studio Web 编辑文件。
- Open the Version control panel.
首次打开该面板时,系统会指示您初始化本地 Git 存储库。此为必要步骤,选择“初始化存储库”按钮后系统会自动执行此步骤。在初始化本地 Git 存储库时,Studio Web:
- 创建一个
.gitignore文件。 - 使用解决方案中的当前文件进行初始提交。
- Creates a local branch named
main.
main分支名称仅适用于通过 Studio Web 初始化的存储库。如果您连接到现有存储库(手动创建或从远程克隆),Studio Web 将使用该存储库的现有默认分支。您可以随时手动重命名任何本地分支。
Git version control can be enabled or disabled from a dedicated toggle in the Version control panel header. You can have version control enabled for some solutions and disabled for others. If you initialize a new repository, version control is enabled automatically.
.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 字节码缓存目录。 |
创建和管理分支
从版本控制面板的左上角选择分支名称,以:
- 通过“创建新分支”按钮创建一个新分支。输入分支名称,然后选择创建。该分支将添加到可用分支列表中。如果名称与现有分支匹配,则该字段上会显示内联错误,并且不会创建分支。
- 通过从本地分支或远程分支下的列表中选择分支名称来切换分支。
分支分为本地分支和远程分支。
切换本地分支: Studio Web 保留任何不受切换影响的未提交更改。
如果文件包含与目标分支冲突的未提交更改,则会显示一个确认对话框,询问是否放弃这些更改并继续。拒绝对话将取消切换,您的更改会保持不变。
您本地删除的文件在切换后会保持删除状态,并仍显示在“更改”下,作为您可以放弃的删除项。解决方案将重新加载,以反映新分支。
切换到远程分支:当您切换到一个被追踪的远程分支时,Studio Web 会检查本地分支是否与远程分支相符:
- 如果您的本地分支是最新版本,或者可以干净地快进,则切换会立即发生,无需确认。
- 如果切换将放弃未推送的本地提交或未提交的更改,则在切换之前会显示一个确认对话框。
在分支切换或还原过程中, “版本”控制面板将暂时禁用,并显示要切换到的目标分支的名称。这会导致其他操作(例如提交或推送)无法运行,直到切换完成为止。
连接到远程存储库
要将现有的本地存储库连接到远程存储库,请执行以下操作:
- 选择版本控制面板右上角的选项图标。
- 选择“连接到 GitHub”按钮。系统将显示 GitHub 身份验证窗口。
- 使用GitHub Integration Service 连接器对 GitHub 进行身份验证。
- 成功进行身份验证后,在“存储库 URL”字段中输入远程存储库的 URL。
- 选择“保存配置”按钮。
- 或者,也可以选择“返回”以返回到“版本” 控制面板。
提交并推送更改
创建解决方案时,您所做的更改将记录在“版本”控制面板中的“更改”下。选择列表中的每项更改,即可并排查看更改情况。更改已突出显示,如下所示:
- 绿色和 + 图标表示项目文件中已添加某些内容。
- 橙色和 / 图标表示该文件已被修改。
- Red and the - icon indicate that something has been removed from a project file.
要提交对解决方案所做的更改并将其推送到您当前所在的分支,请执行以下操作:
- 选择“版本” 控制面板中的“提交”按钮。
- 输入提交消息。提交中包含的更改显示在“更改”部分下。
- 选择以下选项之一:
- Commit to commit your changes without pushing them. Your new commit appears in the Commit history section.
- Commit & Push to commit your changes and push them to the current branch in the configured remote repository. This option is available only after you connect to a remote repository.
To push commits that you made earlier, select the Push button next to the Commit button in the Version control panel.
如果远程分支包含您在本地没有的提交,则推送会被拒绝,并显示推送被拒绝窗口。选择“强制推送”以推送本地提交。
强制推送会使用本地历史记录覆盖远程存储库的提交历史记录,从而绕过 Git 的常规安全检查:
- 重写远程历史记录:它将远程分支上的提交替换为本地提交。
- 放弃提交:远程上任何不属于本地分支的提交都将从远程中删除。
- 更新分支指针:将远程分支指向您的本地提交。
查看提交历史
“提交历史记录”部分按时间顺序包含从初始提交开始的所有提交内容。每次提交都会显示有关其作者和创建时间的信息。
Select a commit from the list to see the Changes section for that particular commit.
打开提交的上下文菜单,然后选择:
- 从此提交开始创建分支,从此提交开始创建一个新的本地分支。为新分支命名,然后选择创建。新分支现已处于活动状态,并显示在可用分支列表中。
- 将本地分支重置为此提交,可将当前分支还原到创建提交时的状态。比本次提交新的提交会自动从“提交历史记录”中删除。