文档
工作原理
控制面与实时面分离、直连优先的连接策略,以及一帧画面的完整链路。
Nearshell 由 Mac 端、iPhone / iPad 控制端，以及官方运营的账户、信令和中继服务组成。
账户与设备控制台
账号负责设备授权与订阅权益。控制台统一显示已添加的 Mac，每台设备分别管理连接状态与偏好；同一 Mac 可承载多个已授权控制端会话。
连接流程
- 使用同一账号添加 Mac，通过扫码或粘贴代码完成设备配对。
- 通过信令服务协调连接，并校验配对设备的身份。
- 建立加密的 WebRTC 连接，优先直连，网络条件不允许时使用 TURN 中继。
- 从控制台进入桌面、应用窗口或终端工作区。
画面与输入
Mac 使用系统屏幕采集能力获取远程画面，控制端解码并显示。采集与发送会根据内容、画质偏好和链路状况调整，不承诺固定帧率或固定延迟。
用户可以查看完整桌面或应用窗口，通过触控、键盘和指针操作 Mac。屏幕录制与辅助功能权限分别控制画面采集和输入注入。
终端工作区
Native shell 由 Mac 端独立终端服务托管。tmux、Herdr 会话通过各自后端接入，需要在 Mac 安装对应程序。控制端提供文本输入、选择复制、历史滚动和外观设置；多个控制端之间的输入权限由运行时协调。
终端服务更新并不等于原进程恢复：Native 可以保存历史文本并恢复为新 shell；tmux、Herdr 会话由各自后端保留。更新前请遵循 App 的任务与保存提示。
移动端输入与浏览
输入草稿支持键盘和语音，确认后发送，不追加回车。画中画可以分别用于远程画面和终端，默认关闭，依赖设备和系统支持。