客户端与后台

安装、连接、启停，以及关闭窗口后会发生什么。

安装是一次准备，运行是独立的后台服务。你可以关掉窗口，再回来继续工作。

安装本机后台

取得当前 macOS Apple 芯片开发预览安装包后，打开 iArm Console Desktop。安装包自带 Python 运行时和后台依赖，使用者无需另外安装 Python、uv 或 Homebrew。

选择“添加服务地址”，填写名称和服务根地址。本机默认地址为 http://127.0.0.1:19310。连接另一台电脑时，填写那台电脑已配置可访问的 iArm 服务地址。当前版本需要手动填写，尚未提供局域网自动发现。

顶部可切换连接；⌘ + , 打开连接管理，⌘ + R 重新连接。重开客户端会恢复上次连接。

操作	发生什么
关闭窗口 / 退出客户端	后台继续运行；前端控制连接关闭，沿用断连释放输入机制。
停止后台	明确停止本机服务，取消下次登录自启，保留设备配置和数据。
重启后台	先停止再启动；请先确认没有需要继续的设备任务。
停止网页中的实时控制	结束本次输入接管，不等于停止后台服务。

后台按当前用户登录运行。退出客户端不等于注销系统；睡眠、注销和关机不属于持续运行承诺。

后台版本与持久数据分开保存。配置、标定和日志在：

~/Library/Application Support/iArm/backend/data/

可点击“打开数据与日志”查看。更新前先停止后台，再选择“更新本机后台”。安装会校验文件，保留原有数据。

已准备设备配置的用户，可在数据目录中放置 service.json。路径填写你自己电脑上的文件，不要照抄示例路径。

{
  "camera": "/你的配置目录/camera.json",
  "input": "/你的配置目录/input.json",
  "inputProvider": "esp32s3_serial"
}

相机与输入文件需要匹配实际硬件。不要把其他手机的芯片标识、永久身份或校准复制过来。未配置时，后台仅提供离线控制台与 API。