PixivBatchDownloader

⚡优化了导出、导入下载记录的性能

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/699

重要： 这次优化需要升级数据库版本。如果你现在打开了多个 Pixiv 标签页，建议全部刷新一遍，或者重启浏览器来完成这次升级。如果只打开了这一个 Pixiv 标签页则无需手动处理。

• 加快了导入下载记录的速度
• 减少了导出下载记录时的内存使用量
• 加快了清空下载记录的速度
• 修复问题：在移动设备上，如果下载记录很多，可能会在导出时卡住，无法导出

✨新功能：在关注页面里，可以批量保存用户头像了

在关注页面的“附加功能”区域里，下载器添加了 2 个按钮：

• 批量保存用户头像
• 批量保存用户头像为图标

点击这些按钮，下载器会按照你设置的页面范围，批量保存里面的用户的头像。文件会保存到下载目录里的 pixiv users 文件夹里。

✨新增设置：收藏面板

当你使用下载器的手动收藏作品功能时，下载器可以显示一个收藏面板。

你可以在收藏面板里设置是否公开收藏、使用哪些标签（可以使用作品的标签、自定义标签、常用的标签），然后再添加收藏。

这个设置在“增强”-“收藏”分类里。

✨下载器收藏作品时，可以使用翻译后的标签了

在“下载器收藏作品时的默认行为 (✩)”里，你可以选择“添加翻译后的标签”了。

✨新增设置：使用第一个匹配的收藏标签建立文件夹

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/368

当你在你的收藏页面里抓取作品时，如果想使用某些收藏标签（而不是作品本身的标签）来建立文件夹，就可以使用这个设置。

先填写你想设置为文件夹名字的标签，然后修改命名规则，添加特殊标记来建立文件夹。例如： pixiv/{match_bookmark_tag_folder1}/{id}

该设置只在收藏页面里抓取时有效；它位于“命名”-“调整文件夹”分类里。

✨新增命名标记：{bookmark_tags}

{bookmark_tags}：作品的收藏标签列表。当你收藏一个作品之后，可以为它添加自定义的收藏标签；这个标记用来输出作品的收藏标签。

注意：

1. 只有当你在收藏页面里抓取作品时，这个标记才是有效的；在其他页面里抓取时无效（通常不会输出内容）。
2. 如果你没有为作品添加收藏标签，那么这个标记也不会输出内容。

✨新增支持的页面类型：可以在追更列表里抓取作品了

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/427

追更列表页面：https://www.pixiv.net/following/watchlist/novels

追更页面里都是系列作品。现在下载器可以批量抓取你追更的小说、漫画了。

✨新增功能：抓取用户列表

在首页的“开始抓取”区域里新增了“抓取用户列表”按钮。你可以输入多个用户 ID，下载器会逐个抓取、下载这些用户的作品。

点击这个按钮可以查看详细说明。

✨新增筛选设置：来自用户

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/521

使用这个设置，你可以只抓取已关注/未关注用户的作品。默认全部抓取。

该设置位于“筛选”-“作品类型”里。

✨新增筛选设置：图片格式

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/414

如果有需要，你可以使用它来排除 .jpg 或 .png 图片。

该设置位于“筛选”-“作品类型”里。

✨新增设置：在作品缩略图上显示收藏按钮

点击收藏按钮可以让下载器收藏这个作品。另外，它还可以配合“点击点赞按钮时下载作品”功能使用，同时收藏 + 下载。

该设置位于“增强”-“缩略图上的按钮”分类。

✨新增设置：在作品缩略图上显示点赞按钮

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/535

点击点赞按钮可以给这个作品点赞。另外，它还可以配合“点击点赞按钮时下载作品”功能使用，同时点赞 + 下载。

该设置位于“增强”-“缩略图上的按钮”分类。

📚小说可以同时保存为 EPUB 和 TXT 格式了

以前用户只能在 EPUB 和 TXT 格式里选择一种，现在可以多选了。

如果你希望在一次下载里同时保存为两种格式，可以把 EPUB 和 TXT 格式都选上。

🏷️在抓取结果里新增了 genre 属性（小说的分类）

✨在手动选择/排除模式里，可以框选作品了

进入手动选择/手动排除模式之后，按下鼠标左键并移动（PC 端），或者在页面上长按 0.5 秒之后拖动（移动端），即可框选作品。

🚀降低了进入手动选择/排除模式后的资源占用，优化性能表现

