功能大而全，界面小而美。

PikPak 增强大师

⭐ 如果这个脚本帮到了你，欢迎给项目点一个 Star

支持语言

主要功能

体验与导航增强

侧键导航：支持鼠标侧键前进 / 后退，在不同目录层级间快速切换。
高级路径栏：支持滚轮滑动、同级目录下拉切换、路径回显与溯源跳转。
全盘搜索增强：支持按文件名与文件路径搜索，关键词部分标红，长文件名会优先展示命中关键词附近内容。
浏览偏好：支持排序偏好、视图偏好、保持浏览位置、媒体模式、隐藏按钮文字、模糊媒体封面缩略图与夜间模式。

批量与空间管理

批量重命名：支持正则替换 / 删除、剧集流水号、文本格式化、FC2 规范命名、前缀去广告，以及基于 MIME 的后缀智能修复。

文件分析：整合文件筛选与文件查重能力，查重支持 哈希精准匹配 / 视频时长相似 / 名称相似 三类分析。
筛选增强：支持按大小、类型、路径、关键词等条件筛选，并提供一键勾选、反选、按文件夹选择、组内排序等批量辅助能力。

文件夹分析：整合文件夹透视与文件夹查重能力，查重支持 名称 / 相似度 / 包含率 三模态分析，适合处理重复剧集、图包、资料目录等。

M3U 播放列表导出：支持将选中的视频导出为 M3U 文件。
导出目录：支持导出当前目录的目录树或目录列表。

智能整理：支持彻底删除、清理空文件夹、批量解压，并可对已解压文件自动清理。
资源管理器：支持自定义资源名单，可作为黑名单执行清理，也可在批量删除时作为保护名单自动跳过命中项。

⚠️ 执行分析、整理、批量删除、批量移动、批量解压等重操作期间，不建议在其他客户端同时修改同一批文件，以免产生同步冲突。

链接收藏夹与云归档

链接收藏夹：链接收藏夹同时存储书签链接、脚本同步数据、云归档磁链与云配置。
云归档：支持将选中文件中的可追溯磁链归档到「链接收藏夹 > 云归档」，可将源文件删除节省空间。
云归档恢复解析：已归档磁链可重新提交云下载任务，并回写提交状态。
云归档清理：支持清空全部云归档链接、删除已提交链接、删除单条归档链接。
配置云同步：支持将脚本配置上传到云端、从云端拉取、清空云端配置，便于多设备同步脚本偏好。

传输、云下载与分享解析

分享解析：支持解析分享链接，在保存前查看分享内容，未保存前不占用自己的网盘空间。
分享文件透视：支持对分享内容进行递归扫描、筛选和预览，适合在保存前检查分享内部结构。
分享解析历史：可记录已解析的分享链接和密码，便于后续快速重新打开。
分享管理：支持设置分享提取次数上限；达到条件后可自动取消分享，使链接失效。
秒传文件：上传文件时若服务器已有相同文件记录，可直接完成秒传，减少重复上传等待时间。
上传保护：内置上传离开提醒，并针对上传中断、残留任务和异常文件进行保护与清理。
云下载增强：支持批量离线链接自动去重；内置磁链智能清洗，可提取 Base32 / Hex 哈希并剔除干扰文本。
TXT 磁链提取：支持预览 TXT 文本，并从文本中识别磁链、HTTP、FTP、ed2k、thunder 等下载链接提交云下载。
磁链预览：当磁链内容存在公开预览信息时，支持显示文件数、总大小、类型、哈希和多张预览图。

⚠️ 分享提取次数上限的自动拦截，仅在网页保持开启且设备未休眠时生效。

媒体播放增强

