微信读书刷时长+保持挑战赛天数的自动化脚本操作详细教程

这个 GitHub 仓库（findmover/wxread）是一个用于微信读书自动刷阅读时长、保持挑战赛天数的自动化脚本。它不需要你开着手机或电脑模拟器，而是通过模拟微信读书网页版的请求（抓包）来实现的。

针对完全没有编程基础的“小白”，推荐使用**第一种方法（GitHub Action）*来运行。这种方法*完全免费，不需要你自己买服务器或整天开着电脑，只要配置一次，GitHub 的服务器每天就会自动帮你运行。

以下是为你整理的超详细“小白”保姆级操作步骤：

第一步：获取你的微信读书“凭证”（抓包）

这是最关键的一步，脚本需要知道是“哪个账号”在读书。

  1. 在电脑上使用浏览器（推荐使用 Google Chrome 或 Edge 浏览器），打开微信读书官网 (weread.qq.com) 并登录你的账号。
  2. 随便搜索一本书（比如【金瓶梅】），点击进入阅读界面。
  3. 打开开发者工具：在键盘上按下 F12 键（Mac 电脑按 Cmd + Option + I），或者在页面任意地方右键选择“检查”（Inspect）。

    image-20260623150548296
  4. 在弹出的工具栏顶部，切换到 “Network”（网络） 标签页。
  5. 在页面上点击“下一页”或“上一页”随便翻几页书。
  6. 回到网络（Network）面板，在左侧的搜索框或者请求列表里，寻找一个名为 read 的接口（完整的 URL 通常类似 https://weread.qq.com/web/book/read）。
    • 怎么确认找对了？ 点击它，看右侧的 Preview 或 Response，如果显示类似 {"succ": 1, ...} 就说明找对了。
  7. 复制数据：在 read 这个请求上右键 -> 选择 Copy（复制） -> 点击 Copy as cURL (bash)。
  8. 把复制下来的这长串文本先新建一个记事本保存起来，一会儿要用。

第二步：将项目复制到你自己的 GitHub

  1. 登录你的 GitHub 账号（如果没有，请先去 github.com 注册一个）。
  2. 打开该项目的网址：https://github.com/findmover/wxread。
  3. 页面右上角有一个 Fork 按钮，点击它。
    image-20260623150648895
  4. 页面会跳转，直接点击 Create fork。这样，这个项目的代码就被完整复制到你自己的账号下了。

第三步：在 GitHub 中配置运行参数

现在需要把你第一步抓到的凭证填入你刚刚 Fork 的仓库里：

  1. 在你自己的这个 wxread 仓库页面，点击顶部的 Settings（设置） 菜单。
  2. 在左侧列表里找到 Secrets and variables，点击展开，然后选择 Actions。
  3. 添加核心凭证（Secrets）：
    • 点击右侧的 New repository secret 按钮。
    • Name 填入：WXREAD_CURL_BASH
    • Value 填入：把你第一步在记事本里保存的那长串 cURL (bash) 文本全部粘贴进去。
    • 点击 Add secret 确认保存。
  4. 添加阅读时间变量（Variables）：
    • 在当前页面（Actions）中，把标签页从 Secrets 切换到 Variables。
    • 点击 New repository variable。
    • Name 填入：READ_NUM
    • Value 填入你想要的阅读次数（脚本每 1 次代表阅读 30 秒。比如填 120 就是 60 分钟，填 200 就是 100 分钟）。
    • 点击 Add variable 确认保存。

(可选) 如果需要每天阅读完后把结果推送到你的微信上，可以在 Secrets 里面再添加 PUSH_METHOD（可选 pushplus、wxpusher 等）以及对应的 Token，不配置则默认不推送，但不影响刷时长。

第四步：启动并静待自动运行

  1. 点击仓库顶部的 Actions 菜单。
  2. 由于是新 Fork 的项目，系统会提示你启用 Action，点击绿色的 “I understand my workflows, go ahead and enable them” 按钮。
    image-20260623151018665
  3. 默认情况下，脚本每天会自动在后台定时运行。
  4. 如果你想立马测试一下是否成功：
    • 在左侧点击具体的 Workflow 名字（通常叫 wxread 类似的名字），一般处于Disabled状态，将其改为Enabled。
    • 看到右侧有一个 Run workflow 的灰色按钮，点击它，再点击绿色的 Run workflow。
      image-20260623151431607
    • 稍等一两分钟，刷新页面，如果看到出现绿色的勾（✔ Success），说明已经成功运行，你的微信读书时长此时就已经加上去啦！
      image-20260623151816995

注意事项： 微信读书的网页版登录凭证（Cookie）是有有效期的。如果过了一段时间（比如一两周后）发现它不自动加时长了，说明凭证失效了。你只需要重复第一步重新抓取一次 read 接口的 cURL (bash)，然后去 Settings -> Secrets 里把 WXREAD_CURL_BASH 的值更新一下即可。

要加上凭证失效的提醒，最简单且对小白最友好的方式就是利用 GitHub 官方的“工作流失败通知” (Workflow Failure Notification)。

因为当你的微信读书凭证（Cookie）失效时，脚本请求网页就会报错，导致 GitHub Action 运行失败（变成红色的 ❌）。只要配置好通知，GitHub 就会在失败的第一时间给你发邮件，或者在手机 App 上推送提醒。

以下是两种配置提醒的方法，推荐第一种（最省心）：

方法一：开启 GitHub 官方邮件/App 提醒（最推荐，无需改代码）

GitHub 默认会对你自己的项目失败进行提醒，你只需要确认你的接收设置是打开的：

  1. 登录 GitHub，点击网页右上角你的头像，选择 Settings（个人设置）。
  2. 在左侧菜单栏中找到 Notifications（通知）。
  3. 在 Actions 这一栏，确保勾选了 Email（邮件）。
    • 如果你手机上装了 GitHub 的手机客户端，也可以勾选 Web/App，手机就能像微信一样收到弹窗推送。
  4. 往下滚动找到 Watching 或 System 相关的触发条件，确保 Failing workflows（失败的工作流） 是处于开启接收状态。

效果： 一旦哪天凭证失效，脚本运行报错，你的邮箱就会收到一封来自 GitHub 的邮件，提示你 Workflow run failed（工作流运行失败），你看到邮件就知道该去更新凭证了。

方法二：通过微信或钉钉提醒（需要配置推送服务）

如果你不想看邮件，希望脚本失效或者每天运行完后直接在微信上收到通知，原项目其实已经自带了推送功能（支持 pushplus、wxpusher、企业微信、钉钉 等）。

这里以最常用的 pushplus（微信扫码即可接收通知） 为例：

  1. 手机微信搜索并关注公众号 pushplus推送加。
  2. 点击公众号菜单栏里的 【激活/登录】，登录后在它的官网个人中心拿到你的 Token（一串代码）。
  3. 回到你 GitHub 的 wxread 仓库，点击 Settings -> Secrets and variables -> Actions。
  4. 点击 New repository secret（新建密钥）：
    • Name 填入： PUSH_METHOD
    • Value 填入： pushplus （代表你使用这个渠道）
  5. 再次点击 New repository secret：
    • Name 填入： PUSH_TOKEN
    • Value 填入： 粘贴你刚才在 pushplus 网站上复制的那串 Token。

效果： 这样配置好后，脚本每次运行完（无论成功还是凭证失效失败），你的微信都会收到一条来自“pushplus”的详细战报。如果某天通知里显示错误或者没有增加时长，就说明凭证需要更新了。