🔥移除了搜索页面里的“手动删除作品”按钮，你可以使用“手动排除作品”按钮代替它

它是搜索页面里的专用按钮，用来在预览抓取结果时手动删除作品。在 19.4.0 版本（2026-09-04）里，下载器添加了“手动排除作品”按钮，可以替代“手动删除作品”按钮的功能，所以现在我把“手动删除作品”按钮删掉了。

✨在搜索页面里，导入抓取结果后会重绘预览卡片

这是一个优化，并且带来了一个新的用途：用户可以把其他页面里的抓取结果导出，在搜索页面里导入，即可预览里面的作品。不过目前只会预览图像作品，不会预览小说或系列小说。

✨在日志区域底部添加了“复制日志”和“清空日志”按钮

点击“复制日志”按钮可以将当前日志区域的内容复制到剪贴板，是纯文本格式。

点击“清空日志”按钮可以清空日志区域的内容。

⌨️Input 组件里 Enter 不再用作提交；只有 Ctrl + Enter 才会提交

✨在图片查看器里添加了两个按钮

添加了查看作品信息和点赞的按钮。

🎨设置“复制作品信息”的“文本格式”时，可以直接换行

之前用户需要使用 {n} 标记表示换行，但这样很不直观，查看、修改规则时效率很低。

所以现在我移除了 {n} 标记，改为直接使用换行。旧设置里的 {n} 会被下载器自动替换，不需要用户手动修改。

前后对比：

✏️修改了一些设置的名字，使其更准确和易于理解

有些设置之前的名字很简短，以至于含义不清楚，用户需要查看帮助才能知道准确的含义。现在我把它们的名字改的更加准确了。

🐞修复问题：在 Firefox 浏览器上，合并系列小说时会报错，无法合并

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/695

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/698

Fireox 的 XrayWrapper 机制导致合并系列小说时的一处代码报错，进而导致合并系列小说失败。

这是只在 Firefox 等 Gecko 内核的浏览器上才会出现的问题，而且是最近才开始出现的，以前我测试时没遇到过这个问题。现在修复。

✅添加了一些模块级单元测试脚本

💡优化了一些帮助内容

🕑更新了作品发布时间数据

本次更新内容概述：

• 优化了下载小说的功能，并新增了一些相关设置
• 可以在两个之前不支持的小说页面里下载
• 优化了一些过滤器的选项和工作方式
• 修改了一些设置的名字，功能无变化
• 修复多个 BUG
• 优化了一些帮助和提示内容

---

🏷️新增命名标记：{human}

{human}：当作品不是 AI 生成的作品时，输出 Human，否则忽略这个标记。它与 {AI} 相反，用来把人类创作的作品和 AI 生成的作品分开保存。

它可以用于作品的文件名命名规则、系列小说的命名规则，以及复制作品信息时的格式。

📚新增设置：只下载这些语言的小说

该设置位于“筛选”-“作品数据”分类里。

你可以要求小说的语言必须是特定的语言，这样下载器才会抓取它。

下载器会检查每篇小说的语言，包括系列里的小说。

你可以设置一种或多种语言代码。多个语言代码之间使用英语逗号 , 分割。例如：zh-cn,ja,en。

📚新增设置：EPUB 文件的语言标签

https://github.com/xuejianxianzun/PixivBatchDownloader/pull/686

该设置位于“下载”-“小说”分类里。

现在下载器默认会使用小说的语言作为 EPUB 文件的语言标签。

📚新增设置：EPUB 文件的排版方向

https://github.com/xuejianxianzun/PixivBatchDownloader/pull/686

你可以设置小说内容使用横排还是竖排，也可以只为特定语言的小说（如日语、繁体中文）使用竖排。

相关文档：notes/一些小说阅读器对竖排 EPUB 的支持情况.md

📚新增设置：简繁转换

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/397

下载器在下载小说时，会根据这个设置决定是否转换简体中文和繁体中文小说。默认不转换。

备注：

• 使用 opencc-js 进行简繁转换。
• 在转换时，繁体一方用的是 twp，也就是会转换台湾常用词。

相关文档：notes/小说的简体中文和繁体中文转换.md

✨支持在小说书签列表页面里抓取

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/631

小说书签列表页面： https://www.pixiv.net/novel/marker_all.php

现在下载器可以在这个页面里批量抓取了。

✨支持在小说分类页面里抓取

