如何快速安装Deja:zsh命令自动建议3步上手教程(含Oh My Zsh与zinit配置)
如何快速安装Deja:zsh命令自动建议3步上手教程(含Oh My Zsh与zinit配置)
Deja 是一款 zsh 命令自动建议工具:它基于模糊匹配、目录感知与命令序列预测,在你键入的每个字符之后即时给出幽灵文字(ghost text)命令建议,比 zsh-autosuggestions 更聪明,比 TUI 插件更轻量。本篇教程带你 3 步完成安装,并覆盖 Oh My Zsh 与 zinit 两套框架的接入方式。
Deja 命令自动建议工具能做什么?
相比只在"前缀匹配"时才出建议的传统插件,Deja 的建议引擎融合了 4 个信号(评分逻辑见 internal/scorer/scorer.go):
| 能力 | 说明 |
|---|---|
| 模糊匹配 | 跳过字母、顺序颠倒也能命中,输入 gco 可建议 git checkout |
| 目录感知 | 在 ~/projects/foo 里常跑的命令,该目录下优先推荐 |
| 序列预测 | 知道你在 make build 之后通常执行 make test |
| 隐私本地 | 数据只存在本地 SQLite 数据库,无任何账号与联网同步 |
架构上是一个轻量常驻 daemon + 每个终端的 zsh widget,单次键入响应小于 1ms(核心实现在 internal/daemon/server.go)。
第 1 步:安装 deja 二进制(一键安装)
方式一:Homebrew(macOS / Linux,推荐)
brew install deja
方式二:官方一键脚本(无需 Homebrew)
仓库自带的 install.sh 会自动探测你的系统与 CPU 架构、下载对应 release 二进制、校验 SHA-256 并安装到 ~/.local/bin:
git clone https://gitcode.com/gh_mirrors/dej/deja
cd deja
sh install.sh
💡 安装脚本执行后,
deja命令应已可用;若提示command not found,确认~/.local/bin已在$PATH中。
第 2 步:导入历史并激活集成
deja import && exec zsh
deja import会把已有的 zsh 历史(默认读$HISTFILE或~/.zsh_history)导入本地数据库,实现方式见 cmd/deja/import.go;历史文件在别处时可用deja import --file /path/to/history显式指定。exec zsh重载当前 shell,让集成脚本生效。
若你的二进制是手动放入 $PATH 的(跳过了安装命令),还需要将以下内容追加到 ~/.zshrc 以持久化激活(脚本生成逻辑见 cmd/deja/init.go):
# ~/.zshrc
if [[ -r "$HOME/.local/share/deja/init.zsh" ]]; then
source "$HOME/.local/share/deja/init.zsh"
else
eval "$(deja init zsh)"
fi
第 3 步:按框架接入插件
根据你的 zsh 环境选择其中一种激活方式即可,切勿重复加载(双重 source 会让 widget 互相干扰)。
Oh My Zsh 配置
与 zsh-autosuggestions 相同的插件式流程,插件文件即仓库根目录的 deja.plugin.zsh:
# 1. 克隆插件到 Oh My Zsh 自定义插件目录
git clone https://gitcode.com/gh_mirrors/dej/deja \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/deja
# 2. 在 ~/.zshrc 的 plugins=(...) 中加入 deja
# plugins=( ... deja )
# 3. 导入历史并重载
deja import && exec zsh
zinit 配置
在 .zshrc 中加入两行即可,zinit 会自动处理插件加载:
zinit ice wait"0" lucid depth=1 pick"deja.plugin.zsh"
zinit light Giammarco-Ferranti/deja
⚠️
deja二进制仍需通过第 1 步单独安装,zinit 只负责加载插件文件。
手动配置(无框架)
不想克隆整个仓库?单独取插件文件到 Oh My Zsh 插件目录即可,或直接在 ~/.zshrc 中 source deja.plugin.zsh。
安装验证与基础操作
| 检查项 | 命令 / 操作 | 预期结果 |
|---|---|---|
| daemon 可达 | deja ping |
输出 pong |
| 建议出现 | 输入任意历史命令前几个字母 | 行尾出现灰色幽灵文字 |
| 接受建议 | 按 →(方向键) |
幽灵文字并入命令行 |
| 浏览候选 | 按 Tab |
切换同排的次优建议 |
三个新手高频注意点:
- 不要用
Enter接受建议——Enter只执行缓冲区里已敲的内容,→才是把幽灵文字提交进缓冲区的键。 - 与 zsh-autosuggestions 二选一:Deja 会检测并"让位",请从
plugins=()中移除zsh-autosuggestions,避免冲突。 - 幽灵文字太暗看不清:在
~/.zshrc的 source 行之前导出export DEJA_HIGHLIGHT_STYLE='fg=cyan'即可提亮。
常见问题快速排查
- 没有建议出现:先跑
deja ping确认 daemon;再确认 shell 已重载(exec zsh);Ctrl+X会暂停当前会话的全部建议,开新 shell 即可恢复。 - daemon 卡住:执行
deja daemon --restart一键重启。 - 想清空重来:
pkill -f 'deja daemon'后删除~/.local/share/deja/deja.db,再deja import重建数据库。 - 卸载:移除
~/.zshrc激活行 →pkill -f 'deja daemon'→ 删除~/.local/share/deja/→brew uninstall deja(或删掉~/.local/bin/deja)。
按以上 3 步操作,从克隆到看到第一条幽灵文字建议,通常只需 1 分钟。更多细节(按键重绑定、模糊度调节、隐私规则)可查阅仓库中的 README.md 与 CONTRIBUTING.md。
