hiSHtory 开源项目使用指南

hiSHtory 开源项目使用指南

hishtoryYour shell history: synced, queryable, and in context项目地址:https://gitcode.com/gh_mirrors/hi/hishtory

---

项目介绍

hiSHtory 是一款用 Go 语言编写的命令行工具，旨在升级你的 shells（如 bash、zsh 和 fish）的历史记录管理能力。它通过钩入 shell 来追踪并记录所有执行过的命令细节，这些数据随后被保存在本地的一个 SQLite 数据库中，并经过加密处理。hiSHtory 的独特之处在于其同步功能，能够安全地将加密后的历史记录同步到你的其他计算机上，便于跨设备查询以往的命令行操作。此外，它尊重 shell 的常规习惯，不会记录以空格开头的命令，确保隐私安全。

---

项目快速启动

安装 hiSHtory

在第一台机器上安装 hiSHtory，只需执行以下命令：

curl https://hishtory.dev/install.py | python3 -

这会立刻开始管理你的 shell 历史记录。你可以通过按下 Control+R 来体验增强的搜索功能。之后，在其他电脑上安装时，先获取你的密钥 (hishtory status)，再按相似步骤执行安装加上初始化指令：

curl https://hishtory.dev/install.py | python3 - && hishtory init

---

应用案例和最佳实践

日常开发中的快速命令回顾

当你需要重新找到之前在服务器上构建的复杂 Bash 管道命令时，简单地使用 hishtory query 加上相关关键词即可迅速找回该命令及其上下文，极大地提高了工作效率。

自定义工作流

利用 hiSHtory 的配置选项，比如自定义颜色方案(hishtory config-set color-scheme)和控制台快捷键集成(hishtory config-set enable-control-r)，可以调整至最适合个人工作流程的状态。

保障安全性

设置默认过滤器(hishtory config-set default-filter exit_code:0)来仅显示执行成功的命令，或禁用重复命令显示(hishtory config-set filter-duplicate-commands true)来避免搜索结果的冗余，这些都是提高日常使用效率和保护信息安全的实用做法。

---

典型生态项目

虽然 hiSHtory 主要作为一个独立的工具存在，但它的设计理念和实现机制鼓励了与其他生产力工具的结合，比如版本控制系统 Git 的紧密集成，允许用户配置显示远程仓库信息(hishtory config-add displayed-columns git_remote)。这种灵活性使得 hiSHtory 不只是历史记录的存储库，而是开发环境个性化和高效工作流程的重要组成部分。

---

通过上述步骤和实践，hiSHtory 使开发者能够更有效地管理和复用命令历史，同时保持数据的安全性和私密性，是现代开发者的得力助手。

hishtoryYour shell history: synced, queryable, and in context项目地址:https://gitcode.com/gh_mirrors/hi/hishtory