帮助
常见问题
- 哪些机器可以运行 Mirasim
- 桌面应用提供 macOS（Apple 芯片，macOS 13 或更高版本）、Windows（10 1809 及以上，x64/Arm64；安装包目前还没有代码签名，首次安装时 SmartScreen 会告警）与 Linux（AppImage 或 .deb，x64/Arm64，Ubuntu 22.04 及以上或同代 glibc 发行版）三种。随身客户端要求 Android 8 及以上，iPhone 版还在 TestFlight 内测。Linux 机器同样可以作为自建服务端，供上述任意客户端连接。
- 必须使用自己的密钥吗
- 不必。可以用你自己的账号（智能体订阅、API 密钥或本地模型），也可以开通套餐走 Mirasim 的平台额度。每条会话走其中一种。
- Mirasim 免费吗
- 用你自己的账号就免费：智能体订阅、API 密钥和本地模型都在 Free 档上用，手机 App 和 IM 也一样。付费套餐增加的是 Mirasim 的平台额度，云端套餐还包含一个团队共用的协作空间。各档见价格页（mirasim.ai/pricing）；官网目前还不能购买。
- 团队能一起用吗
- 能，在协作空间里（每个空间最多 25 人共用；需要更多成员可写信到 support@mirasim.ai 联系我们开通，更大的团队会在企业版中支持），或者在接入云端的你自己的电脑上。用邮箱邀请；每个人发的轮次都署着名、记在发送人名下，团队就在会话旁边聊天。见第 10–12 章。
- Mirasim 支持哪些智能体
- 第三方的编程智能体命令行工具：Claude Code、Codex、Gemini CLI、Kimi Code、Qwen Code 等。Mirasim 没有自研的编程智能体，它把这些智能体并排跑起来，会话切换智能体时会带着已有对话。
- 多个智能体可以同时操作一个仓库吗
- 可以，按会话创建 worktree 正是为此设计：每个智能体在自己的分支上拿到一份真实检出，最后由你决定怎么合并。
- 我的代码会被发送到哪里
- 会发往你接入的模型供应商，使用你自己的账号；走 Mirasim 平台额度的轮次经由 Mirasim 转发；也会发往你启用的聊天渠道。使用本地模型时所有内容留在本机。记录了哪些内容以及如何关闭，见第 17 章。
- 评测会一直运行吗
- 不是。$eval 是需要显式启用并调用的能力，调用时在本机运行。
- Claude Code 和 Codex 还能按现在的方式使用吗
- 可以。两者都保留自己的终端界面和登录状态。Mirasim 只改变它们的模型流量路径，并原样转发请求体。
- 如何校验下载的文件
- 每个版本都会发布 SHA256SUMS，覆盖所有公开下载的文件。打开之前先比对校验值。
订阅与计费
- 各档套餐多少钱
- 具体价格只写在价格页（mirasim.ai/pricing），以那里为准。档位大致是：Free 完全跑在你已有的账号上；Go 在本机提供开源模型的平台额度；Basic、Pro、Max 各含一个协作空间（Linux 或 Mac 环境）和每月的平台额度，档位越高额度越多。协作空间也可以单独买，规模更大的团队可以找我们要企业版报价。用量怎么计量见第 11 章。
- 价格含税吗
- 不含。你所在地的销售税、增值税或商品服务税在结账时计算，付款前会明确列出；在美国这取决于你所在的州。
- 什么时候扣款
- 第一笔在你确认订单时扣。之后每月同一日期扣款，直到你取消；某个月没有对应日期时，扣款落在该月最后一天。
- 会不会被扣超过套餐价的钱
- 不会。套餐是预付的，你看到的价格就是全部费用 —— 没有在此之上按用量另计的部分，也不会事后补一张账单。需要更多就升级。
- 续费日期会变吗
- 不会。升级、降级和更换银行卡都不会移动它。
- 没用完的额度会累积吗
- 不会。包含的用量随每个计费周期重置。剩下的部分不结转、不折现、不转让到其他账号，订阅结束时它也随之结束。
- 月中用完了怎么办
- 把会话切回你自己的 Claude Code、Codex 或 API 账号继续做 —— 这条路径完全不消耗云端额度。另一个选择是升级：立即生效，更大的额度当即可用。路由怎么设见第 10 章；应用在那一刻的具体表现，见「常见故障」里的「任务进行中额度耗尽」。
- 包含的额度可以在 Claude Code 和 Codex 之间分配吗
- 可以，比例随你。按会话怎么设置路由见第 13 章。
- 在哪儿看下一笔要扣多少
- 账号页会显示当前套餐、本周期已用量、下一笔金额，以及扣款日期。
- 可以以公司名义购买吗
- 在结账时填写公司信息和税号。适用的情形下这会使该笔购买免征增值税，这些信息也会体现在发票上。
- 价格会变吗
- 有可能。如果变动影响到你的套餐，我们会在生效前至少 30 天发邮件告知，并说明如何取消。不取消即表示新价格从你的下一次续费开始生效。
变更套餐
- 月中升级会怎样
- 立即生效。你需要为本周期剩余的天数补两档之间的差价，所以在月中升级大约要付一半的差额。续费日期不变。
- 升级后包含的用量怎么算
- 本周期剩余时间按新套餐的月度额度计，且已经用掉的部分要从中扣除。
- 降级会怎样
- 降级是预约生效，不是立即生效。计费周期结束之前，你保留当前套餐及其全部包含用量，期间既不扣款也不退款；账号页会把它显示为一次待生效的套餐变更，并标明新套餐的开始日期。
- 可以撤销降级吗
- 可以，在它生效之前随时都行。当前套餐继续，计费不变。
- 降级为什么不退款
- 这个周期你已经付过钱，而且直到周期结束你都完整保有它，包含用量也在内。既不多扣，也不退回。
取消订阅
- 怎么取消
- 账号 → 订阅 → 管理订阅，然后选择取消订阅。随后会收到一封确认邮件，里面写明云端额度的结束日期。
- 取消什么时候生效
- 在当前计费周期结束时。在那之前你保留套餐和剩余的包含用量，并且不会再被扣款。
- 我的项目和智能体会怎样
- 账号回到 Free。你自己的 Claude Code、Codex、API 和本地模型账号照旧可用 —— 停的只是云端额度。项目、会话、worktree 和各项设置都留在原处。
- 剩下的日子会退钱吗
- 不退。你已付费的那个周期会走完，此后不再扣款。
- 误取消了，能撤回吗
- 如果还没生效，在计费门户里选择恢复订阅即可，一切照旧。如果已经失效，重新订阅即可；账号及其设置都还在。
- 为什么取消不了
- 几乎总是因为你登录的账号不是付款的那一个 —— 用另一个邮箱多出一个账号是很容易发生的事。请用订阅上的那个邮箱登录；如果仍然不行，用该邮箱写信给我们。
退款
- 你们退款吗
- 除服务条款另有规定或法律要求外，款项不予退还。没有自助退款按钮 —— 每一份申请都由人工阅读并判断。
- 通常什么情况下会退
- 如果扣款不足 14 天，且你在该周期内没有使用过套餐，我们通常会退。此范围之外的情况逐例判断。
- 怎么申请
- 用被扣款的那个账号，走「账号 → 计费帮助」，附上金额与日期、有的话再附发票编号，并简述经过。我们会在两个工作日内回复。
- 哪些不退
- 本周期内已经消耗的用量；取消或降级之后的当前周期；以及任何你已向银行发起争议的扣款。
- 退款多久到账
- 原路全额退回付款的那张卡，银行通常在 5 到 10 个工作日内入账。
- 我在欧盟或英国，有 14 天吗
- 购买数字服务后你享有 14 天的法定撤回权。若你在结账时要求立即开通，该权利在服务开始时即告终止；仍然适用的情形下，退款按你已使用的比例计算。
- 该不该直接找银行发起争议
- 请先联系我们。争议处理期间我们无法退款 —— 资金被冻结在争议流程里 —— 而且账号可能会被暂停，直到争议结束。
支付与发票
- 可以用什么支付
- 网页端购买的订阅支持信用卡和借记卡。卡片由支付服务商保管，我们不会看到也不会存储完整卡号。
- 银行账单上会显示什么
- 扣款显示为 MIRASIM。Mirasim 背后的公司是在特拉华州注册的 Dadao，发票上可能出现这个名称。
- 怎么换卡
- 「账号 → 管理订阅」会打开计费门户。新卡将成为默认卡，此后每次续费都从它扣。
- 发票在哪儿
- 订单记录在账号页；完整发票在计费门户里，任意一张都可以作为 PDF 下载。每次付款也会发一封收据邮件。
- 发票能开公司抬头吗
- 在计费门户里更新计费信息 —— 公司名称、地址、税号。这些信息对此后开具的发票生效，已开具的发票无法修改。
- 可以改计费日期吗
- 不能直接改。可以取消，然后在你想要的日期重新订阅；注意取消不会退还当前周期，所以计费周期的末尾才是做这件事的时机。
免费期
- 账号上有赠送的套餐时长，到期后会怎样
- 不会自动扣款。我们会在到期前 14 天和 3 天各发一封邮件；如果你什么都不做，账号回到 Free，你自己的账号照旧可用。想要恢复云端额度时随时订阅即可。
常见故障
- 下载后无法打开
首次启动时 macOS 会要求确认打开来自互联网的应用。右键点击应用并选择一次「打开」即可。如果文件看起来已损坏，请重新下载，并在打开前用 SHA256SUMS 比对。
- 智能体找不到 git、gh 或 docker
从程序坞启动的应用不会继承终端的 shell 环境。查看「插件 → 命令行工具」，其中列出 PATH 上有哪些工具以及各自是否已登录。通常这会把「智能体推送失败」明确为「gh 从未登录」。
- 会话长时间没有输出
会话会说明原因：静默了多少秒、某个具名工具仍在运行、正在等待模型返回，或者进程仅处于存活状态。已停滞的会话在你发送消息后会继续。如果它不是停滞而是在原地重复，几乎总是因为目标不够明确，此时应中断它并重新说明完成标准。
- 截图或屏幕分析无法使用
在 macOS 上这些功能需要「屏幕录制」权限，读取桌面或下载目录还需要「完全磁盘访问」。授权对象是启动 Mirasim 的那个应用。权限页面会逐项引导并支持随时重新检查，因为其中部分权限 macOS 完全不会主动询问。
- Git 操作被拒绝
面板会指出你处于哪一种常见的 Git 情形：本地改动会被覆盖、分支已分叉、尚未设置上游、远端更靠前、有一次未完成的合并、凭据被拒。同时给出可以解决的操作，例如先暂存再拉取，或者拉取时执行 rebase。看到该提示时仓库尚未发生任何变化。
- 两个会话产生了冲突的改动
如果它们运行在各自的 worktree 中，不会有内容丢失：先合并较好的一份，再把另一份 rebase 到它之上或重新生成。下次请给并行的会话分配互不重叠的部分，或者有意让它们并行尝试同一任务，最后保留一份。
- worktree 无法删除
worktree 中仍有未提交的改动时，Git 会拒绝移除。请先提交或丢弃这些改动，然后一并删除会话及其 worktree。
- 任务进行中额度耗尽
切换这条会话的路由：改走你自己的账号，或者在套餐还有余量时改走 Mirasim 的平台额度。两条路由不会自动互相回落；走你自己账号的轮次，在对话记录里带有「Own」标记。
- 我打开的文件被改动了
通常是某个智能体在写入该文件。编辑器会提示并询问是从磁盘重新读取还是保留你的版本，不会无声地丢弃任何一方。要还原该文件的 Git 改动之前，请先保存或关闭正在编辑的版本。
- ui-cli 无法连接应用
把它指向一个正在运行的实例：已安装的应用使用 --port 4970，开发版桌面实例使用 --port 4950；也可以不带 --port，为该条命令启动一个用后即弃的私有服务。
- 某个 MCP 服务的工具始终不出现
先执行一次探活。握手失败的服务会导致智能体无法完成你交给它的工作，而且过程中不会有明显提示。连接器方面，校验会记录工具数量或错误信息；令牌过期时重新完成 OAuth 授权即可。
- 定时任务没有执行
定时任务按该服务端的时钟触发，且需要 Mirasim 处于运行状态；错过的触发会被跳过，不会集中补跑。最短间隔为 10 分钟。请查看该任务的运行历史，需要验证时使用「立即运行」，不必等待。
- 在中国连不上协作空间
协作空间暂不对中国大陆、香港、澳门开放，从这些地区的网络连接会被拒绝。本机工作台、手机 App 和聊天渠道照常可用。
- 协作空间窗口反复重连
断开期间协作空间里的任何东西都不会停；窗口会倒数下一次重试，点「重新连接」立刻再试。一直连不回来时，看机器菜单里它是不是显示「离线」：是的话，连不上的是这个空间本身，而不是你的网络。
- 「这是某某的会话，你没有发送权限」
协作空间里、共享电脑上的会话，在共享之前只有创建者能发。用「分叉一份给我」在自己那份里接着做，或者请创建者「共享给成员」。如果写的是「某某正在使用这个会话」，那是对方这一轮还在跑，等它结束再发。
- 协作空间里提示「这一轮已结束」
智能体在这一轮结束后还在干活（比如后台任务晚回报），那次后续调用没有发出。在会话里发一条消息，它就接着做。
- 银行卡被拒付
通常的原因是发卡行拦截了线上、跨境或周期性扣款，而不是卡本身有问题。可以在账号页重试，在「管理订阅」里核对卡号、有效期、CVC 和账单地址，然后换一张卡试试。仍然不行时，请让银行为这张卡开通上述三类交易。
- 取消之后仍被扣款
取消在计费周期结束时才生效，所以日期在该周期结束之前的扣款，仍属于你当时所在的那个周期。如果扣款日期落在该周期结束之后，请通过「账号 → 计费帮助」把金额、日期和发票编号发给我们。
- 升级了但额度看起来没变
新额度在付款清算后生效，通常是即时的，但也可能要等上一分钟 —— 重新打开账号页看看。本周期已经用掉的部分仍要计入，所以你看到的余量会少于新套餐一整月的量。
账号被限制时
共享的模型容量前面有一套自动风控。它偶尔会拦到正常账号，因为用量很大的正常使用，看上去可能就像它要挡的那种行为。遇到这种情况不必在支持渠道里反复交涉，客户端里有申诉表单，交上来由人工复核。
- 打开版本面板
点侧栏底部的版本号，面板最后一行是「反馈」。
- 把类型切到「申诉」
弹窗默认在「反馈」，顶部的切换里有第二种类型。需要先登录，因为要复核的是一个具体账号。
- 把表填完再提交
每一项都是「不问就得来回一封邮件、再等一天」的问题。填完关键项之前，提交按钮不会亮。
- 报错原文，原样粘贴，不要复述。这是最有用的一项，它能说明是哪条规则拦下的。
- 从什么时候开始，以及这个账号平时用来做什么。
- 三个是非题：账号是否有别人在用、是否有脚本或批量任务在调用、流量是否转给第三方。
- 联系方式。默认填入登录邮箱，可以改，因为收不到信的可能正好是那个邮箱。
同一账号每 30 分钟只能提交一条申诉。如果已经有一条在处理中，返回的提示里会带上它的编号，看到编号就说明我们收到了，不用重复提交。结论会发到你在表单里留的联系方式；自动风控的具体规则不对外公开，所以结论不会逐条解释判据。
获取帮助
咨询、缺陷报告和评测方面的深入讨论，都可以发送到页脚的联系地址，由人工处理。请说明涉及哪个工作区、你让智能体做什么、它实际做了什么；条件允许时，把出错的那一轮导出附上。保留下来的轨迹总是比文字描述更有用。
还有问题，或发现这里缺了一项？ support@mirasim.ai，或者直接去 Discord 频道里提需求。