📦 PikPak 增强大师

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

✨ 主要功能

✨ 体验与导航引擎

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

📂 批量与空间管理

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

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

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

• M3U 播放列表导出：支持将选中的视频导出为 M3U 文件，便于在外部播放器中批量播放。
• 导出目录：支持导出当前目录的目录树或目录列表，便于归档、核对和分享文件结构。

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

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

🌐 传输、云下载与分享解析

• 分享文件透视：支持对分享内容进行递归扫描和筛选，便于在保存前预览分享内部结构。
• 分享管理：支持设置分享提取次数上限；达到条件后可自动取消分享，使链接失效。
• 上传保护：内置上传离开提醒，并针对上传中断、残留任务和异常文件进行保护与清理。
• 云下载增强：支持批量离线链接自动去重；内置磁链智能清洗，可提取 Base32 / Hex 哈希并剔除干扰文本。
• TXT 磁链提取：支持预览 TXT 文本，并从文本中识别磁链、HTTP、FTP、ed2k、thunder 等下载链接提交云下载。
• 磁链预览：当磁链内容存在多张预览图时，支持多图预览。

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

🎬 沉浸式媒体增强

• 播放引擎增强：支持 0.5x - 3.0x 倍速、旋转翻转、强制比例、自动跳过片头片尾、连播 / 循环与进度条缩略图预览。
• 音乐播放器：支持音频文件在线播放、播放列表、顺序播放、随机播放、单曲循环、弹窗模式、封面显示与音量控制。
• 音频弹窗模式：支持将音乐播放器独立为小窗，并保持播放控制、封面展示和主题适配。
• 字幕系统：支持云端同名字幕加载、本地字幕导入、在线字幕搜索；支持字幕轴偏移、字幕位置、字号和背景透明度调整。
• 视觉辅助：支持图片或视频当前帧以图搜图，便于反查封面、演员、番剧或素材来源。
• 媒体模式：可在设置中启用媒体模式，使纯视频或纯图片目录默认按名称 A-Z 排序，提升剧集 / 漫画浏览连续性。

⚡ 下载、外部播放与分发

• 默认打开方式：可在脚本播放器与 PotPlayer 之间选择默认播放方式。
• PotPlayer 协议修复助手：内置 PotPlayer 协议检测与修复辅助，减少浏览器无法唤起外部播放器的问题。
• RPC 分发：支持通过 RPC 协议将文件推送至 Aria2 / Motrix 等下载节点。
• 目录结构还原：推送整个文件夹时可自动恢复云盘中的树状目录结构，避免下载后目录被打平。
• 下载过滤：支持按文件大小、扩展名、名称关键词过滤文件，作用于浏览器下载和 Aria2 / Motrix 推送。
• 下载直链加速域名：支持自定义下载加速域名，提供前缀完整原始链接与 URL 参数传递两种反代改写模式。
• 异常处理：推送时自动跳过 0KB 无效文件，并支持失败清单导出。

⚙️ 配置与数据管理

• 配置备份：支持将偏好设置、管理规则、密码金库、历史记录和部分功能配置导出为带指纹校验的 JSON 备份文件。
• 智能导入：导入时会对名单、记录等列表型数据进行合并去重；基础设置项按导入文件进行更新。
• 本地数据清理：支持按类别清理全盘索引、偏好设置、管理规则、密码金库、视频缓存与运行缓存。

• 密码金库：集中管理常用解压密码，供批量解压自动尝试与快速填充使用。

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

📌 偏好设置、管理规则、密码金库、缓存和历史类数据均保存在本地环境中。

📥 安装指南

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： 文件查重和文件夹查重里的勾选项，本质上都是实际操作项。查重模式本身不会直接删除文件，只会列出可能重复的项目。您需要确认并勾选后，再点击删除，才会真正清理。

在查重结果中：

• 每个分组表头的勾选框，表示选中这一整组；
• 组内排序只负责按时间、大小、路径、名称等规则重新排列显示，不会自动决定删除谁、保留谁；
• 只有点击一键勾选时，脚本才会按规则自动处理：每组保留 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、密码金库及大多数本地配置数据默认保存在本地浏览器环境中。
• 零收集：脚本不会主动收集用户隐私数据，也绝不会将您的文件信息或账号凭证上传至任何第三方服务器。
• 第三方接口：仅在使用“在线字幕搜索”或“以图搜图”等扩展功能时，脚本才会向相关公共服务发送必要的搜索关键词或图片特征参数，不涉及您的个人身份信息。

🤝 致谢

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