Pixiv-Shaft

项目概述

Shaft 相当于 Pixiv 官方 Android 客户端的一个第三方重制版，区别在于它把热度排序、按收藏量筛选、批量下载和离线快照都做成了免费功能。应用覆盖插画、漫画、小说三类内容，登录后即可浏览推荐、动态、排行榜并按日查看，还能在多个账号之间切换。工程用 Kotlin 编写，基于 Retrofit + RxJava2 组织网络层，本地数据落在 Room 数据库里。当前发行版本 4.9.9，安装包为 PixShaft_4.9.9_classic.apk，源码以 MIT 许可公开。

项目	内容
平台	Android 7.0 及以上
开发语言	Kotlin 2.2.0
发行版本	4.9.9
安装包	PixShaft_4.9.9_classic.apk
许可证	MIT

把浏览、筛选、下载和离线阅读收进一个 App，专门为移动端看图优化。

主要功能

• 多账号切换：同时登录多个账号，侧栏直接切换，本地记录互不干扰
• 三类排行榜：插画、漫画、小说排行榜按日查看，另提供推荐流与热门 TAG
• 离线快照：从收藏批量生成离线快照，支持暂停与继续，浏览记录卡片会标出已快照作品
• 批量下载：多选后统一下载，可导出作品链接，下载队列支持中断后继续
• 小说阅读器：支持 TXT 批量下载，并可切换仅原文、仅译文、原文加译文三种显示
• 评论互动：查看、发表、回复评论，可开启垃圾评论过滤
• 作品筛选：非会员也能按热度排序、按收藏量筛选，搜索条件可持久保存
• 动图支持：GIF 可播放与保存，APNG 动图同样能正常显示
• 深色模式：界面深浅色切换，并提供多国语言

使用流程

1. 首次启动选择登录已有账号或注册新账号
2. 在底栏切换首页推荐、动态、排行榜等入口
3. 点开作品进入大图页，左右滑动翻页
4. 长按作品进入多选，勾选后选择下载或生成离线快照
5. 在下载管理里查看进度，可暂停、继续或删除已完成任务
6. 需要换号时从侧边栏菜单切换账号

适用人群

• 经常用手机看插画与漫画的用户
• 需要离线保存作品的重度收藏者
• 用平板看小说的读者
• 需要多账号分开管理的用户

安装与权限

• 安装包：发行页提供 PixShaft_4.9.9_classic.apk，源码中 applicationId 为 ceui.pixiv
• 最低系统：minSdkVersion 24，对应 Android 7.0
• 目标版本：targetSdkVersion 36，按新版系统的存储与权限模型适配
• 签名冲突：GitHub 版与 Google Play 版签名不同，同一台设备不能覆盖安装
• R-18 显示：需先在 Pixiv 官网账号设置里开启，再到应用内打开对应开关

系统要求

项目	要求
操作系统	Android 7.0（API 24）及以上
编译版本	compileSdk 36、targetSdkVersion 36
构建环境	JDK 21、Kotlin 2.2.0
关键依赖	Retrofit 3.0.0、OkHttp 5.1.0、Room 2.8.0

注意事项

• 大陆网络：内置直连方案沿用 Pix-EzViewer 的思路，网络环境变化时可能需要自备代理
• 存储占用：离线快照与批量下载都会写盘，可在「管理下载关联数据」里查看占用并清理历史
• 账号清理：退出登录或删除账号时可选择清理哪些本地数据，删除后的浏览记录无法恢复
• 包名相同：两个发行渠道的包名一致但签名不同，切换渠道前需先卸载
• 过滤逻辑：全局 R-18 过滤会连同只设阅览限制、未打 R-18 标签的作品一起拦下