Mirasim 文档
模型、账号与额度
按会话更换模型与推理强度、使用自己的密钥或本地模型、管理多个账号，并在额度耗尽时自动接续。
模型与推理强度按会话设置
输入区有三个选择项：智能体、模型和推理强度。它们作用于当前会话，不是全局设置。因此设计阶段可以在一个窗格中使用推理能力更强的模型，后续机械性的工作在相邻窗格中使用更快更经济的模型。
模型列表分为两组：「官方」是该智能体自带订阅提供的模型，「我的模型」是你自行配置的。只有模型确实支持推理强度时才提供该选项；不支持时选择项会直接说明，而不是显示一个无效的控件。
模型按会话设置。订阅自带的模型与你自行配置的模型分组显示在一起，长上下文版本标记为 [1m]。（该控件不在当前这一屏上）
这块面板上的按钮可以直接点，点着看看。
选择使用哪个智能体
智能体、模型和工具三者独立配置。新增一家供应商不需要更换工作台，新增一个工具也不会把它绑定到某一个智能体上。
- Mirasim 内置智能体
- 随应用一起安装，无需单独部署。它在进程内运行，按你配置的路径访问模型，包括通过中转服务。
- Claude Code
- Anthropic 的编码命令行工具，在长时间、大量调用工具的会话中表现稳定。它自身的登录状态与终端界面被原样保留。
- Codex
- OpenAI 的终端编码智能体，擅长制定计划和多步重构。同样保留自身的登录状态与界面。
- Pi GUI
- 它不写代码，专做一件事：操作浏览器。读页面的方式和读屏软件一样，用的是浏览器为辅助工具准备的那份结构，而不是靠截图去猜。它的模型走中转服务，所以你不必另配密钥。编码智能体可以把浏览器上的活交给它、拿回结果，做法见讲 Skills、MCP 与工具那一章。
尚未安装的智能体，可以在智能体配置中直接安装。设置中还会并列显示每个智能体命令行的已装版本与最新版本，因此版本落后是可见的，不会成为难以定位的问题。
使用自己的密钥
模型配置分三层：供应商（一个地址加一份凭据）、配置项（某家供应商上的具体模型，附带推理强度和 token 上限）、绑定（某个智能体使用哪个配置项）。Anthropic、OpenAI、Google，以及任何兼容 OpenAI 接口的地址（含 OpenRouter）都是一等支持。
设置模型配置位于设置中，与智能体配置、插件和流量账本并列。（该控件不在当前这一屏上）
这块面板上的按钮可以直接点，点着看看。
# 1 · a provider: endpoint + credential
mirasim ui-cli --port 4970 provider save \
--kind openai-compatible --name MyRouter \
--base-url https://example.com/v1 --api-key sk-…
# 2 · a profile: one model on that provider
mirasim ui-cli --port 4970 profile save --provider PROVIDER_ID --model some-model
# 3 · a binding: route an agent through it, or back to its own subscription
mirasim ui-cli --port 4970 model bind --agent codex --profile PROFILE_ID
mirasim ui-cli --port 4970 model bind --agent codex --native
# prove it works before you rely on it
mirasim ui-cli --port 4970 model test --provider PROVIDER_ID --model some-model一百万 token 的上下文窗口
部分 Anthropic 模型可以提供一百万 token 的上下文窗口。它从不作为默认值，必须由你主动选择带 `[1m]` 后缀的长上下文版本。Mirasim 是通过供应商的 beta 选项申请该窗口，而不是更换模型本身。不支持一百万窗口的模型不会出现该选项。
本地模型
对于不能离开本机的工作，Mirasim 可以接入本地推理服务：Ollama，以及 macOS 上的 `mlx-lm`。其他兼容 OpenAI 接口的本地服务，按普通自定义供应商添加即可。Mirasim 可以探测本机已安装的组件、启动后端、带进度拉取模型，以及在不再需要时删除模型。
mirasim ui-cli --port 4970 local probe # what's installed
mirasim ui-cli --port 4970 local start --backend ollama # bring it up
mirasim ui-cli --port 4970 local pull --backend ollama --model qwen3
mirasim ui-cli --port 4970 local pulls # in-flight pulls多个账号与实时额度
同一个智能体下可以保存多个账号并随时切换当前使用的那个。个人订阅与工作订阅额度不同，或者某个套餐的重置时间不合适时，这一点很有用。请注意，某个智能体当前使用哪个账号是它的全局设置，不是每个会话各自持有。
每个已保存的账号都显示实时额度：套餐类型、剩余量、当前各计费周期的使用比例，以及重置时间。状态用直白的说法标出：充足、偏低、已耗尽，也可以手动刷新。供应商的额度接口自身被限流时，Mirasim 会说明哪些周期仍读取成功，不对其余部分作推测。
云端额度云端额度还剩多少，以及这些轮次被路由到哪里。点击可固定展开，悬停可快速查看。（该控件不在当前这一屏上）
这块面板上的按钮可以直接点，点着看看。
mirasim ui-cli --port 4970 accounts --fresh # accounts + quota each
mirasim ui-cli --port 4970 usage # per-agent quota snapshots
mirasim ui-cli --port 4970 account use --agent claude --id work-account任务进行中额度耗尽
长任务进行到一半触及额度上限，是最浪费时间的一种失败。登录 Mirasim 的中转服务之后，自带订阅耗尽时它可以接续执行。触发条件可以是用量比例、5 小时或 7 天周期、被拒绝时启用，或者始终启用。某一轮走了这条路径时，对话记录会标注：本轮通过额度兜底路径执行。
由于兜底路径是逐轮标注的，不存在会话在你不知情的情况下更换路径的可能。终端一侧显示同样的状态：命令行把当前路径写入智能体自己的状态行，而不是覆盖在它的界面上绘制。
mirasim ui-cli --port 4970 login # relay sign-in
mirasim ui-cli --port 4970 relay # sign-in + fallback state
mirasim ui-cli --port 4970 config set relay.enabled=true relay.threshold=0.8这一页有错或缺了什么？ 告诉我们