如何快速安装Deja:zsh命令自动建议3步上手教程(含Oh My Zsh与zinit配置)

原创2026-10-24 17:20:451,646 阅读

如何快速安装Deja:zsh命令自动建议3步上手教程(含Oh My Zsh与zinit配置)

Deja 是一款 zsh 命令自动建议工具:它基于模糊匹配、目录感知与命令序列预测,在你键入的每个字符之后即时给出幽灵文字(ghost text)命令建议,比 zsh-autosuggestions 更聪明,比 TUI 插件更轻量。本篇教程带你 3 步完成安装,并覆盖 Oh My Zsh 与 zinit 两套框架的接入方式。

Deja zsh命令自动建议幽灵文字效果演示:输入c后即时补全go run命令

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 切换同排的次优建议

三个新手高频注意点:

  1. 不要用 Enter 接受建议——Enter 只执行缓冲区里已敲的内容,→ 才是把幽灵文字提交进缓冲区的键。
  2. 与 zsh-autosuggestions 二选一:Deja 会检测并"让位",请从 plugins=() 中移除 zsh-autosuggestions,避免冲突。
  3. 幽灵文字太暗看不清:在 ~/.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。

登录后查看全文
deja