Repository navigation
Releases
v0.11.2-beta(测试版)|重要修复:AIGC 过滤反向
测试版发布说明 (v0.11.2-beta)
🧪 这是测试版
PX(PixivCrawler)v0.11.2-beta —— 核心功能已可用,但仍在持续迭代,后续会有更多修改(功能、界面、文档都可能变化)。请把它当作"能用的预发布版本"来评估,正式稳定版需要更多打磨。
📦 下载与安装
PixivCrawler-windows.zip(Windows 10/11 x64,双击即用,无需装 Python)- 解压后双击
PixivCrawler.exe启动图形界面 - 首次使用建议先看 README 第二节「登录」(否则只能匿名搜索、每种排序约 600 个作品)
注意:exe 内已含配置与辅助文件,请整目录解压、不要把 exe 单独拷走。
✨ 这个版本能做什么
爬取
- 关键词、画师ID、全量分段(按时间切分突破翻页上限)、用户收藏夹(公开可爬、私密需 OAuth)四种检索
- 内容分级独立开关(全年龄 / R-18 / R-18G)、AIGC 排除/只要
- 发布时间范围(年月日三级联动下拉)、点赞/收藏门槛
- 动图(ugoira)转 webp / gif,画师追更订阅制增量
- 干跑侦察(先看量级再下载)、预估按钮、断点续爬、缺页自动修复
图库管理
- 6 个标签页:爬取 / 追更 / 图库检索 / 图库位置 / 读取能力 / 爬取历史
- 多维检索:原TAG(自动补全+多选)、画师ID(独立列表区)、衍生TAG、时间、人气、分级、AIGC
- 衍生标签(自定义标签层 + 自动「第N次爬取」溯源 + 一键导入原TAG + 爬取完成批量标记)
- 单击预览缩略图(JPG/PNG/WebP)、双击打开原图、安全停止+续跑
- 读取能力体检(登录态/可读量/原图权)+ 三种登录方式(Cookie 导入 / 手动 / OAuth)
可靠性
- 接口结构校验(pixiv 改版时明确报错而不是静默失效)
- 限流自适应、断点续爬、
repair --clean-tags数据清洗 - 自检 selftest(离线 20 项)
⚠️ 已知限制(测试版如实相告)
- pixiv 随时可能改接口 —— 程序会在改版时明确报错,但修复需要更新版本
- 免登录搜索每种排序约 600 个作品;要更多 / 要 R-18 请登录
- 全量模式爬热门关键词可能占用大量磁盘(建议先点「预估」)
- 界面文案、布局仍会调整;语言目前以中文为主,英文版计划中
- Windows 优先;Linux/macOS 可用命令行模式
🐛 遇到问题?
- 提 GitHub Issue,最好附上:做了什么、报错截图/日志、大概什么时间
- 或贴出
selftest(PixivCrawler.exe selftest)输出
🔮 后续计划(不承诺时间)
- 界面中英双语、更细的图库统计
- 标签追更(按关键词订阅增量)
- 代码模块化拆分
- 更多针对不同 Windows 版本的兼容性验证
发布历史:
v0.11.2-beta(2026-10-04)
本轮更新(相对 v0.11.1-beta):重要修复 + 安全修复
🔴 重要修复:AIGC 过滤完全反向
pixiv 的 aiType 语义是 0=未标注 / 1=非AI(人类)/ 2=AI生成,
旧版本误用 aiType != 0 当作「是 AI」,把「1=人类」也当成 AI,导致:
| 你选的 | 旧版实际行为 | 本版修正为 |
|---|---|---|
| 排除 AI | 把人类作品全排除,只留下 AI 作品 ❌ | 只留人类作品 ✓ |
| 只要 AI | 人类 + AI 全留(等于没筛)❌ | 只留 AI 作品 ✓ |
- 真实接口实测(
初音ミク最新页 59 条):修正后排除AI → 55 条人类、只要AI → 4 条 AI - 统一为
is_ai_work()一处定义语义,替换全部 9 处判断(列表/详情/图库检索/收藏夹/画师/全量) - 修了 App API 的
ai_type归一化(原本压成 0/1,丢失"1=人类/2=AI"的区分) - 对已有图库立即生效:记录里存的一直是原始值(0/1/2),无需迁移数据
- 新增
test_ai_filter.py把语义钉死
⚠️ 如果你以前用过「排除 AI」爬图,当时实际下载的是 AI 作品。那批图仍在图库里,
可在「图库检索」页用「排除 AI」筛出后自行处理。
🔒 安全修复:发布包不再包含本地凭据
- 发布用的 exe 改用独立的干净模板
config.release.json(无 cookie/token、相对路径),
不再打包本机config.json(那是给开发者自己用的、可能填了登录态) build_exe.bat增加打包前后双重复检:一旦发现凭据立即中止,杜绝再次误发- 配置里的路径改为相对(
library),跨机器可直接使用;ffmpeg_path留空自动查找
🧪 测试健壮性
- 修正 3 个测试里把
aiType=1当作 AI 的旧断言 - 体检相关测试不再依赖"凭据一定有效"(凭据失效时报「检测失败」也算正确行为)
v0.11.1-beta(2026-10-02)
本轮更新(相对 v0.11.0-beta):
新增
- 爬取状态栏逐张文件信息:每张下载完立即显示「✓ 成功 / ✗ 失败 · 作品名 · 格式 · 大小」,成功绿色、失败红色并附失败原因
- 与进度条同一行显示,不额外占界面高度
- 关键词 / 画师 / 全量 / 追更 / 收藏夹所有模式都生效
README功能表补充「进度与状态」一行
说明
- 日志区的逐张
[ok]/[fail]明细保留(可回看历史),状态栏只是把"最新一张"抬到显眼位置
v0.11.0-beta(2026-09-30)
本轮更新(相对 v0.10.0-beta):
新增
- 爬取「用户收藏夹」:按 pixiv 用户ID 爬取其收藏夹里的作品
- 公开收藏任何登录态可爬(网页书签接口,实测单个用户 1501 条全量分页取回)
- 私密收藏仅本人 + 需 OAuth(refresh_token / App API),缺 token 时明确报错
- 列表阶段筛选:收藏简表自带标签/分级/AI/画师,下载前就筛掉,省详情请求
- 增量:已下载的自动跳过;支持按收藏标签过滤(--bookmark-tag)
- 入口:CLI
crawl --from-bookmarks <用户ID>;GUI 爬取页检索范围新增「收藏夹」档
- 新增
test_bookmarks.py回归测试(筛选/去重/干跑/处理循环)
行为变化
- 爬取页检索范围单选:关键词 / 画师ID / 收藏夹 / 两者都要
版本摘要
- v0.11.2-beta(当前):修复 AIGC 过滤反向(重要)+ 发布包不再含本地凭据(安全)
- v0.11.1-beta:爬取状态栏逐张文件信息(名称/格式/大小/成败)
- v0.11.0-beta:爬取用户收藏夹(公开+私密、列表阶段筛选、收藏标签过滤)
- v0.10.0-beta:画师ID筛选区、爬取批量标记衍生TAG、README 精简
- v0.9.0-beta:首个打包发布,含全部核心功能与可靠性加固
v0.11.1-beta(测试版)|LeebertyPixiv
⚠️ 此版本存在已知问题,请改用 v0.11.2-betaAIGC 过滤完全反向:选「排除 AI」实际只会留下 AI 作品,选「只要 AI」等于没筛。
该问题已在 v0.11.2-beta 修复,且本版本的下载包已撤下。
测试版发布说明 (v0.11.1-beta)
🧪 这是测试版
PX(PixivCrawler)v0.11.1-beta —— 核心功能已可用,但仍在持续迭代,后续会有更多修改(功能、界面、文档都可能变化)。请把它当作"能用的预发布版本"来评估,正式稳定版需要更多打磨。
📦 下载与安装
PixivCrawler-windows.zip(Windows 10/11 x64,双击即用,无需装 Python)- 解压后双击
PixivCrawler.exe启动图形界面 - 首次使用建议先看 README 第二节「登录」(否则只能匿名搜索、每种排序约 600 个作品)
注意:exe 内已含配置与辅助文件,请整目录解压、不要把 exe 单独拷走。
✨ 这个版本能做什么
爬取
- 关键词、画师ID、全量分段(按时间切分突破翻页上限)、用户收藏夹(公开可爬、私密需 OAuth)四种检索
- 内容分级独立开关(全年龄 / R-18 / R-18G)、AIGC 排除/只要
- 发布时间范围(年月日三级联动下拉)、点赞/收藏门槛
- 动图(ugoira)转 webp / gif,画师追更订阅制增量
- 干跑侦察(先看量级再下载)、预估按钮、断点续爬、缺页自动修复
图库管理
- 6 个标签页:爬取 / 追更 / 图库检索 / 图库位置 / 读取能力 / 爬取历史
- 多维检索:原TAG(自动补全+多选)、画师ID(独立列表区)、衍生TAG、时间、人气、分级、AIGC
- 衍生标签(自定义标签层 + 自动「第N次爬取」溯源 + 一键导入原TAG + 爬取完成批量标记)
- 单击预览缩略图(JPG/PNG/WebP)、双击打开原图、安全停止+续跑
- 读取能力体检(登录态/可读量/原图权)+ 三种登录方式(Cookie 导入 / 手动 / OAuth)
可靠性
- 接口结构校验(pixiv 改版时明确报错而不是静默失效)
- 限流自适应、断点续爬、
repair --clean-tags数据清洗 - 自检 selftest(离线 20 项)
⚠️ 已知限制(测试版如实相告)
- pixiv 随时可能改接口 —— 程序会在改版时明确报错,但修复需要更新版本
- 免登录搜索每种排序约 600 个作品;要更多 / 要 R-18 请登录
- 全量模式爬热门关键词可能占用大量磁盘(建议先点「预估」)
- 界面文案、布局仍会调整;语言目前以中文为主,英文版计划中
- Windows 优先;Linux/macOS 可用命令行模式
🐛 遇到问题?
- 提 GitHub Issue,最好附上:做了什么、报错截图/日志、大概什么时间
- 或贴出
selftest(PixivCrawler.exe selftest)输出
🔮 后续计划(不承诺时间)
- 界面中英双语、更细的图库统计
- 标签追更(按关键词订阅增量)
- 代码模块化拆分
- 更多针对不同 Windows 版本的兼容性验证
发布历史:
v0.11.1-beta(2026-10-02)
本轮更新(相对 v0.11.0-beta):
新增
- 爬取状态栏逐张文件信息:每张下载完立即显示「✓ 成功 / ✗ 失败 · 作品名 · 格式 · 大小」,成功绿色、失败红色并附失败原因
- 与进度条同一行显示,不额外占界面高度
- 关键词 / 画师 / 全量 / 追更 / 收藏夹所有模式都生效
README功能表补充「进度与状态」一行
说明
- 日志区的逐张
[ok]/[fail]明细保留(可回看历史),状态栏只是把"最新一张"抬到显眼位置
v0.11.0-beta(2026-09-30)
本轮更新(相对 v0.10.0-beta):
新增
- 爬取「用户收藏夹」:按 pixiv 用户ID 爬取其收藏夹里的作品
- 公开收藏任何登录态可爬(网页书签接口,实测单个用户 1501 条全量分页取回)
- 私密收藏仅本人 + 需 OAuth(refresh_token / App API),缺 token 时明确报错
- 列表阶段筛选:收藏简表自带标签/分级/AI/画师,下载前就筛掉,省详情请求
- 增量:已下载的自动跳过;支持按收藏标签过滤(--bookmark-tag)
- 入口:CLI
crawl --from-bookmarks <用户ID>;GUI 爬取页检索范围新增「收藏夹」档
- 新增
test_bookmarks.py回归测试(筛选/去重/干跑/处理循环)
行为变化
- 爬取页检索范围单选:关键词 / 画师ID / 收藏夹 / 两者都要
发布历史:
- v0.11.1-beta(当前):爬取状态栏逐张文件信息(名称/格式/大小/成败)
- v0.11.0-beta:爬取用户收藏夹(公开+私密、列表阶段筛选、收藏标签过滤)
- v0.10.0-beta:画师ID筛选区、爬取批量标记衍生TAG、README 精简
- v0.9.0-beta:首个打包发布,含全部核心功能与可靠性加固
v0.11.0-beta(测试版)|LeebertyPixiv
测试版发布说明 (v0.11.0-beta)
🧪 这是测试版
PX(PixivCrawler)v0.11.0-beta —— 核心功能已可用,但仍在持续迭代,后续会有更多修改(功能、界面、文档都可能变化)。请把它当作"能用的预发布版本"来评估,正式稳定版需要更多打磨。
📦 下载与安装
PixivCrawler-windows.zip(Windows 10/11 x64,双击即用,无需装 Python)- 解压后双击
PixivCrawler.exe启动图形界面 - 首次使用建议先看 README 第二节「登录」(否则只能匿名搜索、每种排序约 600 个作品)
注意:exe 内已含配置与辅助文件,请整目录解压、不要把 exe 单独拷走。
✨ 这个版本能做什么
爬取
- 关键词、画师ID、全量分段(按时间切分突破翻页上限)、用户收藏夹(公开可爬、私密需 OAuth)四种检索
- 内容分级独立开关(全年龄 / R-18 / R-18G)、AIGC 排除/只要
- 发布时间范围(年月日三级联动下拉)、点赞/收藏门槛
- 动图(ugoira)转 webp / gif,画师追更订阅制增量
- 干跑侦察(先看量级再下载)、预估按钮、断点续爬、缺页自动修复
图库管理
- 6 个标签页:爬取 / 追更 / 图库检索 / 图库位置 / 读取能力 / 爬取历史
- 多维检索:原TAG(自动补全+多选)、画师ID(独立列表区)、衍生TAG、时间、人气、分级、AIGC
- 衍生标签(自定义标签层 + 自动「第N次爬取」溯源 + 一键导入原TAG + 爬取完成批量标记)
- 单击预览缩略图(JPG/PNG/WebP)、双击打开原图、安全停止+续跑
- 读取能力体检(登录态/可读量/原图权)+ 三种登录方式(Cookie 导入 / 手动 / OAuth)
可靠性
- 接口结构校验(pixiv 改版时明确报错而不是静默失效)
- 限流自适应、断点续爬、
repair --clean-tags数据清洗 - 自检 selftest(离线 20 项)
⚠️ 已知限制(测试版如实相告)
- pixiv 随时可能改接口 —— 程序会在改版时明确报错,但修复需要更新版本
- 免登录搜索每种排序约 600 个作品;要更多 / 要 R-18 请登录
- 全量模式爬热门关键词可能占用大量磁盘(建议先点「预估」)
- 界面文案、布局仍会调整;语言目前以中文为主,英文版计划中
- Windows 优先;Linux/macOS 可用命令行模式
🐛 遇到问题?
- 提 GitHub Issue,最好附上:做了什么、报错截图/日志、大概什么时间
- 或贴出
selftest(PixivCrawler.exe selftest)输出
🔮 后续计划(不承诺时间)
- 界面中英双语、更细的图库统计
- 标签追更(按关键词订阅增量)
- 代码模块化拆分
- 更多针对不同 Windows 版本的兼容性验证
发布历史:
v0.11.0-beta(2026-09-30)
本轮更新(相对 v0.10.0-beta):
新增
- 爬取「用户收藏夹」:按 pixiv 用户ID 爬取其收藏夹里的作品
- 公开收藏任何登录态可爬(网页书签接口,实测单个用户 1501 条全量分页取回)
- 私密收藏仅本人 + 需 OAuth(refresh_token / App API),缺 token 时明确报错
- 列表阶段筛选:收藏简表自带标签/分级/AI/画师,下载前就筛掉,省详情请求
- 增量:已下载的自动跳过;支持按收藏标签过滤(--bookmark-tag)
- 入口:CLI
crawl --from-bookmarks <用户ID>;GUI 爬取页检索范围新增「收藏夹」档
- 新增
test_bookmarks.py回归测试(筛选/去重/干跑/处理循环)
行为变化
- 爬取页检索范围单选:关键词 / 画师ID / 收藏夹 / 两者都要
发布历史:
- v0.11.0-beta(当前):爬取用户收藏夹(公开+私密、列表阶段筛选、收藏标签过滤)
- v0.10.0-beta:画师ID筛选区、爬取批量标记衍生TAG、README 精简
- v0.9.0-beta:首个打包发布,含全部核心功能与可靠性加固
v0.10.0-beta(测试版)|LeebertyPixiv
测试版发布说明 (v0.10.0-beta)
🧪 这是测试版
PX(PixivCrawler)v0.10.0-beta —— 核心功能已可用,但仍在持续迭代,后续会有更多修改(功能、界面、文档都可能变化)。请把它当作"能用的预发布版本"来评估,正式稳定版需要更多打磨。
📦 下载与安装
PixivCrawler-windows.zip(Windows 10/11 x64,双击即用,无需装 Python)- 解压后双击
PixivCrawler.exe启动图形界面 - 首次使用建议先看 README 第二节「登录」(否则只能匿名搜索、每种排序约 600 个作品)
注意:exe 内已含配置与辅助文件,请整目录解压、不要把 exe 单独拷走。
✨ 这个版本能做什么
爬取
- 关键词、画师ID、全量分段(按时间切分突破翻页上限)三种检索
- 内容分级独立开关(全年龄 / R-18 / R-18G)、AIGC 排除/只要
- 发布时间范围(年月日三级联动下拉)、点赞/收藏门槛
- 动图(ugoira)转 webp / gif,画师追更订阅制增量
- 干跑侦察(先看量级再下载)、预估按钮、断点续爬、缺页自动修复
图库管理
- 6 个标签页:爬取 / 追更 / 图库检索 / 图库位置 / 读取能力 / 爬取历史
- 多维检索:原TAG(自动补全+多选)、衍生TAG、画师/画师ID、时间、人气、分级、AIGC
- 衍生标签(自定义标签层 + 自动「第N次爬取」溯源 + 一键导入原TAG)
- 单击预览缩略图(JPG/PNG/WebP)、双击打开原图、安全停止+续跑
- 读取能力体检(登录态/可读量/原图权)+ 三种登录方式(Cookie 导入 / 手动 / OAuth)
可靠性
- 接口结构校验(pixiv 改版时明确报错而不是静默失效)
- 限流自适应、断点续爬、
repair --clean-tags数据清洗 - 自检 selftest(离线 20 项)
⚠️ 已知限制(测试版如实相告)
- pixiv 随时可能改接口 —— 程序会在改版时明确报错,但修复需要更新版本
- 免登录搜索每种排序约 600 个作品;要更多 / 要 R-18 请登录
- 全量模式爬热门关键词可能占用大量磁盘(建议先点「预估」)
- 界面文案、布局仍会调整;语言目前以中文为主,英文版计划中
- Windows 优先;Linux/macOS 可用命令行模式
🐛 遇到问题?
- 提 GitHub Issue,最好附上:做了什么、报错截图/日志、大概什么时间
- 或贴出
selftest(PixivCrawler.exe selftest)输出
🔮 后续计划(不承诺时间)
- 界面中英双语、更细的图库统计
- 标签追更(按关键词订阅增量)
- 代码模块化拆分
- 更多针对不同 Windows 版本的兼容性验证
发布历史:
v0.10.0-beta(2026-09-30)
本轮更新(相对 v0.9.0-beta):
新增
- 图库检索新增「画师ID筛选区」:夹在原TAG与衍生TAG之间,画师列表按作品数排序、可多选(并集)、自动补全过滤框、一键清除;与顶部手输框双向联动
- 爬取页新增「标记这批图…」:爬取/追更完成后,一键给本次新下载的这一批作品批量添加衍生标签(弹窗输入多标签,自动去重,写 dtags 并刷新检索);停止后同样可标记
- README 全面精简(712→57 行):保留快速上手/功能/登录/命令/限制/反馈,删去冗余实测数据与参数大全
修复
- 检索页衍生TAG行残留的旧输入框清理(与自动补全框共享变量造成显示混乱)
行为变化
- 检索页三个筛选列表并排:原TAG | 画师 | 衍生TAG,均单击即检索
发布历史:
- v0.10.0-beta(当前):画师ID筛选区、爬取批量标记衍生TAG、README 精简
- v0.9.0-beta:首个打包发布,含全部核心功能与可靠性加固
v0.9.0-beta(测试版)|LeebertyPixiv
测试版发布说明 (v0.9.0-beta)
🧪 这是测试版
PX(PixivCrawler)v0.9.0-beta —— 核心功能已可用,但仍在持续迭代,后续会有更多修改(功能、界面、文档都可能变化)。请把它当作"能用的预发布版本"来评估,正式稳定版需要更多打磨。
📦 下载与安装
PixivCrawler-windows.zip(Windows 10/11 x64,双击即用,无需装 Python)- 解压后双击
PixivCrawler.exe启动图形界面 - 首次使用建议先看 README 第二节「登录」(否则只能匿名搜索、每种排序约 600 个作品)
注意:exe 内已含配置与辅助文件,请整目录解压、不要把 exe 单独拷走。
✨ 这个版本能做什么
爬取
- 关键词、画师ID、全量分段(按时间切分突破翻页上限)三种检索
- 内容分级独立开关(全年龄 / R-18 / R-18G)、AIGC 排除/只要
- 发布时间范围(年月日三级联动下拉)、点赞/收藏门槛
- 动图(ugoira)转 webp / gif,画师追更订阅制增量
- 干跑侦察(先看量级再下载)、预估按钮、断点续爬、缺页自动修复
图库管理
- 6 个标签页:爬取 / 追更 / 图库检索 / 图库位置 / 读取能力 / 爬取历史
- 多维检索:原TAG(自动补全+多选)、衍生TAG、画师/画师ID、时间、人气、分级、AIGC
- 衍生标签(自定义标签层 + 自动「第N次爬取」溯源 + 一键导入原TAG)
- 单击预览缩略图(JPG/PNG/WebP)、双击打开原图、安全停止+续跑
- 读取能力体检(登录态/可读量/原图权)+ 三种登录方式(Cookie 导入 / 手动 / OAuth)
可靠性
- 接口结构校验(pixiv 改版时明确报错而不是静默失效)
- 限流自适应、断点续爬、
repair --clean-tags数据清洗 - 自检 selftest(离线 20 项)
⚠️ 已知限制(测试版如实相告)
- pixiv 随时可能改接口 —— 程序会在改版时明确报错,但修复需要更新版本
- 免登录搜索每种排序约 600 个作品;要更多 / 要 R-18 请登录
- 全量模式爬热门关键词可能占用大量磁盘(建议先点「预估」)
- 界面文案、布局仍会调整;语言目前以中文为主,英文版计划中
- Windows 优先;Linux/macOS 可用命令行模式
🐛 遇到问题?
- 提 GitHub Issue,最好附上:做了什么、报错截图/日志、大概什么时间
- 或贴出
selftest(PixivCrawler.exe selftest)输出
🔮 后续计划(不承诺时间)
- 界面中英双语、更细的图库统计
- 标签追更(按关键词订阅增量)
- 代码模块化拆分
- 更多针对不同 Windows 版本的兼容性验证
发布历史:
- v0.9.0-beta(当前):首个打包发布,含本轮全部功能与可靠性加固