Mirasim Build Fund$100 – $10,000面向开发者的免费额度,无需偿还。仅 500 席立即申请
← Mirasim 教程第 07 章

文件、Git 与终端

工作台的代码一侧:浏览与编辑真实仓库、在其中跳转、审阅并提交、全面检索、预览产出结果。

阅读约 12 分钟,共 6 节,属于「动手做」

文件树与文件操作#

文件树展示的是真实的工作区,每一行都带有 Git 状态:某个目录中改动了多少文件、哪些文件被修改或未被跟踪、哪些被 Git 忽略。智能体写入文件后对应行会立即更新,你看到的是仓库本身,而不是一份缓存的列表。

文件与 Git 面板
Mirasim 文件面板,显示带 Git 状态的工作区文件树,以及刷新按钮。

文件树真实的工作区,每一行都带有 Git 状态:改动了什么、哪些未被跟踪、哪些被忽略。(该控件不在当前这一屏上)

这块面板上的按钮可以直接点,点着看看。

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

右侧面板栏
右侧面板栏,包含当前窗格所属工作区的文件、Git、产物与定时任务面板。

文件当前窗格所属工作区的文件树,每一行都带有 Git 状态。键盘上按 ⇧⌘E 可直接到达。(该控件不在当前这一屏上)

这块面板上的按钮可以直接点,点着看看。

编辑与跳转#

文件在完整的代码编辑器中打开,带语法高亮。Markdown、JSON 等结构化格式另有阅读模式、源码模式、两者分屏和预览。JSON 会给出真实的解析错误并标明行列位置;它允许注释和尾随逗号,同时提示严格的解析器不接受这些写法。

代码智能的行为符合预期:按住 ⌘ 点击某个符号可跳转到其定义,也可以查看它被使用的其他位置。查不到结果时会明确提示,而不是跳到一个看似合理的位置。

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

审阅与提交#

版本控制是一个完整的面板,而不是一行状态提示:包含已暂存与未暂存的改动、每个文件的 diff,以及原本需要切到终端才能完成的操作。diff 支持左右对照和行内对照两种方式,将原始版本与当前版本并列。

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

某项操作未能完成时,面板会指出你处于哪一种常见的 Git 情形:本地改动会被覆盖、两侧分支已分叉、尚未设置上游、远端存在你本地没有的提交、有一次未完成的合并或 rebase、凭据被拒、远端无法连接、被某个钩子拒绝。同时它会给出可以解决的操作,例如先暂存再拉取,或者拉取时执行 rebase。看到这类提示时仓库尚未发生任何变化,提示中也会说明按建议操作后会发生什么。

预览产出结果#

智能体交回的成果会收入产物列表,并可就地预览,支持 Markdown、JSON、以表格形式呈现的 CSV、可缩放的图片、PDF、音频和视频。预览是有意设计为只读的,编辑一律交给外部应用。预览区可以扩展到整个窗格区,也可以作为侧边面板显示。

  • 可以用默认应用打开、指定某个应用打开,或在 Finder 中显示。
  • 超长文件只预览前几千行,并会说明这一点;二进制文件、超大文件和不支持的媒体格式会给出后续操作建议,不会无声失败。
  • 工作区之外的产物会被拒绝读取,预览功能遵守工作区边界。

导出对话#

整段对话或其中一轮都可以导出到一个目录,包含文字以及随附的图片和文件,打包过程中显示进度。这是把事情经过如实交给他人的方式:交出去的是会话本身,不是它的摘要。

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