微信读书的桌面壳。核心诉求:字号能比网页版最小号更小、能自动翻页、像原生客户端一样管书桌和书架。
网页版微信读书能应付日常阅读,但有两个地方一直难受:
- 最小字号还是太大。字号滑块最小一级 18px,再往小没有档位。
- 没有 PC 客户端,只能挂在浏览器标签页里,摸鱼时容易被 Alt+Tab 暴露(划掉)。
Electron + webview 套一层网页版,这两件事都能就地解决。后来顺手把书桌 / 书架 / 统计做成原生界面,日常阅读不再面对一坨网页 UI。
| 说明 | |
|---|---|
| 常驻左侧栏 | 上部「书桌」列出打开过的书(本地记录,重启仍在);左下角 书架 / 我的 / 设置,可折叠 |
| 无系统标题栏 | 红绿灯嵌进侧栏,侧栏与工具条均可拖动窗口 |
| 点书即读 | 书卡单击直接进阅读;右键或 hover ⋯ → 阅读 / 查看详情 / 查看统计 |
| 多书保活 | 每本打开过的书独立 webview,切书不重载,进度和画布原样保留 |
| 说明 | |
|---|---|
| 字号缩放 | 50%–200% 连续可调(正文是 canvas,靠整体 zoom) |
| 上一页 / 下一页 | 工具条 + ⌘/Ctrl+← / ⌘/Ctrl+→ |
| 单页模式 | 工具条「单页」toggle:收窄窗口消除双页中缝,再点还原原宽度 |
| 自动翻页 | 间隔 3–600 秒,翻页期间阻止系统休眠 |
| 设置记忆 | 缩放比例与自动翻页间隔本地持久化,重启恢复 |
| 跨屏自愈 | 换显示器后自动重绘,修复 canvas 字形错位 |
| 手动重绘 | 工具条 ⟳ 兜底 |
| 失败分级提示 | 区分断网 / 被打断 / 正文超时(可能官方改版),不再一律转圈 |
| 说明 | |
|---|---|
| 原生书架 | 继续阅读 + 全部藏书网格,本地缓存秒开;顶部搜索框按书名/作者过滤 |
| 我的(统计) | 热力图、周/月/年/总时长、阅读偏好、读最久 TOP5、连续打卡 |
| 书籍详情 | 概览 / 书评 / 统计 三 Tab(从右键菜单进) |
| 书桌置顶 | 侧栏书卡右键 → 置顶 / 移除,置顶书排前并本地持久化 |
| 深色模式 | 原生壳 UI 默认跟随系统 prefers-color-scheme;设置 → 外观可固定浅色/深色,并可同步微信读书阅读器夜间模式(写站点自带 wr_theme,切换重载阅读器一次) |
需要两样东西,向导会引导:
- 登录态 Cookie(必须)——扫码登录网页版,书架与阅读用
- API Key(可选)——
wrk-开头,统计看板用;授权页可自动识别,也可粘贴
侧栏底部常驻「书架 / 统计」连接状态。
到 Releases 下载对应平台的压缩包,解压即用:
| 平台 | 包名 | 首次打开 |
|---|---|---|
| macOS · Apple Silicon | WeRead-PC-macOS-arm64-<version>.zip |
解压拖进「应用程序」;未公证,右键 → 打开,或 xattr -cr /Applications/WeRead-PC.app |
| macOS · Intel | WeRead-PC-macOS-x64-<version>.zip |
同上 |
| Windows · x64 | WeRead-PC-win32-x64-<version>.zip |
解压进 WeRead-PC/,双击 WeRead-PC.exe;SmartScreen 提示时选「仍要运行」 |
| Linux · x64 | WeRead-PC-linux-x64-<version>.zip |
解压进 WeRead-PC/,./weread-pc --no-sandbox(便携包内 chrome-sandbox 非 root SUID,需此参数) |
仅 macOS arm64 包在本机经过运行验证;x64 / Windows / Linux 为同源交叉构建,结构一致但未在对应系统实测,遇到问题欢迎提 Issue。
首次启动进入连接向导:扫码登录书架 →(可选)开通统计 API。
npm install
npm startnpm run build # 仅 macOS arm64(复用本地 Electron 运行时)
npm run build:all # 四平台全打(自动下载对应 Electron 运行时)
# 产物 release/WeRead-PC-<platform>-<arch>-<version>.zip构建不依赖 electron-builder:运行时只用 Electron 内置模块,脚本把官方预编译运行时注入源码即可。Windows exe 图标需 rcedit(可选,缺省时窗口图标仍由应用运行时设置)。
截图仅含阅读页 / 设置 / 连接向导,不含个人书架与阅读统计。
阅读页——正文 canvas 渲染,工具条提供字号缩放、翻页、自动翻页、单页与手动重绘:
设置——外观(跟随系统/浅色/深色)、阅读器夜间联动、退出登录与清缓存;Key 仅掩码展示:
首次连接向导——扫码登录书架(必须)+ 开通统计 API(可选):
这个项目最反直觉的发现,是改字号这件事在原理上就不可能用 CSS 实现。
第一版按常规思路注入样式覆盖正文字号,结果:章节标题变了,正文纹丝不动。探针抓真实 DOM:
pCount: 0 // 正文里一个 <p> 都没有
canvasCount: 2 // 两个 canvas,1228×3366,CSS 宽度 614px
bodyInnerText.length: 69 // 整页文本只有 69 个字,全是"首页/我的书架/上一章"
正文渲染在 canvas 上,DOM 里没有正文字符。canvas 是位图,不吃 CSS 排版。
于是只能缩放。缩放也有坑:
webContents.setZoomFactor:DPR 变成非整数(如 2 → 1.8),微信读书按像素坐标画字,小数缩放下字形错位。- 最终方案:只给 canvas 页容器加
zoom:
.wr_canvasContainer { zoom: 0.9 !important; }位图等比缩放,DPR 不变,不会乱码;阅读器工具栏字号也不跟着缩。
窗口拖到另一块 DPR 不同的屏 → devicePixelRatio 变了 → 已画好的 canvas 位图不重绘 → 字形错位。修法:监听 moved,比对显示器 ID,换屏后延迟派发 resize 并抖动窗口高度 1px,逼阅读器重排。
weread-pc/
├── main.js # 主进程:无标题栏窗口、多 webview、缓存 IPC、换屏重绘、防休眠
├── preload.js # contextBridge IPC
├── index.html # 书桌侧栏 + 工具条 + 书架/统计/向导/详情 UI
├── renderer.js # 书桌/热切换/连接向导/缩放/翻页/自动翻页
├── shelf-data.js # 书架 VM(纯函数)
├── shelf-fetch.js # webview 同源取书架 + 缓存编排
├── shelf-view.js # 书架网格、虚拟滚动、书卡右键菜单
├── weread-auth.js # 认证路由(纯函数)
├── weread-api.js # Agent Gateway 客户端 + skill_version 自动跟随
├── stats-data.js # 统计 VM(纯函数)
├── book-detail-data.js # 详情 VM(纯函数)
├── stats-view.js # 统计看板
├── detail-view.js # 详情三 Tab
├── settings-view.js # 设置模态(外观 / 退出登录 / 清缓存 / Key)
├── build.sh # 跨平台打包(macOS arm64/x64 · win32 · linux)
├── assets/icons/ # 应用图标(美短猫书 SVG + PNG + ICNS)
├── test/ # node:test 单测(npm test,62 例)
└── release-notes-v*.md
- Cookie / 登录态:webview 分区
persist:weread,扫码一次,Chromium 自动落盘。 - API Key:
auth.json(manualKey/autoKey),本地明文 JSON,不上传、不入库。 - 书桌列表:壳页面
localStorage。
路径
| macOS 安装版 | ~/Library/Application Support/WeRead-PC/ |
| Windows 安装版 | %APPDATA%/WeRead-PC/ |
| Linux 安装版 | ~/.config/WeRead-PC/ |
| 开发版 | 项目下 .userdata/(gitignore) |
关键文件:auth.json(Key)、Partitions/weread/Cookies(微信读书登录态)。应用内「设置」可退出登录(清 Cookie)与清除本地缓存;彻底删除 = 删这两个文件。.gitignore 已覆盖全部用户数据,仓库无凭据。
⚠️ auth.json与 Cookie 文件在本机磁盘,勿整包外发。
- 正文 canvas 渲染,无法选中复制、无法划词划线。
- 依赖网页版内部类名(
.wr_canvasContainer等),官方改版可能要改选择器。 - 统计 API 的
skill_version已做自动跟随;若官方改接口语义仍需改代码。 - 界面与快捷键以 macOS 为第一公民(
hiddenInset标题栏、红绿灯嵌侧栏);Windows/Linux 可运行但标题栏拖拽区与 UA 仍按桌面 Chrome 上报,未做逐平台精修。 - 阅读时长上报依赖把 UA 伪装成标准桌面 Chrome(见
main.js),属微信读书 ToS 灰色地带,请自行评估使用。
- 记住上次缩放比例(含自动翻页间隔)
- 沉浸式阅读模式
- 按字数而非时间自动翻页
- 书桌手动排序(置顶已支持)


