pikpaktui v0.0.58
docs / 指南 / TUI 指南

TUI 指南

不帶參數執行 pikpaktui 即可進入 TUI。首次執行會顯示登入表單。登入後進入自適應檔案瀏覽器。按 h 檢視內建快捷鍵說明,按 ? 開啟操作選單,按 , 開啟設定。

檔案瀏覽器

主畫面會依終端機寬度調整:

  • 96 欄及以上 — 上層目錄、目前目錄和預覽
  • 64–95 欄 — 目前目錄和預覽
  • 64 欄以下 — 僅顯示目前目錄

關閉預覽時,60 欄及以上顯示上層目錄 + 目前目錄;更窄時僅顯示目前目錄。

TUI 主畫面

按鍵操作
j / k / / 上下導覽
g / Home跳至頂端
G / End跳至底部
PageUp / PageDown翻頁
Ctrl+U / Ctrl+D半頁捲動
Enter進入資料夾 / 播放影片(自動開啟畫質選擇器)
Backspace返回上層目錄
w線上播放——開啟畫質/解析度選擇器
r重新整理目前目錄
m移動(依 move_mode 設定使用資料夾選擇器或文字輸入)
c複製
n重新命名(內嵌輸入框)
d刪除——提示確認
f新增資料夾
s加星號 / 取消加星號
y複製直連網址至剪貼簿(僅限檔案)
u上傳本機檔案至目前資料夾
a將目前項目加入/移出購物車
S循環切換排序欄位:name → size → created → type → extension → none
R切換反向排序
A開啟購物車檢視
D開啟下載管理檢視
M開啟我的分享檢視
o離線下載——輸入 URL 或磁力連結
O離線任務檢視
t回收桶檢視
Space檔案/資料夾詳細資訊彈窗
p預覽文字內容 / 載入目錄清單
l切換記錄面板
:輸入雲端路徑跳轉
,設定面板
h快捷鍵說明
?操作選單
q離開(下載進行中時彈出確認)
Ctrl+C離開(同上)

最近的操作結果會短暫顯示在畫面上,無需開啟記錄面板;同一則訊息仍會保留在記錄中。

操作選單

? 瀏覽附有快捷鍵說明的可用操作。使用 j / k 或方向鍵選取, 按 Enter 執行,按 Esc? 關閉。選單也支援滾輪、單擊選取與雙擊執行。

刪除確認流程

d 後彈出確認提示:

  • y — 移至回收桶(可復原)
  • p — 進入二次確認,需輸入 yes 後按 Enter 執行永久刪除
  • n / Esc — 取消

資料夾選擇器(移動/複製)

move_mode = "picker"(預設)時出現,雙面板資料夾導覽器。

複製選擇器

按鍵操作
j / k導覽資料夾
Enter進入資料夾
Backspace返回上層
Space確認目標目錄
/切換至文字輸入模式
Esc取消

文字輸入

登入、重新命名、新增資料夾、路徑、URL、播放器指令和本機傳輸目標等所有文字欄位均支援游標編輯。

按鍵操作
/ 依 Unicode 字元移動游標
Home / End跳至開頭 / 結尾
Backspace / Delete刪除游標前 / 游標處字元
Ctrl+A / Ctrl+E跳至開頭 / 結尾
Ctrl+W刪除前一個單字
輸入字元在游標位置插入
Esc取消

長文字會水平捲動以保持游標可見。移動/複製使用的雲端路徑欄位另支援:

按鍵操作
Tab自動補全雲端路徑
Enter選取補全項 / 確認目標
Ctrl+B切換回資料夾選擇器
Esc先關閉補全清單,再取消

購物車檢視

a 將檔案加入購物車,然後批次下載、移動、複製或分享。

購物車檢視

按鍵操作
j / k導覽
x / d從購物車移除所選項目
a清空購物車
Enter下載全部——提示輸入本機目標路徑
m移動全部(資料夾選擇器)
c複製全部(資料夾選擇器)
t將全部移至回收桶
s分享全部(提示:p 一般連結,P 加密連結)
S分享全部(直接建立一般連結)
Esc關閉購物車

下載管理檢視

D 開啟下載管理器,即時顯示下載進度。

下載檢視

按鍵操作
j / k導覽任務清單
Enter切換摺疊/展開檢視
p暫停 / 繼續所選任務
x取消並移除所選任務
r重試失敗任務
Esc關閉(下載在背景繼續)

回收桶檢視

t 開啟回收桶,透過 dy 刪除的檔案在此可見。

回收桶檢視

按鍵操作
j / k導覽
Enter切換摺疊/展開
u復原(取消刪除)所選檔案
x永久刪除所選檔案
Space顯示檔案詳細資訊彈窗
r重新整理回收桶清單
Esc關閉(或摺疊展開的檢視)

離線任務檢視

O 檢視伺服器端下載任務。

按鍵操作
j / k導覽
r重新整理任務清單
R重試所選失敗任務
x刪除所選任務
Esc關閉

影片畫質選擇器

在影片檔案上按 Enter 或按 w 時出現。

影片播放

按鍵操作
j / k切換畫質選項
Enter使用設定的播放器播放所選畫質
Esc取消

設定面板

, 開啟設定。變更會保留在草稿中,按 s 後才會套用並儲存至 config.toml

設定

按鍵操作
j / k導覽選項
Space / Enter編輯 / 切換所選項目
/ 循環切換多值選項
s儲存至 config.toml
Esc關閉;有未儲存變更時先詢問是否放棄

在未儲存確認框中,按 y / Enter 放棄變更,按 n / Esc 返回繼續編輯。

可設定項目:Nerd Font、邊框樣式、配色方案(含自訂 RGB 編輯器)、說明列、配額列樣式、顯示預覽、延遲載入預覽、預覽最大位元組數、縮圖模式、圖片協定、排序欄位、反向排序、移動模式、CLI Nerd Font、播放器指令、並行下載數。

我的分享檢視

M 開啟分享記錄。

按鍵操作
j / k導覽
y複製分享連結至剪貼簿
d / x刪除分享(確認後執行)
r重新整理分享清單
l切換記錄面板
Esc關閉

說明面板

在檔案瀏覽器中按 h 開啟內建快捷鍵說明。終端機高度不足時,可使用 j / k、方向鍵、翻頁鍵、HomeEnd 捲動;按 Esc(或其他非捲動鍵)關閉。

說明面板

滑鼠支援

  • 單擊 — 選取檔案面板及彈窗清單中的項目
  • 雙擊 — 執行檔案面板、購物車、回收桶和播放器選擇器中的安全主要操作;破壞性操作仍需確認
  • 滾輪 — 導覽檔案面板、說明、操作選單、購物車、下載、離線任務、回收桶、分享、播放器選項、配色/協定設定、預覽和記錄