🎨 PixEz Flutter：12k Stars免代理P站客户端支持动图Ugoira

PixEz Flutter是12.4k Stars的第三方Pixiv客户端,Flutter跨平台打造,支持中国大陆免代理直连。首创Ugoira动图播放、原生搜索+排行榜+关注-feed、多语言界面,Android/iOS/macOS/Windows全平台,开源免费GPL-3.0。

🎤 引言

喜欢逛 Pixiv 的同学,肯定被官方的 App 折磨过 —— 界面卡、功能少、动图(Ugoira)根本没法好好看。

第三方客户端倒是不少,但要么只支持 Android,要么在中国大陆根本没法直连,还得挂代理。

今天安利的 PixEz Flutter 解决了上面所有痛点 —— Flutter 写的跨平台 Pixiv 第三方客户端,支持中国大陆免代理直连,能流畅播放 Ugoira 动图,而且还是开源的。

GitHub 上 12.4k Stars / 449 Forks,最新版本 v0.9.104(2026-06-26),GPL-3.0 开源,2,035 次提交,179 个 releases,质量相当稳。

支持 Android / iOS / macOS / Windows 四大平台,国内开发者可能拿来参考 Flutter 跨平台实战也很有价值。

⭐ 核心功能

1. 中国大陆免代理直连(核心亮点)

这是 PixEz 区别于大多数 Pixiv 第三方客户端的核心差异。支持:

SNI 绕过(ECH):针对 Cloudflare 的加密 SNI 技术,国内可直接连接 Pixiv 服务器
DNS 优化:内置 AliDNS / DNSPod 适配,解决 CDN IP 被墙的问题
多节点自动切换:连接失败时自动尝试其他节点

不用挂代理、不用刷 IP,打开 App 就能直接刷画师作品。

2. Ugoira 动图原生支持

Ugoira 是 Pixiv 独有的动图格式,本质是一组带时间轴的 JPEG 图片序列。官方 App 播放卡顿,很多第三方干脆不支持。

PixEz 用 Flutter custompainter 自绘引擎实现 Ugoira 帧序列渲染,特点:

支持播放/暂停/逐帧控制
自动识别帧率,流畅度接近原生
内存占用比 WebP/GIF 方案更小

3. 搜索功能

支持多种搜索方式:

关键词搜索:输入 tag、画师名,作品标题
ID 精准搜索:输入作品 ID、画师 ID、角色 ID 直接跳转
排行榜:日榜/周榜/月榜/R18 榜
关注者最新:首页直接显示关注画师的最新作品
搜索历史:常搜关键词保留在搜索栏

4. 作品管理

收藏/收藏夹:支持多个收藏夹管理
屏蔽功能:屏蔽特定画师、tag 或作品,眼不见为净
下载:作品打包下载,支持原图和压缩格式
历史记录:浏览历史可追溯

5. 多平台覆盖

平台	安装渠道
Android	Google Play / GitHub Releases / 蓝奏云(国内)
iOS	App Store(美区)
Windows	Nightly MSIX
macOS	源码编译 / Homebrew

6. 国际化

内置多语言支持:

简体中文/繁体中文
日语
英语
印尼语

📥 安装与使用

Android 安装

方式一:Google Play(推荐)
直接在 Google Play 搜索 PixEz 下载,自动更新。

方式二:GitHub Releases

# 访问 releases 页面下载最新 APK
https://github.com/Notsfsssf/pixez-flutter/releases/latest

方式三:蓝奏云(国内用户)
国内直连下载,免翻墙,但不推荐长期使用(版本可能滞后)。

iOS 安装(App Store 美区)

由于 App Store 地区限制,iOS 版本需要切换到美区账号下载:

退出当前 Apple ID
登录美区 Apple ID(或注册新账号)
搜索 "PixEz" 下载

Windows 安装

# 下载 MSIX 安装包
https://github.com/Notsfsssf/pixez-flutter/releases