播放引擎增强：支持 0.5x - 3.0x 倍速、旋转翻转、强制比例、自动跳过片头片尾、连播 / 循环与进度条缩略图预览。
默认打开方式：可在脚本播放器与 PotPlayer 之间选择默认播放方式，并支持默认视频清晰度 / 外部播放清晰度设置。
音乐播放器：支持音频文件在线播放、播放列表、顺序播放、随机播放、单曲循环、弹窗模式、封面显示与音量控制。
字幕系统：支持云端同名字幕加载、本地字幕导入、在线字幕搜索；支持字幕轴偏移、字幕位置、字号和背景透明度调整。
视觉辅助：支持图片或视频当前帧以图搜图，可选择 Google Lens、Yandex、SauceNAO、trace.moe 引擎，用于反查封面、演员、番剧或素材来源。
媒体模式：可在设置中启用媒体模式，使纯视频或纯图片目录默认按名称 A-Z 排序，提升剧集 / 漫画浏览连续性。
PotPlayer 协议修复助手：内置 PotPlayer 协议检测与修复辅助，减少浏览器无法唤起外部播放器的问题。

下载与分发

下载器类型：支持 Aria2 兼容 RPC、Gopeed API、ABDM API 与 IDM 清单导出，适配不同本地下载工具。
目录结构还原：推送整个文件夹时可自动恢复云盘中的树状目录结构，避免下载后目录被打平。
视频下载加速：视频下载可优先尝试使用播放链路获取原画直链，提升下载速度。
下载过滤：支持按文件大小、扩展名、名称关键词过滤文件，作用于浏览器下载和下载器分发。
下载直链加速域名：支持下载加速域名，提供拼接原始链接与 URL 参数传递两种反代改写模式。
异常处理：推送时自动跳过 0KB 无效文件，并支持失败清单导出。

配置与数据管理

配置管理与清理：支持将脚本配置导出跨设备使用，导入配置合并去重，并支持根据配置类型清理。

解压密码库：记录解压成功的密码，供批量解压自动填充。

多账号数据迁移：支持将选中项目加密一键打包，并在另一个账号登录后自动识别接管，实现数据跨账号转存。

安装指南

安装脚本管理器：推荐使用 ScriptCat、Violentmonkey 或 Tampermonkey。
安装脚本：点击 立即安装。
打开 PikPak 网页端：访问 PikPak 并登录账号。
启动增强大师：
- 普通模式下：登录后点击侧栏浮动的蓝色 PikPak Logo 球 进入。
- 极速模式下：登录后脚本可自动开启，接管网页端。

常见问题解答

Q：为什么安装了脚本却没有显示蓝色悬浮球？
A：请按以下顺序检查：

确保脚本管理器中 PikPak 增强大师 处于开启状态。
确保已登录 PikPak 网页端账号。
若使用的是 Tampermonkey，请确认浏览器扩展详情页中的 “允许用户脚本” 已勾选。
建议使用 Edge / Chrome 最新版浏览器。
若以上步骤完成后仍然没有显示悬浮球，请临时关闭其他全部浏览器插件，然后刷新网页（F5）再试。

Q：多层文件夹返回上一层比较麻烦，只能从主界面重新进入吗？
A：不需要。脚本中所有带路径栏的页面，均支持鼠标滚轮横向滚动。

当目录层级较深，前面的上级文件夹路径被隐藏时，可以将鼠标移动到顶部路径栏区域，然后滚动鼠标滚轮。路径栏会横向滚动，把被隐藏的上级路径显示出来。

显示后，直接点击对应的上级文件夹名称，即可快速返回上一层，或跳转到任意上级目录。

Q：文件查重 / 文件夹查重时，勾选出来的文件会自动保留一个原文件吗？还是需要我在列表里再筛选一次？
A：文件查重和文件夹查重里的勾选项，本质上都是实际操作项。查重模式本身不会直接删除文件，只会列出可能重复的项目。您需要确认并勾选后，再点击删除，才会真正清理。

在查重结果中：

每个分组表头的勾选框，表示选中这一整组；
组内排序只负责按时间、大小、路径、名称等规则重新排列显示，不会自动决定删除谁、保留谁；
只有点击一键勾选时，脚本才会按规则自动处理：每组保留 1 个，其余项目会被勾选。

另外，文件查重里的按文件夹选择，是将重复列表中某个文件夹内的文件勾选；反选则是将重复列表中除该文件夹以外的文件勾选。

