Pebrel 把本地 Shell、远程主机、文件和 AI 命令行工具集中在同一个原生桌面工作区。这个页面把仓库 README 中最常用的信息重新组织成可以快速浏览的图文说明。
一个工作区里完成什么
用标签页和分屏组织多个 Shell;每个窗格保留自己的工作目录,并可保存常用工作区布局。
保存远端主机,通过 SSH 连接服务器,并在终端旁使用 SFTP 上传、下载和整理文件。
在独立标签或分屏中运行受支持的 AI CLI,通过活动状态、通知和历史记录跟踪任务。
阅读 Markdown、公式和本地图片,使用主题、背景、快捷键与 Lua 配置调整工作环境。


平台与下载
从最新发行版选择与你的系统和架构对应的安装包。
| 平台 | 当前支持 | 安装包 |
|---|---|---|
| Windows 10 1809+ / 11 | 正式版,x64 / ARM64 | .exe 安装器或 .zip 便携包 |
| macOS 14+ | Preview,Apple Silicon / Intel | .dmg |
| Linux,glibc 2.35+ | Preview,x64 | .AppImage、.deb 或 .tar.gz |
| Android 8.0+ | Preview,手机端 | .apk,用于连接电脑 |
Pebrel 2.1 在 Windows、macOS 和 Linux 上都提供系统托盘、全局快速终端热键、登录启动和本地 AI 集成自动配置;Windows 和 macOS 还可以在应用内安装更新,Linux 通过包管理器或新安装包升级。细节见安装与平台支持。
终端与会话
- 侧栏或顶部标签管理终端,并可拖拽调整分屏。
- 每个窗格可以拥有独立工作目录;复制部分远端或子系统标签时会保留已知目录。
- 内置智能补全:从当前 Git 仓库、项目脚本、SSH 配置别名、文件目录获取候选(Windows 还包括已注册的 WSL 发行版),也支持历史补全,见命令补全。
- 可选择关窗后继续保留后台会话;应用真正退出后的对话恢复属于另一套机制。
要实际配置这些行为,参见标签页与分屏、保存与恢复会话和快捷键速查。
SSH 与文件
Pebrel 可以保存主机、读取 SSH 配置别名,并使用代理或单级跳板。认证可使用密码、私钥及服务器支持的交互流程,首次连接时应核对主机密钥。
SFTP 面板用于浏览远端目录、上传与下载文件或文件夹、查看传输进度并取消任务。本地文件浏览、Git 操作和远端文件编辑可以与终端同时进行。

手机与备份
2.0 起,Android 客户端可以连接电脑,查看正在运行的任务、在获准后发送输入并接收提醒,命令仍在电脑上执行,见Android 连接电脑。设置、SSH 主机和工作区布局可以先在本机加密,再备份到本地目录、WebDAV、S3 兼容存储或 SSH 主机,见加密备份。
AI CLI 工作流
Pebrel 会识别多种 AI CLI,并在受支持时显示活动状态与更精确的任务提示,各工具的支持范围见支持的 AI 命令行工具。通知与来源窗格关联,点击后可以回到对应终端。
已捕获的回答可以在阅读器中查看 Markdown、公式、原文和本地图片。向终端粘贴图片时,Pebrel 会把图片保存为文件并把路径交给当前会话;终端内联显示是否可用取决于命令行工具输出的协议和内容。

外观、文档与配置
Pebrel 提供浅色与深色主题、背景、不透明度、图标和界面语言设置。Markdown 文档可以直接在应用内阅读,数学公式由原生界面排版。

使用命令行初始化并检查 Lua 配置:
pebrel config init --language zh-CN
pebrel config check
GPUI 对 Lua 配置读取的字段有限,校验通过不能证明所有字段生效,也不代表完整热重载。当前范围和示例参见使用 Lua 配置与常用配置示例。
通知
在 设置 → 终端 → 提醒 中可以选择通知显示时长:保留默认时长、5 / 10 / 30 / 90 秒,或保持常驻。隐藏通知卡片只会关闭显示,不会自动执行确认、拒绝或其他任务操作。
构建 Pebrel
安装仓库固定的 Rust 工具链和平台依赖后,README 给出的正式产品构建命令为:
cargo build --release --locked -p nebula --bin pebrel --features gpui-shell
准备参与开发时,请继续阅读贡献与开发,按照仓库规定运行相应检查。
赞助、社区与联系
- 赞助:见官网赞助页与项目 README 中的当前鸣谢。
- 社区:可通过项目 README 中列出的社区入口参与讨论。
- Discord:discord.gg/VFn4rcxmhn
- 邮箱:fickleheartedkeys@163.com
- 许可证:GPL-3.0;第三方版权和许可证声明以仓库内对应文件为准。
说明 本页是 README 的文档化导览,不替代仓库 README。版本、下载文件和社区入口发生变化时,以仓库当前内容和最新发行版为准。