TNotes.notes

Appearance

to top

0007. WeRead 微信读书辅助工具 ​

1. ❌ Deprecated ​

  • 该笔记接下来将不再维护
    • 主要原因是网页脚本这玩意儿太过“脆弱”，一旦微信读书页面的元素结构发生变动，便会导致脚本的一些失效，又得重新改写。
    • 笔记相当于是归档了，暂且留个纪念吧！其中会有一些描述不对的地方，接下来基本不会再去修正，在阅读过程中需要注意。
    • 不再维护的笔记，后续随时可能删除。
  • 最后一次修改于：2025 年 4 月 10 日 21:39:18
    • 今天收到网友反馈，正好近期也在用微信读书看 Node.js 的相关书籍，于是就简单修了一版脚本。
    • 图 0

2. 📝 概述 ​

  • WeRead 辅助脚本
  • scripty 脚本注入工具
  • 微信读书桌面版

3. 📺 视频 ​

3.1. 📺 bilibili 在线视频链接 - 0007.1 ​

3.2. 📺 bilibili 在线视频链接 - 0007.2 ​

  • https://www.bilibili.com/video/BV1sZ421p7fW
    • 微信读书桌面版（网页套壳）
    • 内容概述：
      • 演示如何安装 macos 安装包
      • 演示脚本的功能
      • 其他一些不重要的信息 …… 个人写代码时的外界环境记录

4. 📒 脚本功能说明 ​

快捷键功能说明备注
1复制在打开编写想法的弹窗时无效
2马克笔在打开编写想法的弹窗时无效
3波浪线在打开编写想法的弹窗时无效
4直线在打开编写想法的弹窗时无效
5写想法在打开编写想法的弹窗时无效
6查询在打开编写想法的弹窗时无效
esc关闭编辑想法的弹窗
backspace删除下划线、删除想法在打开编写想法的弹窗时无效
ctrl + enter、cmd + enter发表想法

WARNING

  • 删除想法 - 双栏阅读不支持

5. 📒 测试设备（键盘）说明 ​

  • 目前使用的是 MX Keys Mini 键盘，这是一款非全尺寸键盘，键盘外观如下：
  • 视频中介绍的所有操作，都是基于当前这个键盘来操作的，有些朋友使用的也许是全尺寸键盘，全尺寸键盘的按键会相对多一些，按侧边的这些数字键也是等效的。
  • 下面这是全尺寸键盘，实际上在按下数字键的时候，按上边儿的数字和下边儿的数字效果都是一样的。

6. 💻 微信读书脚本 ​

WARNING

  • 视频中使用的插件是 Scripty，目前 2025 年 4 月 1 日 22:51:59 测试发现好像不好使了，改为用油猴插件来实现了，脚本的实现原理都是一样的，具体配置的做法基本差不多，只需要将脚本粘贴到油猴插件中即可。
展开获取脚本源码
javascript
console.log('weread script called')

// 初始化脚本
document.onmouseup = initializeToolbar

/**
 * 初始化工具栏事件监听
 */
function initializeToolbar() {
  const toolbarContainer = document.querySelector('.reader_toolbar_container')
  if (!toolbarContainer) return // 工具栏未出现时退出

  // 绑定键盘事件
  document.onkeydown = handleKeyDown
}

/**
 * 处理键盘按下事件
 * @param {KeyboardEvent} e - 键盘事件对象
 */
function handleKeyDown(e) {
  const { metaKey, ctrlKey, keyCode } = e
  console.log(metaKey, ctrlKey, keyCode)

  // 定义按键与操作的映射关系
  const keyActions = {
    49: () => handleClick('.toolbarItem.wr_copy', '复制'), // 1
    50: () => handleClick('.toolbarItem.underlineBg', '马克笔'), // 2
    51: () => handleClick('.toolbarItem.underlineHandWrite', '波浪线'), // 3
    52: () => handleClick('.toolbarItem.underlineStraight', '直线'), // 4
    53: () => handleClick('.toolbarItem.review', '写想法', true, e), // 5
    54: () => handleClick('.toolbarItem.query', '查询', true, e), // 6
    8: handleBackspace, // backspace
    13: () => (metaKey || ctrlKey) && handleSubmitIdea(), // enter
    27: handleCloseReviewPanel, // esc
  }

  // 检查是否需要执行对应操作
  const action = keyActions[keyCode]
  if (action) {
    action()
  }
}

/**
 * 点击指定按钮
 * @param {string} selector - 按钮选择器
 * @param {string} logMessage - 日志信息
 * @param {boolean} preventDefault - 是否阻止默认行为
 */