需要注意的是，文件查重中的精准匹配采用哈希值匹配，通常较适合配合一键勾选进行清理；而文件查重中的时长相似 / 名称相似，以及文件夹查重，都属于相似算法匹配，建议删除前人工确认，避免误删。

Q：为什么脚本“精准匹配”提示没有重复文件，但客户端里能看到重复文件？刷新网页或更换浏览器也扫描不出来，怎么办？
A：脚本里的“精准匹配”是按文件内容哈希判断的，不是按文件名判断。只有当文件哈希值和文件大小都一致时，才会被判定为精准重复。

客户端显示的“重复文件”并不一定等同于内容完全相同的文件。它可能包含同名文件、文件名后缀带有 (1) / (2) 的文件，或者大小、时长比较接近的文件。但只要这些文件的实际内容存在差异，脚本的“精准匹配”就不会把它们归为重复。

如果您想查找这类“看起来重复”的文件，可以使用文件查重或文件夹查重中的名称相似模式。

Q：为什么有些视频第一次打开或切换清晰度时会提示无法播放，但稍后再打开又可以播放？
A：这类情况通常与 PikPak 官方视频流的准备状态或浏览器解码状态有关，并不一定是脚本本身判断错误。

部分视频在官方网页端也可能出现第一次打不开、切换清晰度短时间失败、稍后重新打开又能播放的情况。脚本收到的底层错误一般类似：

[VideoError] Code: 4, Msg: PipelineStatus::DEMUXER_ERROR_COULD_NOT_OPEN: FFmpegDemuxer: open context failed

这个错误无法稳定区分是“官方资源还在准备中”，还是“当前清晰度真的不可播放”。如果脚本强行把它当作“正在准备中”并持续重试，可能会让真正无法播放的视频也被误判为可播放，从而造成更差的体验。

因此，脚本目前会保留“当前清晰度不可用”的提示，避免误导用户。

遇到这种情况时，可以尝试：

等待几秒后重新打开视频；
切换到其他清晰度；
使用外部播放尝试播放。

如果后续能找到官方更可靠的状态字段，再继续优化这类误报问题。

Q：批量解压时提示“系统繁忙 / 等待重试”，是脚本出 Bug 了吗？
A：不是。这通常是因为 PikPak 云端服务器触发了并发频率限制，属于官方接口当前繁忙，而不是脚本本身异常。

如果某个文件多次重试后仍然失败，通常说明该资源在云端可能已经损坏、受限，或当前服务器状态不佳。建议稍后重试，或将文件下载到本地后再处理。

Q：批量删除后再还原，文件数量正常，但文件没有回到原来的文件夹，目录结构像是乱了，可以一键恢复吗？
A：这种情况通常不是操作错误，也不是脚本逻辑丢失文件，更接近 PikPak 官方回收站在虚拟路径 / 聚合结果下执行还原时的表现。

当文件是在文件查重、文件透视、文件夹透视、最近添加、收藏夹等聚合视图或虚拟路径中被批量删除时，这些文件本身可能来自多个不同的原始文件夹。删除后再从回收站还原，官方还原机制有时不会逐个恢复到原来的父目录，而可能会把大量文件集中还原到某一个统一目录中，导致原来的多层级目录结构被破坏。

建议在文件查重、文件透视、文件夹透视、最近添加、收藏夹等聚合结果中批量删除前，先确认这些文件是否确实不再需要。尤其是文件来自多个不同目录时，尽量避免删除后再依赖回收站批量还原。

Q：为什么批量删除文件时，部分文件提示受保护或无法被删除？
A：请先检查这些文件是否已被记录在资源管理器中。若您在设置里开启了“删除时跳过管理器中记录资源”，脚本会将命中的文件视为受保护项目，以避免误删。

解决方法：

前往设置中取消勾选该保护规则后，再重新执行删除；
或点击工具栏 / 侧边栏中的 “资源管理器” 入口，选择 “立即运行清理”，对这些记录项执行强制物理清理。

