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
compinit

pikpaktui completions zsh > \
  ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/completions/_pikpaktui
# 重新啟動 shell 或執行：omz reload

Bash

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.fish

PowerShell

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 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 completions <Tab>`	`bash`、`zsh`、`fish`、`powershell`

雲端路徑補全原理

輸入雲端路徑前綴後按 Tab，pikpaktui 會：

在內部呼叫 pikpaktui __complete_path <dir>
列出該遠端目錄的內容
回傳項目名稱，資料夾名稱帶尾部 /（再按 Tab 可繼續深入）

前提條件：

有效的工作階段檔案（~/.config/pikpaktui/session.json）
可存取 PikPak API

首次補全可能有短暫延遲，同目錄的後續補全速度很快。

支援的 Shell

目前支援 Bash、Zsh、Fish 與 PowerShell。