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