Q：为什么我执行“粘贴”操作后，文件没有在列表中显示？
A：请先检查您的网盘剩余空间是否足够。PikPak 官方当前对“空间不足”通常采用静默拦截策略，也就是在容量超限时，不一定会弹出明确提示，而是直接在后台中止操作。

因此，如果执行粘贴后文件没有出现，最常见的原因就是触发了容量限制。建议先清理空间，再重新尝试。

Q：什么是“多账号数据迁移”？具体该如何操作？
A：该功能可将当前账号中的文件或文件夹，快速转存到您的另一个 PikPak 账号中。

操作步骤如下：

在当前账号中选中需要迁移的文件或文件夹；
点击底部的 “数据迁移” 按钮；
脚本会自动将数据加密打包，并自动退出当前账号；
随后，您只需正常登录目标账号；
登录成功后，脚本会自动检测本地缓存中的迁移包，并弹窗提示您一键接收。

隐私与安全声明

本地优先：本脚本所有核心能力均通过浏览器直接与 PikPak 官方 API 交互，您的账号 Token、解压密码库及大多数本地配置数据默认保存在本地浏览器环境中。
零收集：脚本不会主动收集用户隐私数据，也绝不会将您的文件信息或账号凭证上传至任何第三方服务器。
第三方接口：仅在使用“在线字幕搜索”“以图搜图”或“磁链预览”等扩展功能时，脚本才会向相关公共服务发送必要的搜索关键词、图片特征参数或磁链特征信息，不涉及您的个人身份信息。
会员权益边界：本脚本仅用于增强 PikPak 网页端操作体验，不具备破解、绕过或伪造 PikPak 会员权益的能力，也不会提供任何违反官方服务规则的会员解锁功能。

更新日志

V4.4.0

新增 我的分享链接导出，支持在“我的分享”中按选中项、搜索结果或当前已加载列表导出 CSV 分享链接清单。
新增 分享解析历史导出，支持将历史记录中的分享链接导出为 CSV。
优化 我的分享管理逻辑，支持分批加载、增量显示与切换模式后断点续载；取消分享后不再清空列表重刷，仅剔除取消成功项。
优化 上传模式稳定性，修复验证码状态异常后“在文件夹查看”报错的问题，并改进上传完成后的文件图标显示，禁止拖拽文件。
优化 压缩包预览弹窗，使用选中压缩包对应的官方图标，并修复部分文字区域异常隐藏的问题。
UI 与稳定性优化。

V4.3.0

新增 云归档磁链导出，支持在云归档弹窗中导出 CSV，包含标题与磁链两列，并取消云归档选中数量限制。
优化 Aria2 / Gopeed / ABDM / IDM / 浏览器下载直链提取，减少大量文件下载时 captcha_invalid 导致的批量失败。
优化 粘贴兜底逻辑，移除统一提前校验，降低粘贴过程中触发鉴权报错、图片黑屏或视频卡在封面转圈的概率。
优化 文件夹查重相似度算法与阈值处理，统一修正严格 / 宽松阈值混用问题，并在相似度匹配中加入文件夹总大小一致性权重。
UI 与稳定性优化。

V4.2.0

修复 按钮文字自动隐藏误触发问题。
修复 文件夹上传同名检测遗漏问题，上传同名文件夹时会按最终云端路径检查内部文件，避免同名同大小文件重复上传。
优化 分享解析受限视频下载，选中项目存在下载限制时不再直接禁止下载，改为弹出风险确认，由用户决定是否继续。
优化 本地上传交互，上传文件、上传文件夹或拖拽上传后不再强制切换到“我的上传”。
优化 主页路径记忆，从主页切换到其他模式后，再切回主页会恢复到切换前的真实路径；虚拟路径会回到进入虚拟模式前的真实路径。
优化 主页返回刷新策略，切回主页时优先使用缓存渲染，并对最后记录的真实路径执行增强刷新，减少清空刷新、空白等待和闪烁。
UI 与稳定性优化。

V4.1.0

