02049bf68d
* update zh-CN docs * update zh-CN docs * update zh-CN docs * update zh-CN docs |
||
---|---|---|
.. | ||
config.md | ||
docker.md | ||
import.md | ||
k8s.md | ||
key-binding.md | ||
list.md | ||
README.md | ||
search.md | ||
server.md | ||
shell-completions.md | ||
stats.md | ||
sync.md |
神奇的 shell 历史记录
Atuin 使用 SQLite 数据库取代了你现有的 shell 历史,并为你的命令记录了额外的内容。此外,它还通过 Atuin 服务器,在机器之间提供可选的、完全加密的历史记录同步功能。
显示退出代码、命令持续时间、上次执行时间和执行的命令
除了搜索 UI,它还可以执行以下操作:
# 搜索昨天下午3点之后记录的所有成功的 `make` 命令
atuin search --exit 0 --after "yesterday 3pm" make
你可以使用我(ellie)托管的服务器,也可以使用你自己的服务器!或者干脆不使用 sync 功能。所有的历史记录同步都是加密,即使我想,也无法访问你的数据。且我真的不想。
功能
- 重新绑定
up
和ctrl-r
的全屏历史记录搜索UI界面 - 使用 sqlite 数据库存储 shell 历史记录
- 备份以及同步已加密的 shell 历史记录
- 在不同的终端、不同的会话以及不同的机器上都有相同的历史记录
- 记录退出代码、cwd、主机名、会话、命令持续时间,等等。
- 计算统计数据,如 "最常用的命令"。
- 不替换旧的历史文件
- 通过 Alt-<num> 快捷键快速跳转到之前的记录
- 通过 ctrl-r 切换过滤模式;可以仅从当前会话、目录或全局来搜索历史记录
文档
支持的 Shells
- zsh
- bas
- fish
社区
Atuin 有一个 Discord 社区, 可以在 这里 获得
快速开始
使用默认的同步服务器
这将为您注册由我托管的默认同步服务器。 一切都是端到端加密的,所以你的秘密是安全的!
阅读下面的更多信息,了解仅供离线使用或托管您自己的服务器。
bash <(curl https://raw.githubusercontent.com/ellie/atuin/main/install.sh)
atuin register -u <USERNAME> -e <EMAIL> -p <PASSWORD>
atuin import auto
atuin sync
使用活跃图
除了托管 Atuin 服务器外,还有一个服务可以用来生成你的 shell 历史记录使用活跃图!这个功能的灵感来自于 GitHub 的使用活跃图。
例如,这是我的:
如果你也想要,请在登陆你的同步服务器后,执行
curl https://api.atuin.sh/enable -d $(cat ~/.local/share/atuin/session)
执行结果为你的活跃图 URL 地址。可以共享或嵌入这个 URL 地址,令牌(token)并不是加密的,只是用来防止被枚举攻击。
仅离线 (不同步)
bash <(curl https://raw.githubusercontent.com/ellie/atuin/main/install.sh)
atuin import auto
安装
脚本 (推荐)
安装脚本将帮助您完成设置,确保您的 shell 正确配置。 它还将使用以下方法之一,在可能的情况下首选系统包管理器(pacman、homebrew 等)。
# 不要以root身份运行,如果需要的话,会要求root。
bash <(curl https://raw.githubusercontent.com/ellie/atuin/main/install.sh)
然后可直接看 Shell 插件
通过 cargo
最好使用 rustup 来设置 Rust 工具链,然后你就可以运行下面的命令:
cargo install atuin
然后可直接看 Shell 插件
Homebrew
brew install atuin
然后可直接看 Shell 插件
MacPorts
Atuin 也可以在 MacPorts 中找到
sudo port install atuin
然后可直接看 Shell 插件
Pacman
Atuin 在 Arch Linux 的 社区存储库 中可用。
pacman -S atuin
然后可直接看 Shell 插件
从源码编译安装
git clone https://github.com/ellie/atuin.git
cd atuin
cargo install --path .
然后可直接看 Shell 插件
Shell 插件
安装二进制文件后,需要安装 shell 插件。 如果你使用的是脚本安装,那么这一切应该都会帮您完成!
zsh
echo 'eval "$(atuin init zsh)"' >> ~/.zshrc
或使用插件管理器:
zinit load ellie/atuin
bash
我们需要设置一些钩子(hooks), 所以首先需要安装 bash-preexec :
curl https://raw.githubusercontent.com/rcaloras/bash-preexec/master/bash-preexec.sh -o ~/.bash-preexec.sh
echo '[[ -f ~/.bash-preexec.sh ]] && source ~/.bash-preexec.sh' >> ~/.bashrc
然后设置 Atuin
echo 'eval "$(atuin init bash)"' >> ~/.bashrc
fish
添加
atuin init fish | source
到 ~/.config/fish/config.fish
文件中的 is-interactive
块中
Fig
通过 Fig 可为 zsh, bash 或 fish 一键安装 atuin
脚本插件。
...这个名字是什么意思?
Atuin 以 "The Great A'Tuin" 命名, 这是一只来自 Terry Pratchett 的 Discworld 系列书籍的巨龟。