快速上手

安装 Mirasim#

Mirasim 的主要形态是一款 macOS 桌面应用，运行在 Apple 芯片的 Mac 上。下载页会自动指向最新版本，各个入口提供的都是同一个安装包。

1. 下载安装包

   在下载页获取 macOS 版本。运行环境要求 Apple 芯片（M 系列）的 Mac，系统为 macOS 13 Ventura 或更高版本。目前没有 Windows 和 Linux 的图形界面版本。

2. 拖入「应用程序」并打开

   首次启动时，系统可能要求确认打开来自互联网的应用，选择「打开」即可。签名与公证取决于该版本构建时使用的凭据，如果系统反复拦截，请查看对应版本的发布说明。

3. 校验安装包（可选）

   每个版本都会发布 SHA256SUMS，覆盖所有公开下载的文件。打开安装包之前可以先比对校验值。

shasum -a 256 ~/Downloads/Mirasim-*-arm64.dmg
# compare the hash against the matching line in SHA256SUMS

标题栏里的版本号是可以点的。点开是更新面板：当前运行的是哪一版、上次检查是什么时候、有没有新版本在等着。新版本会自行下载，下载完停在那里，点一下即可完成更新。帮助入口也在这个面板里，包含使用文档和一个反馈框；反馈可以匿名提交，匿名意味着不附带你的账号、邮箱和设备标识，因此也就无法回复你。

首次启动的设置向导#

首次启动打开的不是工作台，而是一个占满窗口的设置向导。它只出现一次，并且没有跳过：必须先登录，工作台才会加载。除第一屏外，每一屏都可以返回上一步。

1. 登录

   可以使用 GitHub 或 Google 登录，也可以让系统把验证码发到邮箱。同意服务条款和隐私政策也在这一步。

2. 兑换邀请码

   只有当账号本身还没有使用权限时才会出现。兑换后立即生效，之后不会再问；本身已有权限的账号不会看到这一屏。

3. 安装智能体

   Claude Code 和 Codex 至少要装一个。向导会列出这台机器上已经装好的，缺的由它来装。

4. 选择额度来源

   用你自己的账号，还是在额度用尽时改用 Mirasim 的兜底额度。这一步决定默认用哪一个，之后可以在设置里改。不提供兜底额度的版本没有这一屏。

5. 开始使用

   最后一屏汇总这台机器上已经就绪的内容，然后进入工作台。

添加工作区并选择智能体#

从安装完成到开始工作，只需要两样东西：一个用于开发的工作区，以及一个与你协作的智能体。本教程其余内容都是围绕这两项选择展开的。

Mirasimv0.0.121

默认

42%you@yourteam.dev

8%

checkout-api

修窄屏下两栏分屏错位2h

把导出按钮接到渲染队列上4h

让商品列表在路由之间缓存4h

空状态要说清接下来该做什么21h

上传失败改成重试，不要直接丢掉21h

+ 4 more

design-system

把设置页放到功能开关后面<1m

搜索框要能全程只用键盘完成4h

侧栏不要跟着页面一起滚6d

编辑器改成按需加载，把包体积降下来6d

处理刷新时令牌已过期的情况7d

+ 91 more

docs-site

慢查询日志要带上绑定参数13d

把结账表单拆成两步15d

infra

价格在显示时取整，不要在存储时取整4h

只在数据变化时重绘图表22h

导出的文件名跟着报表名走1d

草稿没写完就离开时要提醒6d

输入过程中 diff 视图要同步更新7d

+ 16 more

mobile-app

日期选择器要按地区格式显示4h

写入队列改成批量提交，不要一条一次4d

显示具体启用了哪些筛选条件，不只给个数量5d

接口不可用时回退到缓存列表5d

表格的排序方式下次进来要记得6d

+ 2 more

storefront

给设置加一个深色模式开关23h

报错要讲清原因，而不是只打一个错误码5d

修窄屏下两栏分屏错位5d

把导出按钮接到渲染队列上5d

给设置加一个深色模式开关5d

infra

让商品列表在路由之间缓存<1m

空状态要说清接下来该做什么1h

上传失败改成重试，不要直接丢掉1d

把设置页放到功能开关后面1d

搜索框要能全程只用键盘完成4d

+ 7 more

添加工作区

YYou

storefront/新建会话

输入提示词开始新会话，也可粘贴或拖拽图片、文件

~/code/storefront

打开终端

storefront

Apodex/opus-4-8

high

1. 1工作区
2. 2智能体与模型
3. 3推理强度
4. 4输入框

工作区会话运行所在的目录，可以指向已有仓库，也可以是一个空目录。文件始终保存在你本机的磁盘上。（该控件不在当前这一屏上）

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

1. 添加工作区

   把 Mirasim 指向你要开发的目录，可以是已有仓库，也可以是一个空目录。项目文件、Git 状态和会话历史都由本机服务端持有：Mirasim 自身的状态大多保存在 ~/.mirasim 下，按项目区分的配置保存在 <工作区>/.mirasim 下。

2. 选择智能体

   可选 Mirasim 内置智能体、Claude Code 或 Codex。已有的 Claude Code 和 Codex 登录状态会原样沿用。尚未安装的智能体，可以在智能体配置中直接安装。

3. 选择模型与推理强度

   每个会话各自携带模型与推理强度。订阅自带的模型和你自行配置的模型都会出现在选择列表中，分成「官方」与「我的模型」两组。

4. 决定是否隔离

   输入区可以让会话运行在独立的 Git worktree 中，并指定它基于哪条分支。worktree 是 Git 自带的机制，把同一个仓库检出到另一个目录，各自处于不同分支。只运行单个会话时不必开启；一旦要并行，建议立即开启。

完成一项真实任务#

写下需求并发送。第一次请交给它一件小事，而且完成标准要能在几秒内验证，例如某个测试应当通过、某个页面应当正常渲染、某个脚本应当能跑通。第一个会话的目的是把整个流程走一遍：交付需求、观察执行、审阅结果。

1. 描述预期结果，而非操作步骤

   「新增一个 /health 接口，返回当前的 git sha 和运行时长」比逐行指令有效得多。给出清晰的完成标准，智能体的产出质量高于被逐步指挥。

2. 全程观察，不要脱手

   对话记录会实时展示推理过程、工具调用及其返回、子任务的执行情况，并显示本轮的用量。你可以排入下一条指令、对正在执行的这一轮进行引导，也可以直接中止。三种操作都不需要从头重来。

3. 先审阅，再决定保留

   它的产出就是对真实仓库的普通改动。打开 Git 面板查看 diff，运行一遍结果，再把需要的部分暂存并提交。系统不会在你不知情的情况下提交任何内容。

• ⌘K命令面板：跳转到任意会话、执行任意工作台命令、检索全部对话记录
• ⌘N新建会话窗格
• ⌘D向右分出新窗格
• ⇧⌘E打开当前窗格所属工作区的文件与 Git 面板

更习惯终端、编辑器还是手机#

完整的工作台在桌面端，但它不是唯一的入口。各端连接的是同一个本机服务，因此在一端创建的会话，在其他端同样可见。

./mirasim doctor       # check the install and its environment
./mirasim              # Mirasim's built-in agent
./mirasim claude       # Claude Code, with its own TUI and auth
./mirasim ui-cli help  # the scriptable control surface