在安卓手机上浏览 Pixiv 的插画、漫画和小说（Pixiv-Shaft）

Pixiv 上的插画、漫画和小说分散在不同入口，官方客户端能做的操作有限，想批量保存一套作品，或者把小说存到本地慢慢读，往往要绕几步。Pixiv-Shaft 从 2019 年 4 月开始开发，仓库主语言是 Kotlin，默认分支为 classic，Android 7.0 及以上系统可以安装。

Pixiv-Shaft 是一个用 Kotlin 写的开源安卓客户端，可浏览 Pixiv 的插画、漫画和小说，支持批量下载、断点续传与本地收藏，免费且无广告。

使用者通常是每天泡在 Pixiv 上的读者和收藏者。除了主站，它还把 FANBOX 和 pixiv COMIC 的内容接进应用内；图片加载不畅时可以在应用里切到镜像站或自建反向代理，也可以跑一次网络自检，看是哪一环出了问题。

基础用法

安装与依赖

项目在 Google Play 上架，包名是 ceui.pixiv.pshaft，也可以从 GitHub Releases 下载 APK 侧载。README 标注的系统要求是 Android 7.0+。仓库地址是 CeuiLiSA/Pixiv-Shaft，许可证为 GNU General Public License v2.0（GPL-2.0），主要语言 Kotlin。

对安装包完整性有要求的话，Issue 记录里有人请求为 Release 增加 SHA-256 哈希，该条已标记为已解决。仓库另有 FAQ-install.md（1.8 KB）和 FAQ.md（6.2 KB）两份文档，安装与常见问题可以先翻这两份。

从源码编译的话，仓库根目录有 gradlew、build.gradle、settings.gradle，语言占比为 Kotlin 82.2%、Java 14.7%、HTML 2.1%。README 节选中没有给出源码构建的具体步骤，这一步仓库里没有说明。

最短能跑通的示例

从安装到打开这一段，仓库没有提供命令行形式的步骤，按 Release 说明与文档描述整理的路径大致是：

从 Google Play 搜索 pixiv shaft，或到 GitHub Releases 下载最新 APK
安装并打开（Android 7.0 及以上）
用 Pixiv 账号登录
首页加载推荐流与排行榜
在设置里跑一次网络自检

写作时的最新版本是 v4.9.5（2026-09-28）。登录环节出过问题，细节写在下面的坑一节里。

确认它跑起来了

判断这一跑是否成功，看三个地方。首页出现个性化推荐流与排行榜轮播，说明 App API 通了；下载队列页面能看到任务，说明写入路径可用；设置里的网络自检页会把 DNS、App API、web 端点和一次真实图片下载逐项检查，IPv6 污染会在这一页被点出来。

下载文件的落盘位置由 SAF 指定的保存路径决定，本地收藏镜像存在应用自己的数据里，图片缓存上限可以在设置中调整。

主要功能

浏览、搜索与阅读

• 首页与排行榜：排行榜分日/周/月，带日期选择器，可以翻回任意一天；发现页里另有收藏榜、AI 榜、时代榜、壁纸榜、标签区和画师榜。首页推荐支持插画、漫画、小说三类的个性化流，首页底栏跟随列表滚动收起，上滑恢复。
• 搜索与筛选：提供六种排序，可按投稿时间、收藏数区间、宽高比和分辨率筛选，AI 作品有三分支开关；按人气排序不需要 Pixiv Premium。搜索结果页在 v4.9.5 里加了一键置顶当前标签组合。
• 以图搜源：内置 SauceNAO、TinEye、IQDB、Ascii2D 四个入口，一次点击跳转。
• 小说与漫画阅读：小说阅读器支持系列、章节、收藏与进度百分比，会把相关插画自动混排；可以指向一个文件夹读本地 txt，收藏时把整篇小说存成 TXT，默认导出 TXT 时可自动改存 EPUB。v4.9.5 补上了系统 TTS 朗读、单手翻页、自定义文字颜色和防误触模式。漫画按章阅读，支持双向翻页与整系列翻译。翻译功能接入云端 OpenAI（gpt-5.6-luna），覆盖评论、标题、标签和漫画，属于灰度接入，小说暂不支持。
• FANBOX 与 pixiv COMIC：FANBOX 是原生实现，动态流、推荐创作者、正文与方案都在应用内，不用跳浏览器；pixiv COMIC 的首页同样在应用里。

下载、本地与网络

