Pebrel 文档

文档 / 开始使用

项目概览

用图文方式浏览 README 中的定位、核心能力、平台下载、配置与社区信息。

GPU 加速终端、SSH 工作区,以及 AI CLI 会话空间。

Pebrel 把本地 Shell、远程主机、文件和 AI 命令行工具集中在同一个原生桌面工作区。这个页面把仓库 README 中最常用的信息重新组织成可以快速浏览的图文说明。

Rust 2024GPUIWindows 10 / 11macOS 14+ PreviewLinux glibc 2.35+ PreviewGPL-3.0

一个工作区里完成什么

TERMINAL终端与会话

用标签页和分屏组织多个 Shell;每个窗格保留自己的工作目录,并可保存常用工作区布局。

REMOTESSH 与文件

保存远端主机,通过 SSH 连接服务器,并在终端旁使用 SFTP 上传、下载和整理文件。

AI CLIAI 命令行工作流

在独立标签或分屏中运行受支持的 AI CLI,通过活动状态、通知和历史记录跟踪任务。

READER原生阅读与配置

阅读 Markdown、公式和本地图片,使用主题、背景、快捷键与 Lua 配置调整工作环境。

Pebrel 顶部标签和终端工作区
用标签页组织多个终端,并在同一个窗口里保持工作上下文。
Pebrel 中的多 AI CLI 分屏工作流
多个命令行任务可以并排运行;每个窗格保持独立输入和输出。

平台与下载

从最新发行版选择与你的系统和架构对应的安装包。

平台当前支持安装包
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 操作和远端文件编辑可以与终端同时进行。

Pebrel 工作区示例
终端、文件与远端连接围绕同一工作区组织。

手机与备份

2.0 起,Android 客户端可以连接电脑,查看正在运行的任务、在获准后发送输入并接收提醒,命令仍在电脑上执行,见Android 连接电脑。设置、SSH 主机和工作区布局可以先在本机加密,再备份到本地目录、WebDAV、S3 兼容存储或 SSH 主机,见加密备份。

AI CLI 工作流

Pebrel 会识别多种 AI CLI,并在受支持时显示活动状态与更精确的任务提示,各工具的支持范围见支持的 AI 命令行工具。通知与来源窗格关联,点击后可以回到对应终端。

已捕获的回答可以在阅读器中查看 Markdown、公式、原文和本地图片。向终端粘贴图片时,Pebrel 会把图片保存为文件并把路径交给当前会话;终端内联显示是否可用取决于命令行工具输出的协议和内容。

Pebrel 中的 AI CLI 会话
AI CLI 与普通 Shell 一样运行在终端中,同时可使用会话相关的辅助能力。

外观、文档与配置

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

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。版本、下载文件和社区入口发生变化时,以仓库当前内容和最新发行版为准。

关于本页

内容来自用户指南 PR #291,原始基线 v2.1.1。2026-10-21 修正配置生效范围和赞助入口;其他介绍仍来自原文档基线。

Markdown 原文 ↓发行说明 ↗
核对来源

搜索文档

输入关键词,搜索使用指南。

本地全文搜索 PAGEFIND / 不上传搜索内容