小说分类页面： https://www.pixiv.net/genre/novel

这次适配之后，用户可以使用快速下载功能、手动选择作品、全选功能来下载里面的作品。

PS：因为该页面的每个分类里只有 20 - 50 个左右的作品，滚动也不会加载新作品，所以我没有添加该页面专用的“开始抓取”按钮。

🛸优化检查标签的过滤器：在检查小说标签时，会同时检查分类标记

原创小说通常有分类，在标签列表前面会显示该分类的名称，例如：

注意：“异世界奇幻”不是小说自己的标签，而是根据这篇小说的原创分类（genre）显示的分类名字。

PS：这里的分类就是前面“小说分类页面”里的分类。现在一共有 17 种分类。

用户可能会以为这是作品标签，并在过滤器里（如“标签不能含有”、“标签必须含有”）使用它们。

之前，由于分类名不在标签列表里，所以下载器无法过滤它们。

现在下载器会把分类名字添加到标签列表里，可以检查和保存它们。

✨优化了检测图片色彩的流程和设置项

抓取条件里的“图片色彩”可以让用户只抓取“彩色图片”或“黑白图片”。如果用户只选择了其中一种，下载器就会检查图片的颜色。

优化内容：

1. 我添加了“彩色占比阈值”的设置，用户可以调节对图片进行颜色检查时的宽松程度。
2. 之前下载器在抓取多图作品时，不会检查它的颜色（而是留到下载时检查）；现在在抓取时就会检查每张图片的颜色。
3. 在抓取完成后，下载器还会在保存抓取结果时同时保存每个作品的检查结果，记录每个作品里排除了哪些图片，以便在重复检查时节省时间。不过这份数据会与保存的抓取结果一起被清除（通常是在下载完成、放弃下载时被清除）。

测试记录文档：notes/检查图片色彩的测试记录.md

🧠优化了判断图片色彩的算法

之前的判断方式是计算所有像素的 RGB 的平均值，如果相差在 1 左右就认为是黑白图片。这个方法不太准确，有时彩色像素被非彩色像素平均之后可能会把图片视为黑白图片。

现在改为使用彩度来判断。彩度是 R G B 三者中最大值减去最小值得到的数字，反映了颜色是否偏向彩色，偏向有多大。

判断方式是： 排除白色和透明色的像素，只统计彩色、灰色、黑色像素。然后下载器计算彩色像素的占比，和“彩色占比阈值”进行比较。 如果一张图片的彩色像素占比大于阈值，就把它视为彩色图片；否则视为黑白图片。

另外还添加了彩色像素占比的阈值，让用户可以调节判断的严格程度。阈值越小，对彩色图片的判断就越松（即彩色较少的图片也会被视为彩色）。但是和之前一样，无法完全避免误判。毕竟有些图片里就是灰色和彩色一起出现的，下载器只能按照占比判断，做不到完全符合人眼的判断。

✨在“不能含有标签”里，你可以同时使用“全字匹配”和“部分匹配”了

之前你只能在“全字匹配”和“部分匹配”里选择一种匹配模式，现在可以同时使用两种了。

两种匹配模式有各自的开关和输入框，你可以根据自己的需要使用它们。

提示：你的旧设置会被继承，所以你不需要重新设置此项。。

✨新增设置：在“ID 范围”设置里新增了“书签 ID”分类

在你的收藏页面里，你可以使用书签 ID 来筛选新增的收藏。具体用法可以查看该设置的帮助信息。

⚙️调整“预览搜索页面的抓取结果”设置

🔧把它移动到“筛选”-“执行策略”里

⚡预览抓取结果时，作品会分页显示，以降低性能压力

之前抓取到的作品是全部显示在页面上的，当作品数量很多时，页面会非常卡顿。现在改为分页显示。

✨新增设置：每页显示的作品数量

🔥移除了“预览搜索页面的抓取结果”的“上限”设置

因为“预览搜索页面的抓取结果”已经改为了分页显示，所以没有必要设置上限了。

✏️把导航里的“抓取”分类改名为“筛选”，使其更准确

抓取分类里保存了许多筛选/过滤设置。

之前叫“抓取”是因为：它里面的设置大多会在抓取阶段使用。

现在我修改这个名字，是因为使用“抓取”作为分类名存在缺点：

• 不够准确，它里面的设置其实是过滤器，不是“抓取”这个动作或流程本身。
• 首页（仪表盘）里有“开始抓取”区域。导航里的“抓取”分类名字与“开始抓取区域”重复，并且可能会误导新手用户（以为需要在“抓取”分类里开始抓取）。