修复 复制 / 剪切 / 粘贴失效源文件问题，粘贴前会校验源文件是否已删除、进入回收站或不存在，失效项会自动跳过或清空。
优化 浏览器下载链路，修复“提示已下载但浏览器没有实际下载”的问题。
优化 非会员视频播放清晰度识别与提示，避免将会员专属画质误导为普通用户可用画质造成卡顿。
优化 下载加速，新增自定义模板模式、预览与校验，并支持按使用场景控制直链重写范围。
优化 浏览器下载与上传任务冲突处理，降低触发下载时误触页面离开、刷新拦截或上传中断提示的风险。
优化 PotPlayer 链路，降低部分设备使用 PotPlayer 时渲染 Pin 失败的风险。
优化 以图搜图，支持选中带真实封面的文件夹后直接以封面搜图。
优化 云端错误提示，针对文件不存在、已删除、进入回收站或资源不可用等场景给出更准确的提示。
优化 分享预览播放稳定性，增加播放卡死检测，分享视频预览受限时可更快进入失败兜底提示，避免长时间转圈。
优化 上传任务保护，暂停状态也纳入活跃上传任务判断，降低上传暂停时误关闭、误刷新导致任务状态异常的风险。
优化 输入长度限制，进一步规范输入框文本上限。
UI与稳定性优化。

V4.0.1

修复 移动端浏览器夜间模式兼容问题，减少浏览器夜间模式对脚本界面的二次改色影响。
优化 自动隐藏按钮文字边界检测，降低按钮文字反复显示/隐藏的抖动风险。

V4.0.0

新增 链接收藏夹，支持管理 PikPak 官方 Bookmark 数据，可进行文件夹与链接的新建、编辑、删除、搜索、预览、复制、打开、分页管理，并加入远端变更校验、容量校验与重名文件夹修复。
新增 云归档，支持将选中文件中的可追溯磁链归档到链接收藏夹，提供归档检测、去重、写入校验、重新提交云下载、清理归档、归档后删除源文件及异常保护机制。
新增 配置云同步，支持将脚本配置上传到云端、从云端拉取、清空云端配置。
新增 配置容量与输入限制体系，统一限制配置项长度、数量、容量、TTL 与 LRU，自动规范化异常配置并清理过期缓存。
新增 分享解析下载增强，支持分享解析中的文件和文件夹下载，浏览器下载与外部下载器均可保留分享路径结构，并支持原始下载直链识别、预览限制提示和失败清单。
修复 本地上传任务失败问题，提升本地文件上传流程的稳定性和异常恢复能力。
优化 分享解析历史，新增状态、最近检测时间与异常状态记录。
优化 下载链路，增强 Aria2 推送容错。
优化 最近添加，最近文件支持轻量刷新并保持滚动位置。
优化 播放历史，播放历史改为基于官方播放事件加载，支持分页、去重、进度记录、会话缓存与删除状态保持。
优化 离线下载，离线任务新增轻量探测、状态同步、进行任务添加与删除不会清空列表重新刷新。
优化 移动端播放器交互，新增手势监听适配，支持播放器进度条拖动，并优化移动端目录切换时的手势响应体验。
优化 刷新与虚拟场景状态保持，改进手动刷新、网络恢复、认证恢复、搜索结果、最近、历史、离线、分享解析、链接收藏夹等场景的列表稳定性，减少跳位、空白和误刷新。
优化 UI 与稳定性，整理 CSS 与 SVG 架构。

查看历史更新日志

V3.1.0

新增 多下载器支持，下载器类型扩展为 Aria2、Gopeed、ABDM 与 IDM。
新增 分享解析历史，支持记录成功解析的分享、搜索、重新解析、置顶、备注、删除与清空。
优化 下载链路处理，支持视频优先使用播放链路加速下载。
优化 音乐播放器小窗，折叠状态下长歌名支持连续滚动显示。
UI与稳定性优化。

V3.0.3

新增 Aria2 下载路径。

V3.0.2

将项目协议调整为 AGPL-3.0-or-later，移除非商业使用限制，并保留修改版开源要求。
补充第三方 MIT License 声明与原项目致谢。

V3.0.1

稳定性优化，完善配置文件。

