Mirasim 文档
核心概念
服务端、工作区、会话、窗格、分组。理解这几个概念，后面各章都会变得直观。
构建、评测、迭代
Mirasim 是一个以本机为主、支持多智能体协同的开发空间。它的组织方式是一条循环，而不是一份功能清单：智能体完成开发，仿真用户实际使用产出结果，取得的证据决定下一步做什么。产品中的每一处设计，都是为了让这条循环转得更快，并让下一轮从上一轮的结论出发。
- 构建：多个智能体同时工作，分布在各个窗格与工作区分组中。会话可以共处同一个项目，也可以各自占用独立的 worktree。文件、diff、终端、Git 和产物，都摆在生成它们的智能体旁边。
- 评测：需要主动启用的 $eval 能力会派出仿真用户，在真实的浏览器、手机、命令行或已渲染的产物上完整使用一遍，并把运行时的操作与观察结果作为证据。阅读源码不计入用户证据。
- 迭代：行为轨迹转化为反馈，也转化为下一批任务。据此保留改动、回退改动，或者换一批预留用例重新验证。
真实数据都在服务端
一个 `mirasim serve` 进程持有一个 SessionHost（会话宿主）。所有真实数据都由它持有：项目文件、Git worktree、会话历史、产物、录制、定时任务，以及本机用量数据。各端都是它的客户端，而非它的副本。
通常你自己的机器就是服务端：桌面应用管理一个本地服务并与之通信。桌面端提供 macOS 与 Linux 两种，两者都可以改为连接你自行部署的 macOS 或 Linux 服务器。而 `mirasim`、`mirasim claude`、`mirasim codex` 这几条命令是直接启动一个智能体。
工作区就是你添加进来的一个目录
侧栏不是别处内容的一个视图，它本身就是那份清单。一个工作区出现在那里，是因为你把那个目录添加了进来；每一个都可以移除，所以全新安装打开时侧栏是空的，显示的是「添加工作区」，而不是某个你从没选过的目录。
有一处例外是为了让这份清单如实：如果某个会话在一个还没添加的目录里启动，服务端会把那个目录补进清单。因此只要某个目录下有会话，它就一定是一个真实且可移除的工作区。侧栏不会显示你无法操作的条目，也不会藏起确实存在的会话。
一个会话对应与一个智能体的一次对话
一个会话由一个智能体、一个模型和一档推理强度组成，运行在某个工作区目录中。它可以单独占用一个 Git worktree，也可以指定基于哪条分支。每个会话各自持有对话记录、指令队列、待办清单和终端。
由于智能体、模型和工具独立配置，相邻两个会话背后可以使用不同的模型：设计阶段用推理能力强的模型，后续机械性的部分用更快更便宜的模型，不能离开本机的内容则用本地模型。
- 智能体
- 可选 Mirasim 内置智能体、Claude Code 或 Codex，按会话选择。但某个智能体当前使用哪个账号，是该智能体的全局设置。
- 模型与推理强度
- 按会话从订阅自带的模型和你自行配置的模型中选择。已排入队列的指令，沿用你发送时选定的配置。
- 工作区与分支
- 会话运行所在的目录，以及它基于哪条分支。
- Worktree
- 可选的隔离方式：一个真实的 Git worktree，处于独立分支，由智能体创建并由 Mirasim 记录。
- 对话记录
- 包含每一轮对话、推理过程、工具调用、子任务、计划和决策，可检索、可分叉、可导出。
分组、分格与文档标签
工作台有三层嵌套结构，每一层解决下一层无法解决的问题。理解一次之后，界面就不会再出现意外。多窗格工具中的意外其实只有一种：你正在关注的内容不见了。
分组栏整套工作布局在这里切换。切换到另一组时，其他组中正在运行的内容不会被关闭。（该控件不在当前这一屏上）
这块面板上的按钮可以直接点，点着看看。
- 分组一整套工作布局，在标题栏的分组栏中切换
每个分组各自保存一套布局，切换时不会关闭任何内容。同一个会话可以同时出现在多个分组中。关闭分组只关闭视图，其中的会话继续运行。
- 分格分屏结构中的一格，可以是会话、终端或文档
分屏行为与终端复用器一致。最小尺寸按实际区域的像素计算，因此信息密度随显示器变化，而不是固定占窗口的某个比例。
- 文档标签标签形式，只存在于文档分格内
文档会以标签形式叠放，会话和终端不会。这种差异是一项安全设计：文件可以被标签遮住，正在运行的会话不会。
产物、证据与可追溯性
一次运行产出的所有内容，包括构建结果、截图、日志、导出文件和评测报告，都保存在产出它的那一端，并可在生成它的会话旁边预览。智能体交付的成果会列为产物，可以打开、在文件系统中定位，或者下载。
这种绑定关系保证了整条循环的可信度。无法追溯到具体某次运行的结论，一律视为没有结论。评测会完整保留截图、命令、轨迹和产物，并把观察到的事实与推断出的判断分开记录。
各类数据在磁盘上的位置
- ~/.mirasim
- 服务端状态：设置（setting.json）、会话记录、原始录制、本机用量账目、智能体状态文件。
- <workspace>/.mirasim
- 应随仓库一起管理的项目级配置，包括工作区级 skills 和 schedules.json。
这一页有错或缺了什么？ 告诉我们