帮助
常见问题
- 哪些设备可以运行 Mirasim
- 桌面应用支持 macOS（Apple 芯片或 Intel，macOS 13 或更高版本）、Windows（10 1809 及以上，x64/Arm64）和 Linux（AppImage 或 .deb，x64/Arm64，Ubuntu 22.04 及以上或同代 glibc 发行版）。手机 App 要求 Android 8 及以上，或 iOS 15 及以上（TestFlight 内测）。没有桌面的 Linux 服务器可以用一行命令接入（第 12 章）。
- 必须使用自己的密钥吗
- 不必。每条会话要么用你自己的账号（智能体订阅、API 密钥或本地模型），要么用 Mirasim 的平台额度。
- 空间里的程序怎么调模型
- 空间里的终端、智能体和定时任务已经带上
MIRASIM_API_BASE和MIRASIM_API_KEY：代码直接读，应用里就填成 Base URL 和 API Key。先要所有者或管理员在 空间设置 › 空间额度 › API 密钥 里新建一把密钥并设为默认。新建的密钥只在空间里用。详见第 11 章。 - Mirasim 免费吗
- 用你自己的账号（智能体订阅、API 密钥和本地模型）使用工作台免费，手机 App 也一样。跑在你自己电脑上的协作空间同样免费；跑在我们云端的协作空间收费，并加赠额度。详见价格页（mirasim.ai/pricing）。
- 团队能一起用吗
- 能，在协作空间里（每个空间 5 个协作席位，另可容纳 100 位观察成员；要加席位写信到 support@mirasim.ai），或者在接入云端的你自己的电脑上。用邮箱邀请。见第 10–12 章。
- Mirasim 支持哪些智能体
- Claude Code、Codex、Gemini CLI、Kimi Code、Qwen Code 等。它们可以并排运行；会话切换智能体时会带着已有对话。
- 多个智能体可以同时操作一个仓库吗
- 可以。给每个会话创建各自的 worktree，每个智能体在自己的分支上工作，最后由你决定怎么合并。
- 我的代码会被发送到哪里
- 会发往你使用的模型供应商；走 Mirasim 平台额度的轮次经由 Mirasim 转发。使用本地模型时所有内容留在本机。记录了哪些内容以及如何关闭，见第 21 章。
- 评测会一直运行吗
- 不是。$eval 是需要显式启用并调用的能力，调用时在本机运行。
- Claude Code 和 Codex 还能按现在的方式使用吗
- 可以。两者都保留自己的终端界面和登录状态。
- 如何校验下载的文件
- 每个版本都会发布 SHA256SUMS，覆盖所有下载文件。打开之前先比对校验值。
购买与价格
| 档位 | 价格 | 每份包含 |
|---|---|---|
| 自带 | 免费 | 用你们自己的账号或 API 密钥；没有加赠 |
| 体验 | $4.99 一次，用 7 天 | 加赠 25 额度，所有模型都能用；每个账号一次。之后同一个空间可以转成基础：规格不变，不用重启。不退款、不自动续费。 |
| 基础 | $49 / 30 天 | Linux · 2 核 · 4 GB 内存 · 30 GB 硬盘（可加）；加赠 20 额度 |
| 轻量 | $99 / 30 天 | Linux · 4 核 · 8 GB 内存 · 50 GB 硬盘（可加）；加赠 50 额度 |
| 标准 | $169 / 30 天 | Linux · 8 核 · 16 GB 内存 · 100 GB 硬盘（可加）；加赠 80 额度 |
| 专业 | $249 / 30 天 | macOS · Apple 芯片 · 10 核 · 16 GB 内存；加赠 120 额度 |
- 有哪几档、多少钱
- 免费版是本机工作台的全部功能，用你自己的账号或 API 密钥。协作版给团队一个协作空间，每一档功能完全一样；基础、轻量、标准、专业跑在我们的环境里，一次付款用 30 天，并加赠额度 —— 上面的表就是这几个数，和价格页读的是同一份。以价格页（mirasim.ai/pricing）为准。
- 体验是怎么回事
- $4.99 一次付款开一个 7 天的体验空间，送 25 额度，所有模型都能用。每个账号只能买一次，不退款，不自动续费。体验结束后可以把这个空间转成基础 —— 同一个空间、同样的规格，不用重启。体验期内或体验结束后 14 天内第一次付费，立减 $4.99、首月加赠翻倍；这期间另开轻量或标准也算。
- 是订阅吗，会自动扣款吗
- 不是订阅。协作空间一次付款用 30 天，不自动续费；Token 包也是一次性购买。你不再下单，就不会再扣款。
- 续费怎么算
- 所有者和管理员可以在空间卡上按现在的档位续费。续费加 30 天，原到期日比现在晚时从原到期日往后算，所以提前续不吃亏；一个空间最多续到 366 天后。续费不改档位。空间到期后会先停用：14 天内续费即可恢复，之后会清除。
- 价格含税吗
- 不含。你所在地的销售税、增值税或商品服务税在结账时计算，付款前会明确列出；在美国这取决于你所在的州。
- 会不会被扣超过价格的钱
- 不会。结账时看到的价格就是全部费用，没有按用量另计的部分，也不会事后补一张账单。额度不够时，要不要买 Token 包由你决定。
- 额度是什么
- 1 额度按 API 刊例价计 $1 的模型用量，所有模型通用。加赠的额度和 Token 包都按额度算，付款金额照旧是美元。
- Token 包怎么买
- 单独购买的一份额度，在价格页买，$10 起，目前 $1 得 2 额度。免费版和协作版都能买，本机和协作空间里都能用。
- 额度会过期吗
- 个人额度每一笔（买的 Token 包、兑换的码、给你加的额度）都从到账起 6 个月内有效，先用最早到期的。2026 年 10 月 23 日已有的额度有效期到 2027 年 4 月 23 日。到期日在账号页能看到。协作空间的额度没有到期日，只在空间删除或到期收回时清零。
- 加赠的额度归谁
- 空间开好时，加赠的额度直接进空间额度，空间里的人马上就能用。随空间一起买的 Token 包进所有者的个人额度。详见第 11 章。
- 首发加赠怎么算
- 前 200 个付款的空间加赠翻倍，价格不变；体验后第一次付费的翻倍不看名额：基础 40 额度、轻量 100 额度、标准 160 额度、专业 240 额度（常态是 20 额度、50 额度、80 额度、120 额度）。名额按付款先后，价格页上能看到还剩几个，付款后的结果页会写明这个空间拿到的加赠。两条不叠加，两种情况价格都不变。
- 额度用完了怎么办
- 买一个 Token 包；或者把会话切到你自己的 Claude Code、Codex 或 API 账号，这条线路不消耗平台额度。怎么切换见第 14 章。
- 在哪儿看余额和付款
- 官网账号页：「概览」里是额度和到期日，「付款记录」里是每一笔付款。应用里在左下角账号卡 ›「额度」。
- 可以以公司名义购买吗
- 在结账时填写公司信息和税号。适用的情形下这会使该笔购买免征增值税，这些信息也会体现在发票上。需要多个空间、合同或统一开票，找我们谈企业版。
- 价格会变吗
- 有可能。价格以下单时价格页上的为准；调整不会影响你已经付款的那 30 天。
席位、硬盘与换档
- 协作席位不够
- 每个空间含 5 个协作席位（所有者不占）。加席位每人 $30 / 月，所有档同价，写信到 support@mirasim.ai 开通。观察成员不占席位。
- 硬盘不够能加吗
- Linux 档可以。基础自带 30 GB、轻量自带 50 GB、标准自带 100 GB，每多 50 GB 收 $10 / 月，写信到 support@mirasim.ai 开通。硬盘只能加，不能减。
- 想换一档
- 开一个对应档位的空间：官网账号页 ›「空间与席位」›「再开一个空间」。只是额度不够的话，不用换档，买 Token 包就行。
- 需要多个空间
- 每个空间单独下一单。需要合同或统一开票，找我们谈企业版。
空间到期
- 需要取消吗
- 不需要。一单用 30 天，之后不会再扣款。
- 在哪儿看还剩几天
- 官网账号页 ›「空间与席位」写着每个空间还剩几天、哪天到期。
- 到期后会怎样
- 空间会先停用，停用期 14 天：在这 14 天里续费即可恢复，接着用。14 天之后清除，里面的内容和转入的空间额度一起清空；要留的代码请先推到远端仓库。你自己的 Claude Code、Codex、API 和本地模型账号照旧可用，个人额度在它自己的到期日前照常可用。
- 想接着用
- 在账号页的空间卡上直接续费：同一个空间、同一档再用 30 天，从原到期日往后算。算法见上面续费那一行。
- 跑在自己电脑上的那一档
- 免费，没有到期日。电脑关机时空间离线。
退款
- 你们退款吗
- 除服务条款另有规定或法律要求外，款项不予退还。没有自助退款按钮 —— 每一份申请都由人工阅读并判断。
- 通常什么情况下会退
- 如果付款不足 14 天，且你还没有使用这一单买到的空间或额度，我们通常会退。此范围之外的情况逐例判断。
- 怎么申请
- 用付款的那个账号登录官网，在账号页的「帮助」里点「写给我们」，选「退款申请」和相关订单，说说情况。我们会在两个工作日内回复到你账号的邮箱。
- 哪些不退
- 已经用掉的额度；已经开始使用的那 30 天；以及任何你已向银行发起争议的付款。
- 退款多久到账
- 原路全额退回付款的那张卡，银行通常在 5 到 10 个工作日内入账。
- 我在欧盟或英国，有 14 天吗
- 购买数字服务后你享有 14 天的法定撤回权。若你在结账时要求立即开通，该权利在服务开始时即告终止；仍然适用的情形下，退款按你已使用的比例计算。
- 该不该直接找银行发起争议
- 请先联系我们。争议处理期间我们无法退款 —— 资金被冻结在争议流程里 —— 而且账号可能会被暂停，直到争议结束。
支付与发票
- 可以用什么支付
- 网页端购买支持信用卡和借记卡。卡片由支付服务商保管，我们不会看到也不会存储完整卡号。
- 银行账单上会显示什么
- 扣款显示为 MIRASIM。Mirasim 背后的公司是在特拉华州注册的 Dadao，发票上可能出现这个名称。
- 付款没完成
- 没付完的订单在账号页「付款记录」里，点「继续付款」接着付。
- 收据和发票在哪儿
- 每次付款都会发一封收据邮件，账号页「付款记录」里有每一笔和它的订单号。需要发票或公司抬头，在账号页的「帮助」里选「账单疑问」写给我们。
兑换码与赠送时长
- 账号上有赠送的套餐时长，到期后会怎样
- 不会自动扣款。我们会在到期前 14 天和 3 天各发一封邮件；如果你什么都不做，账号回到免费版，你自己的账号照旧可用。想继续用平台额度时，随时买 Token 包或协作版即可。
- 兑换码在哪儿用
- 官网账号页「我的兑换码」里点「直接兑换」；也可以在应用的账号页里兑换。
常见故障
- 下载后无法打开
首次启动时 macOS 会要求确认打开来自互联网的应用：右键点击应用，选择一次「打开」即可。如果文件看起来已损坏，请重新下载，并在打开前用 SHA256SUMS 比对。
- 智能体找不到 git、gh 或 docker
打开「插件 → 命令行」，这里列出 PATH 上的工具以及各自是否已登录。
- 会话长时间没有输出
会话会显示原因：静默了多少秒、某个工具仍在运行、正在等待模型返回，或者进程仅处于存活状态。已停滞的会话在你发送消息后会继续。
- 截图或屏幕分析无法使用
在 macOS 上这些功能需要「屏幕录制」权限，读取桌面或下载目录还需要「完全磁盘访问」。打开设置里的「系统权限」页，按提示逐项授权，并可随时重新检查。
- Git 操作被拒绝
面板会指出是哪种情形：本地改动会被覆盖、分支已分叉、尚未设置上游、远端更靠前、有一次未完成的合并、凭据被拒；同时给出可以解决的操作，例如先暂存再拉取，或者拉取时执行 rebase。此时仓库还没有发生任何变化。
- 两个会话产生了冲突的改动
如果它们运行在各自的 worktree 中，不会有内容丢失：先合并较好的一份，再把另一份 rebase 到它之上或重新生成。
- worktree 无法删除
worktree 中仍有未提交的改动时，Git 会拒绝移除。请先提交或丢弃这些改动，然后一并删除会话及其 worktree。
- 任务进行中额度耗尽
切换这条会话的线路：改走你自己的账号，或者在还有平台额度时改走 Mirasim 平台额度。两条线路不会自动互相回落；走你自己账号的轮次，在对话记录里带有「自有」标记。
- 我打开的文件被改动了
通常是某个智能体写入了该文件。编辑器会询问是从磁盘重新读取还是保留你的版本。要还原该文件的 Git 改动之前，请先保存或关闭正在编辑的版本。
- ui-cli 无法连接应用
已安装的应用使用 --port 4970；也可以不带 --port，为该条命令启动一个用后即弃的私有服务。
- 某个 MCP 服务的工具始终不出现
先执行一次健康检查。连接器可以执行校验，查看工具数量或错误信息；令牌过期时重新完成 OAuth 授权即可。
- 定时任务没有执行
定时任务按该服务端的时钟触发，需要 Mirasim 处于运行状态；错过的触发会被跳过，不会补跑。最短间隔为 10 分钟。请查看该任务的运行历史，需要验证时使用「立即运行」。
- 在中国连不上协作空间
协作空间暂不对中国大陆、香港、澳门开放，从这些地区的网络连接会被拒绝。本机工作台和手机 App 照常可用。
- 协作空间窗口反复重连
断开期间协作空间里的工作不会停。窗口会倒数下一次重试，点「重新连接」立刻再试。一直连不回来、「所有空间」里这个空间显示「离线」时，是这个空间本身连不上。
- 别人的会话里发不了消息
协作空间里、共享电脑上的会话，在共享之前只有创建者能发。用「分叉一份给我」在自己那份里接着做，或者请创建者「共享给成员」。如果提示某某正在使用这个会话，等对方这一轮结束再发。
- 协作空间里提示「这一轮已结束，后续调用未发出」
智能体在这一轮结束后还想继续，那次调用没有发出。在会话里发一条消息，它就接着做。
- 银行卡被拒付
通常的原因是发卡行拦截了线上或跨境扣款，而不是卡本身有问题。核对卡号、有效期、CVC 和账单地址后重试，或换一张卡试试；没付完的订单在账号页「付款记录」里点「继续付款」。仍然不行时，请让银行为这张卡开通线上和跨境交易。
- 付了款，空间或额度没到
协作空间通常在付款后一分钟内开好；要多等一会儿时，开好会发邮件通知你，用同一个账号登录 Mirasim 就能在「所有空间」里看到。额度到账可能要等一分钟，重新打开账号页看看。一直没到时，在账号页的「帮助」里选「付了没生效」写给我们。
账号被限制时
账号被限制或请求被拒时，可以在客户端里提交申诉，由人工复核。
- 打开「版本」页
点左下角账号卡，再点「版本」，然后点最后一行的「反馈」。
- 把类型切到「申诉」
在弹窗顶部切换类型。需要先登录。
- 把表填完再提交
填完带 * 的项，点「提交申诉」。
- 报错原文，原样粘贴。
- 从什么时候开始，以及这个账号平时用来做什么。
- 三个是非题：账号是否有别人在用、是否有脚本或批量任务在调用、流量是否转给第三方。
- 联系方式。默认填入登录邮箱，可以修改。
同一账号每 30 分钟只能提交一条申诉。已有一条在处理中时，提示里会带上它的编号，不用重复提交。结论会发到你在表单里留的联系方式。
获取帮助
咨询和缺陷报告请发送到页脚的联系地址。请说明涉及哪个工作区、你让智能体做什么、它实际做了什么；条件允许时，把出错的那一轮导出附上。
还有问题，或发现这里缺了一项？ support@mirasim.ai，或者直接去 Discord 频道里提需求。