Mirasim 文档
文件、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 中显示。
- 超长文件只预览前几千行，并会说明这一点；二进制文件、超大文件和不支持的媒体格式会给出后续操作建议，不会无声失败。
- 工作区之外的产物会被拒绝读取，预览功能遵守工作区边界。
导出对话
整段对话或其中一轮都可以导出到一个目录，包含文字以及随附的图片和文件，打包过程中显示进度。这是把事情经过如实交给他人的方式：交出去的是会话本身，不是它的摘要。
这一页有错或缺了什么？ 告诉我们