PixShaft-Win:把 Pixiv 搬上 Windows 桌面
它不是网页套壳,也不是 Electron 应用,而是基于 Pixiv-Shaft、用 Kotlin 与 Compose Multiplatform 写成的 Windows 原生桌面分支。
PixShaft-Win 是 Pixiv-Shaft 的 Windows 桌面分支。上游 Android App 保持原样继续跟随 classic 分支更新,桌面端则在仓库中新增 desktop/ 模块。
项目目前仍在建设中,目标平台是 Windows 10+ x64。它采用 Kotlin + Compose Multiplatform,登录使用系统 WebView2,默认提供面向中国大陆网络环境的直连方案。项目与 Pixiv 官方无关,代码以 GPL-2.0 开源。
一、先看项目结构
这个项目最重要的设计不是“把 Android 界面放大”,而是把平台相关的部分拆开:
app/:上游 Android App,尽量保持原样。shared/:双端共享的 Pixiv App API 客户端、模型和 OAuth。desktop/:Windows 桌面端,包含导航、瀑布流、详情、预览和设置。desktop/webview-auth/:基于 .NET 8 的 WebView2 登录辅助进程。docs/:协议和架构记录。
桌面端代码集中在 desktop/,共享层只做必要增量。这样既能复用上游的网络与业务能力,也能让桌面 UI 按键鼠标、宽屏和窗口管理的习惯重新设计。
二、它和 Android 版有什么不同
桌面端没有照搬底部导航或单列列表,而是围绕大屏重新安排信息密度:侧栏可以收起并悬停展开,内容支持瀑布流、左右分栏和中缝切换。
| 功能 | Windows 桌面端 |
|---|---|
| 浏览 | 瀑布流、左右分栏、页面与滚动位置缓存 |
| 缩放 | Ctrl+滚轮或双指捏合,40%–300% 无极缩放 |
| 排行 | 19 种榜单和日期选择器 |
| 搜索 | 历史、发现、排序、匹配、收藏数和 R-18 筛选 |
| 预览 | 全窗口缩放、拖动、多页翻页和 Esc 关闭 |
| 快捷键 | Ctrl+F 搜索,1–5 切换页签,方向键翻页 |
三、从截图看桌面端
这些截图对应项目 README 中的主要使用路径:从首页进入推荐流,在排行或搜索中定位作品,再进入作品详情、用户页或下载队列。






四、功能重点
浏览与作品详情
首页支持插画和漫画推荐,排行覆盖日、周、月、AI、男性、女性、原创、新人、R-18 等类型。关注页分为插画与漫画、小说两条流,并支持全部、公开和私人筛选。
作品详情支持多 P 页签、缩略图、动图自动播放、漫画阅读器、相关作品翻页、评论浏览与发表,以及收藏、下载和关注联动。用户页提供插画、漫画和收藏三类内容。
精华列与下载
精华列可以保存搜索、作者、关注、相关作品和排行等入口,重启后仍然保留。下载器支持文件名模板、按作者或内容类型分目录、覆盖策略、并发数和本地队列管理,也可以把精华列中的内容批量加入队列。
其它能力
项目还包含多账号、以图搜图、网络自检、FANBOX、pixiv COMIC、本地小说、本地书库、深色模式、强调色和自绘标题栏等功能。不同功能的完成度可能随开发进度变化,项目 README 的功能清单是更准确的现状入口。
五、登录和网络
登录走系统 WebView2,与 Pixeval 使用相近的路线。首次启动需要系统安装 WebView2 Runtime,Windows 11 通常已经自带。
网络部分由 Chromium QUIC 和无 SNI 图片通道组成,项目 README 将其描述为默认面向中国大陆环境的直连方案。网络自检会帮助定位连接问题,但它不意味着所有网络环境都无需额外配置。
这是一个非官方第三方客户端。请遵守 Pixiv 服务条款,尊重创作者版权;下载功能仅用于个人离线欣赏。
六、下载安装与源码构建
普通用户可以前往 GitHub Releases 下载:
PixShaft-Win-x.y.z.msi:推荐的 Windows 安装包,带开始菜单和卸载项。PixShaft-Win-x.y.z.exe:同样的 EXE 安装包。PixShaft-Win-x.y.z-portable.zip:便携版,解压即用,数据与程序同目录。
开发者需要 JDK 17,可以按 README 的方式构建:
git clone https://github.com/normalwindow/Pixiv-Shaft-Win.git
cd Pixiv-Shaft-Win
set JAVA_HOME=C:\path\to\jdk-17
gradlew.bat :desktop:packageReleaseDistributionForCurrentOS构建产物位于 desktop/build/compose/binaries/main-release/。只想运行开发版本时,可以使用 gradlew.bat :desktop:run。
写在最后
PixShaft-Win 没有把“桌面版”理解成简单放大,而是保留上游 Android 客户端的业务基础,再为 Windows 重新处理导航、布局、输入、窗口和发行方式。
项目仍在建设中。想看最新状态、下载构建或提交问题,直接从 GitHub 仓库 开始。