Mirasim 文档
成员与协作
把人加进协作空间或设为协作空间的电脑,给团队配好智能体、模型和额度,看谁在做什么,在会话旁边直接讨论。
谁能进来
这一章适用于协作空间,以及设为协作空间的你自己的电脑(第 14 章)。每个空间、每台电脑都有自己的成员名单,每位成员是四种身份之一。
| 身份 | 是谁 | 能做什么 |
|---|---|---|
| 所有者 | 拿到它的人:建这个协作空间的人,或这台电脑的主人 | 一切。只有所有者能任免管理员。不能被降级或移出,也不能退出。 |
| 管理员 | 所有者任命;占一个协作席位 | 还能升级那里的 Mirasim、安装与更新智能体、配置模型、加人,在协作与观察之间调整成员、移出他们。 |
| 协作成员 | 占一个协作席位(协作空间每个 5 个,可加购;自己的电脑开的协作空间 2 个,连主人 3 人) | 使用里面的全部资源:工作区、会话、终端。不能改凭据、模型、智能体与设置。可以自己退出。 |
| 观察成员 | 每个空间最多 100 位,不占协作席位 | 能看会话、文件、成员和聊天,在群里也能 @ 助手;不能发起或推动会话。可以自己退出。 |
加人
- 打开 空间设置 › 邀请
点左栏顶部的空间名 › 空间设置 › 邀请。这里可以按邮箱添加、分享邀请链接、审批加入申请。成员名单在 空间设置 › 成员,点窗口右侧工具条的「成员设置」或其中一个头像也能打开。
- 填对方的邮箱
对方还没注册也可以。已经有 Mirasim 账号的直接加入;没有的会收到一封邀请邮件,用这个邮箱第一次登录时自动加入。只有所有者能直接邀请为管理员。
- 对方在「所有空间」里找到它
对方登录后会收到通知,空间菜单的「所有空间」里多出这个空间,点开就是它自己的窗口。

- 协作席位满了(协作空间 5 个,自己的电脑 2 个),「邀请」里会写「新成员先以观察成员加入」;要加席位,写信到 support@mirasim.ai。还没接受的邀请按它的身份占名额,列在「已邀请」里并写着几天后过期,可以「撤销」。
- 想让人付费加入,在 空间设置 › 开放设置 里开启「付费加入」(见下文「开放设置」)。
- 改了某人的身份,对方已打开的窗口会在 15 秒内生效。
- 移出某人会立刻断开对方的所有窗口,之后除非重新添加,否则进不来。成员也可以自己退出:空间设置 › 通用 › 危险操作 ›「退出空间」。
- 所有者可以在「成员」里,从对方的角色菜单选「转让所有者」,对方接受后生效。
- 空间设置 › 访问记录 写着谁添加、任免、移出了谁,从现任所有者拿到它那一刻算起。