Windows 版本为 Nightly 构建,更新较频繁,安装后记得定期检查更新。

登录 Pixiv 账号

首次打开 App,点击登录,使用 Pixiv 账号(OAuth2.0 授权流程),无需输入密码,安全快捷。

登录后可解锁:

关注画师动态
收藏作品
评论/点赞

🎨 技术架构

Flutter 跨平台设计

项目用 Flutter 写 UI,核心特点:

Hot Reload:开发时所见即所得,极大缩短调试周期
PlatformChannel:各平台调用原生能力(如 iOS 的 PhotoKit 做相册保存)
状态管理:从 flutter_bloc(逐步弃用)迁移到 mobx,另有 provider 做依赖注入

Ugoira 播放实现

// 核心思路:CustomPainter 逐帧绘制
class UgoiraPainter extends CustomPainter {
  final List<Uint8List> frames;
  final int currentFrame;
  final int frameDelay;

  @override
  void paint(Canvas canvas, Size size) {
    // 根据 currentFrame 绘制对应 JPEG 数据
    // 通过 frameDelay 控制帧率
  }
}

相比 GIF 和 WebP,Ugoira 的 JPEG 序列方案体积更小,但需要 App 端自己做帧控制。

HTTP 请求层

项目自研 plugins/rhttp,处理:

SNI 伪装
证书校验绕过
自动降级(直连 → SNI → 代理)

⚠️ 注意事项

iOS 版本需美区账号:由于 App Store 地区限制,iOS 版需要切换到美区 Apple ID 才能下载和更新,比较麻烦。
ECH 功能在部分地区受限:如果你的网络环境完全阻断 Cloudflare ECH 域名(如 cloudflare-ech.com 被墙),需要关闭 ECH 功能并改用 AliDNS/DNSPod 才能直连。
Windows 为 Nightly 版:Windows 客户端是自动构建的每日版,可能有偶发性 Bug,不建议作为主力平台。
非官方客户端风险:Pixiv 官方不保证 API 兼容性,App 可能因 Pixiv 后端更新而出现登录失败或功能失效,遇到问题多关注 GitHub Issues。
数据隐私:App 会连接 Google Firebase(推送)和 Google Play Core(内购),介意的话建议用 GitHub 发布的 APK 版(蓝奏云版也可能内置非必要组件)。
R18 内容:App 支持 R18 内容浏览,但请遵守各地法律法规,未成年人请自觉跳过相关内容。
贡献需谨慎:项目接受 PR,但因为 state management 正在从 flutter_bloc 迁移到 mobx,新功能最好先看最新代码分支再动手。

✅ 总结

PixEz Flutter 是目前功能最全、社区最活跃的第三方 Pixiv 客户端之一。

优点:

中国大陆免代理直连,SNI+ECH+多 DNS 适配,国内体验最友好
Ugoira 动图原生播放,CustomPainter 帧序列渲染,流畅度接近原生
Flutter 跨平台,一份代码跑 Android / iOS / macOS / Windows
多语言支持,中文界面,国内用户无门槛
搜索+排行榜+关注-feed 功能完整,体验比官方 App 强
开源免费,GPL-3.0,可二次开发

缺点:

iOS 需要美区账号,更新不便
Windows 为 Nightly 构建,稳定性不如正式版
连接 Google Firebase,隐私敏感用户需要注意
依赖 Pixiv 非公开 API,存在被封风险

推荐指数 ⭐⭐⭐⭐(4/5)
适合:国内 Pixiv 用户、iOS 党、想要更好浏览体验的画师粉丝、Flutter 跨平台开发学习者。
不适合:极度注重隐私(不想连 Google 服务)、只用官方 App 不折腾的用户。

仓库:github.com/Notsfsssf/pixez-flutter
最新版本:v0.9.104 (Jun 26, 2026)
交流群:Telegram @PixEzViewer | Discord @PixEz
反馈邮箱:PxezF[email protected]