NW' Blog
2026年9月6日 · 内容页面

PixShaft-Win:把 Pixiv 搬上 Windows 桌面

它不是网页套壳,也不是 Electron 应用,而是基于 Pixiv-Shaft、用 Kotlin 与 Compose Multiplatform 写成的 Windows 原生桌面分支。

PixShaft-Win:把整个 Pixiv 搬上桌面

GitHub Release GitHub Stars GPL-2.0 License

PixShaft-WinPixiv-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 中的主要使用路径:从首页进入推荐流,在排行或搜索中定位作品,再进入作品详情、用户页或下载队列。

PixShaft-Win 首页推荐流
首页:推荐内容与实时热门标签
PixShaft-Win 排行页面
排行:榜单类型与日期选择
PixShaft-Win 搜索页面
搜索:历史、发现和多组筛选
PixShaft-Win 作品详情页面
作品详情:多页作品、评论和相关内容
PixShaft-Win 用户页面
用户页:插画、漫画和收藏
PixShaft-Win 下载管理页面
下载管理:队列、重试和本地文件

四、功能重点

浏览与作品详情

首页支持插画和漫画推荐,排行覆盖日、周、月、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 的方式构建:

bat
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 仓库 开始。

评论区 留下您的想法
教程