文件、Git 与终端
工作台的代码一侧:浏览与编辑真实仓库、在其中跳转、审阅并提交、全面检索、预览产出结果。
文件树与文件操作#
文件树展示的是真实的工作区,每一行都带有 Git 状态:某个目录中改动了多少文件、哪些文件被修改或未被跟踪、哪些被 Git 忽略。智能体写入文件后对应行会立即更新,你看到的是仓库本身,而不是一份缓存的列表。
文件树真实的工作区,每一行都带有 Git 状态:改动了什么、哪些未被跟踪、哪些被忽略。(该控件不在当前这一屏上)
这块面板上的按钮可以直接点,点着看看。
它是一个可操作的文件管理器,不是只读视图。在某一行的右键菜单中可以:打开、在旁边打开、用其他应用打开、在 Finder 中显示、复制文件、复制路径或相对路径、剪切、粘贴、重命名、创建副本、移到废纸篓,以及新建文件和目录。
文件当前窗格所属工作区的文件树,每一行都带有 Git 状态。键盘上按 ⇧⌘E 可直接到达。(该控件不在当前这一屏上)
这块面板上的按钮可以直接点,点着看看。
编辑与跳转#
文件在完整的代码编辑器中打开,带语法高亮。Markdown、JSON 等结构化格式另有阅读模式、源码模式、两者分屏和预览。JSON 会给出真实的解析错误并标明行列位置;它允许注释和尾随逗号,同时提示严格的解析器不接受这些写法。
代码智能的行为符合预期:按住 ⌘ 点击某个符号可跳转到其定义,也可以查看它被使用的其他位置。查不到结果时会明确提示,而不是跳到一个看似合理的位置。
- ⌘click跳转到定义
- ⌘F在当前文件或对话记录中查找
- ⇧⌘E聚焦文件树
审阅与提交#
版本控制是一个完整的面板,而不是一行状态提示:包含已暂存与未暂存的改动、每个文件的 diff,以及原本需要切到终端才能完成的操作。diff 支持左右对照和行内对照两种方式,将原始版本与当前版本并列。
- 暂存与取消暂存
- 可按文件操作,也可一次全部操作。还可以丢弃某个文件的改动、删除未被跟踪的文件。这两项操作都会先确认,因为都无法撤销。
- 提交
- 可以提交已暂存的改动、提交全部改动,或者一次完成提交并推送。提交说明在面板中填写。
- 分支
- 查看当前分支、切换分支,并了解相对上游领先或落后多少,或者尚未设置上游。
- 拉取与推送
- 两者均支持,失败情形会明确说明,而不是直接输出 Git 的原始信息。
- 还原
- 把单个文件还原到 HEAD,已暂存与未暂存的改动一并还原,执行前需明确确认。
某项操作未能完成时,面板会指出你处于哪一种常见的 Git 情形:本地改动会被覆盖、两侧分支已分叉、尚未设置上游、远端存在你本地没有的提交、有一次未完成的合并或 rebase、凭据被拒、远端无法连接、被某个钩子拒绝。同时它会给出可以解决的操作,例如先暂存再拉取,或者拉取时执行 rebase。看到这类提示时仓库尚未发生任何变化,提示中也会说明按建议操作后会发生什么。
检索文件与检索对话#
这里有两种检索,因为你要找的本来是两类内容。
在代码中检索
可以按文件名筛选文件树,也可以在整个工作区内检索文件内容,支持区分大小写、全词匹配和正则表达式,并可用包含与排除通配符缩小范围。结果按文件分组,给出命中数量和文件数量。结果被截断时会明确提示,不会假装已找到全部内容。
在对话记录中检索
⌘K 检索的是全部已记录会话的正文,适合查找你记得做过、却想不起位置的那个决定。扫描过程中会显示进度,结束后报告覆盖了多少个会话,因此存在上限时你能看到那是上限。
预览产出结果#
智能体交回的成果会收入产物列表,并可就地预览,支持 Markdown、JSON、以表格形式呈现的 CSV、可缩放的图片、PDF、音频和视频。预览是有意设计为只读的,编辑一律交给外部应用。预览区可以扩展到整个窗格区,也可以作为侧边面板显示。
- 可以用默认应用打开、指定某个应用打开,或在 Finder 中显示。
- 超长文件只预览前几千行,并会说明这一点;二进制文件、超大文件和不支持的媒体格式会给出后续操作建议,不会无声失败。
- 工作区之外的产物会被拒绝读取,预览功能遵守工作区边界。
导出对话#
整段对话或其中一轮都可以导出到一个目录,包含文字以及随附的图片和文件,打包过程中显示进度。这是把事情经过如实交给他人的方式:交出去的是会话本身,不是它的摘要。
这一页有错或缺了什么? 告诉我们