使用 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 不会询问。
在命令行中:
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 的格式打印窗格的改动,包括未跟踪的文件:
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。