从手机或聊天软件里运行编程智能体

Mirasim 提供的各端

通常你的桌面端既是服务端，也是数据的唯一来源。其余各端都是进入它的通道：已配对的安卓客户端和已配置的聊天渠道各走自己的传输方式，桌面端也可以改为指向你自行部署的 macOS 或 Linux 服务器。

各端的用途

桌面端: 主要的多智能体工作台，同时作为本机服务端。Apple 芯片的 macOS 用 DMG 安装（要求 macOS 13 及以上）；Linux 提供 AppImage 与 .deb（x86_64 与 arm64）。
安卓端: 配对使用的随身客户端，用于查看会话、发送指令、处理待决事项、接收通知和查看对话中的图片。已签名的 APK，要求 Android 8.0 及以上。
iPhone: iOS 上的同一款随身客户端，通过 Apple 的 TestFlight 测试通道分发，尚未上架 App Store：请先安装 TestFlight，再从下载页打开邀请链接。要求 iOS 15 及以上。
命令行与终端界面: 内置智能体、透明启动 Claude 与 Codex、控制服务端、管理账号、自检和自动化。独立的 darwin-arm64 压缩包。
聊天渠道: 远程发送指令、查看实时进度、由人处理待决事项、接收产物回复。支持 Telegram、飞书、Slack、Discord、钉钉、企业微信和微信。

安卓客户端

安装已签名的 APK 并与服务端配对之后，你在任何地方都可以查看会话、发送指令、处理正在阻塞工作的待决事项，并在有事项需要你时收到通知。配对带有密钥：当配对码包含服务端的端到端公钥时，该连接使用应用层端到端加密。

在服务端开启远程访问
在设置的「连接」中配置：本机可以仅限本地访问，也可以在局域网内可达，或者通过中转地址在互联网上可达。如果这台机器本身有公网地址，填入之后客户端会直接连接。
完成手机配对
在客户端中扫描服务端的二维码，或粘贴连接码。连接码中包含访问令牌，只应提供给你信任的人。
把它作为随身客户端使用，而不是第二套工作台
手机端针对适合单手完成的操作设计：查看进展、回答问题、排入下一条指令、解开被阻塞的决定。

手机的设置里有一项「运行账号」：那台机器上的对话用哪个订阅账号跑，每个账号都显示自己的用量。切换从下一轮开始生效，正在跑的这一轮仍用原来的账号。添加账号需要粘贴一串凭据，那件事更适合在电脑上做；手机只负责在已有账号之间挑一个。

手机还可以升级与它配对的那台电脑，机器在家里而人不在时这一点有用。执行前会先问一次，因为升级会重启那台机器上的应用并断开当前连接——重新连上就是升级成功的凭证。

配对的设计目标是比它建立时所在的那个网络活得更久。手机和服务端在同一个局域网时优先走局域网，不在时改用中转地址，而这个地址由服务端自己找到，不需要你去配。手机暂时连不到这台机器时，面板会说明，链路会自行重连，你不需要重新配对。背后的凭据加密保存，并与签发给它的那台设备绑定，因此凭据被复制到别处也用不了。

聊天渠道

接入一个聊天平台之后，你的工作区就可以从对话中访问：发送指令、查看进度、处理待决事项、接收产物。所有支持的渠道都使用长连接模式，因此都不需要公网 IP，也不需要对外开放回调地址。

七个渠道，各自需要不同形式的凭据

Mirasim

默认

42%

checkout-api

design-system

docs-site

infra

mobile-app

storefront

infra

payments

/New Session

Type a prompt — paste or drop files too

~/code/storefront

Mirasim 的聊天渠道设置界面，列出支持的渠道以及各自尚未完成的配置。

七个渠道每一行都明确标出是否已连接、还缺少什么。因此配置到一半的渠道是可见的，不会表现为无故没有响应。（该控件不在当前这一屏上）

这块面板上的按钮可以直接点，点着看看。

各渠道需要提供的内容

渠道	需要提供
Telegram	从 @BotFather 获取的机器人令牌；另可提供允许的会话 ID 名单，限制使用范围。
飞书	应用的 App ID 与密钥、启用机器人能力、导入消息相关权限，并把事件与回调均设为长连接模式。
Slack	启用 Socket Mode 并配置应用级令牌，另需机器人令牌，以及消息和被提及两类事件订阅。
Discord	已启用消息内容权限的机器人令牌，并把机器人邀请进某个服务器。
钉钉	从企业内部应用或机器人应用获取 Client ID 与密钥，启用机器人能力，事件使用 Stream 模式。
企业微信	在管理后台获取智能机器人的 ID 与一次性密钥，之后该渠道会保持一条长连接。
微信	扫码登录并在手机上确认；只有校验通过之后该渠道才会启用。

每个渠道的配置面板都按自身步骤依次引导，并在启用之前先校验凭据，因此密钥填错会在配置阶段就失败，而不是三天之后。你也可以随时用命令行校验某个渠道。

用命令行配置并检查渠道

mirasim ui-cli --port 4970 im validate --channel feishu
mirasim ui-cli --port 4970 config set im.feishuAppId=cli_xxx im.feishuAppSecret=yyy

使用另一台机器作为服务端

「连接」页面决定当前界面控制哪台机器：本机、局域网内按地址指定的另一台，或者按连接码指定的远端。同一页面也可以把本机共享出去：开启服务访问，再把连接码交给你信任的人。

连接码不必你自己拆开。粘到哪个框里都行——地址框或令牌框——它会自己拆成两半填好。如果这个码里本来就没有可直连的地址，就只填令牌，并说明缺的是哪一半。共享本机时，除了连接码，还可以单独复制访问令牌，因为另一台桌面端接进来要的正是它。

远端条目使用 bearer token 认证，不携带安卓配对的端到端密钥，因此请使用 HTTPS/WSS 或可信网络。
选择远端服务端不会迁移本机服务端上的配对、聊天渠道配置和定时任务，这些内容归属于持有它们的那一端。
工作内容跟随服务端：文件、Git worktree、会话历史、产物、录制和用量数据都保存在服务端所在的机器上。

通过 SSH 使用一台 Linux 主机

作为服务端的 Linux 机器不需要事先装好 Mirasim。在「连接」页面填入一个 SSH 目标，Mirasim 会探测那台机器、把服务端程序传过去、在那边启动，再通过隧道连回来，远端不需要对外开放端口。关掉窗口之后，那台机器上的智能体仍然继续运行。

登录方式有三种：SSH agent、密码、私钥。选 SSH agent 时沿用你现有的 ssh-agent 和 ~/.ssh/config，与你在终端里执行 ssh 的行为完全一致。密码只保存在这台电脑上，由系统钥匙串加密。
已经写在你 SSH 配置里的主机会直接列出来，不必把这台电脑已经记录过的主机名再输入一遍。
高级选项里可以指定跳板机，也可以为每台机器单独设置环境变量，在那台机器上启动服务时会一并传入。

在终端里做同一件事

mirasim ssh ubuntu@dev.example.com   # connect, tunnel, stay in the foreground
mirasim ssh list                     # saved machines and their status
mirasim ssh stop dev.example.com     # stop the server on that machine

接下来，Mirasim 将调整开放方式

关于大家关心的 Pro 权益

Mirasim 后续的开放节奏

手机、聊天软件与远端服务端

Mirasim 提供的各端

安卓客户端

聊天渠道

使用另一台机器作为服务端

通过 SSH 使用一台 Linux 主机