GitTree桌面手册

使用 GitTree 进行日常工作

GitTree 是适用于 macOS、Windows 和 Linux 的桌面 Git 客户端。登录后，每个本地 Git 任务都在免费计划中：打开、克隆、提交、分支、合并、变基、存储和撤消。 GitTree Pro 添加了托管集成、CI/CD 运行、AI 起草和 AI 助手 Nour。

在 macOS 上安装 GitTree

Mac 版 GitTree 是一款适用于 macOS 13 或更高版本的 Apple 芯片和 Intel Mac 的通用应用程序，由 Apple 签名和公证。首先安装Git，打开.dmg，将GitTree拖到应用程序中并启动它。

在 Windows 上安装 GitTree

Windows 的 GitTree 是 Windows 10 (22H2) 和 Windows 的 64 位安装程序。 11. 首先安装 Git for Windows，选择 Microsoft Store 或直接 EXE，然后从“开始”菜单启动 GitTree。

在 Linux 上安装 GitTree

Linux 的 GitTree 为 Ubuntu 22.04 或更高版本和 Debian 12 或更高版本的 .deb，以及可移植的 AppImage，两者均适用于 64 位 x86_64。首先安装 Git 2.39 或更新版本，然后使用 apt 安装 .deb 或运行 AppImage。

找到 Git 并设置您的提交身份

GitTree 运行您计算机上安装的 Git，并且从不捆绑它。它需要 Git 2.39 或更新版本，以及您的提交的名称和电子邮件（user.name 和 user.email），这是第一次提交需要它们时询问的。

找到你的路GitTree

存储库选项卡有六个部分：选项卡栏、工具栏、侧边栏、提交图、检查器和状态栏。此页面显示每个人的位置以及您在那里做什么。 使用 GitTree 可视化查看并安全管理您的提交历史记录、分支、差异和暂存更改。

创建您的第一个提交

提交会保存您暂存的更改的快照，并附有一条说明原因的消息。在 GitTree 中，您在更改面板中暂存一个文件，输入摘要并按 Commit：新提交将显示在图表顶部。

免费使用本地Git，了解Pro

GitTree 中的每项本地 Git 功能对于所有使用 GitTree 帐户登录的人都是免费的。 GitTree Pro 添加了 Nour、托管集成和 AI 起草；您可以通过免费试用来尝试它们，该试用仅在您提出要求时才开始。

打开现有存储库

选择您计算机上已有的 Git 存储库的文件夹，然后 GitTree 在其自己的选项卡中打开它，其中包含提交图、分支和更改。未上传任何内容：存储库保留在您的计算机上。

克隆存储库

克隆将存储库从 GitHub、GitLab、Bitbucket、Azure DevOps 或任何 Git 服务器复制到您的计算机及其历史记录。在 GitTree 中粘贴 URL，选择其所在位置并按 Clone；完成后，它会在新选项卡中打开。

创建存储库

初始化会将文件夹变成 Git 存储库，与 git init 相同。在 GitTree 中，您选择文件夹和初始分支，可以选择添加 .gitignore 和许可证，然后按 Initialize。

使用最近和最喜欢的存储库

新选项卡列出了您在 Recent 下打开的存储库以及您在 Favourites 下加星标的存储库。选择一个以在选项卡中将其打开。这些列表保留在此计算机上。

在磁盘上查找存储库

Scan for Repositories… 浏览您选择的文件夹并列出每个 Git 存储库（最多三个文件夹）。除非您选择，否则不会打开任何内容；您可以打开一个或将它们添加到工作区。

检查存储库信任

某些存储库包含 Git 设置或挂钩，当 Git 在其中运行时，这些设置或挂钩会在您的计算机上运行程序。在此之前，GitTree 会准确地显示 Trust this repository? 所找到的内容，并让您信任它或在 Restricted mode 中打开它。

打开裸存储库

裸存储库有历史记录，但没有工作文件，就像服务器保留供其他人推送到的文件一样（git init --bare，git clone --bare）。 GitTree 打开它以显示图表、分支和标签，标记其选项卡 bare，并关闭需要工作文件的操作。

管理存储库选项卡

每个存储库都会在窗口顶部的自己的选项卡中打开。选项卡显示存储库的状态，例如未提交的更改或正在进行的变基，您可以通过键盘在它们之间切换。 使用 GitTree 可视化查看并安全管理您的提交历史记录、分支、差异和暂存更改。

读取提交图

提交图将存储库的历史记录显示为行，最新的在前，通道在分支开始的地方分割并在合并的地方连接。行上的标签显示分支和标签；复选标记显示您所在的分支。 使用 GitTree 可视化查看并安全管理您的提交历史记录、分支、差异和暂存更改。

查找提交

