脆皮鸭 CPYOS
Read Pico · ESP32-S3CPYOS 0.1.0Open source

脆皮鸭CPYOS / E-INK READING

把晋江、微信读书和一座纸面书架,装进 4.7 英寸墨水屏。

A reading-first e-ink system for the MindReset Read Pico. Native JJWXC and WeRead clients, Chinese input, a refreshed UI, water-ripple page turns and device OTA — built on CrossMux.

01 / FEATURES

不是把手机 App 缩小,
而是重新排一遍。WHAT WE ADDED TO CROSSMUX

01

新版界面 / Refreshed UI

首页只留下真正要看的东西:上次读到、最近阅读、近 7 天阅读和晋江更新。书架、找书、我的共用同一条水线与底部导航。

HOMELIBRARYFINDSETTINGS
02

晋江文学城原生客户端

书架、发现、书籍与作者搜索、高级搜索、收藏夹、章节购买、段评点赞与回复、阅读进度同步。免费章走 App API,VIP 章走完整 WAP 解密链。

JJWXCWAPVIPCOMMENTS
03

微信读书

扫码登录、书架浏览、EPUB 下载与离线阅读、阅读进度同步;本地书、晋江书和微信读书共用一个书架,并显示来源徽标。

WEREADSYNCOFFLINE
04

为中文阅读准备

离线拼音输入与书名搜索、11 种语言断词、GB2312 常用字兜底;支持 SD 卡 TTF / OTF / TTC 与 EPUB 内嵌字体,按书覆盖字体。

PINYINHYPHENATIONFONTSGB2312
05

墨水屏显示

水波纹翻页、黑白快速翻页、状态栏时钟局部刷新、屏幕修复。为 684×1216 面板调过 gamma、波形和异步推屏,尽量少闪、少残影。

WAVEFAST TURNAREA REFRESH
06

体感翻页

倾斜或左右摇晃设备翻页。阈值来自 kiikoread 的手势策略:慢倾斜、回弹、纵向晃动和普通点按都不会误触。

TILTSHAKEIMU
07

本地书库与阅读器

EPUB / TXT / CBZ / FB2,实验性 PDF;书签、批注、词典、阅读统计、待机表盘。成品 EPUB 与章节正文使用设备绑定密钥加密。

EPUBCBZFB2ANNOTATION
08

系统与连接

设备 OTA、SD 卡固件更新、浏览器传书与设置、WebDAV、OPDS、Calibre 无线;33 种 UI 语言按需从数据分区加载。

OTAWEB TRANSFEROPDSi18n
02 / PRINCIPLES

三条取舍。WHAT WE OPTIMISED FOR

01

阅读优先

打开设备先看到上次读到的书,而不是功能网格。翻页、字号、字体和进度是主线;游戏和工具可以等。

02

中文优先

拼音输入、断词、字体回退、晋江和微信读书都按中文阅读习惯设计。英文界面仍然完整,但不再是一切的原点。

03

设备优先

每个功能都按 Read Pico 的 4.7 英寸、16 灰阶、无前光和有限内部内存做取舍;不能在这块板上成立的方案就不放进来。

03 / INTERFACE

界面结构。LAYOUT MOCKUPS, NOT DEVICE CAPTURES

以下为排版与结构示意,不含任何设备上的书籍、账号或网络信息。真机效果以实际固件为准。

04 / DEVICE

只为一台设备。READ PICO / 小纸 PICO

DeviceRead Pico(小纸 Pico,RDP-G01-W)
PanelEWW 4.7" · 684 × 1216 · 16 灰阶 · 约 297 PPI · 无前光
SoCESP32-S3 · 双核 240 MHz · 8 MB PSRAM · Wi-Fi / BT5
Flash16 MB · 2 × 7.19 MiB app 槽 · 1.5 MiB 数据分区
Input电容触摸 + 3 个电容键 · 无 BOOT / RESET 键
Release脆皮鸭 CPYOS 0.1.0 · 预编译包只面向 Read Pico;上游其它目标仍可从源码构建
05 / INSTALL

用浏览器刷机。NO TOOLCHAIN REQUIRED

0.1.0 READ PICO · 2026

这次更新

  • 新版首页、书架与找书界面
  • 晋江书架、发现、段评与购章
  • 水波纹翻页与摇晃翻页
  • 拼音输入与 SD 卡字体
SHA-256 —

选择安装方式

第一次安装、从 CrossMux 1.6.5 或出厂固件切换,用「首次安装」。已经在跑 CPYOS 的设备用「升级」,保留 NVS 和分区表。

这个浏览器不支持 Web Serial。请用桌面版 Chrome 或 Edge。 刷机页必须通过 https 打开;本地预览请用 http://localhost。

首次安装会按完整安装包重建分区表,并要求浏览器擦除芯片。开始前请确认已备份整片 Flash,SD 卡里的书和设置不会被网页刷机删除。

  1. 用 USB-C 数据线连接设备;它应显示为 USB JTAG/serial debug unit。
  2. 点按钮,在串口列表里选择设备,等待写入完成并自动重启。
  3. 串口列表只显示 Read Pico(USB 303A:1001);看不到设备时先换数据线。

设备内 OTA

已经安装 CPYOS 后,直接在设备上更新:

  1. 连接 Wi-Fi。
  2. 打开 设置 → 系统 → 检查更新。
  3. 确认升级后不要断电;完成后设备会重启。

OTA 只写 app0,不动 SD 卡、书库和设置。首次从 CrossMux 1.6.5 升级请使用完整安装包,因为两边的分区表不同。

先备份,再刷机

这是非官方固件。第一次安装前请用 esptool 做一次整片 16 MiB 备份,并把备份文件放在另一台机器上。

python -m esptool --chip esp32s3 read_flash 0x0 0x1000000 readpico-backup.bin

恢复时把整片备份写回 0x0。不要只凭本页的偏移量手动刷写;完整包里的 FLASH.md 和 SHA256SUMS 才是准绳。

06 / CREDITS

站在很多人肩上。THANKS

上游与朋友

KIIKOREAD / APACHE-2.0

kiikoread 的水波纹翻页引擎、TEXTTURN 白→中灰提前回浅、gamma 覆盖 LUT、离线拼音搜索与连续拼音输入、摇晃翻页阈值与判定,均在本项目中标注并移植。移植时按 Read Pico 的内部内存与扫描时序做了改动,具体差异见仓库 patches/。

第三方组件

  • MuPDF 1.26.3(AGPL-3.0):实验性 PDF 阅读。默认 Read Pico 发布包不启用 PDF;启用后的组合按 AGPL-3.0 分发。
  • FreeType(FTL / GPLv2):矢量字体与 CFF / OTF 轮廓。
  • Noto Sans CJK、Source Han Sans(SIL OFL 1.1):中文回退字体与测试字体。
  • pypinyin 0.55.0(MIT)、hyphenation 词典(各自许可证)、Lucide 图标(ISC)。
  • 晋江文学城与微信读书是各自权利人的商标;本项目是非官方客户端,与两家公司及 MindReset 无隶属关系。

许可证

本项目代码以 MIT 发布;第三方组件保留各自许可证。完整清单见仓库的 LICENSE、THIRD_PARTY_NOTICES.md 与 LICENSES/。