Mirasim 文档

第 09 章

文件、Git 与终端

浏览与编辑文件、审阅并提交改动、检索代码与对话、预览产物、导出对话。

文件树与文件操作

文件树展示工作区,每一行都带有 Git 状态:目录中改动了多少文件、哪些文件被修改或未被跟踪、哪些被 Git 忽略。智能体写入文件后,对应行会更新。

在某一行的右键菜单中可以:打开、在旁边打开、用其他应用打开、在 Finder 中显示、复制文件、复制路径或相对路径、剪切、粘贴、重命名、创建副本、移到废纸篓,以及新建文件和目录。

会话的输出目录与项目目录不同时,面板会分别标注:工作区是该会话的输出目录,项目是原始代码目录。

编辑与跳转

文件在代码编辑器中打开,带语法高亮。Markdown、JSON 等结构化格式另有阅读模式、源码模式、两者分屏和预览。JSON 会显示解析错误及行列位置,并对注释和尾随逗号给出提示。

按住 ⌘ 点击某个符号可跳转到其定义,也可以查看它被使用的其他位置。

  • ⌘click跳转到定义
  • ⌘F在当前文件或对话记录中查找
  • ⇧⌘E聚焦文件树

审阅与提交

版本控制面板显示已暂存与未暂存的改动,以及每个文件的 diff。diff 支持左右对照和行内对照两种方式。

不离开工作台即可完成的操作
暂存与取消暂存
可按文件操作,也可一次全部操作。还可以丢弃某个文件的改动、删除未被跟踪的文件,这两项都会先确认,且无法撤销。
提交
可以提交已暂存的改动、提交全部改动,或者一次完成提交并推送。提交说明在面板中填写。
分支
查看当前分支、切换分支,并查看相对上游领先或落后多少,或者尚未设置上游。
拉取与推送
在面板中拉取和推送。
还原
把单个文件还原到 HEAD,已暂存与未暂存的改动一并还原,执行前需明确确认。

某项操作未能完成时,面板会指出原因,例如本地改动会被覆盖、分支已分叉、尚未设置上游、有未完成的合并或 rebase、凭据被拒、远端无法连接。能解决时会给出对应操作,例如先暂存再拉取,或者拉取时执行 rebase。执行建议的操作之前,仓库不会有任何变化。

预览产出结果

智能体交回的文件会收入产物列表,并可就地预览,支持 Markdown、JSON、以表格形式呈现的 CSV、可缩放的图片、PDF、音频和视频。预览只读,要编辑请用外部应用打开。预览区可以占满整个窗格区,也可以作为侧边面板显示。

  • 可以用默认应用打开、指定某个应用打开,或在 Finder 中显示。
  • 超长文件只预览前几千行;二进制文件、超大文件和不支持的媒体格式会提示改用什么方式打开。
  • 只能预览工作区内的产物。

导出对话

整段对话或其中一轮都可以导出到一个目录,包含文字以及随附的图片和文件,打包过程中显示进度。

这一页有错或缺了什么? 告诉我们