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 后回车执行永久删除
  • 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(或其他非滚动键)关闭。

帮助面板

鼠标支持

  • 单击 — 选中文件面板及弹窗列表中的条目
  • 双击 — 执行文件面板、购物车、回收站和播放器选择器中的安全主操作;破坏性操作仍需确认
  • 滚轮 — 导航文件面板、帮助、操作菜单、购物车、下载、离线任务、回收站、分享、播放器选项、配色/协议设置、预览和日志