Pixiv 插画批量下载器，由 Lemon 基于 pxder（原作者：Tsuk1ko）使用 Zig 重写。
单二进制分发，无运行时依赖，原生性能，支持交叉编译。
- 按画师 UID 下载全部插画
- 按插画 PID 下载指定作品
- 下载关注画师的作品（公开/私密）
- 下载收藏插画（公开/私密）
- 增量更新已下载的画师作品
- 多线程并发下载（默认 5 线程，最大 32）
- 聚合下载进度显示（降低高并发下的终端刷新开销）
- 自动重试与限流处理
- 断点续传（跳过已下载文件）
- HTTP/HTTPS CONNECT 代理（手动 TLS 隧道）
- 流式下载写盘，避免整张图片先完整进入内存
- 分页抓取 + 固定 worker 池流水线下载
- 代理下载隧道复用，减少重复 CONNECT + TLS 握手
- 热点接口轻量 JSON 定向解析
- 日志系统（
--debug启用详细输出） - OAuth PKCE 登录（模拟 Pixiv Android 客户端）
- Windows
pixiv://协议自动回调 - 跨平台：Windows / Linux / macOS
| 特性 | pxder (Node.js) | pxder-zig |
|---|---|---|
| 运行时依赖 | Node.js >= 16 | 无（单二进制） |
| 安装方式 | npm install -g | 下载对应平台的二进制文件 |
| 代理支持 | HTTP / SOCKS5 | 直连 + HTTP/HTTPS CONNECT |
| 直连模式 | 支持 | 支持 |
| Windows 协议回调 | 支持 | 支持 |
| 配置存储 | 用户目录 | 用户目录 |
| 交叉编译 | N/A | 支持 Windows/Linux/macOS |
需要 Zig 0.16.0。
# Debug 构建
zig build
# Release 构建（推荐）
zig build -Doptimize=ReleaseSafe
# 交叉编译
zig build -Dtarget=x86_64-windows-gnu -Doptimize=ReleaseSafe
zig build -Dtarget=x86_64-linux-musl -Doptimize=ReleaseSafe
zig build -Dtarget=aarch64-macos -Doptimize=ReleaseSafe
# 运行基准测试（推荐 ReleaseFast）
zig build bench -Doptimize=ReleaseFast构建产物在 zig-out/bin/ 目录下。
- Windows:
.\zig-out\bin\pxder.exe - Linux/macOS:
./zig-out/bin/pxder
也可以直接通过：
zig build run -- --helpzig build bench 用于运行本地 benchmark。
仓库内置了几条 GitHub Actions 工作流：
- release.yml：推送
v*标签后自动构建并发布 GitHub Release。 - winget.yml：Release 发布后自动提交 WinGet 更新。
- winget-bootstrap.yml：用于首个版本的 WinGet 提交。
发布前先修改 src/cli/args.zig 中的版本号，然后执行：
git tag vX.Y.Z
git push origin main --tagsWinGet 相关变量：
WINGET_PACKAGE_IDENTIFIERWINGET_CREATE_GITHUB_TOKEN
# 打开浏览器进行 OAuth 登录（推荐）
pxder --login
# 使用已有的 refresh token 登录
pxder --login TOKEN
# 在不支持协议回调的系统上登录
pxder --login --no-protocol登录步骤（默认模式）：
- 程序会自动打开浏览器，访问 Pixiv 登录授权页面
- 登录并授权后，浏览器会弹出对话框，选择"打开"
- 程序自动接收回调，完成登录
登录步骤（--no-protocol 模式）：
- 程序输出 Login URL，手动在浏览器中打开
- 按
F12打开开发者工具，切换到 "Network" 选项卡，勾选 "Preserve log" - 进行登录授权，最终会进入空白页面
- 在 Network 面板中找到最后一个请求，复制 URL 中的
code参数 - 将 code 粘贴到程序中并回车
pxder --logout仅删除当前计算机用户的 refresh token。
pxder --export-token输出当前存储的 refresh token，可用于在其他设备上登录：
pxder --login <exported_token>pxder --setting进入交互式设置界面，可配置以下项目：
[1] Download path 下载目录（必须设置）
[2] Download thread 下载线程数（默认 5，范围 1-32）
[3] Download timeout 下载超时秒数（默认 30）
[4] Proxy 代理设置
[5] Auto rename 自动重命名画师文件夹（跟随画师改名）
代理格式：
<协议>://[用户名:密码@]<IP>:<端口>
示例：
http://127.0.0.1:7890http://user:pass@127.0.0.1:1080https://127.0.0.1:8443
输入空行则从环境变量 all_proxy / https_proxy / http_proxy 中读取。输入 disable 完全禁用代理。
注意：当前下载链路实际支持并验证过的是 http:// 和 https:// CONNECT 代理；socks4/4a/5/5h 语法已预留解析，但尚未实现真实下载通路。
# (1) 按画师 UID 下载（逗号分隔多个）
pxder -u 5899479,724607,11597411
# (2) 下载公开关注的画师
pxder -f
# (3) 下载私密关注的画师
pxder -F
# (4) 增量更新已下载的画师
pxder -U
# (5) 下载公开收藏
pxder -b
# (6) 下载私密收藏
pxder -B
# (7) 按插画 PID 下载（逗号分隔多个）
pxder -p 70593670,70594912-M, --no-ugoira-meta 下载动图时不请求帧延迟元数据
-O, --output-dir <dir> 覆盖下载目录
--force 预留兼容参数（当前版本暂未启用）
--debug 启用详细输出
--no-protocol 登录时不使用 Windows 协议处理器
--output-config-dir 输出配置文件目录路径
-v, --version 显示版本号
-h, --help 显示帮助信息
- 每位画师的作品下载在
(UID)画师名格式的子文件夹中 - 文件命名格式为
(PID)作品名.ext，多图作品追加_p0,_p1后缀 - 动图下载为包含所有帧的 ZIP 压缩包，标注帧延迟信息，如
(PID)标题@30ms.zip - 画师名中的
@及其后内容会被自动去除（通常是摊位信息） - 文件名会过滤 Windows/Linux 不允许的字符
- 已下载的插画会自动跳过
- 单文件最多重试 10 次
- 404 状态码直接跳过（Pixiv 自身问题）
- 连续失败达到阈值时暂停 5 分钟后继续
- 下载到临时目录后校验完整性再移至最终路径
src/
main.zig CLI 入口
auth.zig OAuth PKCE 流程，token 管理
pixiv_api.zig Pixiv API 客户端（认证头、重试、限流）
app/
context.zig 共享上下文（配置、HTTP、API 资源管理）
runner.zig 命令分发
cli/
args.zig CLI 参数类型定义
parser.zig 参数解析
help.zig 帮助信息
commands/
login.zig 登录 / 令牌登录
setting.zig 交互式设置
download_uid.zig 按画师 UID 下载
download_pid.zig 按插画 PID 下载
follow.zig 下载关注画师
bookmark.zig 下载收藏
update.zig 增量更新
export_token.zig 导出令牌
version.zig 版本信息
core/
illust.zig 插画数据模型（单图/多图/动图 URL 构造）
illustrator.zig 画师数据模型，分页逻辑
protocol.zig Windows pixiv:// 协议处理器
services/
download_service.zig 多线程下载引擎
infra/
http/
http_client.zig HTTP 客户端封装（代理 + TLS 隧道）
proxy.zig 代理解析（HTTP CONNECT / SOCKS5）
storage/
config.zig 配置文件读写，跨平台路径解析
fs.zig 文件系统操作（读写、移动、清理）
shared/
terminal.zig ANSI 颜色，终端交互
json_utils.zig JSON 安全解析辅助
tools.zig 文件下载，临时目录管理
crypto.zig SHA-256, MD5, base64url
update_checker.zig 版本检查
- HTTP/TLS：基于
std.http.Client+std.crypto.tls，为代理 HTTPS 路径手动实现 CONNECT 隧道与 TLS 升级，并复用下载隧道 - 并发模型：固定 worker 池 + 分页生产者流水线；每个 worker 维护独立
HttpClient，减少共享状态竞争 - 加密：
std.crypto.hash.Md5（API 签名）、std.crypto.hash.sha2.Sha256（PKCE）、base64url - JSON：热点路径使用定向结构解析，其余场景保留
std.json.Value动态树解析 - 依赖：仅使用 Zig 标准库，无第三方依赖
- Tsuk1ko/pxder — 原始项目，本项目的功能设计参考来源
本项目基于 GNU General Public License v3.0 开源，与原项目保持一致。