给团队配智能体
Claude Code、Codex 等智能体是实际干活的程序。在空间窗口的 设置 › 智能体配置 里,所有者和管理员可以安装、更新智能体,设定「默认智能体」、默认模型和「推理强度」,新会话按这里开始。协作成员在自己发起的会话里可以换智能体和模型;观察成员只能看。
共享 API key
- 打开 设置 › 模型配置
在空间窗口里打开,所有者和管理员能改这一页。
- 接入供应商
任意供应商或中转都可以:填 API 地址和 key,再导入要用的模型。
- 勾选「共享给成员」
新建的配置默认勾选;以前配置或导入的 key,编辑后勾上再保存。
- 成员直接选用
它出现在每位成员会话的模型选择里,成员直接用,看不到 key 和接口地址。
- 用共享 key 的轮次由它的供应商结算,不扣 Mirasim 额度;花费上限在供应商后台设置。
- 在协作空间里,同一页的「成员用量」写着每个人用了多少:管理员看全部人,成员只看自己。
- key 由添加它的人管理,其他人只能选用、不能修改。
空间额度与个人额度
平台模型用 Mirasim 额度,1 额度按官方 API 价计 $1。额度分两种:
| 额度 | 从哪来 | 谁来用 |
|---|---|---|
| 个人额度 | 档位附带的额度、Token 包 | 自己 |
| 空间额度 | 买空间加赠的额度,以及成员从个人额度转入的。转入的保留原来的到期日,加赠的从到账起 6 个月内有效;空间删除或到期收回时清零 | 空间里的成员 |
让全队用上空间额度
- 转入额度
空间设置 › 空间额度 ›「转入额度」。任何成员都能从个人额度转入,最少 50 额度:转入 100,空间到账 100。转入后归空间所有,不能转回个人,成员退出也留在空间里。
- 空间额度默认开着
每个空间一开始就开着空间额度。只有所有者能在「开启空间额度」处停用,余额保留。
- 设好分配方式
所有者和管理员决定每人能用多少,见下文。
开着的时候,每个人在「额度来源」里选「空间」或「个人」,默认用空间。用空间的轮次先扣空间额度;本人份额用完或空间余额不足时,这一轮改扣他自己的个人额度。空间额度够用时,成员无需自己购买。
分配方式与成员上限
| 分配方式 | 效果 |
|---|---|
| 不限 | 大家共用,直到空间余额用完。 |
| 固定均分 | 按现在的余额平均分给现在的成员。之后加入的人、新转入的额度,点「重新均分」再分。 |
| 定期均分 | 每小时或每天,按当时的余额重新平均分给所有成员。 |
也可以给某个人「单独设置」上限。上限按累计用量算:某人已用 30,想让他再用 20,就把上限设为 50。
空间里的程序调模型
空间里的程序可以直接调模型,费用从空间额度扣:自己写的代码,以及 Dify、LobeChat、n8n、Open WebUI 这类应用都行。每把密钥单独记账、可设上限;暂不支持 Claude 模型。
- 新建一把密钥并设为默认
空间设置 › 空间额度 › API 密钥 ›「新建密钥」:填名称、上限和「有效期」。空间里还没有默认密钥时,「设为默认」已经勾上。由所有者或管理员在电脑上操作。
- 代码里读两个环境变量
空间里的终端、智能体和定时任务已经带上
MIRASIM_API_BASE和MIRASIM_API_KEY,不用往代码里抄任何值。
import os
from openai import OpenAI
client = OpenAI(
base_url=os.environ["MIRASIM_API_BASE"],
api_key=os.environ["MIRASIM_API_KEY"],
)
r = client.chat.completions.create(
model="deepseek-flash",
messages=[{"role": "user", "content": "hi"}],
)
print(r.choices[0].message.content)新建的密钥不会显示出来,页面上只有名称和「编号」。MIRASIM_API_KEY 只在这个空间里有效,不是模型密钥。也可以在会话里让智能体帮你接好。
在应用里填写
| 字段 | 填什么 |
|---|---|
| Base URL / API 地址 | http://127.0.0.1:4963/v1 |
| API Key | MIRASIM_API_KEY 的值(msl_ 开头) |
| 模型 | 应用会自己拉取列表,也可以手填 |
- 两个值在「API 密钥」页的「在空间里怎么用」里各有复制按钮;也可以在空间的终端里运行
echo $MIRASIM_API_BASE $MIRASIM_API_KEY。 - GPT 型号也能用大多数应用调用的聊天接口(chat/completions)。
- 网页前端不能在浏览器里直接调用,要经过自己的服务端。
- Docker 里要用 host 网络(
--network host):容器里的 127.0.0.1 是容器自己。
常驻服务
不是从空间终端启动的服务,从 ~/.mirasim/run/space-api.env 读这两个值:
| 启动方式 | 写法 |
|---|---|
| pm2 | 在空间终端里重启:pm2 restart <应用名> --update-env |
| systemd | 写进服务的 [Service] 段:EnvironmentFile=%h/.mirasim/run/space-api.env |
| Docker | docker run --env-file ~/.mirasim/run/space-api.env --network host … |
指定用哪一把密钥
不写编号的调用用默认密钥。想让某个程序单独记账、单独设上限,给它建一把密钥,把编号写进地址 http://127.0.0.1:4963/k/<编号>/v1,或加请求头 X-Mirasim-Key: <编号>。
谁能做什么
| 角色 | 能做什么 |
|---|---|
| 所有者、管理员 | 新建、编辑、设为默认、停用、删除密钥;「重置通行证」 |
| 协作成员 | 看密钥(名称、编号、是否默认、用量)和接入说明,在程序里使用 |
| 观察成员 | 不能使用 |
「重置通行证」让当前的 API Key 立即失效:读环境变量的程序重启后自动用上新值,贴进应用设置的要重新填一次。
以前建的密钥与空间外的程序
- 密钥改成只在空间里用之前建的,标着「旧密钥」,照常在任何地方能用,包括空间外,直到过期或被删除。这一类不能再新建。
- 部署到空间外的程序(比如自己的服务器)只能用旧密钥;否则就把它放在空间里,从空间对外发布(见下文「开放设置」)。
调用失败时
| 报错说的是 | 怎么办 |
|---|---|
通行证不对(bad_pass) | 通行证被重置过。重启程序或新开终端;贴在应用里的重新填一次。 |
还没有默认密钥(no_default_key) | 请所有者或管理员把一把密钥「设为默认」,或在调用里写上编号。 |
这把密钥用不了(key_unavailable) | 编号写错,或密钥已停用、已过期。换一把,或请所有者、管理员处理。 |
| 额度用完 | 空间额度或这把密钥的上限用完了。转入额度,或请管理员调高上限。 |
| 网络不稳定 | 稍后再试。 |
谁在、在做什么
- 窗口右侧工具条上,「协作」下面是此刻在这里的其他人的头像,最多 5 个,其余折成 +N。右下角有小点的是正在运行一轮,变暗的是暂时离开。
- 指向一张脸会弹出这个人的名片:角色、设备、最近活跃、正在运行的会话。点一下打开 空间设置 › 成员,并选中这个人。
- 空间设置 › 成员 里的「成员动态」打开「谁在做什么」,画出此刻谁在运行、谁在查看哪个会话。
一起用会话
每个人发出的每条指令都署着名。几个人一起写过的会话里,每条用户消息上方都写着发送人的名字和头像;侧栏里这个会话那一行,也会画出在里面提过问的人。
- 默认只有创建者能发
- 别人的会话你都能看,但只有创建者能在里面发。想接着做,就「分叉一份给我」;或者请创建者在会话的 ⋯ 菜单里打开「共享给成员」,共享之后所有成员都能在里面发消息。
- 一次只跑一个人的一轮
- 某人的这一轮在跑时,别人可以看,等这一轮结束再发。所有者可以停止别人的这一轮,会先确认。
- 全部 / 我的
- 会话列表顶部的切换。「我的」只留你创建的、或你发过言的会话。
- 通知
- 手机上会话跑完、等人回答的通知,只发你自己发出的那一轮。

