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

它能做什么
安装与使用
按项目说明安装本地应用
按项目脚本在 Mac 安装,通过微信读书网页扫码登录后连接 NOTE4。
Mac · Node.js 18+ / npm · Rust stable / CMake / Xcode 命令行工具 · NOTE4 与电脑同一局域网
作者仅在 macOS 验证,适用于 NOTE4,不适用于 NOTE4C。仓库自带 SDK 0.1.0,兼容清单标注匹配固件 3.7.2。本次已验证当前 Mac 与 NOTE4 的连接和四灰阶推送;其他系统与固件版本需另行核对。
准备 Mac 与安装依赖
按 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 停止。
把任务交给电脑上的 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 实际四灰阶推送数据导出,不是实机照片;原仓库下载版暂不包含此书架功能。

