← Mirasim 教程第 16 章

查阅

快捷键表、完整的 ui-cli 命令清单、配置树、端口、路径和各端要求，集中在一处便于查阅。

阅读约 8 分钟，共 4 节，属于「查阅」

快捷键表#

定位与跳转

⌘K命令面板：会话、命令，以及对话记录全文检索
⌘N新建会话窗格
⌘1至 ⌘9，按等你处理的排在前面这个顺序把第 N 个会话打开为窗格
⌥1至 ⌥6，聚焦当前分组的第 N 个窗格
⌘⌥←循环切换窗格焦点，⌘⌥→ 为正向
⌥1至 ⌥6，聚焦窗格区中的第 N 个窗格
⌘F在对话记录中查找，支持上一个、下一个和命中计数

布局调整

⌘D新建窗格，向右分割
⇧⌘D新建窗格，向下分割
⌘W依次关闭当前文档、其所在分格，最后关闭窗格
⇧⌘⏎放大当前窗格，再按恢复
⌘T新建分组
⇧⌘T在当前窗格内新建标签
⌃⇥循环切换分组，⌃⇧⇥ 为反向
⌥⌘→另一组切换分组的按键，⌥⌘← 为反向

代码与终端

⇧⌘E当前窗格所属工作区的文件与 Git 面板
⌃`在对话与智能体终端界面之间切换当前窗格
⌃⇧`新建独立终端窗格
⌘click在编辑器中跳转到定义

ui-cli 命令清单#

`mirasim ui-cli help` 输出的是权威清单，这里给出它的概貌。只读命令随时执行都安全；会产生实际操作的命令，效果与在界面上点击一致。

读取

命令	返回内容
state	服务端基本信息：版本、工作目录、平台
agents · clis · cli-tools	已安装的智能体及默认项；智能体命令行的版本；PATH 上的开发命令行工具及其登录状态
sessions · history · queue	会话列表；某个会话已结束的轮次；它排队中的指令
catalog · commands · models	某个智能体在输入区可选的内容；它的斜杠命令；自带密钥的供应商、配置项与绑定三层
accounts · usage · relay	已保存账号及其额度；各智能体的额度快照；中转服务的登录与兜底状态
workspaces · workspace git	已登记的目录；某个目录当前的 Git 状态
mcp list · connectors list · skill list	各作用域下的工具清单
traffic stats · calls · meta	本机用量账目，以及它占用的空间和当前的上传声明
system · permissions · resources	服务端运行指标；macOS 各项权限状态；一份资源基线

操作

命令	作用
prompt · send · watch · stop	开始或继续执行一轮（会一直等到该轮结束）、流式查看快照、中断
answer	回答智能体的交互式提问，相当于可脚本调用的「点击允许」
queue steer \| jump \| recall \| move	把排队中的指令交给正在执行的一轮、插队、撤回、调整顺序
session new \| open \| rename \| delete \| resume	会话生命周期管理，包括输出其原生恢复命令
workspace add \| update \| remove	登记、修改、取消登记一个工作区目录
account use \| add \| rename \| token \| remove	多账号管理；中转服务的登录与退出
provider · profile · model bind · model test	自带密钥的各层配置，以及发一次真实请求进行验证
local probe \| start \| pull \| pulls \| delete	本地推理后端与模型
mcp add \| remove \| toggle \| health	工作区级或全局作用域的 MCP 服务
skill install \| create \| update \| remove	工作区级或全局作用域的 skills
connectors install \| enable \| validate \| auth \| search \| uninstall	连接器生命周期管理，包含官方注册表查询
im validate · codex-reset · restart	校验某个渠道的凭据；使用一次 Codex 额度重置；重启服务端

配置与外壳

命令	作用
config get \| set \| apply	整棵读取设置树、按点分路径设值，或收敛到指定的配置树（--dry-run 只输出差异）
screenshot · shell	真实应用窗口的 PNG 截图；窗口与应用的基本信息
navigate · ui · dom · click · press · type · read	切换界面路由、执行语义化界面命令、列出可操作控件，并按文字或选择器驱动它们
raw	原样发送任意协议帧，覆盖全部能力的兜底方式

设置树#

`config get` 返回一棵 JSON 树，覆盖所有会被保存的设置。凭据有意不包含在其中。

defaultAgent: 新建会话默认使用的智能体。
agents.<agent>.{model,effort,accessMode}: 各智能体的默认模型、推理强度，以及使用订阅还是 API 密钥。
relay.{enabled,threshold,on5h,on7d,reactive,always}: 额度兜底的行为：是否启用、在多少使用比例时触发、按哪个周期、被拒绝时启用，还是始终启用。
computerUse.{browserEnabled,browserHeadless,peekabooEnabled}: 浏览器与屏幕自动化的开关。
preventDisplaySleep · agentAutoUpdate: 应用运行期间保持屏幕不休眠；保持智能体命令行为最新版本。
workdir · workspaces[]: 默认工作目录，以及已登记的工作区目录。
im.<channel credentials>: 聊天渠道配置，热生效。

路径、端口与各端要求#

磁盘位置

路径	内容
~/.mirasim/setting.json	服务端设置，即设置界面与 `config set` 写入的内容
~/.mirasim/recordings	原始的模型请求与响应记录，受留存策略约束
~/.mirasim/capture.off	创建该文件，下次启动起停止记录
~/.mirasim/tui/	Mirasim 写入各智能体自身状态位置的实时状态
<workspace>/.mirasim/schedules.json	当前工作区的定时任务
<workspace>/.mirasim/	应随仓库一起管理的工作区级 skills 与配置

ui-cli 连接的端口

端口	对应实例
4970	已安装桌面应用的服务
4950	开发版桌面实例的服务
4939	由 `mirasim serve` 启动的服务，这是它的默认端口
（不指定）	为单条命令启动用后即弃的私有服务

各端要求

端	要求
桌面端	Apple 芯片的 Mac，macOS 13 Ventura 或更高版本
安卓端	Android 8.0 或更高版本
iPhone	iOS 15 或更高版本，TestFlight 内测
VS Code	VS Code 1.90 或更高版本
命令行与终端界面	Apple 芯片的 macOS，使用 darwin-arm64 压缩包

常用环境变量

MIRASIM_RECORD=0            # disable raw recording for this launch
MIRASIM_EXPORT=0            # disable the background export sweep
MIRASIM_BROWSER_CDP_URL=…   # attach browser automation to an external Chrome

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