Atuin

產品說明

Atuin（取自《碟形世界》中的巨龜 A’Tuin）是一款用 Rust 語言編寫的 Shell 歷史紀錄管理工具。如果你曾苦惱於換了電腦就遺失所有指令紀錄，或是覺得傳統終端機的 Ctrl + r 搜尋功能太過陽春，Atuin 會徹底改變你的使用習慣。

傳統的 Shell（如 Bash/Zsh）僅將歷史紀錄存在一個簡單的文字檔中，而 Atuin 則將其升級為 SQLite 資料庫。這意味著它能記錄更多上下文資訊，包括「指令執行時間」、「執行時的目錄」、「退出代碼（Exit Code）」以及「執行耗時」。更強大的是，它提供端對端加密（E2EE）的同步功能，讓你所有的機器（筆電、桌機、伺服器）都能共享同一份加密的指令歷史，且伺服器端無法解密讀取。

核心特色：

• 全機同步：在不同電腦間同步 Shell 歷史紀錄，重灌電腦或切換伺服器時，熟悉的指令隨手可得。
• 豐富上下文：不只記錄指令本身，還記錄了執行當下的目錄、執行花費時間與是否成功（Exit Code）。
• 全螢幕 TUI：按下 Ctrl + r 或 Up 鍵，會彈出美觀的全螢幕搜尋介面，支援模糊搜尋（Fuzzy Search）。
• 隱私安全：所有同步的資料皆在本地進行高強度加密，你可以使用官方伺服器或輕鬆自架（Self-host）。
• 統計圖表：內建指令使用習慣分析，告訴你最常下的指令是什麼，以及你在週幾最忙碌。

常用指令

安裝 Atuin 後，它通常會自動接管你的 Ctrl + r 和 Up（向上鍵）。

啟動與基礎操作

# 啟動互動式搜尋介面 (通常綁定於 Ctrl + r)
atuin search

# 搜尋特定關鍵字 (非互動模式)
atuin search -i "docker"

# 檢視個人的指令統計數據
atuin stats

進階技巧

• 過濾模式：在搜尋介面中，你可以透過快捷鍵切換「僅搜尋當前目錄下的歷史」或「搜尋所有目錄的歷史」，這在大型專案開發時非常有用，能過濾掉不相關的雜訊。
• 匯入舊資料：剛安裝好時，可以使用 atuin import auto 將你現有的 .bash_history 或 .zsh_history 匯入到資料庫中。
• 自然語言時間搜尋：Atuin 支援時間過濾，例如 atuin search --after "yesterday 3pm" "git commit" 可以搜尋昨天下午三點後的 git commit 紀錄。
• 同步設定：使用 atuin login 與 atuin sync 即可開啟同步功能，讓你的 Shell 記憶跟著帳號走。

操作介面