function handleClick(selector, logMessage, preventDefault = false, e) {
  if (isVisible_ReaderWriteReviewPanel()) return
  const button = document.querySelector(selector)
  if (button) {
    console.log(`按下 ${logMessage}`)
    button.click()
    if (preventDefault) e.preventDefault()
  }
}

/**
 * 处理 Backspace 按键
 */
function handleBackspace() {
  console.log('按下 backspace 删除记录（包括想法的删除和下划线的删除）')
  document.querySelector('.toolbarItem.removeUnderline')?.click()

  // 单栏删除想法
  document
    .querySelectorAll('.readerReviewDetail_item .actions .actionItem')
    .forEach((btn) => btn.click())

  // ! 暂时不处理多栏删除想法
}

/**
 * 提交想法
 */
function handleSubmitIdea() {
  if (!isVisible_ReaderWriteReviewPanel()) return
  console.log('按下 cmd + enter | ctrl + enter 提交想法')
  const submitButton = document.querySelector(
    '.wr_btn.wr_btn_Big:not([disabled])'
  )
  submitButton && submitButton.click()
}

/**
 * 关闭想法记录窗口
 */
function handleCloseReviewPanel() {
  console.log('按下 esc 关闭想法记录窗口')
  document
    .querySelectorAll('.closeButton, .reader_float_panel_header_closeBtn')
    .forEach((btn) => btn.click())
}

/**
 * 判断记录想法的弹窗是否可见
 * @returns {boolean}
 */
function isVisible_ReaderWriteReviewPanel() {
  const isSingleColumn = document.querySelector(
    '.readerControls_item.isNormalReader'
  )
  if (isSingleColumn) {
    const panel = document.querySelector('.readerWriteReviewPanel')
    return !!panel && panel.style.display !== 'none'
  } else {
    return [...document.querySelectorAll('.float_panel_position_wrapper')].some(
      (wrapper) => wrapper.offsetWidth > 0
    )
  }
}
js
// ==UserScript==
// @name         微信读书帮助脚本
// @namespace    http://tampermonkey.net/
// @version      2025-04-10
// @description  try to take over the world!
// @author       You
// @match        https://weread.qq.com/web/reader/*
// @icon         https://weread.qq.com/
// @grant        none
// ==/UserScript==

;(function () {
  'use strict'

  console.log('weread script called')

  // 初始化脚本
  document.onmouseup = initializeToolbar

  /**
   * 初始化工具栏事件监听
   */
  function initializeToolbar() {
    const toolbarContainer = document.querySelector('.reader_toolbar_container')
    if (!toolbarContainer) return // 工具栏未出现时退出

    // 绑定键盘事件
    document.onkeydown = handleKeyDown
  }

  /**
   * 处理键盘按下事件
   * @param {KeyboardEvent} e - 键盘事件对象
   */
  function handleKeyDown(e) {
    const { metaKey, ctrlKey, keyCode } = e
    console.log(metaKey, ctrlKey, keyCode)

    // 定义按键与操作的映射关系
    const keyActions = {
      49: () => handleClick('.toolbarItem.wr_copy', '复制'), // 1
      50: () => handleClick('.toolbarItem.underlineBg', '马克笔'), // 2
      51: () => handleClick('.toolbarItem.underlineHandWrite', '波浪线'), // 3
      52: () => handleClick('.toolbarItem.underlineStraight', '直线'), // 4
      53: () => handleClick('.toolbarItem.review', '写想法', true, e), // 5
      54: () => handleClick('.toolbarItem.query', '查询', true, e), // 6
      8: handleBackspace, // backspace
      13: () => (metaKey || ctrlKey) && handleSubmitIdea(), // enter
      27: handleCloseReviewPanel, // esc
    }

    // 检查是否需要执行对应操作
    const action = keyActions[keyCode]
    if (action) {
      action()
    }
  }

  /**
   * 点击指定按钮
   * @param {string} selector - 按钮选择器
   * @param {string} logMessage - 日志信息
   * @param {boolean} preventDefault - 是否阻止默认行为
   */
  function handleClick(selector, logMessage, preventDefault = false, e) {
    if (isVisible_ReaderWriteReviewPanel()) return
    const button = document.querySelector(selector)
    if (button) {
      console.log(`按下 ${logMessage}`)
      button.click()
      if (preventDefault) e.preventDefault()
    }
  }

  /**
   * 处理 Backspace 按键
   */
  function handleBackspace() {
    console.log('按下 backspace 删除记录（包括想法的删除和下划线的删除）')
    document.querySelector('.toolbarItem.removeUnderline')?.click()

    // 单栏删除想法
    document
      .querySelectorAll('.readerReviewDetail_item .actions .actionItem')
      .forEach((btn) => btn.click())

    // ! 暂时不处理多栏删除想法
  }

  /**
   * 提交想法
   */
  function handleSubmitIdea() {
    if (!isVisible_ReaderWriteReviewPanel()) return
    console.log('按下 cmd + enter | ctrl + enter 提交想法')
    const submitButton = document.querySelector(
      '.wr_btn.wr_btn_Big:not([disabled])'
    )
    submitButton && submitButton.click()
  }

  /**
   * 关闭想法记录窗口
   */
  function handleCloseReviewPanel() {
    console.log('按下 esc 关闭想法记录窗口')
    document
      .querySelectorAll('.closeButton, .reader_float_panel_header_closeBtn')
      .forEach((btn) => btn.click())
  }

  /**
   * 判断记录想法的弹窗是否可见
   * @returns {boolean}
   */
  function isVisible_ReaderWriteReviewPanel() {
    const isSingleColumn = document.querySelector(
      '.readerControls_item.isNormalReader'
    )
    if (isSingleColumn) {
      const panel = document.querySelector('.readerWriteReviewPanel')
      return !!panel && panel.style.display !== 'none'
    } else {
      return [
        ...document.querySelectorAll('.float_panel_position_wrapper'),
      ].some((wrapper) => wrapper.offsetWidth > 0)
    }
  }
})()