在图表中按 Ctrl+F（Mac 上为 ⌘F）并键入提交消息的一部分、作者、SHA、分支或标签。 GitTree 突出显示匹配项以及它们之间的移动； Filter Graph 缩小了历史记录本身。

检查提交

在图表中选择一个提交，右侧的检查器会显示有关它的所有内容：消息、完整的 SHA、其父级、编写和提交它的人以及它更改的文件。选择一个文件以查看其差异。 使用 GitTree 可视化查看并安全管理您的提交历史记录、分支、差异和暂存更改。

聚焦和过滤图表

在繁忙的存储库中，Focus on Current Branch 仅显示您的分支、其上游和基础，以及自基础以来的提交次数。 Filter Graph… 保留作者的提交、日期范围或路径。过滤永远不会删除历史记录； Clear Graph Filter 返回每一行。

自定义图表列

该图默认显示分支标签、通道和消息。 Graph columns 菜单添加 Author、Date 和 SHA 列并切换为紧凑行；您可以调整每列的大小并隐藏侧面板。

比较提交并根据选择采取行动

按住 Ctrl（在 Mac 上为 ⌘）选择两个提交，然后选择 Compare These Two Commits 以查看每个不同的文件。多个提交的选择有其自己的操作：复制 SHA、挑选、恢复、压缩或创建补丁。

使用图表拖放

将一个分支标签拖到图表中的另一个分支上，GitTree 提供两者可以执行的操作：Fast-forward、Merge 或 Rebase。除非你做出选择，否则什么都不会发生；通常的确认和撤消适用。

审查工作变更

Working Changes 面板是 GitTree 的 git status：它列出了自上次提交以来您更改的每个文件，分为 Unstaged Files 和 Staged Files，并显示您选择的文件的差异。

舞台文件、帅哥和选定的台词

提交仅包含您暂存的内容。在 GitTree 中，您可以暂存整个文件、其中的一部分，或者只是您在差异中选择的行，其余的编辑内容将保留在工作文件夹中以供以后提交。 使用 GitTree 可视化查看并安全管理您的提交历史记录、分支、差异和暂存更改。

编写提交消息并提交

提交表单位于暂存文件下方：Summary 行、可选的 Description 和用于共同作者、签核、挂钩和随后推送的 Commit Options。 GitTree 在您提交之前指出常见的消息错误。

修改最后一次提交

修改会将最后一次提交替换为包含更正消息和您现在暂存的任何更改的新提交，例如 git commit --amend。在 GitTree 中，它是提交表单中的 Amend Previous Commit 开关。

放弃更改并清理未跟踪的文件

丢弃会将文件恢复到上次提交或暂存的状态，例如 git restore；清理会删除 Git 不跟踪的文件，例如 git clean。 GitTree 首先保存恢复快照，以便 Undo 可以将它们恢复。

选择并使用差异视图

GitTree 中的每个差异都可以显示为 Hunk、Inline 或 Split（并排）。突出显示更改的单词、换行、忽略空格更改、预览 Markdown 以及从一个更改跳到下一个更改。

忽略来自 GitTree 的文件

您不想提交的文件（例如构建输出或本地设置）属于 .gitignore。右键单击工作更改中的新文件并选择要忽略的内容，或直接使用 Edit .gitignore… 编辑 .gitignore。

创建并应用补丁

补丁是一种将更改从一个存储库传送到另一个存储库的文件。 GitTree 将文件的更改或一个或多个提交保存为补丁，并将补丁应用到您的工作树、暂存或作为当前分支上的提交。

查看图像和二进制更改

文本差异无法显示图像。当 PNG、JPEG、GIF、WebP 或其他图像发生变化时，GitTree 会比较之前和之后的图片：Side by side、Swipe 或 Onion skin。其他二进制文件显示其大小。

管理跟踪文件索引标志

有时您仅更改计算机上的跟踪文件，例如本地配置。两个 Git 标志隐藏了此类更改：Skip Worktree… 保留您的副本并停止显示其更改； Assume Unchanged… 是一种加速，可阻止 Git 检查文件。两者都不是忽略文件的方法。

创建和切换分支

分支是工作线的可移动名称。在 GitTree 中，工具栏中的 Branch 在您所在的提交处创建一个；右键单击任何提交以在其中创建一个。双击分支标签即可切换到该分支。

重命名和删除分支

右键单击 Rename 和 Delete 的分支标签。删除本地分支会首先将其最后一次提交保存在 refs/ogt/trash 下，因此 Undo 将其恢复；在远程删除是一个单独的、名称明确的选择。

创建和管理标签

标签是一次提交的固定名称，通常是一个版本，例如 v2.2.0。右键单击提交，选择 Tag Here，然后选择轻量级或带注释的标记。标签不会随您的提交一起推送：使用 Push Tag 推送每个标签。

设置跟踪并发布分支

