本页内容

远程与手机访问

在另一台电脑或手机上继续同一项工作。模型请求、文件操作与命令执行仍发生在开发机,设备只是访问工作区的入口。

选择连接方式

方式适合什么场景如何进入
Connections 直连设备可以直接访问开发机,例如同一局域网。打开主机地址,输入访问口令;也可从另一台 Mica 的 Connections 添加地址。
Mobile Relay手机与开发机不在同一网络。部署或接入公网中转机,打开插件生成的手机链接。
会话分享链接给可信的人提供特定会话的操作入口。打开 /share?session=… 链接,无需另外输入口令。

在局域网连接

  1. 在开发机启动桌面或 Web 运行时。默认监听地址为 0.0.0.0:8787;要被其他设备连接,服务必须监听可达的网络地址。
  2. 在侧栏打开 Connections,启用局域网/公网可访问。
  3. 修改初始访问口令 0000。输入新口令后回车或移出输入框保存。
  4. 在另一台设备打开卡片显示的主机地址,输入口令进入工作区。实际端口以启动日志为准。

如果另一台电脑也运行 Mica,可在它的 Connections 中添加这个地址,探测后打开对应运行时。手机浏览器会使用移动布局,操作的仍是相同的会话和工作区。

Mica 移动视口的会话界面,展示示例任务与输入区
移动视口预览 · 示例项目与脚本化模型响应。

直连无法打开时,先确认设备能访问主机 IP 与端口,再检查监听地址和访问设置。绑定 127.0.0.1 的运行时只能从本机访问。

通过公网中转连接手机

Mobile Relay 由插件管理开发机与中转机之间的桥。开发机向外轮询,无需把本机运行时端口转发到公网。手机通过 HTTPS 访问中转机。

已有中转机

  1. 打开 Settings → Plugins → Mobile Relay。
  2. 填写中转地址,例如 https://mica.example.com。
  3. 点击注册到中转机。插件会把生成的凭据保存到本机,并显示手机链接。
  4. 在手机上打开完整链接,包括其中的 ?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 中启动已有构建:

TERMINAL
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 检查用于防范跨站请求,不能替代代理端的访问认证。

需要理解不同运行方式,见桌面与浏览器;插件配置入口见插件与能力管理。

文档随项目持续更新编辑此页