跳转到内容

改动与文件预览

当 Agent 帮你修改或重构代码时,你需要快速确认它改了哪些文件、代码改得对不对。Condr 内置了只读的文件改动与预览视图,无需打开外部 IDE 即可完成审查。

  • 快捷键:按下 Cmd + Option + B (macOS) 或 Ctrl + Alt + B (Windows/Linux)。
  • 界面入口:点击右侧栏标题栏的侧栏按钮打开。

改动视图会根据 Git 状态将修改的文件分为三组:

  • Conflicts:存在合并冲突的文件。
  • Tracked:已追踪并被修改的文件。
  • Untracked:Agent 新建但尚未纳入 Git 追踪的文件。

每一个文件后都会标出新增和删除的行数,顶部会汇总累计变动行数。

改动列表上方的按钮写着当前的比较对象,例如 Against main,点开菜单可以改选:

  • HEAD:只列出尚未提交的改动。Agent 提交之后,这些文件就会从列表中消失。
  • base 分支:菜单里显示分支名,例如 main。列表包含这条分支从分叉点以来的全部改动,已提交和未提交的都在内,base 分支后来新增的提交不会列入。

Condr 新建 Worktree 时,会把父 Workspace 当时所在的分支记为 base 分支。其他 Workspace 依次使用远端的默认分支(例如 origin/main)、本地的 main 和 master。当前分支本身就是 base 分支或它的上游时,只能对比 HEAD。

每个 Workspace 分别记住自己的选择。

  1. 在 Changes 列表中点击任意文件,中间区域会自动打开 Diff 标签页。
  2. 页面会以高亮形式展示该文件相对于所选比较对象的具体改动,标题栏会标出比较对象,例如 Against main。
  3. 点击标题栏的 Show File 可以直接跳转到该文件的完整内容预览。

提示:极大的二进制文件或单文件超过 1 MiB 时,出于性能保护会自动隐藏明细对比。

浏览项目文件与预览 (Files & Preview)

Section titled “浏览项目文件与预览 (Files & Preview)”
  • 切换至文件树:在右侧栏顶部将标签切至 Files,即可像文件管理器一样展开和浏览项目文件夹。
  • 改动标记:有修改的文件夹旁会带有一个圆点标记,被 .gitignore 忽略的文件会自动变灰。
  • 点击预览:点击任意文本文件,即可在 Preview 标签页中打开只读预览,代码高亮与滚动位置在磁盘文件变动时会自动刷新。
  • Markdown 与图片渲染:Markdown 与 SVG 文件默认以渲染后的效果打开,可在 Tab 顶部的 Preview 与 Source 间随时切换。常见格式图片(PNG、JPEG、GIF、WebP、BMP、ICO、TIFF,约 2 MiB 以内)会自动缩放适应窗口,动图可直接播放。Markdown 中的图片仅支持加载项目本地文件,网络图片则显示其替代文字。

在 Changes 或 Files 列表中的文件上右键,可选择以下常用操作:

  • Open in …:选择用本地已安装的 VS Code、Zed、Cursor 或 IntelliJ IDEA 打开当前文件或项目。
  • Insert Path into Terminal:快速将文件的相对路径粘贴到最近使用的终端窗格中,方便传给命令行工具。
  • Copy Relative Path / Copy Path:一键复制文件相对路径或绝对路径。