新分支仅存在于您的计算机上，直到您推送它为止。第一个 Push 询问将其发送到哪个远程分支，然后分支将跟踪该远程分支（其上游），例如 git push -u。 Set Upstream… 改变它跟踪的内容。

比较分支和标签

Compare References… 按名称比较任意两个分支、标签、远程分支或提交。它显示一个提交在另一个之前和之后的提交数量，以及不同的文件：每个差异 (git diff A B) 或仅新一侧自拆分以来更改的内容（A...B，拉取请求显示的内容）。

使用 Gitflow 操作

Gitflow 是一个分支模型，具有生产分支、开发分支以及功能、发布和修补程序分支。 GitTree 的 Gitflow 部分对其进行初始化，并启动和完成这些分支，并为您合并、标记和删除它们。

识别并保持分离的 HEAD

签出提交或标签而不是分支会将您置于 detached HEAD 上：您不在任何分支上。您可以环顾四周，甚至可以提交，但新提交不属于任何分支。创建一个分支来保留它们，或者签出一个分支以返回。

获取、拉动和推送

Fetch 下载遥控器上的新内容，而不改变您的工作。 Pull 将您分支的上游引入其中。 Push 将您的提交发送到远程。这三个选项都在工具栏中，其选项位于旁边的箭头菜单中。

添加和编辑遥控器

远程是其他地方的存储库的命名副本，例如 GitHub 上的 origin。左侧面板的 Remote 部分列出了它们； Add Remote… 添加一个，右键单击远程可编辑、获取、修剪或删除它。

选择远程凭据

GitTree 运行您自己的 Git，因此可以按照 Git 在您的计算机上执行的方式获取、拉取和推送签名：通过您的凭据助手通过 HTTPS，通过您的密钥或 SSH 代理通过 SSH。密码和令牌保留在您的系统钥匙串中，而不是在 GitTree 的文件中。

配置自动抓取

自动提取功能可以使图表中的远程分支保持最新状态，而无需您按 Fetch All。在几分钟内为每个打开的存储库设置 Auto-fetch interval，为一个存储库覆盖它，并在新提交到达时收到桌面通知。

使用带租约的强制推送

在修改、变基或重置已推送的提交后，正常推送将被拒绝。 Force Push (With Lease)… 将远程分支替换为您的分支，但前提是它仍然是您上次提取分支的位置，例如 git push --force-with-lease。 GitTree 绝不会以任何其他方式强行推动。

使用有限的存储库历史记录

浅克隆仅下载最新的提交；无 blob 克隆仅在需要时下载文件内容。两者都可以快速克隆巨大的存储库。在浅克隆中，图表显示历史停止的位置，而 Fetch More History 或 Fetch Full History 则显示其余部分。

合并分支

合并会将另一个分支的提交引入您所在的分支，例如 git merge。右键单击另一个分支并选择 Merge … into …：GitTree 首先检查冲突并让您选择如何记录合并。

重新设定分支基础

变基会在另一个分支之上重放您分支的提交，因此历史记录保持一条直线，例如 git rebase。提交获得新的 ID； GitTree 将旧分支保留在 refs/ogt/trash 下，而 Undo 将其恢复。

解决合并冲突

当两个分支更改相同的行时，就会发生冲突。 GitTree 的解析器并排显示两个版本，A 和 B：勾选要保留在每个冲突中的行，检查 Output，然后检查 Save 并继续合并、变基或择优挑选。

择优挑选并恢复提交

Cherry-Pick Commit 将一项提交的更改作为新提交复制到当前分支，例如 git cherry-pick。 Revert Commit 添加了一个撤消提交的新提交，例如 git revert：收回已推送内容的安全方法。

继续、跳过或中止操作

合并、变基、挑选或恢复可能会中途停止，通常是因为发生冲突。图表上方的横幅命名了操作及其步骤，并提供了 Resolve、Continue、Skip（变基）和 Abort…。中止会先保存它丢弃的内容，因此 Undo 将其恢复。

重复使用记录的冲突解决方案

启用 Reuse recorded resolutions (rerere) 后，Git 会记住您解决冲突的方式，并在冲突再次出现时（例如在重复变基期间）写入相同的解决方案。 GitTree 会告诉您问题发生的时间，并让您在将文件标记为已解决之前进行查看。

使用交互式变基编辑历史记录

交互式变基会重写所选提交之上的提交：保留、改写、编辑、压缩、修复或删除每个提交，然后将它们拖到新的顺序中，例如 git rebase -i。对于单个更改，提交菜单中的 Edit History 可以一步完成。

壁球提交

压缩将多个提交合并为一个，就像 git rebase -i 中的 fixup 或 squash。在 GitTree 中，每个挤压都会首先打开 Squash 对话框：它显示折叠的提交、结果、消息以及谁获得荣誉，在您确认之前不会发生任何变化。您未提交的工作永远不会被触及，并且 Undo 将提交放回原处。

