PikPak_Enhancement_Master

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

PikPak 增强大师

移动端已适配：V5.0.0 起，脚本针对手机及窄屏触控设备重构了核心界面，文件浏览、搜索、批量操作、媒体播放及主要弹窗均提供响应式布局，同时保持桌面端原有布局与操作习惯。

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

支持语言

简体中文 | 繁體中文 | English | 한국어 | 日本語 | Indonesia | Bahasa Melayu

主要功能

体验与导航增强

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

移动端适配

• 响应式文件管理：适配手机横竖屏与安全区域，提供移动端底部导航、紧凑工具栏、两列网格及专用列表布局。
• 触控与批量操作：支持长按进入选择模式、全选 / 取消全选、批量重命名、排序、文件夹置顶及统一的更多操作菜单。
• 搜索与返回导航：提供可折叠搜索栏，支持搜索结果高亮；浏览器或系统返回键可依次关闭搜索、菜单、弹窗和媒体预览，并恢复目录历史。
• 媒体手势：支持上下滑动切换图片或视频、横向拖动视频进度、长按倍速，以及图片双指缩放、单指拖动、双击放大和长图浏览。
• 外部工具联动：移动端支持 VLC 外部播放和 Gopeed 下载，并与桌面端 PotPlayer 及下载器偏好分别保存。
• 弹窗与用量面板：设置、分享、云下载、云归档、文件分析、批量重命名等主要弹窗均适配触控和短屏，并提供移动端空间与流量用量面板。

批量与空间管理

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

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

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

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

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

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

链接收藏夹与云归档

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

传输、云下载与分享解析

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

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

媒体播放增强

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

下载与分发

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

配置与数据管理

• 配置管理与清理：支持导出脚本配置并在其他设备上使用，导入配置合并去重，并支持按配置类型清理数据。

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

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

安装指南

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

常见问题解答

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

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

Q：多层文件夹中，如何通过路径栏快速切换目录层级？
A： 将鼠标移动到顶部路径栏区域，然后使用鼠标滚轮即可逐级切换路径：

• 鼠标滚轮向下滚动一次，进入下一级目录；
• 鼠标滚轮向上滚动一次，返回上一级目录。

每滚动一次只切换一级，便于在多层文件夹之间快速浏览。

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： 请先检查这些文件是否已被记录在资源管理器中。若您在设置里开启了“删除时跳过管理器中记录资源”，脚本会将命中的文件视为受保护项目，以避免误删。

解决方法：

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

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

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

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

操作步骤如下：

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

隐私与安全声明

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

更新日志

V5.3.0

• 新增 PikPak Magnet Companion 伴生扩展支持，可在任意网页选中磁链后发送到当前 PikPak 页面；支持主脚本就绪握手、消息确认及多磁链批量转交。伴生扩展仅支持桌面版浏览器。
• 新增 伴生扩展安装入口与首次使用提示，设置中提供扩展下载和安装说明，首次使用云下载功能时可提示用户安装。
• 新增 搜索框识别分享代码开关，默认开启；关闭后搜索框仅执行本地搜索，不再检索或提示分享代码。该配置已加入本地配置和云配置的导入导出。
• 优化 首次文件列表加载与网络异常恢复，区分首次加载失败和真实空目录，增加响应校验、超时重试、网络异常重试、在线恢复重试及缓存列表保护，减少文件列表清空后需要手动刷新才能恢复的问题。
• 优化 视频文件查重算法，基于 PikPak 已有元数据，结合哈希、文件大小、视频时长、文件名相似度及扩展名进行匹配，并细化严格和宽松模式的判断阈值。图片及其他文件仍沿用原有查重逻辑。
• 修复 虚拟路径中的磁链保存目录错误，在文件夹查重、文件夹透视及其他虚拟路径中解析或保存磁链时，统一使用主页默认目录或真实目录，避免拼接不存在的虚拟路径。
• 优化 视频清晰度切换与播放失败判定，切换清晰度后重新建立播放会话并增加过渡保护，避免频繁切换时因旧计时器或临时播放错误误弹出无法播放提示。
• 修复 文件查重工具栏文件夹选择器显示不完整，调整桌面端选择器宽度，确保文件夹名称能够完整显示。
• UI 与稳定性优化。

V5.2.0

