本地应用 · NOTE4

微信读书阅读搭子

在 Mac 扫码登录微信读书,把书籍正文投送到 NOTE4,用设备按键翻页。优化墨水屏文字对比度和留白,支持黑白与多级灰度。

它能做什么

浏览器扫码登录,登录状态保存在本机
下键下一页、上键上一页、确认键刷新
400×300 正文画面,mono / gray4 / gray16 输出
安装与启动脚本,重启尝试恢复上次阅读页

安装与使用

按项目说明安装本地应用

按项目脚本在 Mac 安装,通过微信读书网页扫码登录后连接 NOTE4。

公开源码

Mac · Node.js 18+ / npm · Rust stable / CMake / Xcode 命令行工具 · NOTE4 与电脑同一局域网

作者仅在 macOS 验证,适用于 NOTE4,不适用于 NOTE4C。仓库自带 SDK 0.1.0,兼容清单标注匹配固件 3.7.2。本次已验证当前 Mac 与 NOTE4 的连接和四灰阶推送;其他系统与固件版本需另行核对。

  1. 准备 Mac 与安装依赖

    按 README 安装 Node.js 18+、npm、Rust stable、CMake 和 Xcode 命令行工具。获取源码后运行 bash scripts/setup.sh,脚本下载 Chromium 并编译程序;首次安装需要联网,不是免安装的 .app。

  2. 配置设备并启动

    首次复制 .env.example 为 .env,填写 ZECTRIX_IP;已有配置请保留。电脑与 NOTE4 保持同一局域网,退出其他占用设备连接的程序,再运行 bash scripts/start.sh。默认 mono,默认关闭预取以避免提前翻页。

  3. 扫码选书并验证翻页

    在弹出的浏览器中扫码登录并打开书籍,验证设备上下键翻页和确认键刷新。换书时在同一浏览器按 ⌘L 打开 https://weread.qq.com,关闭旧书标签页,打开新书后按确认键。关闭浏览器或 Ctrl+C 停止。

获取本地推送 SDK ↗

把任务交给电脑上的 Codex 或其他本地 AI,按项目当前 README 完成安装与验证。

看看交给 AI 的内容
请按当前 README 与 TUTORIAL.md 在 Mac 安装微信读书阅读搭子,保留现有配置和登录数据,不自动升级固件。
https://github.com/hadronliu/weread-zectrix-bridge
https://github.com/hadronliu/weread-zectrix-bridge/blob/main/TUTORIAL.md
Mac · Node.js 18+ / npm · Rust stable / CMake / Xcode 命令行工具 · NOTE4 与电脑同一局域网
作者仅在 macOS 验证,适用于 NOTE4,不适用于 NOTE4C。仓库自带 SDK 0.1.0,兼容清单标注匹配固件 3.7.2。本次已验证当前 Mac 与 NOTE4 的连接和四灰阶推送;其他系统与固件版本需另行核对。
按 README 安装 Node.js 18+、npm、Rust stable、CMake 和 Xcode 命令行工具。获取源码后运行 bash scripts/setup.sh,脚本下载 Chromium 并编译程序;首次安装需要联网,不是免安装的 .app。
首次复制 .env.example 为 .env,填写 ZECTRIX_IP;已有配置请保留。电脑与 NOTE4 保持同一局域网,退出其他占用设备连接的程序,再运行 bash scripts/start.sh。默认 mono,默认关闭预取以避免提前翻页。
在弹出的浏览器中扫码登录并打开书籍,验证设备上下键翻页和确认键刷新。换书时在同一浏览器按 ⌘L 打开 https://weread.qq.com,关闭旧书标签页,打开新书后按确认键。关闭浏览器或 Ctrl+C 停止。
安装后核对正文显示、上下键翻页、确认刷新和退出后释放连接;其他设备与环境需自行验证。

装好以后,确认这一点

安装后核对正文显示、上下键翻页、确认刷新和退出后释放连接;其他设备与环境需自行验证。

当前 Mac / NOTE4 推送已验证。复制任务不会自动执行安装。

常见问题

和“墨读”有什么不同?

同一作者的独立项目。墨读展示阅读时长和书籍进度;本项目显示书籍正文并支持实体按键翻页,通过扫码登录,不需要微信读书 API Key 或极趣云 API Key。

登录信息和阅读进度如何处理?

Cookie 保存在本机 browser-controller/.user-data/,截图和上次书籍地址也留在本机,请勿上传。微信读书负责云端进度同步,本工具不保证跨端实时一致;自动换书和进度冲突处理尚未实现。

使用时有哪些限制?

阅读时 Mac、浏览器和程序需保持运行。设备断线后可能需要重启程序;网页结构和特殊排版变化可能影响显示。配图是本机新增的封面书架,按 NOTE4 实际四灰阶推送数据导出,不是实机照片;原仓库下载版暂不包含此书架功能。

项目与更新

公开仓库。 项目已于 2026-11-10 核对资料,支持范围以实际版本为准。

后续完善会持续更新到 GitHub 仓库。安装或升级前,请让 AI 阅读当前 README 与版本变更,保留已有设置和数据。

查看源码与说明 ↗
本地应用 · NOTE4开始使用 →

提交后,项目资料会发送至 support@zectrix.com,由我们审核后收录。联系邮箱仅用于投稿沟通。