更改选定的本地提交

要快速更改历史记录，您不需要整个交互式变基编辑器。提交的 Edit History 菜单可以编辑其消息、删除消息或上下移动消息；选择多个提交将打开 Squash 对话框。 GitTree 重写其上方的提交并保留旧分支，因此 Undo 将其放回原处。

将分支重置为提交

重置会将当前分支移动到另一个提交，例如 git reset。 Soft 保留所有更改，Mixed 将它们保留在您的工作文件夹中，Hard 丢弃它们。 GitTree 首先保存 refs/ogt/trash 下的所有内容，因此即使是硬重置也可以撤消。

撤消和重做

GitTree 记录您的 Git 操作，以便工具栏中的 Undo 可以取回最后一项：提交、合并、变基、重置、丢弃、清理、删除的分支或标记。 Redo 再次执行此操作。破坏性步骤在运行之前会在 refs/ogt/trash 下保存恢复快照。

查找以前的分支提示

reflog 记录分支或 HEAD 每次移动时指向的位置：提交、签出、重置、变基。 View Reflog… 列出了这些条目；选择一个以在图表中显示其提交或 Restore as Branch。

归档历史和责任

History 列出更改文件的每个提交，并重命名，例如 git log --follow。 Blame 显示每行的提交和最后更改它的作者，如 git blame。两者都是文件工作区的视图。

使用二等分工作流程

Bisect 通过将有问题的提交和没有问题的提交之间的历史记录减半来查找第一个引入问题的提交，例如 git bisect。选择两个提交，测试提交 GitTree 签出，将其标记为 Good 或 Bad，然后重复，直到命名为 First bad commit。

导出存档

Export Archive… 将提交、分支或标记的文件写入 .zip 或 .tar.gz，而不包含 .git 文件夹，如 git archive。这是向某人提供版本源的最快方法。

使用存储库维护和创作工具

Repository Maintenance… 显示对象数据库的大小并运行检查它或使历史记录和状态更快的任务。 Merge Author Identities… 写入 .mailmap 行，以便具有多个姓名或电子邮件的人显示为一位作者。

整理工作空间

工作区是作为一个单元打开的一组命名存储库，例如“客户端 A”或“移动设备”。它的仪表板显示每个存储库的分支、同步状态和更改，以及跨它们运行的​​拉取请求和 CI/CD。

管理已保存的存储库

每个工作区都会保存一个 Saved repositories 列表：您在当前工作区时打开、克隆、创建或通过扫描添加的每个存储库都会保存在那里，并在其选项卡关闭后保留下来。一次性从列表中打开它们，或者删除一个；它的文件夹从未被触及。

隐藏更改

存储将您未提交的更改放在一边，并为您提供一个干净的工作文件夹，例如 git stash，以便您可以切换任务并稍后返回更改。工具栏中的Stash保存所有内容；更改面板的 Stash 选项卡准确选择内容。

使用工作树在多个分支上工作

工作树是同一存储库的第二个工作文件夹，具有自己的签出分支，例如 git worktree add。检查拉取请求、运行长时间构建或让编码代理在其中一个中工作，而无需在另一个中隐藏任何内容。

管理子模块

子模块是在特定提交时固定在您的存储库中的另一个存储库。 GitTree 列出它们的状态（未初始化、最新、不同提交、冲突）并添加、初始化、更新、打开、编辑和删除它们。

使用 Git LFS 控件

Git LFS 在存储库外部存储大型文件，例如图像、视频或模型，并将小型指针文件保留在其位置。 Git LFS… 进行设置、跟踪模式、下载内容、锁定文件并修剪旧内容。

浏览和编辑项目文件

左侧面板的 Files 部分显示项目的文件夹，标记保存更改的文件夹。打开文件以在 Graph 选项卡旁边的选项卡中读取或编辑它，并在 File、Changes、Blame 和 History 之间切换。

打开和编辑文件

您在 GitTree 中打开的文件在固定的 Graph 选项卡旁边有自己的选项卡。提交中的文件是只读的； Edit in Working Directory 打开项目中的副本进行编辑并 Save。如果文件在磁盘上同时发生更改，则 GitTree 不会保存任何内容并让您选择。

返回提交图

差异、文件、责任、历史、比较、管道和拉取请求在图表上打开。 Esc 关闭最上面的一个并返回到打开它的视图； Back to Graph 一次性将它们全部脱掉。打开的文件仅隐藏：它们的选项卡保留在 Graph 选项卡旁边。

使用内置终端

工具栏中的 Terminal 将在图表下方抽屉中的存储库根目录中打开一个 shell。在那里运行任何命令，包括 Git：图表和您的更改会随时更新。每个存储库选项卡都有自己的终端。

配置外部工具

