移动端使用

Paseo 移动端登录、连接主机、查看任务、文件与 Git 和语音输入。

本页介绍 Paseo 移动端和网页版的使用。手机客户端的安装见安装与接入，终端命令见常用命令，连接问题见配置与排查。

登录与连接主机

打开 Paseo 网页版或 Paseo 移动端，选择 Login with Feishu 完成授权，或通过 Login with email 登录；Create account 可注册邮箱账号，密码至少 8 位。
如需指定服务器，在登录页打开 Configure Hub URL，填写管理员提供的 Hub 地址。
登录后点击 Refresh，找到已注册且在线的主机，再点击 Connect。

设备归属取决于注册时使用的账号；飞书账号与邮箱账号不一定互通。主机需要先完成安装与接入，并保持在线。Hub 登录不会代替模型服务认证。

Host 改名： 在设备列表点击铅笔 / Add note / Edit，输入备注后点击 Save。备注作为主要显示名称；清空后恢复机器名，无需重启。

创建任务与选择模型

选择主机上的项目目录，创建工作区和会话，选择 Provider、Model，输入任务后发送。

Local 工作区：直接使用现有目录；多个会话可能共享文件。
Worktree 工作区：使用独立 Git 工作目录，适合隔离并行任务。
左侧栏自动按时间排序：默认按项目最近活动时间排列，最近活跃的项目会自动排到前面，方便继续处理刚才的任务；手动拖动后保留自定义顺序。
任务状态：running 表示执行中，idle 表示等待后续指令；Stop 请求中断当前任务。
历史会话：从 History 查找。关闭根 agent 标签页会归档会话；关闭子 agent 标签页仅收起视图。

支持哪些工具？

改装版支持 ginit-codex、ginit-claude 两个工具，也支持远程 Host 上的 Codex 和原生 Claude Code。连接对应 Host 后，在创建会话时选择其已配置的 Provider，即可从手机或浏览器发送任务、查看执行进度并继续对话。工具和任务实际运行在所连接的 Host 上，该主机需提前完成工具安装与认证。

此外，还支持 GitHub Copilot、OpenCode、Pi、Oh My Pi，以及配置后的 ACP agent。实际可选工具以当前 Host 返回的 Provider 列表为准。

可以添加模型吗？

可以。除了选择已有模型，也可以在 Host 上通过自定义 Provider 添加模型或接入其他模型服务：在 $PASEO_HOME/config.json 的 agents.providers 中配置对应 Provider、接口和认证信息，并通过 models 列表指定模型 ID 与显示名称。配置生效后，创建会话时先选 Provider，再选 Model。

Claude 可选 Opus、Sonnet、Haiku 等系列；GLM、Qwen 等也可通过自定义 Provider 接入。添加的模型需由对应工具和接口支持，实际可用性取决于账号权限与服务配置，具体模型以 Host 返回的列表为准。

paseo provider ls
paseo provider models claude
paseo provider models codex

文件与 Git

工作区右侧提供 Files / 文件 和 Changes / 变更；手机上需展开相应面板，文件或差异也可能在标签页中打开。

操作	方法
文件预览	在 `Files` 展开目录，点击文件；不支持预览的格式可下载后打开
加入对话	文件更多菜单 → `Add to chat`，再向 agent 说明需求
文件下载	文件更多菜单 → `Download`；`Changes` 中现存文件也支持
查看代码改动	`Changes` → `Uncommitted` 查看未提交改动，`Committed` 查看相对基线差异
查看提交	展开 `Commits`，点击提交查看差异；这里只列出工作区相对基线新增的提交

Web 下载在浏览器下载记录中查找；安卓/iOS 下载后通过系统分享面板选择保存位置或接收应用。支持 Relay 连接下下载单个文件，整个目录需先在主机打包。下载时保持 Host 在线。

完整 Git 历史可在工作区 Terminal 查询：

git log -30 --oneline                         # 最近提交
git log --all --graph --oneline --decorate    # 所有已知分支
git log --all --author="作者名" --oneline      # 按作者
git log --all --grep="login" -i --oneline     # 按提交说明
git log --follow -- path/to/file             # 文件历史
git show <sha>                               # 单次提交详情

替换示例路径和 SHA；需要最新远端记录时先 git fetch origin，分页器中按 q 退出。

语音输入

在会话输入区点击麦克风，允许录音权限，口述任务，结束录音后检查识别文字，再发送。

浏览器版本需要 HTTPS 或 localhost 才能使用麦克风。语音识别服务和凭据由主机管理员配置，具体配置方式见配置与排查。