ashell/README.md

中文 | English

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 页面 下载 macOS、Windows 和 Linux 版本的最新预编译程序。

Mac 安装指南

下载并解压后，请先将 ashell.app 拖入或移动到 应用程序 (Applications) 目录。 由于应用采用本地签名，初次启动时如果系统提示“App 已损坏，无法打开”，请打开终端（Terminal）并执行以下命令：

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 并发传输、布局记忆、断线感知、多语言热切换，以及终端右键复制粘贴等增强能力。

运行

在本地运行该应用：

cargo run --release

打包 macOS 应用

./scripts/package-macos-app.sh
open target/release/ashell.app

该打包脚本会创建一个标准的 .app 应用程序包。它没有附加 entitlements 文件，并且在签名后会验证是否不存在 com.apple.security.app-sandbox（这意味着它在非沙盒模式下运行）。

协议

本项目采用 GPL-3.0-or-later 协议 开源。