首选项 › External Tools 选择 Editor、Diff tool 和 Merge tool GitTree 从文件菜单和冲突视图中打开。 Automatic 使用首次安装的 Visual Studio Code、Cursor 和 Antigravity； Custom… 使用您提供的参数运行任何程序。

创建并运行自定义操作

自定义命令通过 Custom actions 按钮以及提交、分支和文件菜单在存储库上运行您自己的程序。每个参数都完全按照编写的方式传递，不涉及 shell，并且命令的第一次运行准确地显示了在此之前将运行的内容。

使用命令面板查找操作

命令面板通过键入其名称的一部分来运行任何 GitTree 命令，并且还跳转到分支、提交、文件和打开的存储库。按 Ctrl+Shift+P（在 Mac 上为 ⌘⇧P），键入，然后按 Enter。

键盘快捷键

大多数 GitTree 命令都有快捷方式。按 Ctrl+/（在 Mac 上为 ⌘/）可查看应用程序内的完整列表，并在您键入时进行筛选； Customize… 其中任何一个都发生了变化。下表列出了默认值。

检查活动和通知

Activity Log 列出了 GitTree 运行的每个 git 命令及其输出、花费的时间以及是否失败； URL 中的令牌、密码和凭据将被删除。 Notifications 保留此会话中显示的消息，首选项 › Notifications 决定哪个弹出窗口以及您的系统是否也显示它们。

使用应用内功能指南

Feature Guide 列出了 GitTree 可以执行的所有操作、在哪里可以找到它及其快捷方式，按区域分组，并带有搜索框。 Show me 会将您带到已打开的存储库中的功能；需要存储库、Pro 或连接帐户的功能是这样说的。

连接GitHub

连接 GitHub 让 GitTree 列出您的存储库、拉取请求、问题和检查。使用浏览器登录（建议：您在 GitHub 自己的页面上批准 GitTree）或使用个人访问令牌。该令牌仅保存在您系统的钥匙串中。

连接 GitLab

GitTree 连接到 gitlab.com 或您指定的自我管理的 GitLab 主机。通过 OAuth 应用程序（对于 gitlab.com GitTree 使用自己的）使用浏览器登录，或使用该主机的个人访问令牌。该令牌仅用于该主机。

连接 Bitbucket 云

GitTree 通过三种方式连接到 Bitbucket Cloud (bitbucket.org)：在浏览器中使用您的 Bitbucket 帐户登录，通过帐户的电子邮件使用 Atlassian API 令牌，或者使用工作区、项目或存储库访问令牌。令牌仅保存在系统的钥匙串中。

连接 Bitbucket 数据中心

对于公司 Bitbucket 数据中心服务器，为其主机命名，然后使用其中的个人 HTTP 访问令牌，或通过管理员为 GitTree 创建的传入 OAuth 应用程序链接使用浏览器登录。 GitTree 仅与该主机对话。

连接 Azure DevOps

在浏览器中使用你的 Microsoft 帐户登录，或使用 Azure DevOps 的个人访问令牌。 GitTree 与 dev.azure.com 和 Microsoft 的配置文件服务对话以查找您的组织，然后列出他们的存储库、拉取请求和管道。

连接企业和自托管服务器

GitTree 连接到您公司自己的服务器：GitHub Enterprise Server、自我管理的 GitLab 和 Bitbucket Data Center。您指定主持人； GitTree 仅与该主机的 https:// 通信，且令牌仅用于该主机。浏览器登录需要管理员在其中注册的 OAuth 应用程序。

检查集成可用性

提供商并不都提供相同的东西。对于开放存储库的提供商和您的帐户，功能指南的 Integrations 选项卡显示什么是 Available、什么是该提供商的 Not offered by 以及什么是 Coming soon。

浏览并创建提供商存储库

连接帐户后，Clone a repository 按 Owner 列出该帐户的存储库并进行搜索，因此您无需复制 URL。 Publish Repository… 采用另一种方式：它在您的帐户上创建存储库，将其添加为远程并推送您的分支。

使用 GitTree 的叉子

分叉是您自己在提供者上的存储库的副本。 Create Fork… 要求提供商制作一份； Add Remote from Fork… 添加一个现有的 fork 作为遥控器。创建分支不会改变您的存储库中的任何内容，除非您添加它，并且现有的远程版本永远不会被替换。

拉取请求

连接托管帐户后，GitTree 在左侧面板中列出存储库的拉取请求，并使用 Review… 和 Merge… 在图表旁边打开每个拉取请求：其对话、提交、文件和检查。拉取请求是 GitTree Pro 的一部分。

创建拉取或合并请求

右键单击您的分支并选择 Start a Pull Request…。选择合并 From 和 Into 的内容，写入 Title 和 Description，添加审阅者，可选 Open as a draft，然后按 Create Pull Request。首先推送不在远程的分支。

