Repository navigation
Releases
WeRead PC v0.9.0
WeRead PC v0.9.0
侧栏阅读时长一眼可见 + 连接状态徽章化,刷新节奏可控、不频繁打接口。
新增
- 侧栏阅读时长卡片:书桌下方常驻「今日 / 本周 / 本月」三列时长,复用统计看板缓存派生(今日按日期 key 匹配,跨天/跨月缓存不会拿错日期),未配置统计 Key 时自动隐藏
- 低频刷新:缓存秒显,
fetchedAt超过刷新间隔才拉一次接口;打开统计页顺带同步侧栏,不产生额外请求 - 刷新间隔可配置:设置 → 数据与缓存 →「侧栏阅读时长刷新间隔」,5–240 分钟(默认 30),本地持久化,改完立即重启定时器
- 手动刷新:卡片标题行 ⟳ 按钮强制刷新(不受间隔限制),拉取期间置灰防连点,悬停显示上次更新时间
体验优化
- 阅读时长改为圆角卡片 + 三列数值格(数值在上、标签在下),今日数字主题色突出,等宽数字、超长省略不撑破
- 书架 / 统计连接状态改为并排小徽章:已连接绿底绿点,未连接中性底 + 蓝色「去登录 / 去开通」;折叠侧栏时只留状态点竖排,不再溢出
- 刷新图标统一换成 SVG 环形箭头(与翻页箭头同款线条风格):阅读工具栏重绘按钮 16px、侧栏刷新 14px,点击区扩大,替换原先偏小的文本 ⟳
- 清除本地缓存时同步隐藏侧栏时长卡片
下载与安装
| 平台 | 包 | 首次打开 |
|---|---|---|
| macOS · Apple Silicon | WeRead-PC-macOS-arm64-0.9.0.zip |
拖进「应用程序」;未公证,右键 → 打开,或 xattr -cr /Applications/WeRead-PC.app |
| macOS · Intel | WeRead-PC-macOS-x64-0.9.0.zip |
同上 |
| Windows · x64 | WeRead-PC-win32-x64-0.9.0.zip |
解压进 WeRead-PC/,双击 WeRead-PC.exe;SmartScreen 选「仍要运行」 |
| Linux · x64 | WeRead-PC-linux-x64-0.9.0.zip |
解压进 WeRead-PC/,./weread-pc --no-sandbox |
验证状态:macOS arm64 包已本机运行验证(侧栏卡片真实数据、手动刷新强制取数、间隔设置持久化与定时器重启、折叠态徽章、67 例单测全过);其余平台为同源交叉构建,结构一致但未在对应系统实测。Linux 便携包内 chrome-sandbox 非 root SUID,需
--no-sandbox启动。问题欢迎提 Issue。
从源码运行
npm install
npm start
npm test # 67 例单测WeRead PC v0.8.0
WeRead PC v0.8.0
体验打磨 + 夜间模式联动,并首次提供 四平台 下载包(macOS arm64/x64 · Windows x64 · Linux x64)。
新增
- 应用外观开关:设置 → 外观,跟随系统 / 浅色 / 深色,选择本地持久化;壳 UI 颜色收敛为 CSS 变量,默认跟随系统
prefers-color-scheme - 阅读器夜间联动:应用切深色时同步微信读书阅读器夜间模式——写站点自带的
wr_themecookie(等同点站点自己的夜间按钮,不注入 CSS),可在设置里关闭同步 - 书架搜索:顶部搜索框按书名 / 作者本地过滤,计数联动,清空即还原
- 书桌置顶:书卡右键 → 置顶 / 取消置顶,置顶持久化并排前显示
- 设置自助维护:新增「退出登录」(清 Cookie,保留统计 Key)与「清除本地缓存」
- 单页模式 toggle:工具条「单页」收窄窗口消除双页中缝,再点还原进单页前的宽度
体验修复(P0)
- 缩放比例与自动翻页间隔写入本地,重启后恢复
- book webview 检测登录页跳转:登录态过期时更新连接状态并提示就地扫码
- 加载失败分级提示:区分断网 / 被打断 / 正文超时(可能官方改版),不再一律转圈
- 首次气泡文案对齐「单击直接阅读,右键看详情 / 统计」
夜间联动稳定性(多轮修复)
wr_theme是站点 cookie 而非 localStorage:改为比对 / 写入 cookie + 镜像 localStorage- 写入前清 host / domain 双级旧 cookie,消除无限重载
- 阅读页判断移入 guest 脚本(宿主
getURL重载后不可靠) - 同一目标值每页只注入一次,消除并发重复 reload
清理
- 删除永不生效的「自动取 Key」死路径(
AUTO_KEY_ENDPOINT/tryAutoKey/ 重新获取 Key 按钮);授权页wrk-自动抓取与手动粘贴仍保留
多平台打包
build.sh 重写为跨平台:复用 / 下载官方 Electron 预编译运行时注入源码,无需 electron-builder。
npm run build # 仅 macOS arm64
npm run build:all # 四平台全打下载与安装
| 平台 | 包 | 首次打开 |
|---|---|---|
| macOS · Apple Silicon | WeRead-PC-macOS-arm64-0.8.0.zip |
拖进「应用程序」;未公证,右键 → 打开,或 xattr -cr /Applications/WeRead-PC.app |
| macOS · Intel | WeRead-PC-macOS-x64-0.8.0.zip |
同上 |
| Windows · x64 | WeRead-PC-win32-x64-0.8.0.zip |
解压进 WeRead-PC/,双击 WeRead-PC.exe;SmartScreen 选「仍要运行」 |
| Linux · x64 | WeRead-PC-linux-x64-0.8.0.zip |
解压进 WeRead-PC/,./weread-pc --no-sandbox |
验证状态:macOS arm64 包已本机运行验证(启动 → 壳 UI → webview 到达书架);macOS x64 已校验架构与签名;Windows / Linux 为同源交叉构建,结构一致但未在对应系统实测。Linux 便携包内 chrome-sandbox 非 root SUID,需
--no-sandbox启动。问题欢迎提 Issue。
从源码运行
npm install
npm start
npm test # 62 例单测v0.7.0
WeRead PC v0.7.0
首次使用引导补齐,窗口去掉系统标题栏,点书直接进阅读。
新增
- 首次连接向导:两步引导——登录微信读书书架(必须,扫码)、开通统计 API(可选,
wrk-Key 自动识别 + 手动粘贴) - 侧栏连接状态:常驻「书架 / 统计」绿点,可点击回到向导
- 右键菜单:书卡右键或 hover
⋯→ 阅读 / 查看详情 / 查看统计 - 书桌:原「上次打开」改名,语义更准
体验
- 去系统标题栏(hiddenInset),红绿灯嵌入侧栏,侧栏/工具条可拖窗
- 单击书 = 直接阅读;详情抽屉只从菜单进
- 工具栏按钮现代化,并精简「模式 / 书架」冗余入口
修复
- 退出登录后状态仍显示已连接(改为在线
shelf/sync为准;有缓存时乐观显示,避免灰→绿闪烁) - 点「去登录」进不去扫码页(向导误盖住登录 webview)
- 登录成功后 webview 占满主区不回原生书架
安装
下载 WeRead-PC-macOS-arm64-0.7.0.zip,解压得到 WeRead-PC.app,拖进「应用程序」即可。
⚠️ 首次打开会被 Gatekeeper 拦截(未做 Apple 公证)。解决方式二选一:
- 右键点击 App → 选择「打开」→ 再点一次「打开」
- 或在终端执行:
xattr -cr /Applications/WeRead-PC.app
系统要求:macOS,Apple Silicon(arm64)。Intel 机器需要自行改用 x64 运行时。
从源码运行
npm install
npm start打包:
npm run build
# 产物 release/WeRead-PC-macOS-arm64-0.7.0.zipv0.6.0
WeRead PC v0.6.0
首页整体重构成「左侧常驻栏 + 右侧内容区」的微信式布局:书不再乱跳、切书不重载、侧栏可折叠。
新增
- 常驻左侧栏
- 上部「上次打开」:本地记录的打开过书籍(封面+书名+作者),重启仍在
- 左下角导航:
书架/我的(阅读统计)/设置,图标+文字居中 - 可折叠:右缘显著把手
⟨/⟩,折叠后导航只剩图标、书只剩封面小图
- 点书仅右侧切换:左栏不动,loading 只盖主区;已打开的书走多 webview 保活秒切,不重载
- 列表位置固定:点书只高亮,不再置顶乱跳
修复
- 「全部藏书」网格在书架隐藏时初始化导致 0 宽单元格(竖条假残影)
- 封面加载失败显示 alt 竖排文案;网格改 top 定位减少拖影
- 侧栏折叠与主区宽度不同步引起的合成层残影
- 从书架点侧栏当前书被忽略、右侧不切换
- 「我的 / 书架」异步刷新抢视图导致来回闪烁
安装
下载 WeRead-PC-macOS-arm64-0.6.0.zip,解压得到 WeRead-PC.app,拖进「应用程序」即可。
⚠️ 首次打开会被 Gatekeeper 拦截(未做 Apple 公证)。解决方式二选一:
- 右键点击 App → 选择「打开」→ 再点一次「打开」
- 或在终端执行:
xattr -cr /Applications/WeRead-PC.app
系统要求:macOS,Apple Silicon(arm64)。Intel 机器需要自行改用 x64 运行时。
从源码运行
npm install
npm start打包:
npm run build
# 产物 release/WeRead-PC-macOS-arm64-0.6.0.zipv0.5.0
WeRead PC v0.5.0
这一版把阅读变成了「多书并行」:左侧在读侧栏可快速切换,书页后台保活,切换不重载。
新增
- 阅读左侧「在读」侧栏:列出本会话打开过的书,高亮当前在读;点书快速切换,✕ 关闭(关当前则切下一本或回书架);侧栏底部可一键回首页
- 多 book webview 后台保活:每本在读书独立 webview,切走只隐藏不销毁,进度/画布/滚动原样保留;再点回是热切换,不闪 loading
- 侧栏顺序固定:按首次打开顺序排列,点击切换不再乱跳
其他
- 应用图标定稿为银虎斑美短正脸(圆脸宽颊 + 经典涡纹 + 绿眼)
- 首页(书架/统计)保持独立视图,阅读侧栏不侵入首页
安装
下载 WeRead-PC-macOS-arm64-0.5.0.zip,解压得到 WeRead-PC.app,拖进「应用程序」即可。
⚠️ 首次打开会被 Gatekeeper 拦截(未做 Apple 公证)。解决方式二选一:
- 右键点击 App → 选择「打开」→ 再点一次「打开」
- 或在终端执行:
xattr -cr /Applications/WeRead-PC.app
系统要求:macOS,Apple Silicon(arm64)。Intel 机器需要自行改用 x64 运行时。
从源码运行
npm install
npm start打包:
npm run build
# 产物 release/WeRead-PC-macOS-arm64-0.5.0.zipv0.4.0
WeRead PC v0.4.0
这一版换了新应用图标,修掉了安装版统计页「未连接」和 Dock 旧图标两个硬伤,并给网关 Skill 升级加了兼容层。
新增
- 阅读页模式切换:顶栏「模式」按钮,一键切换微信读书的「上下滚动 / 翻页」;由主进程注入真实鼠标事件点按阅读页内官方控件(合成 click 无效),并能唤出自动隐藏的工具栏
- 新应用图标:美短银虎斑猫窝在书里;打包时自动注入 ICNS,可执行文件同步改名为
WeRead-PC
修复
- 安装版统计页报「未连接」:
userData落在~/Library/Application Support/WeRead-PC,不再写进.app包内;首次运行自动从旧目录迁移登录态 / API Key / 缓存 - Dock 显示 Electron 旧图标:可执行文件改名为产品名,双写
WeRead-PC.icns+electron.icns - 统计页闪一下又未连接:网关
skill_version升级提示不再丢弃已取到的业务数据;skill_version升到 1.0.5 - 状态栏按钮换行:长文案不再把工具按钮挤成两行
兼容
- Skill 版本自动跟随:解析网关
upgrade_info.latest_version并记忆;旧版本号请求失败时用新号自动重取一次。后续微信读书再升 Skill 版本,一般无需改代码
安装
下载 WeRead-PC-macOS-arm64-0.4.0.zip,解压得到 WeRead-PC.app,拖进「应用程序」即可。
⚠️ 首次打开会被 Gatekeeper 拦截(未做 Apple 公证)。解决方式二选一:
- 右键点击 App → 选择「打开」→ 再点一次「打开」
- 或在终端执行:
xattr -cr /Applications/WeRead-PC.app
系统要求:macOS,Apple Silicon(arm64)。Intel 机器需要自行改用 x64 运行时。
从源码运行
npm install
npm start打包:
npm run build
# 产物 release/WeRead-PC-macOS-arm64-0.4.0.zipWeRead PC v0.3.0
WeRead PC v0.3.0
这一版聚焦阅读统计看板:支持周 / 月 / 年三个维度筛选,指标与图表随维度联动,并把时长精度做到了分钟。
新增功能
- 维度筛选(周 / 月 / 年):看板顶部新增维度 Tab,切换时指标卡与热力图 / 分布图整体联动;切换走本地缓存视图模型重解析,无需重新取数,秒切
- 指标卡四槽随维度变化:总时长、日均、环比(周环比上周 / 月环比上月 / 年环比去年)、阅读天数,均按当前维度呈现
体验优化
- 时长精度到分钟:指标卡与分布图统一采用
Xh/YhMMm/Nm格式,周维度柱状图涵盖分钟 - 年热力改为滚动 12 个月:不再固定日历年,始终以最近一年按月展示
- 勋章墙去重:同名勋章合并计数,溢出折叠为「等 N 种」,解决此前重复标题刷屏
安装
下载 WeRead-PC-macOS-arm64-0.3.0.zip,解压得到 WeRead-PC.app,拖进「应用程序」即可。
⚠️ 首次打开会被 Gatekeeper 拦截(未做 Apple 公证)。解决方式二选一:
- 右键点击 App → 选择「打开」→ 再点一次「打开」
- 或在终端执行:
xattr -cr /Applications/WeRead-PC.app
系统要求:macOS,Apple Silicon(arm64)。Intel 机器需要自行改用 x64 运行时。
WeRead PC v0.2.0
WeRead PC v0.2.0
在 v0.1.0「能读、能翻页」的基础上,这一版把壳补成了完整的桌面客户端:原生书架首页、阅读统计看板、书籍详情侧栏,以及一批阅读体验打磨。
新增功能
- 原生书架首页:清爽网格取代官方网页书架,本地缓存秒开;带「继续阅读」入口,书卡虚拟滚动
- 阅读统计看板:阅读热力图、阅读时长、类型偏好、书籍 TOP5、打卡记录;数据经微信读书 Agent Gateway 实时获取
- 书籍详情侧栏:单击书卡看元信息 / 热门书评 / 本书统计,双击直接进阅读;✕ 或 Esc 关闭
- 设置模态:连接状态、手动 API Key 与 Cookie、缓存管理、隐私说明
- 认证升级:优先走 Agent Gateway 自动取 Key,失败回退手动配置;Key 展示掩码
阅读体验
- 默认单页:默认窗口宽 1000px,阅读器自动单页,消除双页中缝(手动拉宽仍可双页)
- 悬浮翻页钮:右下角两个圆形上一页 / 下一页按钮,鼠标翻页更顺手
- 正文边距:单页模式正文两侧边距收敛到 40px,版式更饱满;双页模式自动恢复网页版原版式
- 详情侧栏关闭:关闭按钮常驻侧栏头部行内,另支持 Esc
安装
下载 WeRead-PC-macOS-arm64-0.2.0.zip,解压得到 WeRead-PC.app,拖进「应用程序」即可。
⚠️ 首次打开会被 Gatekeeper 拦截(未做 Apple 公证)。解决方式二选一:
- 右键点击 App → 选择「打开」→ 再点一次「打开」
- 或在终端执行:
xattr -cr /Applications/WeRead-PC.app
系统要求:macOS,Apple Silicon(arm64)。Intel 机器需要自行改用 x64 运行时。
从源码运行
npm install
npm start打包
npm run build # 产出 release/WeRead-PC-macOS-arm64-<version>.zip已知限制
- 统计看板与详情书评依赖微信读书 Agent Gateway(需自动取 Key 成功或手动配置)
- 未做 Apple 公证,首次打开需右键绕过
- 仅提供 macOS arm64 产物
v0.1.0 — 首个可用版本
WeRead PC v0.1.0
微信读书的桌面壳,基于 Electron + webview。核心解决两件事:字号能比网页版最小号更小、能自己翻页。
功能
- 完整网页版阅读:登录态持久化,扫码登录一次即可
- 字号缩放 50%–200%:默认 90%(≈16px,小于网页版最小的 18px),连续可调
- 上一页 / 下一页:顶栏按钮 +
⌘+←/⌘+→快捷键 - 自动翻页:间隔 3–600 秒可调,翻页期间阻止系统休眠
- 跨屏自愈:窗口拖到另一块屏幕后自动重绘,修复正文错位
- 手动重绘:工具栏「重绘」按钮,兜底渲染异常
安装
下载 WeRead-PC-macOS-arm64-0.1.0.zip,解压得到 WeRead-PC.app,拖进「应用程序」即可。
⚠️ 首次打开会被 Gatekeeper 拦截(未做 Apple 公证)。解决方式二选一:
- 右键点击 App → 选择「打开」→ 再点一次「打开」
- 或在终端执行:
xattr -cr /Applications/WeRead-PC.app
系统要求:macOS,Apple Silicon(arm64)。Intel 机器需要自行改用 x64 运行时。
从源码运行
npm install
npm start打包
npm run build # 产出 release/WeRead-PC-macOS-arm64-<version>.zip打包脚本不依赖 electron-builder / electron-packager:本应用运行时只用 Electron 内置模块,无第三方依赖,于是直接复用 node_modules/electron/dist 里的运行时,注入源码 + 改 Info.plist + ad-hoc 签名即可。
已知限制
- 正文为 canvas 渲染,无法选中复制、无法划词划线(这是渲染方式的代价,详见 README)
- 依赖网页版内部类名(
.wr_canvasContainer、.renderTarget_pager_button),官方改版可能失效 - 仅提供 macOS arm64 构建,未签名未公证