文件、搜索与 Git
管理项目文件、预览媒体、通过 ripgrep 搜索,暂存、提交、切换分支、发布分支、解决冲突并浏览历史。
右栏跟随当前工作区。标签页为 Files、Changes、Graph 与 Search。结果和文件标签会在中间工作区画布中打开。它们都作用于项目自身的检出目录,该项目的所有工作区共享这一目录。
工作区笔记有单独的页面:见笔记。
文件
打开 Files 浏览项目。文件树显示除 .git 之外的全部内容;被 Git 忽略的条目会变暗,符号链接会显示,单子文件夹链会合并为一行。超大文件夹只列出部分内容时,文件树会明确提示。
- 工具栏:New file、New folder、Refresh files、Collapse all 与 Filter files(按名称筛选)。
- 右键菜单:New file、New folder、Refresh、Cut、Copy、Paste、Copy Path、Copy Relative Path、Reveal in File Manager、Rename 与 Delete。
- 可多选条目、拖动以移动,并粘贴在文件资源管理器中复制的文件。
- Delete 会先询问,然后把条目移到回收站(macOS 上为废纸篓)。
- 文件树跟随当前编辑器。命令面板中的 Reveal active file in Files 会选中当前文件。
- 每一行显示其 Git 状态;智能体大量写文件时,文件树也能跟上。
编辑器与预览
选择文件会在工作区标签中用语法感知编辑器打开。Cmd/Ctrl+S 保存;未保存工作由脏标记提示。关闭时若会丢弃未保存内容,Cordy 会先询问。二进制或不支持的文件不会被当成可编辑文本。
图片、SVG、视频与音频会改为在预览标签中打开:
- 图片可适应窗格、按 1:1 显示或缩放;
- SVG 以图片渲染,可用 View source 查看文本;
- 视频与音频使用标准控件播放。
按 Cmd/Ctrl+F,或从命令面板选择 Find in file,打开活动编辑器的查找卡片。可以切换区分大小写、全字匹配或正则表达式。Enter 转到下一项,Shift+Enter 转到上一项,Escape 关闭卡片。展开替换行后,可替换当前匹配或全部匹配;只读编辑器不能替换。这里仅搜索打开的文件。
右键文件标签可以关闭当前、关闭其他标签,或关闭左侧 / 右侧标签。批量关闭会跳过有未保存缓冲区的标签。该菜单还可复制绝对路径或工作区相对路径,并在操作系统文件管理器中显示文件。
项目搜索
打开 Search 并输入查询。Cordy 对项目运行捆绑的 ripgrep,并按文件分组显示匹配项。选择结果会在对应行打开文件。如需用键盘快速搜索,可在命令面板中输入 %。
选项:
- Match case (off = smart case)(区分大小写;关闭时使用智能大小写)。
- Match whole word(全字匹配)。
- Use regular expression(正则表达式)。
- 包含 / 排除文件,输入以逗号分隔的 glob,例如
*.ts, src/**。
一次搜索最多返回 2,000 个匹配。达到上限时,摘要以 First 开头,例如 First 2,000 matches in 120 files;请缩小查询或文件模式来查看其余结果。
使用方向键在结果行中移动,按 Enter 打开当前匹配。
改动
打开 Changes,工作树会按分组显示:Merge Conflicts、Staged Changes、Changes 与 Untracked Files。工具栏显示动态的 +/− 汇总与改动文件数。
单文件与批量操作
- 选择文件可打开 Diff。单文件操作只会暂存、取消暂存或丢弃该文件;丢弃会重写工作文件,因此会先询问。
- 在 Diff 中,每个 hunk 都有自己的按钮:未暂存的 Diff 中用 + 暂存、用撤销箭头丢弃该 hunk;已暂存的 Diff 中用 − 取消暂存。
- 冲突文件的暂存操作为 Mark resolved。
- 分组操作:Unstage all(Staged Changes);Stage all 与 Discard all changes(Changes);Stage all untracked 与 Delete all untracked(Untracked Files)。丢弃与删除会先询问。
- 超过 2,000 行的列表会截断并给出提示;隐藏行不能暂存或丢弃,请缩小工作集,或在终端使用 Git。
Diff
- 在成功解析的 Diff 中,可使用区块旁的操作暂存、取消暂存或丢弃该 hunk。
- 长行默认自动换行。可在 Diff 标题栏用 Wrap lines 关闭换行;该选择会被记住。
- 图片 Diff 可在 Preview 与 Text 之间切换。
- 空 Diff、二进制或无法解析的 Diff 会显示提示或原始 Diff,而不提供 hunk 操作。
提交
- 至少暂存一个文件。表单标题显示 Commit · N staged。
- 输入 Commit message。需要可选描述时选择 Add description。
- 选择 Commit,或在消息框中按 Cmd/Ctrl+Enter。
没有已暂存文件或消息为空时,提交按钮不可用,原因显示在按钮下方。写到一半的提交消息会随工作区保留,切换面板也不会丢失。
分支与远端
- 身份行显示分支及其 upstream,或 no upstream。
- Switch branch 打开可用键盘操作的选择器(Search or create a branch…)。输入新名称即可创建分支。已在另一个 worktree 中检出的分支会显示其检出位置,且不能选择。
- Fetch、Pull 与 Push 使用仓库已配置的远端与凭据,显示落后或领先的提交数,并报告结果,包括失败原因。
- 分支没有 upstream 时,Publish Branch 会替代 Push,并通过 Publish to remote… 选择器选择远端。
- 执行 Pull 或切换分支前,Cordy 会列出该项目上有未保存文件或运行中智能体的工作区,并请你确认。不会暂存(stash)或丢弃任何内容:Git 会拒绝覆盖未提交的改动,打开的编辑器也会保留未保存的文本。
提交图
打开 Graph 查看活动分支历史。展开提交以列出改动文件,再选择文件打开该提交的 Diff。滚动时会分页加载历史;Refresh history 会重新加载。新提交总会出现。