审查并讨论变更

打开拉取请求，阅读 Files，然后按行旁边的 + 向您的评论添加行注释。 Review… 发送您的决定（Approve、Request changes 或 Comment），并带有 Summary 和每行注释。在提供商支持的情况下，可以回复并解决对话。

合并或关闭拉取请求

Merge… 询问提供者如何合并拉取请求，显示它是否为 Ready to merge，并仅提供存储库允许的 Merge method。 GitTree 仅当头部仍然是您查看的提交时才合并；如果新提交到达，则不会合并任何内容。

使用支持的问题操作

左侧面板的 Issues 部分列出了存储库的未解决问题。打开一个以阅读和评论，使用 New Issue… 创建一个，或使用 Create Branch from Issue… 开始工作。关闭和编辑问题发生在提供商的页面上：Open Issue in Browser。

检查检查和提交状态

GitTree 显示提交和拉取请求的 CI 状态：Checks passing、Checks failing、Checks running、Checks skipped 或 No checks reported，以及通过、失败、运行或跳过的数量。选择它可以查看运行情况、打开检查日志或 Re-run Check。

CI/CD 运行

GitTree 在左侧面板和图表旁边的完整列表中显示存储库主机的 CI/CD 运行，例如 GitHub 操作：通过的内容、失败的内容以及原因，包括 Re-run Failed Jobs、Cancel Run… 和 Run Workflow…。 CI/CD 是 GitTree Pro 的一部分。

浏览和过滤运行

CI/CD 列表显示存储库的每次运行，并在运行时自行更新。 Filters 将其缩小 Branch、Workflow、Status 和 Trigger； Mine 保持跑步； Watch 在后台保持运行更新并在完成时通知您。

读取作业和日志

打开运行并选择一个作业或步骤以在 Log 选项卡中读取其日志。 Jump to first error 直接走向失败，Search the log… 查找文本，Timestamps 和 Wrap 更改视图，Following 将正在运行的作业的实时输出保留在视图中，Save Log… 将其写入文件。

重新运行或取消管道

在运行中，Re-run Failed Jobs 仅重复失败的内容，Re-run All Jobs 重复所有内容，并且作业的菜单仅重新运行该作业（在 GitLab 样式阶段上为 Retry Stage）。 Cancel Run… 停止它； Force Cancel Run… 结束它而不让作业清理。任何取消都无法撤消。

运行工作流程

Run Workflow… 启动可手动运行的工作流程，例如带有 workflow_dispatch 触发器的 GitHub Actions 工作流程或 Bitbucket custom 管道。 GitTree 从您选择的分支的工作流程文件中读取输入，并为每个输入显示一个字段。

下载可用的工件

运行的 Artifacts 选项卡列出了它生成的文件，包括 Name、Size 和运行时间 Expires。 Save… 询问将其保存在哪里，并在提供商存储它时将其下载到那里； zip 被另存为 zip 并且 GitTree 不会打开它。

检查部署和环境

部署的运行会显示 Deploys to … 和 Environments 选项卡：每个环境、其部署、分支或提交以及时间。等待的部署显示 Waiting for approval；如果您是其审核者之一，则 Approve Deployment… 和 Reject Deployment… 会采取行动。这些改变了每个人的事情，并且无法挽回。

创建并检查管道文件

New CI/CD File… 在您的提供程序读取的地方写入一个起始文件，例如 .github/workflows/ 或 .gitlab-ci.yml；它永远不会覆盖现有文件。在 GitTree 中编辑它，按 Check with … 让提供商验证它，然后像任何文件一样提交它。

管理管道设置

CI/CD Settings 显示提供程序允许其他应用管理的内容：Variables、Secrets、Environments、Runners、Schedules、Caches、Definitions 和 Releases。秘密的值在安全系统提示中输入或从您选择的文件中读取，然后直接发送给提供商； GitTree 绝不会在其他地方展示、保留或发送它。

使用管道发布控件

CI/CD Settings › Releases 列出了存储库的版本。 New Release 命名一个标签（或从分支或提交创建一个标签），其中包含 Title、Notes (Markdown) 和人们可以下载的文件。除非您 Save as a draft，否则将为所有可以查看存储库的人发布版本。

向 Nour 询问管道故障

Explain Failure 打开 Nour，询问有关运行失败的问题。仅当您每次都批准时，Nour 才会读取失败步骤的日志（最多 64 KiB），并回答它认为出了什么问题以及要尝试什么。将答案视为建议：根据日志进行检查。

设置 AI 助手 Nour

Nour是GitTree的AI助手。它运行您已使用的编码代理 CLI，例如 Claude Code、Codex 或 Gemini CLI，以及您自己的订阅：GitTree 永远不会看到您的密钥。在Ask模式下Nour仅查看和回答；在 Agent 模式下，它可以在您允许的范围内执行操作。 Nour 是 GitTree Pro 的一部分。

