远程与手机访问
在另一台电脑或手机上继续同一项工作。模型请求、文件操作与命令执行仍发生在开发机,设备只是访问工作区的入口。
选择连接方式
| 方式 | 适合什么场景 | 如何进入 |
|---|---|---|
| Connections 直连 | 设备可以直接访问开发机,例如同一局域网。 | 打开主机地址,输入访问口令;也可从另一台 Mica 的 Connections 添加地址。 |
| Mobile Relay | 手机与开发机不在同一网络。 | 部署或接入公网中转机,打开插件生成的手机链接。 |
| 会话分享链接 | 给可信的人提供特定会话的操作入口。 | 打开 /share?session=… 链接,无需另外输入口令。 |
在局域网连接
- 在开发机启动桌面或 Web 运行时。默认监听地址为
0.0.0.0:8787;要被其他设备连接,服务必须监听可达的网络地址。 - 在侧栏打开 Connections,启用局域网/公网可访问。
- 修改初始访问口令
0000。输入新口令后回车或移出输入框保存。 - 在另一台设备打开卡片显示的主机地址,输入口令进入工作区。实际端口以启动日志为准。
如果另一台电脑也运行 Mica,可在它的 Connections 中添加这个地址,探测后打开对应运行时。手机浏览器会使用移动布局,操作的仍是相同的会话和工作区。

直连无法打开时,先确认设备能访问主机 IP 与端口,再检查监听地址和访问设置。绑定 127.0.0.1 的运行时只能从本机访问。
通过公网中转连接手机
Mobile Relay 由插件管理开发机与中转机之间的桥。开发机向外轮询,无需把本机运行时端口转发到公网。手机通过 HTTPS 访问中转机。
已有中转机
- 打开 Settings → Plugins → Mobile Relay。
- 填写中转地址,例如
https://mica.example.com。 - 点击注册到中转机。插件会把生成的凭据保存到本机,并显示手机链接。
- 在手机上打开完整链接,包括其中的
?t=参数。可加入主屏幕以便再次访问。
手机链接使用独立 token,和 Connections 的访问口令分开。不要自己编写 token;中转机只接受已经登记的值。
首次部署
准备一台可通过 SSH 管理的公网 Linux 主机。在会话设置的 Mobile Relay 中打开手机访问面板,填写中转机 SSH 等信息,再执行接入 / 部署。缺少页面构建产物时,面板可以把构建部署任务交给 agent。
也可以明确要求 Mica“使用 mobile-relay-setup 配置手机访问”。部署涉及服务器与域名设置,完整前提与手动流程见插件说明。
运行与更新
保持开发机上的运行时与插件宿主可用。插件详情会显示本机桥、中转机、手机和页面版本状态;升级后可点击更新中转机页面上传本机页面产物。
连接异常时,可以让 Mica 使用 mobile_relay 的 doctor 操作逐项排查。停止手机访问可关闭插件中的启用手机访问,或停用整个插件。
手机入口的能力范围
中转支持会话操作、流式输出、工作区终端、只读文件与 Git 视图。文件和 Git 的直接写入操作、配置页调用、受控浏览器与受控终端窗口不在中转白名单中。
这些界面限制不构成执行沙箱:对话中的 agent 与工作区终端仍可在开发机执行命令。
分享一条会话
从会话的分享入口复制链接。链接形如:
http://YOUR_HOST:8787/share?session=SESSION_ID接收者无需额外输入口令。只有指向真实存在会话的链接才会换取分享凭据;裸 /share 和无效会话 ID 不会取得凭据。
分享凭据可以调用通用运行时 API,包括文件、终端与配置能力。页面聚焦一条会话,并不限制 API 只能访问这条会话。链接没有独立有效期或逐链接撤销机制,请仅发给可信的人。
--no-share 关闭分享页面路由,不会撤销已经签发的分享凭据。修改访问口令会使已有 cookie 失效,但原有效分享链接仍可能再次换取凭据;也不要把关闭远程访问开关当作已有凭据的撤销动作。
仅在本机使用
只需本机浏览器工作区时,在 apps/desktop 中启动已有构建:
npm run start:web -- --host 127.0.0.1 --port 8787 --no-share回环连接与 MICA_DESKTOP_TRUSTED_CLIENTS 显式信任的来源按本机放行。默认完整远程访问开关关闭;没有完整访问凭据的远端通常只能进入有效分享链接。/api/health 仅用于探测运行时指纹与访问状态,保持开放。
反向代理与访问地址
经反向代理访问时,使用 MICA_DESKTOP_ALLOWED_HOSTS 配置允许的主机名;用 MICA_DESKTOP_PUBLIC_URL 指定生成分享链接时使用的公开基础地址。
运行时按直接连接的对端地址识别本机。反向代理或隧道从回环转入的请求会按本机放行,这条链路的认证需要由代理提供。Host / Origin 检查用于防范跨站请求,不能替代代理端的访问认证。