• 新增 磁链文件预览与部分保存，支持在文件标签页查看磁链内部的文件夹层级、搜索文件、展开目录及选择性保存。
• 新增 磁链文件过滤设置，支持官方智能过滤，以及自动跳过资源管理器中已记录的文件和文件夹。
• 优化 配置云同步冲突处理，手动拉取发生冲突时以云端配置为准；启用自动上传前需要先拉取云端配置建立可信同步基线。
• 优化 自动上传体验，自动上传期间锁定相关云同步操作；后台自动上传完成后采用静默处理，打开设置面板时再显示同步状态。
• 优化 移动端视频播放器操作栏，横屏全屏时恢复直接显示以图搜图和画中画按钮，避免隐藏在省略菜单中。
• UI 与稳定性优化。

V5.1.0

• 新增 “外观随系统”，可跟随系统明暗主题变化。
• 新增 “默认”视频清晰度，自动选择“原画”之后的第一档可用清晰度。
• 新增 配置自动上传，默认关闭；仅在存在可信同步基线、本地配置发生变化且云端未变化时自动上传，无基线的新设备不会直接覆盖云端。
• 优化 文件列表与网格视图渲染性能，缓解低配置设备的 GPU / CPU 占用及滚动微卡顿。
• 优化 视频源加载与清晰度切换。
• 优化 媒体播放器操作入口，修复切换视频后以图搜图按钮重复出现在右上角的问题。
• 优化 移动端操作栏与分享列表显示。
• 修复 部分环境升级后目录文件无法显示的问题。
• UI 与稳定性优化。

V5.0.0

• 全面升级 移动端核心界面，针对窄屏及触控设备完成系统性的响应式适配，提升不同尺寸与横竖屏场景下的布局一致性和操作体验。
• 优化 移动端文件浏览与批量操作，统一卡片和列表视图的更多菜单，支持长按选择、全选 / 取消全选、批量重命名、移动端排序及文件夹置顶；切换列表、网格或屏幕方向时可保持滚动位置、选中状态与当前项目。
• 优化 移动端搜索与返回导航，新增可折叠搜索栏，回收站支持本地搜索与结果高亮；浏览器或系统返回键会优先关闭当前搜索、菜单、弹窗及媒体预览，并正确恢复虚拟模式和真实目录的导航历史。
• 新增 PikPak 分享代码智能识别，在主搜索框输入分享代码或分享链接后，可确认并直接进入分享解析；无法唯一识别时继续执行普通搜索。
• 全面升级 移动端图片与视频手势，支持上下滑动切换媒体、横向拖动预览并定位视频进度、单击显隐控件、双击播放 / 暂停、长按 2× / 3× 倍速，以及图片双指缩放、单指拖动、双击放大和长图边界切换。
• 优化 移动端媒体播放体验，原生全屏可根据视频方向自动旋转，切换视频时保留封面直至首帧就绪；播放列表、字幕、画质及倍速面板完成短屏适配，并增强图片加载失败、音频误判为视频及移动端音频解码失败时的兜底处理。
• 新增 图片与视频连续浏览，支持在同一媒体队列中跨图片和视频连续切换，并可在播放器内收藏、取消收藏或删除当前文件；相关设置支持本地保存与配置云同步。
• 新增 移动端 VLC 外部播放，支持将 VLC 设为默认打开方式并应用下载加速地址；未能成功拉起 VLC 时会自动复制播放链接，且移动端 VLC 与桌面端 PotPlayer 配置相互独立。
• 优化 移动端下载器适配，移动端使用 Gopeed 时不会覆盖桌面端下载器偏好，保存目录交由 Gopeed 管理，并保持外部播放器与下载器快捷入口可见。
• 优化 分享解析与配置云同步稳定性，补充分享文件夹数量、大小展示及扫描中止保护；上传配置前会合并本地与云端分享历史，并检测远端数据变化以避免意外覆盖，上传失败时可恢复原有本地数据。
• 修复 配置保存与媒体队列问题，完善“播完暂停 / 列表循环 / 单集循环”播放模式的旧值迁移，修复 IDM EF2 导出类型及文件夹置顶默认值不一致的问题，并改进删除进度校验、列表复用和响应式切换时的状态清理。
• 调整 站点适配范围，新增 mypikpak.net 与 pikpak.me，移除 app.mypikpak.com 的脚本匹配。
• UI 与稳定性优化。

致谢

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

感谢 @yebuwudong 在 PR #9 中提供的移动端布局与触控适配方案，为 V5.0.0 的移动端重构提供了重要参考。