• 批量下载与断点续传：整套作品可以一次性入队，网络中断后从断点续传；支持命名模板批量重命名、导出作品说明文字，也可以把任务交给 NAS 上的 aria2。
• 屏蔽、稍后再看与本地收藏：屏蔽可按标签和按画师分别管理，也能就地屏蔽单个作品，被屏蔽的卡片会做模糊处理，点击展开。稍后再看纯粹存在本地，不上报。我的收藏支持整份镜像到本地，可倒序、按宽度比例排序和多维筛选，小说同样支持。
• 网络自检与图片镜像：自检页检查 DNS、App API、web 端点与真实图片下载；图片源可以切到 pixiv.cat、pixiv.re、pixiv.nl 或自己的反向代理，也可以用自建的 App API 代理。

参数与配置

常用参数

可调项集中在应用设置里。v4.9.5 新增的有：标签原文亮暗度、预测性返回逐页控制、悬浮按钮靠左或靠右、收藏振动、多图自动展开、图片缓存上限。

平板双栏排版默认关闭，需要在设置中开启，开启后横屏是左列表、右详情。同时该版本把「我的收藏」做成了本地镜像，可排序，也能按名字和作品标签搜索；「我的关注」同样有本地镜像，收藏库同步过程中即可浏览。

下载相关的可调项包括命名模板、说明文字导出开关、aria2 远程下载地址。屏蔽规则分标签和画师两个维度管理，热门标签也会按屏蔽规则过滤。网络相关的可调项是图片源与 App API 代理地址。

配置文件

应用层没有对外的配置文件，开关都在设置界面里改。仓库根目录的 build.gradle、gradle.properties、settings.gradle 是构建配置，不是运行配置。

有一处例外：垃圾评论过滤规则以资源文件的形式内置在 app/src/main/assets 目录下，规划随后续 Release 一起发布生效。

实际使用中的坑

• 登录失败：有用户反馈用用户名和邮箱都登不进去，新账号同样，注册按钮一直转圈。该 Issue 已标记为已解决。
• 安卓 11 上闪退重载：有反馈称 3.1.5 版本之后偶尔闪退重载，该条已解决。v4.9.5 也修了网络请求随机崩溃、Play 包侧载、老版 WebView、聊天初始化等多处崩溃。
• 保存路径：早期请求的用 SAF 指定保存路径已实现，下载位置由系统文件选择器决定。找不到文件时，先看下载队列里记录的路径。
• 垃圾评论屏蔽规则仍在征集：过滤垃圾评论功能已实装，入口在设置-常规-过滤垃圾评论，目前以域名匹配为主，因为垃圾评论一般是发链接的。规则会随版本更新，该 Issue 保持开放，可以回复补充，也可以直接提 PR。这条属于待解决状态。

几个同类怎么选

这三者在「安卓平台上的第三方客户端、不需要自建服务器」这一点上重合，做的事并不相同。Pixiv-Shaft 真正不如那两个小工具的地方在于它绑定了 Pixiv 的账号与接口：登录不上、接口变动、账号被限制，应用里的大半功能就用不了，而 Share-My-Thing 和 FoodExpirationDates 完全本地运行，不受第三方服务状态影响。如果你只要把一条链接发给对面，或者记一记家里的食材有效期，别装 Shaft，那两个更省事。反过来，要浏览、搜索、下载 Pixiv 的内容，那两个替代不了它。

合规限制

Pixiv-Shaft 是 Pixiv 的第三方客户端，README 里写明所有插画、漫画和小说版权归各自创作者或 Pixiv 所有，项目本身以学习与交流为目的开源。

批量下载、断点续传、本地收藏这些能力用在个人备份上没有争议，把下载到的作品重新分发、打包出售或者上传到公开网盘，会直接侵犯创作者权益，也可能连带影响你自己的账号。

账号登录走的是 Pixiv 的接口，使用非官方客户端本身存在账号受限的可能，README 没有对这一点作出保证。以脚本方式高频请求同样可能触发平台侧的风控。

适合谁

适合每天刷 Pixiv 的安卓用户，尤其是需要批量下载、断点续传、把小说漫画存到本地慢慢读的人；也适合想在一个应用里同时看主站、FANBOX 和 pixiv COMIC 的人，以及网络环境不稳、需要自己切换图片源和代理的人。

不适合只想偶尔看几张图、不愿意登录 Pixiv 账号的人；不适合对第三方客户端风险敏感、只肯用官方 App 的人；也不适合需要 iOS 或桌面端的用户，这个项目只有安卓版本。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.5 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。