向 Nour 询问您的工作

Nour 始终知道聊天的存储库和签出分支。输入 @ 以提及文件、文件夹、分支、提交或拉取请求、附加文件或告诉 Nour 有关其他分支的信息。消息框上方的方块显示What Nour is told；范围选择器决定聊天涵盖哪些存储库。

查看 Nour 个应用操作

在 Agent 模式下，Nour 可以通过自己的命令在 GitTree 中进行操作：打开视图、阶段、提交、获取、推送等。每个操作都属于一种类型（Look around、Change you can undo、Risky）并遵循您的选择；任何有风险的事情总是等待您点击批准卡。

起草提交或拉取请求

提交框和拉取请求对话框可以使用您已安装的编码代理 CLI 起草其文本：Generate commit message with … 读取您的暂存更改，Draft the title and description with … 读取您分支的提交。您审阅并编辑草稿；在您按下按钮之前，不会提交或打开任何内容。

管理 Nour 会话

每个聊天记录都保存在 Chat history 中的每个存储库中。 Stop结束当前回复； Nour 还会停止长时间不打印任何内容的代理。如果所选代理无法应答（未登录、未使用、缺少型号），则另一个已安装的代理可能会应答，并且 Nour 会说明原因。

查看Nour隐私和恢复

在每次可能更改文件的回合之前，Nour 都会保存工作树的快照； Changes from this turn 列出更改的内容，而 Undo this turn 将工作树放回原处。快照不涵盖存储库外部的推送或文件。您的消息将根据其提供商的策略发送至您选择的代理 CLI； GitTree 从不存储 API 密钥或调用模型本身。

配置代理和模型

首选项 › Nour (AI) › Agents 列出找到的代理 CLI GitTree，标记为 Installed 或 Not installed。选择 Agent for new chats、每个 Model（空使用代理自己的默认值）以及 First one installed 后面的 Automatic selection order。 Test 检查代理是否在此计算机上运行。

查找并更改首选项

首选项每个区域都有一个页面，例如 General、Profiles、SSH、Integrations、Nour (AI)、External Tools 和 UI Customization，以及每个打开存储库的 Repo-Specific Preferences。 Search preferences 按名称、说明或键查找设置，每个设置都会说明其位置：Saves to：App、Profile 或 Repository。

外貌和语言

首选项 › UI Customization 设置 Theme（浅色、深色和高对比度版本）、Follow the system appearance、Language（英语或阿拉伯语，从右到左排列）、Zoom、Dates 的显示方式和 Reduce motion。

配置 Git 和存储库行为

首选项 › General 保存 GitTree 驱动 Git 的方式：Git executable、Pull mode、Auto-fetch interval、变基选项、Long paths 和 Line endings。 Repo-Specific Preferences 会覆盖一个存储库的其中一些，例如其 Base branch、自动获取、提交模板以及它如何通知文件更改。

管理 Git 身份和配置文件

配置文件是提交的名称和电子邮件，以及可选的签名密钥和 SSH 命令，您可以在它们之间进行切换。默认情况下，它是 Passed to each git command GitTree 运行，因此 ~/.gitconfig 永远不会更改，并且存储库自己的名称或电子邮件仍然有效； Written to ~/.gitconfig 使每个 git 工具都使用它。

在 GitTree 中配置 SSH

首选项 › SSH 列出 .ssh 文件夹中的密钥、创建新密钥、显示 SSH 配置中的每个主机并测试连接。 GitTree 从不启动 SSH 代理，也从不编辑 ~/.ssh/config 或 core.sshCommand；您为 SSH 远程选择的密钥将传递给它运行的 git 命令。

配置提交和标签签名

首选项 › Commit Signing 选择 Format（OpenPGP、SSH 密钥或 X.509）和 Key，以及是否选择 Sign every commit 和 Sign every annotated tag。在您按下 Apply to Global Git Config 之前，不会写入任何内容。然后，图表和提交详细信息显示每个提交的签名状态。

配置工具和文件编码

使用首选项 › Editor › Default encoding 读取差异和非 UTF-8 的文件；字节顺序标记总是获胜，不适合的字节显示为 �。 Line endings (core.autocrlf) 决定 git 如何转换 CRLF 和 LF，而 Long paths 让 git 在 Windows 上创建超过 260 个字符的路径。

配置通知和日志记录

首选项 › Notifications 设置 Where notifications appear，是否为系统中的 Show success notifications 和 Desktop notifications。 General 中的 Extended logging 从下次启动开始将更多详细信息写入本地日志，以帮助诊断问题；没有任何东西被发送到任何地方。

配置 Nour 权限