V3.0.0

新增 音乐播放器，支持音频文件在线播放、播放列表、顺序播放、随机播放、单曲循环、弹窗模式、封面显示与音量控制。
新增 TXT 预览，支持从文本中识别下载链接提交云下载。
新增 M3U 播放列表导出，支持将选中的视频导出为 M3U 文件，便于外部播放器批量播放。
新增 默认打开方式 设置，可在脚本播放器与 PotPlayer 之间选择默认播放路径。
优化 分享解析模式，增强分页加载、目录缓存、递归透视、分享预览限制提示与分享文件打开处理。
优化 排序与视图偏好，统一主页、回收站、播放历史、文件透视、分享解析等场景的排序和视图状态。
优化 回收站，新增网格视图。
优化 本地上传与登录恢复，增加官方上传兜底提示、直传签名错误提示与官方登录状态恢复判断。

V2.5.1

新增 Aria2 下载保存文件夹内部结构 设置。
优化 分享解析文件透视，修复返回后文件夹置顶按钮状态异常等问题。
修复脚本屏蔽官方网页端弹窗开关异常。
移除小窗口下强制隐藏脚本界面的旧逻辑，改为按钮文字自适应隐藏。

V2.5.0

新增 分享解析模式，支持分享链接解析、剪贴板识别、递归透视、文件保存、媒体预览与压缩包处理。
新增 下载直链加速域名设置，支持前缀模式与查询参数模式，可用于浏览器下载与 Aria2 / Motrix 推送链接改写。
新增播放器鼠标滚轮调节音量，支持音量浮层提示与静音图标状态。
优化网页全屏播放器、窄屏适配、搜索高亮、压缩包预览与设置保存提示。
修复 Aria2 / Motrix 推送 0KB 文件、行高异常、图标统一、英文列宽与路径下拉字体等问题。

V2.4.0

新增版本检查与更新提示。
新增视频播放设置，支持播放进度读取与默认清晰度选择。
新增视频播放网页全屏功能。
新增隐藏按钮文字设置，可仅保留图标与悬浮提示。
优化网格视图、视频播放体验、设置窗口、密码保险库弹窗、最近添加与播放历史数据获取。
清理调试输出、冗余配置与低风险死代码，降低脚本体积。

V2.3.0

新增 PotPlayer 协议修复助手。

V2.2.3

修复上传失败。
优化 UI 稳定性。

V2.2.2

修复快捷键层级冲突问题。

V2.2.1

修复 Aria2 / Motrix 下载问题。

V2.2.0

新增 剪贴板磁链监听 与 磁链预览 功能。
增强 UI 稳定性。

V2.1.1

修复 Aria2 / Motrix 在仅支持 ws:// / wss:// RPC 或非标准端口反向代理环境下连接失败的问题。

V2.1.0

支持监听鼠标侧键，实现目录层级跳转。
优化稳定性。

V2.0.0

支持语言扩展为 简体中文 / 繁體中文 / English / 한국어 / 日本語 / Indonesia / Bahasa Melayu。
UI 与架构升级，以图搜图按钮外置，新增网格视图。

V1.3.2

本地上传逻辑加固，增加中国大陆 IP 直连。
调整文件查重的时长相似阈值，优化检测精度。

V1.3.1

进一步优化登录闪烁问题。

V1.3.0

新增多账号数据迁移功能。
新增彻底删除机制，支持跳过回收站释放空间。

V1.2.0

重构视频时长嗅探引擎。

V1.1.0

Aria2 支持保留文件夹路径结构，新增投递丢包提醒及错误清单导出。
云下载支持批量提交与智能去重，支持自动清洗污染磁链与 Base32 自动解码。
批量重命名预览界面新增图标与封面展示，支持文件夹悬浮大图预览。
导入功能升级为智能合并模式，导入备份时不再覆盖本地已有名单和记录。

致谢

本项目在 UI 设计语言及部分网页端 API 调用逻辑上，深受 PikPak File Manager v1.2.0 (by 브랜뉴) 的启发，特此致敬。

PikPak_Enhancement_Master