使用 Hyla

改动

当会话在 git 仓库中工作时,Hyla 会显示它的分支和改动,让你在窗格旁审阅智能体的工作。

分支一览

每个窗格的标题会显示它所在的分支,以及自上次提交以来改动增加和删除的行数:fix-login +40 −2。进行中的合并或变基也会显示在这里。

在边栏中,如果会话所在的分支不是仓库的默认分支(比如智能体在自己的 worktree 中工作),会直接显示该分支的名称。将鼠标悬停在会话上,可以看到它的分支、相对上游领先或落后多少,以及改动了多少文件。

改动面板

点击窗格的分支,或按 ⌥ ⌘ G,即可在会话右侧打开改动面板。它列出改动过的文件,以及每个文件增加和删除了多少,比较基准可以是以下之一:

  • 上一轮:会话中的智能体上一次开始工作的位置,这样你只会看到它最近一轮做了什么,而不包括之前的改动。Hyla 会在智能体开始时为 worktree 拍一个快照,不会动你的暂存区和文件。
  • 未提交:上一次提交,包括未跟踪的文件。
  • 分支:当前分支从仓库默认分支分出的位置,与拉取请求中看到的一致。

每个文件下方紧跟着它的 diff,依次排列;智能体继续编辑时,diff 也会随之更新。滚动到较长的 diff 中时,文件名会固定在顶部。点击文件名可以折叠或展开它的 diff:二进制文件以及改动行数特别多的文件默认折叠。拖动面板边缘可以调整宽度。

面板较窄时 diff 以统一视图显示,足够宽时则并排显示。列表摘要右侧的按钮可以在两者之间切换,diff-layout 设置会记住你的选择。

审阅一轮改动

在 上一轮 中,将鼠标悬停在某处改动上,会出现两个按钮:

  • 还原:把旧的内容放回文件中。
  • 保留:将这处改动标记为已审阅,并隐藏它。

只有在会话中没有智能体正在工作时才能还原,这样就不会与智能体的编辑冲突;而且文件必须仍与 diff 所示一致。如果文件在此期间又有改动,则会重新显示。

在专属工作树中运行的会话

多个智能体在同一个检出目录里并行工作,会被彼此的改动绊住。会话 › 在工作树中新建会话…(⌘ ⌥ T)会询问分支名,然后在专属的 git 工作树中启动会话:一个从仓库默认分支创建并检出新分支的文件夹。

  • 工作树位于仓库内的 .hyla/worktrees/<branch>,Hyla 通过 .git/info/exclude(而不是你的 .gitignore)忽略它。设置 worktree-dir 可以把工作树放到别处。
  • 设置 worktree-base = current,可以从你所在的会话而不是默认分支创建分支。
  • 会话会加入仓库所在的项目,边栏中会显示它的分支。

关闭会话时,Hyla 会询问是否一并删除它的工作树:

  • 没有未提交的改动: 默认是“删除工作树”。分支若已合并会一并删除,否则会连同提交一起保留。
  • 有未提交的改动: Hyla 会说明有多少文件会丢失,默认是“保留工作树”。
  • 还有其他会话在这个工作树中工作: 工作树会保留,Hyla 不会询问。

在命令行中:

sh
hyla new --worktree fix-login -- claude   # 在专属工作树中、以新分支启动会话
hyla new --worktree fix-login --base dev  # 从 dev 创建分支
hyla close fix-login --remove-worktree    # 关闭会话并删除工作树
hyla close fix-login --remove-worktree --force   # 即使有未提交的改动

在命令行中查看

hyla diff 以 git diff 的格式打印窗格的改动,包括未跟踪的文件:

sh
hyla diff                       # 此窗格未提交的改动
hyla diff --turn                # 它的智能体在上一轮中改了什么
hyla diff review --branch       # review 会话自默认分支以来的改动
hyla diff src/auth              # 只看这些路径

hyla status --json 和 hyla ls --json 会在 git 字段中包含每个窗格的分支和改动。

关闭此功能

设置 git-status = false,或在设置中关闭 显示 Git 状态,Hyla 就不会再在你的仓库中运行 git。