两个设置绑定 Nour。 What Nour may do in a repository 设置代理本身可以执行的操作：Read only、Edit files, no commands 或 Everything, as in a terminal。 What Nour may do in GitTree 为应用操作的每种类型和区域设置 Never、Ask me first 或 On its own；危险的变化总是会问。

配置集成刷新

首选项 › Integrations 控制 GitTree 如何读取您的托管帐户：列表在 Refresh pull requests, issues and checks 之前可能存在多久、是否要 Refresh when I come back、CI/CD 日志默认值以及作者图片的来源。仅当 GitTree 的窗口位于前面时才会进行读取。

备份、导入或重置设置

首选项 › General › Back up, restore and reset 将您的应用设置、配置文件和 git 设置导出到文件、导入此类文件或重置所有内容。导出从不包含密码、令牌或帐户详细信息，也不包含任何存储库的设置。仅在您查看导入的 Git 设置后，它们才会写入 ~/.gitconfig。

检查并安装更新

GitTree 找不到 Git

GitTree 使用您自己的 Git 安装，并且从不捆绑或安装。如果没有找到，则显示 GitTree needs Git；如果找到的版本早于 2.39，则会显示 This Git is too old。安装或更新 Git，或按 Locate Git… 选择它，然后按 Check again。

存储库将无法打开

当文件夹无法打开时，GitTree 会说明原因并提供下一步：This folder is not a Git repository（初始化或选择另一个）、This cannot be opened as a repository（缺少路径）、GitTree cannot read this folder（权限）或 This repository belongs to another user（Git 的所有权检查）。

变化并不令人耳目一新

GitTree 通过系统的更改通知注意到其他程序中所做的编辑。在 WSL 文件夹和网络共享上，这些通知不会到达，因此 Automatic 每隔几秒检查一次文件夹。如果更改仍然出现较晚，请强制该存储库的检查模式或手动刷新。

远程身份验证尝试失败

Git 首先使用您自己的凭据助手或 SSH 密钥登录到远程。 … needs you to sign in. 表示没有回答； … refused the credentials sent for this repository. 表示发送的内容不再有效或不允许。修复 Git 使用的凭据；仅当您的助手没有任何内容或您选择将其用于存储库时，才会填写连接的帐户。

推送被拒绝

推送因以下三个原因之一而被拒绝，GitTree 会说明具体原因。 The remote refused …：远程提交了您的分支没有提交的内容。 The remote declined the push：钩子或分支保护说不，及其原因。 … moved：使用租约强制推送发现遥控器不再位于您上次获取它的位置，因此没有任何内容被替换。

Git操作需要注意的地方

当合并、变基、挑选、恢复或平分中途停止时，GitTree 会显示一个横幅（例如 Rebasing … onto …, step 3 of 7）并标记选项卡 rebase in progress。大多数命令都会等到完成：解决所有冲突，然后 Continue、Skip 该步骤或 Abort… 返回到开始的位置。

集成操作不可用

当托管操作无法使用时，GitTree 会说明原因，而不是默默地失败。通常的原因是：它是 GitTree Pro 的一部分；没有帐户连接到远程主机；令牌需要重新连接；您在提供商中的角色不允许这样做；提供商不提供该服务；或者提供商暂时限制请求。

Nour 无法开始或结束

Nour 在您的计算机上运行编码代理 CLI，因此大多数问题都是 CLI 的：未安装、未登录、没有剩余使用量、您设置的模型不可用，或者需要 Node.js。 GitTree 也会拒绝在受限存储库中启动轮次，或者当它无法保存使轮次不可撤销的快照时。

无法加载管道或日志

GitTree 说明运行或日志丢失的原因：This repository’s host does not list … runs.、This log has expired on …、This account may not read logs here.、… offers no log from outside its own page.，或者提供程序限制请求。大多数都有一个修复方法；有些只打开提供商的页面。

密钥环或 SSH 请求失败

GitTree 仅在您的系统钥匙串中保留帐户令牌、其登录和记住的 SSH 密码：macOS Keychain、Windows 凭据管理器或 Linux 上的 Secret Service（GNOME Keyring 或 KeePassXC）。当钥匙串拒绝时，GitTree 会要求您允许访问并重试；它永远不会退回到文件。

离线时使用 GitTree

GitTree 是本地优先：每个本地 Git 功能都无需连接即可工作，包括提交、分支、合并、变基、存储、历史记录和撤消。获取、拉取、推送、托管集成、CI/CD 和 Nour 的提供商需要网络；而离线时 GitTree 显示它读取的最后数据并这样说。

收集并分享支持报告

当 GitTree 捕获错误时，它会在此计算机上保存报告；没有任何东西被发送到任何地方。 Report a Bug… 显示要复制的内容（删除了令牌和密码的已保存报告或简短摘要），供您选择，然后在 GitTree 网站上打开支持表单供您粘贴。 Contact Support… 写入支持地址。