安装与接入
安装并接入 Paseo，打开网页即可使用。
在存放项目、运行 agent 的那台机器上操作。开始前请确认已安装 Ginit，并且至少有一个 agent CLI 已配置好、可以正常运行。
1. 登录
ginit login按提示完成飞书登录；已登录可以跳过。
2. 安装
ginit paseo install等待安装完成。命令会安装并配置 Paseo 后台服务，接入 Ginit。通常不需要手动填写端口或连接地址。
可选安装参数
--name qizhi-gpu-01：指定设备名称。--source git --branch main：从改装版仓库主线构建。--no-history：跳过导入主机上已有的 Claude 会话，不会删除已导入记录，也不是关闭所有记录上传的开关。--no-attach：跳过 Ginit Hub 注册，与历史会话导入无关。
例如，不导入已有聊天记录：
ginit paseo install --no-history其他参数见 ginit paseo install --help。Paseo 是可选集成，普通 ginit up / ginit update 不会默认安装；需要时显式运行安装命令。
3. 确认状态
ginit paseo status确认本机服务及 Hub、Relay 连接正常，即可开始使用。
4. 打开网页使用
打开 paseo.opensii.cn，使用与主机接入时相同的账号登录，选择在线主机并点击 Connect，即可开始使用。使用期间请保持主机开机、联网。
网页与桌面入口
- Paseo 官网：paseo.sh。
- 上游桌面客户端下载：paseo.sh/download。
- Ginit 改装版：GAIR-NLP/paseo Releases。使用飞书登录、Hub 设备发现等功能时，请使用支持 Ginit 接入的改装版客户端或 Paseo 网页版；上游下载入口不等于 Ginit Web 登录入口。
安装手机客户端
接入完成后，在手机上安装 Paseo 客户端。客户端装在手机上，主机保持在线即可，无需在手机上重复上面的步骤。
iOS 测试版（TestFlight）
iOS 测试版在 App Store 中的正式名称为 Gaseo，通过 TestFlight 分发：
- 使用参与测试用户自己的 Apple ID 绑定邮箱联系 jiashuomeng，申请测试资格。
- jiashuomeng 负责测试人员资格审批；审批通过后，邀请邮件会发送到申请者自己的 Apple ID 绑定邮箱。
- 收到邮件后接受邀请，并使用同一个 Apple ID 登录 App Store。
- 在 App Store 下载并打开 TestFlight。
- 在 TestFlight 中安装 Gaseo 测试版。
请确保接受邀请、登录 App Store 和使用 TestFlight 的 Apple ID 是同一个参与测试的账号。
Android 测试版
使用管理员提供的改装版 APK，或在有权限的 仓库 Releases 中下载 .apk 文件。安装时按系统提示允许安装未知来源应用，然后使用与主机对应的账号登录。覆盖升级需要包名和签名一致；自行构建见 Android 指南。
接下来可以用终端启动第一个任务，或在支持 Ginit 接入的 Paseo 客户端里登录同一飞书账号，选择这台主机。具体见跨设备连接。
安装或连接遇到问题时，先看配置与排查，无需重复安装或自行开放公网端口。