Advanced Shell History 使用教程

1. 项目介绍

Advanced Shell History 是一个开源项目，旨在将命令行历史记录保存到 SQLite3 数据库中。该项目不仅记录了命令本身，还保留了命令的退出代码、开始和结束时间（以及命令持续时间）、当前工作目录、会话详细信息（如 tty、pid、ppid、ssh 连接详情）等额外信息。它支持多种 shell（如 zsh 和 bash），并提供了一个方便的工具来查询历史数据库。

2. 项目快速启动

2.1 安装依赖

在开始之前，确保你的系统上安装了以下依赖：

• awk
• bash
• curl
• flex（可选，仅在重建 queries.cpp 时需要）
• g++ 和 gcc
• make
• sed
• tar
• unzip
• sqlite3（推荐）

在 macOS 上，你还需要安装 Xcode 来编译 C++ 版本。

2.2 克隆项目

首先，克隆项目到本地：

git clone https://github.com/barabo/advanced-shell-history.git
cd advanced-shell-history

2.3 构建项目

你可以选择构建 C++ 版本或 Python 版本，或者两者都构建：

make build_c          # 构建 C++ 版本
make build_python     # 构建 Python 版本
make build            # 构建两者

2.4 安装项目

安装构建好的版本：

make install_c        # 安装 C++ 版本
make install_python   # 安装 Python 版本
make install          # 安装两者

2.5 配置项目

为了使项目正常工作，你需要在 shell 配置文件中添加一些配置。例如，在 ~/.bashrc 文件中添加以下内容：

source /usr/local/etc/advanced-shell-history/config
export ASH_CFG_SYSTEM_QUERY_FILE
source /usr/local/lib/advanced_shell_history/sh/bash

确保在修改后重新加载配置文件：

source ~/.bashrc

2.6 验证安装

打开一个新的终端窗口，你应该会看到类似以下的消息：

Advanced Shell History enabled: session 1

这表明项目已经成功启用。

3. 应用案例和最佳实践

3.1 查询历史记录

你可以使用 ash_query 工具来查询历史记录。例如，查询当前目录下的所有历史记录：

ash_query -q RCWD

3.2 自定义查询

你可以通过修改 queries 目录中的查询文件来自定义查询。例如，创建一个新的查询文件 my_query.l，然后使用 flex 生成对应的 C++ 文件：

flex -o queries/my_query.cpp queries/my_query.l

3.3 跨会话历史记录

由于历史记录保存在 SQLite3 数据库中，你可以在不同的 shell 会话之间共享历史记录。这对于多任务处理和团队协作非常有用。

4. 典型生态项目

4.1 SQLite3

Advanced Shell History 依赖于 SQLite3 数据库来存储历史记录。SQLite3 是一个轻量级的嵌入式数据库，广泛用于各种应用程序中。

4.2 Bash 和 Zsh

该项目支持 Bash 和 Zsh，这两种 shell 是 Linux 和 macOS 上最常用的 shell。通过集成到这些 shell 中，Advanced Shell History 可以无缝地记录和查询命令历史。

4.3 Git

Git 是一个分布式版本控制系统，广泛用于软件开发中。通过结合 Advanced Shell History，开发者可以更好地跟踪和管理他们的命令历史，特别是在多人协作的项目中。

通过以上步骤，你可以快速启动并使用 Advanced Shell History 项目，记录和管理你的命令行历史记录。