Shell 补全
pikpaktui 提供动态 Shell 补全，可以实时从你的 PikPak 网盘补全云端路径——类似 scp 补全远程路径的体验。
Zsh
# 添加到 ~/.zshrc
eval "$(pikpaktui completions zsh)"# 生成一次并保存到 fpath
pikpaktui completions zsh > ~/.zfunc/_pikpaktui
# 在 ~/.zshrc 中添加（需在 compinit 之前）：
fpath=(~/.zfunc $fpath)
autoload -Uz compinit
compinitpikpaktui completions zsh > \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/completions/_pikpaktui
# 重启 shell 或运行：omz reloadBash
mkdir -p ~/.local/share/bash-completion/completions
pikpaktui completions bash > ~/.local/share/bash-completion/completions/pikpaktui
# 或仅为当前 Shell 加载：
eval "$(pikpaktui completions bash)"Fish
mkdir -p ~/.config/fish/completions
pikpaktui completions fish > ~/.config/fish/completions/pikpaktui.fishPowerShell
pikpaktui completions powershell | Out-String | Invoke-Expression补全覆盖范围
| 场景 | 补全内容 |
|---|---|
pikpaktui <Tab> | 所有子命令及说明 |
pikpaktui ls /<Tab> | 实时列出云端目录 |
pikpaktui ls -<Tab> | -l、--long、-J、--json、-s、--sort、-r、--reverse、--tree、--depth |
pikpaktui ls --sort <Tab> | name、size、created、type、extension、none |
pikpaktui mv /src<Tab> | 云端路径补全 |
pikpaktui mv -t /dst<Tab> | -t 目标的云端路径 |
pikpaktui cp /src<Tab> | 云端路径补全 |
pikpaktui download /cloud<Tab> | 云端路径补全 |
pikpaktui download -o <Tab> | 本地文件路径 |
pikpaktui upload <Tab> | 本地文件路径 |
pikpaktui upload -t /dst<Tab> | -t 目标的云端路径 |
pikpaktui share /path<Tab> | 云端路径补全 |
pikpaktui offline --to /dst<Tab> | --to 目标的云端路径 |
pikpaktui tasks <Tab> | list、ls、show、retry、delete、rm |
pikpaktui rm -<Tab> | 递归、强制删除和 dry-run 参数 |
pikpaktui mkdir -<Tab> | -p、-n、--dry-run |
pikpaktui info /path<Tab> | 云端路径 |
pikpaktui cat /path<Tab> | 云端路径 |
pikpaktui play /path<Tab> | 云端路径 |
pikpaktui rename /path<Tab> | 云端路径 |
pikpaktui star /path<Tab> | 云端路径 |
pikpaktui unstar /path<Tab> | 云端路径 |
pikpaktui completions <Tab> | bash、zsh、fish、powershell |
云端路径补全原理
输入云端路径前缀后按 Tab，pikpaktui 会：
- 在内部调用
pikpaktui __complete_path <dir> - 列出该远程目录的内容
- 返回条目名，文件夹名带尾部
/（再次按 Tab 可继续深入）
前提：
- 有效的会话文件（
~/.config/pikpaktui/session.json） - 可访问 PikPak API
首次补全可能有短暂延迟，同目录的后续补全速度很快。
支持的 Shell
目前支持 Bash、Zsh、Fish 和 PowerShell。