协作:频道、私信与话题
每个协作空间、每台共享的电脑都有自己的团队聊天,从窗口右侧工具条的「协作」打开(⇧⌘M)。它停靠在窗口右侧,也可以「在窗口中打开」。消息存在空间或电脑里,那里的智能体读得到;离线时,它的协作也用不了。

- 频道
- 每个空间、每台共享的电脑都自带「大厅」。只有所有者和管理员能新建频道、改频道成员。
- 私信
- 一对一。
- 会话评论
- 每个会话一个房间,放的是对它各轮的评论,见下一节。
- 话题
- 「在话题中回复」把一段讨论从主线里拿出去。关注一个话题,它的新回复会进「与我相关」;讨论完了右键(手机上长按)「完结话题」,它仍然能看、也还能回复。
- 与我相关
- @ 你的、回复你的、你关注的话题,以及命中关键词的消息。@所有人 / @在线的人 能一次叫到整个房间或此刻在线的人。
- 自己的设置
- 每个房间的通知(所有消息 / 仅 @ 和回复 / 静音)、勿扰(可以每天定时)、关键词提醒,以及导出聊天记录。
助手:在群里派活
在聊天里 @ 一个助手,它就在这个协作空间(或这台电脑)里开一个会话去做,结果回到话题里。助手就是起了名字的智能体,带着模型、默认工作区,以及选定的技能和 MCP 服务器;由所有者和管理员在「成员」里新建,或从「助手市场」添加。助手要问问题时,只有 @ 它的那个人能回答。
也可以交给 Mira Bot。它把一句话拆开,分给合适的助手,各自在自己的会话里并行做,互不干扰。每件活有自己的话题,在那里接着说,话直接进那件活的会话。进度随时问 Mira Bot。
第 3 章 · Mira Bot 与助手 → 新建助手、派活的几种方式,以及派出去的活去哪看。
聊天和会话之间
- 评论某一轮:在会话里悬停一轮,选「评论」,@ 人把对方叫进来。「交给智能体」把这条评论作为你发的一轮送进会话;「解决」把它关掉。
- 分享到聊天…:把一个会话、或其中某一轮,作为卡片发到某个房间,别人点开就能看。
- 发给会话…:在消息的 ⋯ 菜单里,把这条消息交给某个会话,作为它的下一轮。
- 记为事项…:在会话某一轮的 ⋯ 里,从这一轮的回答中勾出要做的几件事;在消息的 ⋯ 里,把这条消息记成事项。见下一节。
事项:团队要做的事
事项是团队要做的事,在「协作」的「事项」页签里,协作空间和设为协作空间的电脑上都有。每个事项有编号(T-1、T-2…)。在列表顶上那一行直接写一条;在会话里,某一轮的 ⋯ 里选「记为事项…」,从这一轮的回答里勾出几条来记;协作里的消息也能在 ⋯ 里记成事项。点一个事项打开它的详情:各项属性、会话、子事项、活动记录,要讨论时再「发起讨论」。事项默认只在列表里,要大家看到时再发到大厅。
- 负责人
- 一个负责人;不指定就是待认领,房间里谁都能「认领」。「指派」给别人时可以附一段交接说明。
- 协作人
- 和负责人一起做的人,跟着它的话题,收到和负责人一样的状态和提问。
- 状态
- 待办、进行中、待验收、已完成、已取消,点行首的状态图标就能改。没人改过状态时,有会话接手的事项就算进行中。
- 子事项
- 最多两层。可以逐条添加、按说明里的列表拆出来,或者挂上已有的事项;父事项上显示完成了几个。
- 会话
- 事项详情里的「新建会话」为它开一条会话:「我来开」或「委托给助手」,选好用途(执行、调研、评审、对比、拆分),首句已经带上事项内容,可以改;助手做完的结果回到事项里。「关联会话」把已经在做的会话挂上来。每条会话旁边显示它此刻在跑、等人、中断还是完成;从会话某一轮记下的事项,自动挂着那个会话作出处。会话那边,输入框上方会写出它属于哪个事项。
- 截止日与里程碑
- 截止日当天变黄、逾期变红。里程碑把一组事项归在一起,带自己的截止日和完成进度。
列表上方的视图按人切分:全部、我负责、我参与、我分发、已完成,以及里程碑;「筛选」再往下收窄,常用的筛选可以存成「视图」。「展开」把事项铺满窗口;从「列表」切到「看板」,待办、进行中、待验收、已完成排成四列,把卡片拖到另一列就是改状态。手机上有同样的列表、状态图标、子事项和会话,没有看板。
开放设置:空间对外提供什么
「空间设置」›「开放设置」列出这个空间对外提供的一切,外面的人和系统不用加入空间就能用:空间主页、空间里的智能体(在 Zed、JetBrains 等编辑器里通过 ACP 连接)、已发布的网页和服务,以及接口应用。网页、服务和对外智能体要审核通过才公开;接口应用保存即生效。配置都在工作区的 .mirasim/publish.json 里,可以自己改,也可以在会话里交给智能体:内置的 mirasim-publish 技能会写好配置、在本机预览,把结果给你看过再提交。
接口应用让外部系统把事件送进空间:告警、Webhook、网页上的反馈表单、和别的工具同步事项。这台电脑按规则、智能体或你自己的服务处理每个事件,只用你勾选的权限在空间里执行动作:新建事项、发送房间消息、通知成员、运行智能体、接收文件、运行定时任务。
- 访问方式
- 令牌:外部系统带访问令牌调用。公开:空间已上线网页的访客调用,无需登录,每位访客每天有次数上限。
- 处理方式
- 直连(调用方自己调动作)、规则(几步固定动作)、智能体(在指定目录里跑一轮,指令写在 AGENTS.md)、或本机端口上你自己的服务。
- 权限
- 不勾选就什么都做不了。消息只能发给应用里写明的成员和房间。
- 计费方式
- 只有智能体回合产生费用。可以用空间额度并设每日上限(公开应用从对外钱包扣),也可以用自有账号。
- 事件推送
- 事项变化或任务完成时,空间把带签名的事件推送到你填写的地址;「推送记录」里能看每一次结果,也能重新发送。
- 访问令牌、调用记录、测试
- 令牌生成时只显示一次,由你交给对方系统。调用记录保留 30 天。「测试」在这台电脑上真实地跑一次。
「开放设置」里的「付费加入」卖的是空间本身的名额:定个价格(或者直接对空间里的智能体说「加入空间收 1 额度」),就得到一条加入链接。访客打开链接、登录,在 Mirasim 的付款框里确认,额度从对方自己的账号出。云空间里,付了款当场加入,按你选的身份成为协作成员或观察成员,额度进空间额度;名额满时不收钱,没能加入的原路退回。电脑上的协作空间,付费申请仍要你审批,没通过、撤回或 14 天没处理都会退款。
手机上
手机 App 用同一个账号登录,你的协作空间就列在「云端」一组里。连上之后,手机上有同样的协作聊天和成员名单,管理员在手机上也能任免和移出成员。
这一页有错或缺了什么? 告诉我们