文件改动
「文件改动」在一条连续视图里按文件展示工作树相对 HEAD 的全部变化,可逐文件还原、切到 linked Worktree,并挂着这个会话的变更请求。
更新于 2026年11月10日
「文件改动」是右侧工作区的固定标签,和「文件」并列。它统计整个工作树相对 HEAD 的变化:已暂存、未暂存和未追踪的文件都算,不是只统计 Agent 这一轮改了什么。默认是一条连续视图——所有文件的 diff 从第一个排到最后一个,文件列表只做导航。
范围
- 只罗列在会话目录、项目目录、附加目录里的文件,仓库其他位置不出现。
- 父目录里以
.开头的隐藏目录不展开;仓库根目录下的 dotfile 仍然列出。 - 按 Git 仓库分组,仓库名旁是该仓库的文件数和绿色
+A、红色-D总计。 - 文件列表里每个仓库的组头右侧还有两个按钮:「在 XX 打开终端」「在文件夹中显示 XX」。
浏览
- 面板够宽时文件列表常驻左侧;不够宽时收进工具栏最左的文件列表按钮,点开是浮层,选中后收起。
- 列表行有图标、文件名、
+N-N和状态字母:M已修改、D已删除、U未追踪、A新增。目录行可折叠,搜索时强制展开。 - 点列表里的文件滚到对应文件段;滚到哪个文件,列表里那一项跟着高亮。
- 未读小圆点只出现在 Agent 写工具改过的文件上,由 Bash 里的 git 命令造成的改动不会点亮。
- 搜索框在两个视图上方常驻,占位「搜索改动文件...」,有内容时显示匹配数量和一个清除按钮。
连续视图
- 按文件依次排开,每个文件有自己的头:折叠箭头、图标、路径、
+N -N;头随滚动贴顶,多个文件同一屏能连着读。 - 未改动的区段不铺开,收成一条「N 行未更改」,点开才补上那一段原文。
- 点文件头里的路径打开文件预览;改动本身留在视图里,不会被预览替换。
- 工具条从左到右:文件列表开关、
N 个文件 +A −D、全部展开 / 全部收起、并排 / 统一视图、自动换行、刷新改动。默认统一视图、自动换行。 - 单个文件超过 4000 行先收成一整条,点开才渲染;首屏按累计行数逐个展开,排在后面的大文件默认保持收起。
- 整份 patch 超过读取上限时只展示前面一部分文件,顶部提示「改动过大,仅展示前面一部分文件;完整内容请用文件列表逐个查看。」
还原
- 文件头右侧有还原按钮,提示「还原 <路径> 的改动」;未追踪文件没有这个按钮。
- 还原走
git restore,已暂存和未暂存一起丢弃。 - 确认弹窗:「确定要还原 <路径> 的所有变更吗?此操作不可撤销。」
- 页面没有接受 / 拒绝逐个 hunk 的操作。
工作目录与 Worktree
面板顶部是一条上下文栏:左边当前分支名,等宽小字,点开是工作目录下拉;加载中或读取失败时右侧多一段状态副标题。
- 下拉第一项「会话默认目录」,说明「查看会话与项目目录中的改动」。
- 分隔线下按「N 个 Worktree」列出该仓库已存在的 linked worktree,每行有分支名、完整路径、7 位提交号;当前项带「已激活」徽标和勾选。刷新按钮在下拉的状态行右侧。
- 行尾两个按钮:在右侧标签中打开该 worktree 的终端、删除这个 worktree。
- 没有创建 worktree 的入口,列表也没有的显示「这些目录暂未发现 linked Worktree。」,读取失败显示「暂时无法确认 Worktree 列表,请刷新重试。」
- 切换工作目录会同时改变会话的活动目录,之后的文件读写都落在新目录;worktree 目录被删掉后,会话回退到主仓库或最近的现有目录,不会卡在失效路径上。
删除 worktree 的确认弹窗写明:「将永久删除该目录内的全部文件,包括未提交、未追踪及忽略的文件,并移除 Git worktree 登记。分支和已提交记录会保留。此操作无法撤销。」
变更请求
上下文栏右侧挂这个会话的变更请求 chip,形如 ⤴ #326 · 2/2 通过:编号是 PR,后面是 CI 检查的通过比例;检查失败或仍在执行时换成对应文案和颜色。
- 点开 popover 列出绑定的全部变更请求:仓库、编号、状态、检查明细;每条都能打开、复制链接、刷新、隐藏。
- 没有绑定时 chip 退化成一个小
+,点开可以粘贴 PR 链接手动关联。 - 绑定来自 Agent 执行
gh pr create/view/edit/checkout的输出和分支发现,状态由后台轮询刷新;长时间没刷到会标「状态可能已过期」。 - 左栏会话行上的同一份状态见「会话列表」。
其他文件变更
Git 仓库之外的会话文件改动单独成段,标题「其他文件变更」,旁注「非 Git 目录,无基线可比较」。
- 每条带「新增」或「已编辑」,点击直接打开文件预览。
- 没有 diff、行数统计和还原。
- 只有这类改动时,空态写的是「当前目录不是 Git 仓库,或暂无文件改动」。
注意
- 文件内容超过 10MB 不读取;被删除的文件仍以
D留在列表里,diff 呈整文件删除。 - 二进制或只改了权限的文件没有可展示的行,段内直接写「该文件没有可展示的行改动(二进制或仅权限变化)」。
- 外部编辑器的修改不会实时推进列表,窗口重新获得焦点或用工具栏的刷新才会更新。
- 右侧工作区收起时,Agent 本轮结束且确实有新改动,会自动展开右侧并切到这一页;在此之前红点挂在标题栏的展开按钮上。
- 空态文案:「没有文件改动」「没有匹配的文件改动」。