7. 💻 使用 scripty 脚本注入插件来自动运行脚本 ​

scripty 具体如何使用，可以参考 TNotes.notes.0004 笔记的介绍。

8. 💻 微信读书桌面版的实现 ​

  • 启动流程
    1. git clone https://github.com/Tdahuyou/electron.git 克隆代码，编号切到 0044 目录
    2. npm i 安装依赖
    3. npm run dev 启动开发环境
    4. npm run build 出包
  • 核心源码
javascript
const { app, BrowserWindow } = require('electron')
const { join } = require('path')

const createWindow = () => {
  const win = new BrowserWindow({
    width: 800,
    height: 600,

    webPreferences: {
      nodeIntegration: true,
      contextIsolation: false,
      preload: join(__dirname, 'preload.js'),
    },
  })

  win.loadURL('https://weread.qq.com/')
  // win.webContents.openDevTools()
}

app.whenReady().then(() => {
  createWindow()
})
javascript
// 就是上面提到的微信读书脚本。
// ...

8.1. 解决 macos 安装报错问题 ​

  • macos 报错 - “weread-helper” 已损坏
  • 将 weread-helper 丢到应用程序 Applications 目录中
  • 执行命令解决报错问题
    • sudo xattr -rd com.apple.quarantine /Applications/weread-helper.app
    • 通过执行这条命令，即可解决安装时的错误问题。

8.2. 记录开发微信读书桌面版时的桌面环境 ​

  • 右边是我家的 we，已经 1 岁了，巨社恐～
  • 桌面番茄钟从 30 开始倒计时，写完出包时还剩 10min，比想象得快了好多……

9. 🤔 问：为什么要写微信读书桌面版？ ​

  • 其实现在 2025 年 3 月 2 日 11:31:05 想来没必要做这东西，当时写它的目的可能是考虑到有些网友在使用脚本的过程中遇到了些许麻烦，就想着想着通过一种方式将脚本集成到应用中，帮用户完成套壳。
  • 以下是一些网友的在视频中的一些评论。

10. 🤔 问：微信读书脚本如何使用？ ​

  • 这里记录的是一些历史问题，在 24.06.02 做了一个桌面版的工具，可以直接下载桌面版来使用，脚本已经注入到程序中了，只需要安装即可使用。
  • 问题背景：
  • 图 4 大概率是因为快捷方式冲突导致的，这种情况可以尝试换一个环境再试试看。

11. 🤔 问：为什么想到要写这个脚本？ ​

在使用网页版的微信读书时，很多时候想要发表想法时，会碍于操作成本太高而放弃记录 📝 的行为。心想，如果有对应的快捷键就好了，这样记录的话就会方便很多，便给官方提了建议。隔天觉得官方可能不会采纳亦或者压根就看不到这条建议，而自己又急着用，想着自己好像也能实现，于是就 ……

问题描述：

在 微信读书的网页端 读书时，遇到了一个问题 —— 记录成本太高，影响阅读节奏。（尤其是在竖屏的情况下浏览）

12. 🔗 References ​

Details
  • 🔗 Pack - tw93 大佬的 github 开源项目
    • https://github.com/tw93/Pake
      • 这是早期 23-02-05 视频中提到的微信读书桌面版下载地址，这个桌面应用程序是基于 pack 来实现的，其中一个很明显的特点是轻量（包体积很小）。
  • 🔗 桌面版 we-read 实现源码见笔记 👉 TNotes.electron.0044