⚡️ 安装
快速安装
将以下内容添加到 .zshrc 文件中：
- Instant
- Verified
source <(curl -sL init.zshell.dev); zzinit
这种安装方法需要在版本库中每次更改内容时，手动验证 lib/zsh/init.zsh 文件的 sha256 checksum。
local cs_ok='7fab1ecb8d2ffbdb4aa98dd1e51cebaeaa4d8137e1de11938f3e0df24af262bb'
local cs_get=$(sha256sum <(curl -sL init.zshell.dev) | awk '{print $1}')
[[ $cs_ok == $cs_get ]] && { source <(curl -sL init.zshell.dev); zzinit; } || {
print -P "%F{160}▓▒░ Houston, we have a problem, the %F{226}$cs_get%F{160} do not match\!%f%b"; return 1
}
unset cs_ok cs_get
使用 exec zsh -il 重新加载 shell，然后运行 zi -h 获取使用说明。
自动安装
- 校验 lib/sh/install.sh 文件的 sha256 checksum
- If required append -b <tag> or -b <branch> e.g:
sh -c "$(curl -fsSL get.zshell.dev)" -- -i skip -b main
- Minimal
- Loader
- Repository
- Annex
- ZUnit
仅安装zi本体然后将自动添加最小化配置到 .zshrc 文件:
sh -c "$(curl -fsSL get.zshell.dev)" --
用 loader 最小化安装并加载：
sh -c "$(curl -fsSL get.zshell.dev)" -- -a loader
The installer will download the loader and add the snippet below to the .zshrc file.
if [[ -r "${XDG_CONFIG_HOME:-${HOME}/.config}/zi/init.zsh" ]]; then
source "${XDG_CONFIG_HOME:-${HOME}/.config}/zi/init.zsh" && zzinit
fi
loader 可以从 links 中选择可用链接手动下载到本地系统上的任何位置，并在 .zshrc 或如 quick-setup 中所示进行 source 加载 loader。
然后重新加载 shell 使用：exec zsh。 全部完成了！
使用默认值或 自定义 值克隆版本库：
sh -c "$(curl -fsSL get.zshell.dev)" -- -i skip
安装包含最小化配置与被推荐的 annexes ：
sh -c "$(curl -fsSL get.zshell.dev)" -- -a annex
安装包含最小化配置与被推荐的 annexes 和 zdharma/zunit：
sh -c "$(curl -fsSL get.zshell.dev)" -- -a zunit
手动安装
设置安装位置并创建目录：
typeset -Ag ZI
typeset -gx ZI[HOME_DIR]="${HOME}/.zi" ZI[BIN_DIR]="${ZI[HOME_DIR]}/bin"
command mkdir -p "$ZI[BIN_DIR]"
出于安全原因，运行函数 compaudit 以检查 补全系统 是否会使用由root 或当前 user 所有的文件，或者位于 world 或 group-writable 目录中的文件。
如果失败，则将当前用户设置为目录的所有者，然后删除 group/others 的写入权限，并克隆存储库：
compaudit | xargs chown -R "$(whoami)" "$ZI[HOME_DIR]"
compaudit | xargs chmod -R go-w "$ZI[HOME_DIR]"
command git clone https://github.com/z-shell/zi.git "$ZI[BIN_DIR]"
要启用 Zi，将以下代码段放入 .zshrc 以加载先前安装目录中的 zi.zsh 文件：
typeset -A ZI
ZI[BIN_DIR]="${HOME}/.zi/bin"
source "${ZI[BIN_DIR]}/zi.zsh"
下面的两行必须放在上面的行之后，即在启用 Zi 之后。
启用 Zi 补全：
autoload -Uz _zi
(( ${+_comps} )) && _comps[zi]=_zi
安装之后
全新安装后，建议使用以下命令重新加载 shell 并重新编译 Zi：
- exec zsh -il
- zi self-update
运行 zi -h 获取可用命令或 探索 wiki 去 扩展, 自定义 和 创建插件 👍 🎉。
如果您有任何问题或需要帮助 🤦♂️，让我们在 Github 上讨论或打开一个问题。
这有助于我们改进和完善 Zi。 Don't forget to help the project: share, contribute, or translate 🌐 🥰 🤓.
让我们粘合一个适合自己的工具链 🚀。
有想法吗？
在 playground 提出建议或请求
sh -c "$(curl -fsSL get.zshell.dev)" -- -a ???
需要热身吗？
Docker Alpine
docker run --rm -it ghcr.io/z-shell/zd:latest
Turbo Zi in Docker
如果您创建使用 Zi 的 Docker 映像，请在 shell 开始交互之前安装 Turbo-loaded 插件，以 @zi-scheduler 这样的方式使用函数：
- 无需等待提示即可安装插件（i.e，对脚本友好）。
- 立即安装所有插件，无需考虑 wait 参数。
为此，请使用 burst 参数并调用 @zi-scheduler 函数：
RUN zsh -i -c -- '@zi-scheduler burst || true'
- 示例： Dockerfile
- 实操： Playground
Zi 模块：zpmod
该模块以透明方式自动编译源脚本，并列出所有源文件，在左侧标明 source 耗时（以毫秒为单位）。
可用链接
Installer
| 服务 | URL |
|---|---|
| 带重定向 | https://get.zshell.dev |
| Cloudflare | https://src.zshell.dev/sh/install.sh |
| Git.io | https://git.io/get-zi |
| GitHub RAW | https://raw.githubusercontent.com/z-shell/zi-src/main/lib/sh/install.sh |
Loader
| 服务 | URL |
|---|---|
| 带重定向 | https://init.zshell.dev |
| Cloudflare | https://src.zshell.dev/zsh/init.zsh |
| Git.io | https://git.io/zi-loader |
| GitHub RAW | https://raw.githubusercontent.com/z-shell/zi-src/main/lib/zsh/init.zsh |