mirror of
https://github.com/rust-kotlin/ashell.git
synced 2026-09-22 16:00:59 +00:00
121 lines
4.5 KiB
Markdown
121 lines
4.5 KiB
Markdown
[中文](README.md) | [English](README.en.md)
|
|
|
|
# ashell
|
|
|
|
|
|
|
|
`ashell` 是一款现代化的、基于 GPUI Component 构建的 Rust 桌面终端客户端。
|
|
|
|
该项目旨在通过结合本地和远程环境，并内置丰富的核心功能，提供一个高性能且美观的 Shell 工作区。
|
|
|
|
## 🚀 v0.4 版本重要升级
|
|
|
|
v0.4 在 v0.3 打下的基础上，重点带来了更完整的工作区操作能力和更顺手的日常体验：
|
|
- ✨ **键位管理功能**：支持在设置中可视化查看和修改常用快捷键，并提供冲突提示。
|
|
- ✨ **设置页优化**：设置页的布局和交互更加紧凑顺手，整体信息层级更清晰。
|
|
- ✨ **Tab 内多 Pane 与类 tmux 体验**：一个 tab 内现在可以管理多个 pane，支持分屏、聚焦和切换，提供更接近 tmux 的工作流。
|
|
- ✨ **传输历史增强**：传输历史面板展示更完整的任务信息，便于回溯上传和下载过程。
|
|
- ✨ **SSH passphrase 支持**：现在可以为私钥填写 passphrase，并在连接时自动使用保存的口令。
|
|
- ✨ **终端显示优化**：终端渲染进一步增强，支持 Block Elements 等自定义图形字符的更完整显示。
|
|
|
|
## 下载
|
|
|
|
您可以从 [GitHub Releases 页面](https://github.com/rust-kotlin/ashell/releases/latest) 下载 macOS、Windows 和 Linux 版本的最新预编译程序。
|
|
|
|
## Mac 安装指南
|
|
|
|
### 方法 1: Homebrew 安装 (推荐)
|
|
|
|
如果您使用 [Homebrew](https://brew.sh/)，可以通过以下命令快速安装：
|
|
|
|
```bash
|
|
brew install rust-kotlin/taps/ashell --cask
|
|
```
|
|
|
|
更新应用：
|
|
|
|
```bash
|
|
brew update
|
|
brew upgrade ashell --cask
|
|
```
|
|
|
|
> **注意**: 由于应用采用本地签名，Homebrew 在安装或更新过程中会执行一个后置脚本来自动处理隔离属性（quarantine flag），这需要您输入管理员密码以授权。
|
|
|
|
### 方法 2: 手动下载
|
|
|
|
1. 从 [Releases 页面](https://github.com/rust-kotlin/ashell/releases/latest) 下载并解压。
|
|
2. 将 `ashell.app` 拖入或移动到 **应用程序 (Applications)** 目录。
|
|
3. 由于应用采用本地签名，初次启动时如果系统提示“App 已损坏，无法打开”，请打开终端（Terminal）并执行以下命令：
|
|
|
|
```bash
|
|
sudo xattr -cr /Applications/ashell.app
|
|
```
|
|
|
|
## 功能特性
|
|
|
|
当前版本提供了一个功能完备的 GPUI 原生工作区：
|
|
|
|
- **本地与远程会话**：支持打开本地终端标签页或通过 SSH 连接到远程服务器。
|
|
- **高级 SSH 认证**：支持基于密码和基于密钥（文件路径或内联内容）的 SSH 连接方式。
|
|
- **会话管理**：可以轻松地保存、重新打开、编辑和删除您的 SSH 会话。
|
|
- **SFTP 集成**：内置 SFTP 文件管理器，可以浏览、上传、下载以及管理远程文件。
|
|
- **强大的终端模拟器**：使用 `alacritty_terminal` 解析终端输出，支持丰富的 ANSI 颜色代码、极速渲染和完整的键盘输入转发。
|
|
- **系统遥测**：在左侧边栏实时可视化显示 CPU、内存、Swap、网络和磁盘的使用指标。
|
|
- **主题系统**：支持直接从顶部工具栏切换多种 GPUI Component 颜色主题。
|
|
- **内置字体**：开箱即用，内置 Maple Mono NF CN 字体，提供卓越的中日韩（CJK）字符与 Nerd Font 图标支持。
|
|
- **v0.3 核心增强**：全局字体与字号可调，支持 SFTP 并发传输、布局记忆、断线感知、多语言热切换，以及终端右键复制粘贴等增强能力。
|
|
|
|
## 运行
|
|
|
|
在本地运行该应用：
|
|
|
|
```bash
|
|
cargo run --release
|
|
```
|
|
|
|
## 打包 macOS 应用
|
|
|
|
```bash
|
|
./scripts/package-macos-app.sh
|
|
open target/release/ashell.app
|
|
```
|
|
|
|
该打包脚本会创建一个标准的 `.app` 应用程序包。它没有附加 entitlements 文件，并且在签名后会验证是否不存在 `com.apple.security.app-sandbox`（这意味着它在非沙盒模式下运行）。
|
|
|
|
## 打包 Linux (Debian/Ubuntu)
|
|
|
|
### 前置条件
|
|
|
|
```bash
|
|
sudo apt install pkg-config libfontconfig1-dev
|
|
cargo install cargo-deb
|
|
```
|
|
|
|
### 构建 .deb 包
|
|
|
|
```bash
|
|
cargo build --release
|
|
cargo deb
|
|
```
|
|
|
|
生成的 `.deb` 文件位于：
|
|
|
|
```
|
|
target/debian/ashell_0.4.9-1_amd64.deb
|
|
```
|
|
|
|
### 安装
|
|
|
|
```bash
|
|
sudo dpkg -i target/debian/ashell_0.4.9-1_amd64.deb
|
|
```
|
|
|
|
安装后可通过应用菜单或命令行 `ashell` 启动。`.deb` 包包含以下内容：
|
|
- `/usr/bin/ashell` — 主程序
|
|
- `/usr/share/applications/ashell.desktop` — 桌面入口
|
|
- `/usr/share/icons/hicolor/256x256/apps/ashell.png` — 应用图标
|
|
|
|
## 协议
|
|
|
|
本项目采用 [GPL-3.0-or-later 协议](LICENSE) 开源。
|