使用指南

开始使用

1. 在 Mac 上打开 Ping4U Host。Agent 和终端任务在这台 Mac 上运行。
2. 在手机上打开 Ping4U 客户端，按页面提示连接 Mac。
3. 如需使用 Agent，请在 Mac 上安装并登录对应的 Agent CLI，再在 Host 中检查其状态。可用功能取决于实际安装、认证、版本和配置。

安装包与平台可用性以下载中心展示为准；未列出的版本暂不提供下载。

连接手机

1. 在 Mac Host 的手机连接界面生成一次性配对码。
2. 在手机端扫描或输入配对码，发起连接。
3. 在 Mac 上核对设备并确认授权。确认前，新设备不能操作工作空间。

已授权设备可尝试使用保存的凭据重新连接。如果凭据失效或已被撤销，按提示重新配对。保留已有设备记录，除非你确定需要撤销或重新配对。

开始 Agent 会话

1. 选择 Mac 上的项目目录和当前可用的 Agent，创建会话。
2. 输入任务并发送；在会话中查看回复、执行活动和状态。
3. 按需继续已有会话，或切换到其他项目和会话。

模型、权限和附件选项由对应 Agent 的实际能力决定。可执行程序被发现，不代表它已经完成登录或支持所有功能；请以界面中显示的可用选项为准。

使用终端

在终端工作区选择或创建会话。手机连接后可以查看 Mac 上对应终端的输出并输入命令；Shell 运行在 Mac 上。执行命令前请确认当前设备拥有输入控制权，以及命令作用的目录。

模型与权限

在提交任务前选择当前 Agent 提供的模型与权限选项。Agent 的登录方式、服务商配置和版本决定可用模型；Ping4U 不会因为选择了另一种 Agent，就自动获得它的订阅或模型权限。

遇到权限请求时，先核对要执行的操作。不同 Agent 支持的批准方式不同，以当前界面显示为准。附件入口也只对支持的 Agent 开放。

设备与账户

Mac Host 负责运行任务和保存工作空间；手机是远程操作入口。连接前，请确认 Host 正在运行。设备授权与网站账户登录是不同的步骤，登录网站不会自动完成手机配对。

不再使用某台设备时，可在 Host 中撤销对应授权。手机端移除配对记录不等于 Host 已撤销设备权限。

连接遇到问题

• 确认 Mac Host 正在运行，手机和 Mac 均有网络连接。
• 查看连接状态与错误提示；网络变化后可尝试重新连接。
• 如果提示设备凭据无效或授权已撤销，再按提示重新配对。不要为了排查先删除有效配对或关闭正在运行的任务。
• 任务状态不明时，先查看原会话状态和操作结果，避免重复提交。