HSTR 命令行工具安装与使用指南

HSTR 命令行工具安装与使用指南

hstr bash and zsh shell history suggest box - easily view, navigate, search and manage your command history. 项目地址: https://gitcode.com/gh_mirrors/hs/hstr

项目简介

HSTR（原名为 HH）是一个强大的命令行历史记录管理工具，它通过交互式界面帮助用户快速搜索、编辑和执行历史命令。相比传统的 history 命令，HSTR 提供了更直观的界面和更高效的搜索功能。

安装方法

主流 Linux 发行版安装

Ubuntu/Debian 系列

对于 Ubuntu 21.10 及更新版本和 Debian 11 及更新版本：

sudo apt install hstr

对于旧版本系统，可以通过添加 PPA 源安装：

sudo add-apt-repository ppa:ultradvorka/ppa
sudo apt-get update
sudo apt-get install hstr

RHEL/CentOS/Fedora 系列

sudo dnf install hstr
# 或
sudo yum install hstr

Arch Linux/Manjaro

可通过 AUR 安装：

yay -S hstr

openSUSE

zypper addrepo https://download.opensuse.org/repositories/home:lemmy04/openSUSE_Leap_15.1/home:lemmy04.repo
zypper refresh
zypper install hstr

macOS 安装

使用 Homebrew：

brew install hstr

或使用 MacPorts：

sudo port install hstr

其他系统

• Gentoo: emerge app-shells/hstr
• Alpine Linux: apk add hstr
• FreeBSD: pkg install hstr

从源码编译安装

通用编译方法

1. 克隆仓库：

git clone https://github.com/dvorka/hstr.git
cd hstr

2. 准备构建环境：

cd ./build/tarball && ./tarball-automake.sh && cd ../..

3. 编译安装：

./configure && make && make install

系统特定依赖

• Ubuntu/Debian: sudo apt install automake gcc make libncursesw5-dev libreadline-dev
• Fedora: sudo dnf install autotools ncurses-devel readline-devel
• macOS: 需要先安装 readline 和 ncurses

配置与使用

安装完成后，需要将 HSTR 绑定到快捷键（通常是 Ctrl+R）：

hstr --show-configuration >> ~/.bashrc
source ~/.bashrc

基本操作

• 按下 Ctrl+R 打开 HSTR 界面
• 输入关键字过滤历史命令
• 使用方向键选择命令
• 按 Enter 执行选中的命令
• 按 Tab 键可以编辑选中的命令

版本升级注意事项

从 1.x 升级到 2.x

2.0 版本进行了重大重构，建议查看变更日志了解新特性。

从 2.x 升级到 3.x

3.0 版本针对 Linux 内核 6.2+ 移除了 TIOCSTI 支持，改为使用 shell 特定的行编辑器功能。升级后需要重新配置：

hstr --show-configuration >> ~/.bashrc
source ~/.bashrc

常见问题解决

1. 命令无法插入提示符：确保已正确运行配置命令并重新加载了 shell 配置。

2. 特殊环境支持：

   • WSL/Cygwin：需要使用特定版本 hstrwsl 或 hstrcygwin
   • 无 TIOCSTI 支持的系统：确保使用最新版本并正确配置

3. 依赖问题：如果编译失败，请检查是否安装了所有必要的开发包。

结语

HSTR 是提升命令行工作效率的利器，通过本文介绍的安装和配置方法，您可以在各种系统上轻松使用这一工具。熟练掌握 HSTR 后，您会发现管理复杂命令历史变得前所未有的简单高效。

hstr bash and zsh shell history suggest box - easily view, navigate, search and manage your command history. 项目地址: https://gitcode.com/gh_mirrors/hs/hstr