那么把它改为“筛选”还是“过滤”呢？

在中文语境里，“筛选”更倾向于“保留特定结果”，而“过滤”更倾向于“排除特定结果”。结合该分类里设置的使用方式、目的（保留符合自己需求的作品）、以及 QQ 群里的调查，我决定使用“筛选”。

PS：在 QQ 群的简单调查里，5 人支持使用“筛选”，0 人支持“过滤”，另有 2 人感觉可以保持“抓取”。

🔧把“收藏状态”移动到了“筛选”-“作品类型”分类里

之前它在“作品数据”分类里，把它移动到“作品类型”里更符合直觉。

✏️修改了一些设置的名字，功能无变化

旧名字	新名字
必须含有tag	标签必须含有
不能含有tag

🐞修复问题：在Firefox上，特殊的空格字符导致文件无法保存

https://www.pixiv.net/artworks/147879864

这个作品的标题里有个颜文字表情 (º﹃º )，最右侧的括号前面有个特殊空格 \u00A0，Firefox 不允许用作文件名，导致文件保存失败。现在修复。

🐞修复问题：修复保存命名规则时的一处判断不正确

触发这个 bug 的步骤： 如果用户先修改了默认的命名规则，之后又改回了默认的命名规则，下载器有可能不会保存第二次修改。

触发此 bug 时的表现是：命名规则不能恢复到默认值；下载器只会保存与默认值不同的规则。

现在修复。

🕑更新了作品发布时间数据

本次更新的主要内容：

• 添加了全选作品、手动排除作品的功能
• 优化了预览作品功能
• 可以抓取用户主页里的约稿作品了
• 在网页右侧添加了查看日志的按钮
• 优化了移动端界面，提升用户体验
• 添加了自定义快捷键功能
• 其他优化和 Bug 修复

ℹ️提示：如何关闭“快捷屏蔽用户”功能

上个版本我添加了“快捷屏蔽用户”功能，一些用户不知道如何关闭它。该功能只有当你启用了“用户屏蔽名单”之后才会生效，并且它的开关就在“用户屏蔽名单”里。

✨新增功能：全选当前显示的作品

我在“开始抓取”区域里添加了这个按钮，点击它就可以选择当前页面上显示的所有作品。

另外，我更新了在移动端页面里查找作品缩略图的代码，查找更准确、也覆盖到了很多之前没有覆盖到的地方，这样才能让全选功能发挥作用。

✨新增功能：手动排除作品

我在“开始抓取”区域里添加了这个按钮，快捷键是 Alt + W。它的操作方式和“手动选择作品”类似，但作用是标记你不想抓取的作品。

下载器不会抓取被排除的作品；如果它已经被抓取了，下载器会把它从抓取结果里删除。

✨新增功能：在多图作品页面里，你可以选择作品里的部分图片，然后下载它们

在多图作品页面里，下载器会在大图下方添加缩略图列表。

有时用户可能想选择其中的一部分图片然后下载它们，所以我添加了一些按钮来实现这个功能。

⚙️优化了“自动开始下载”设置

之前即使用户关闭了“自动开始下载”，快速下载任务也总是会自动开始下载。

现在我区分了“普通下载任务”和“快速下载任务”，你可以分别设置它们是否自动开始下载。

✨在预览作品里新增子选项：允许预览图遮挡缩略图

该选项默认未启用。现在预览作品区域默认不会遮挡缩略图，除非你启用这个选项。

之前当你预览横图时，预览图经常会遮挡住缩略图，有时这会影响用户体验。现在预览图默认不会遮挡住缩略图了，体验更好，但有时这会导致预览图的尺寸比原来更小。

如果你想让预览图和以前一样：尽量不缩小，且允许它遮挡住缩略图，可以启用此开关。

✨在预览作品里添加了更小的图片尺寸：小图(540px)

之前下载器在预览作品时默认使用普通尺寸（1200px），有很多图片的体积达到了 1.5 MB，在弱网时加载比较慢，所以我添加了更小的尺寸：小图(540px)。大部分小图的体积只有 50 KB 左右，你可以根据需要选择这个尺寸。

✨在预览作品时，按 V 可以查看它的原始比例图片

预览作品时显示的图片是缩略图，如果你想以 1:1 的比例查看原图，可以按 V 查看原图，再次按 V 可以关闭原图。

