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 与稳定性优化。

V4.6.1

• 修复 下载器连接测试与配置提示弹窗，解决 Aria2 / Motrix、Gopeed、ABDM 等安装指引中的链接或 HTML 标签直接显示为代码的问题，并安全保留受信任的跳转链接。
• 优化 下载加速设置交互，未启用“下载时使用加速地址”时，自动隐藏链接传递方式、加速地址、生效范围及模板预览；启用后再显示相关配置。

V4.6.0

• 新增 视频截帧，支持为单个视频生成 16 张画面截帧，并提供全选、反选、批量保存、以图搜图及单帧定位播放功能。
• 优化 访问验证与登录令牌恢复机制，修复 V4.5.0 中验证码有效期判断、失效令牌复用及恢复入口不完整导致的频繁鉴权失效，提升自动恢复能力。
• 修复 播放历史进度读取与续播异常，完善官方播放进度的读取与恢复。
• UI 与稳定性优化。

V4.5.0

• 优化 网格视图流畅性，改进大量文件和文件夹场景下的渲染、滚动与切换体验。
• 优化 数据稳定性，改进目录加载、分页续载、缓存同步、文件操作回写、访问验证恢复及后台扫描调度，降低数据丢失、重复、回退和任务卡住的概率。
• UI 与稳定性优化。

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 브랜뉴) 的启发，特此致敬。

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