其实这个查看原图的功能就是“在缩略图上长按鼠标右键时显示大图”，只不过添加了一个新的调用方式。

另外，这次我为查看原图功能添加了两个新的快捷键：

• 按 B 收藏这个作品；
• 按 V 关闭原图。

✨在搜索用户的页面里，适配了“显示更大的缩略图”的样式

✨适配了用户主页里的“约稿”分类页面

现在你可以在用户主页里抓取他的约稿作品了。

✨新增快捷键 Alt + Z，用来点击默认的抓取按钮

快捷键 Alt + Z 可以点击默认的抓取按钮（具有蓝色背景的主按钮，通常是“开始抓取”），这样不需要打开设置面板就可以直接开始抓取。

PS：在下载器不支持的页面里没有这个按钮，此时快捷键没有实际效果。

✨新增设置：自定义快捷键

如果你想修改下载器内置的部分快捷键，可以在"通用"-"操作方式"-"自定义快捷键"设置里进行修改。

截图：

其实我先用了在浏览器里注册扩展快捷键的方法来做这个功能，但是这个方法有很多不便，后来返工改成了由下载器自己管理。

✨优化日志功能

• 在日志区域底部添加了两个按钮：手动导出日志、隐藏日志区域
• 把顶部的“显示日志”按钮移动到了右侧，避免遮挡 Pixiv 的搜索框。

✏️修改了一些设置的名字，功能没有变化

• “导出日志”改为“自动导出日志”。这是为了与新增的“手动导出日志”按钮区分。
• “在作品缩略图上显示放大按钮”改为“在作品缩略图上显示图片查看器按钮”。
• “复制按钮”改为“复制作品信息”。
• “同时下载数量”改为“同时下载多少个文件”。

🎨优化了下载器在移动端页面里的界面，提升用户体验

之前在移动端页面里，顶部的标题栏、搜索栏、导航栏占据了太多高度，导致下方内容区域的高度很小，用户在查看、使用内容区域时很不方便。

现在我进行了优化，减少了顶部板块的高度，并增加了内容区域的高度。另外我还减小了一些元素的尺寸，让内容更加紧凑。

优化前后的对比截图：

😊优化一处体验：在排行榜页面里，“抓取多少作品”的数量不会自动变化了

在排行榜页面里，抓取数量的最大值会根据不同的分类而变化。例如在普通分类里 max 是 500, 在 R-18 分类里 max 是 100。

之前当用户从普通分类里进入 R-18 分类时，如果设置的值是 500，会自动变成 100。之后即使返回普通分类，也还是 100。这会让用户困惑，因为数字自动变小了。现在这个值不会变化了，所以用户可以使用大于最大值的数字。

😊优化体验：文件名超长时，之前可能会只保留 id，现在可以保留更多文字了

当需要截断文件名时，在截断后的内容里，文件名里可能没有包含 {id} 的内容。这通常是因为用户在命名规则里把 {id} 放到了末尾。为了保证文件名不重复，之前下载器会强制把文件名设置为 {id}，但这丢失了其他信息。现在改为只把末尾的一些文字替换为 {id}，保留了更多信息。

😊优化了一些帮助内容

🌍优化了 i18n 文本的翻译

src/ts/langText.ts 里保存着下载器的 i18n 文本，以前有些翻译不准确。主要的原因是：以前 AI 没有流行的时候，我是用谷歌翻译来把简体中文文本翻译成其他语言的，但是翻译质量并不好。现在我让 AI 重新进行了翻译，修正和优化了一些翻译结果。

🐞修复问题：转换动图为 WebM 格式时，有极少数作品会转换失败

https://github.com/xuejianxianzun/PixivBatchDownloader/pull/673

下载器在转换 WebM 时会向 worker 发送数据，之前没有把 ImageBitmap 作为 transferable 对象传递，这会导致 ImageBitmap 被浏览器再次复制，可能会导致内存溢出。现在修复。另外对 GIF 格式也应用了同样的优化。

🐞修复问题：当下载器移除被屏蔽的用户的作品时，在移动端的一些页面上，不能移除小说作品

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/675

🐞修复问题：在手机版 Firefox 上无法保存文件

https://github.com/xuejianxianzun/PixivBatchDownloader/issues/526

笔记：notes/解决移动版 Firefox 的兼容性问题.md

🕑更新了作品发布时间数据