微信读书自动阅读的配置与运行指南

weread-bot 是一个面向微信读书的自动阅读工具，重点在“行为更接近真实阅读”，而不是简单定时点击。

它支持单用户、多用户、定时任务、守护进程，也支持 Docker 和 GitHub Actions。

这篇文章聚焦一件事：如何尽快跑通，再稳住。

WeRead Bot 能做什么

这个项目最实用的是四块：

1. 阅读行为模拟：随机延迟、速度变化、随机休息、章节连续性。
2. 多用户编排：多账号配置、并发上限、失败隔离、汇总统计。
3. 多运行模式：立即执行、定时执行（cron）、守护进程。
4. 自动化友好：环境变量、配置文件、Docker、GitHub Actions、通知渠道。

如果你想把手工流程改成可重复执行的任务，这套能力基本够用。

快速开始：本地最小可运行方案

最快路径是直接跑 Python 脚本：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# 1) 下载主程序与依赖
wget https://raw.githubusercontent.com/funnyzak/weread-bot/refs/heads/main/weread-bot.py
wget https://raw.githubusercontent.com/funnyzak/weread-bot/refs/heads/main/requirements.txt

# 2) 安装依赖
pip install -r requirements.txt

# 3) 提供抓包得到的 curl 数据（文件方式）
export WEREAD_CURL_BASH_FILE_PATH="curl_command.txt"

# 4) 可选参数
export TARGET_DURATION="30-50"
export READING_MODE="smart_random"

# 5) 运行
python weread-bot.py

这里最关键的是 WEREAD_CURL_BASH_FILE_PATH 或 WEREAD_CURL_STRING。没有有效抓包数据，程序无法构造可用请求。

配置优先级与三种运行方式

配置优先级：

1. 环境变量
2. 配置文件
3. 程序默认值

建议做法：稳定配置放 config.yaml，环境差异（token、代理、时区）放环境变量。

立即执行模式

1

python weread-bot.py --mode immediate

适合手动跑一次，完成即退出。

定时执行模式

1

python weread-bot.py --mode scheduled

用 cron 控制频率，适合固定时间窗口。

守护进程模式

1

python weread-bot.py --mode daemon

适合长期运行，通过会话间隔和每日上限控制节奏。

多用户场景怎么配

多个账号时，推荐用配置文件：

• 每个用户独立 curl 文件
• reading_overrides 给每个用户单独设时长/模式/间隔
• 用 MAX_CONCURRENT_USERS 控制同时在线账号数

并发别一开始就拉太高。先从 1 跑稳，再小步上调，并结合 RATE_LIMIT 和 READING_INTERVAL。

通知与可观测性

项目支持 PushPlus、Telegram、飞书、企业微信、钉钉、Gotify、Ntfy、Bark、PushDeer 等通知渠道。建议至少开一个，避免任务失败后没人发现。

另外可以重点盯两类指标：

1. 请求成功率
2. 会话总时长和失败重试分布

这两项基本能快速判断问题是网络、配置还是账号状态。

Docker 与 GitHub Actions 怎么选

• 本地或私有服务器常驻：优先 Docker。
• 不想维护服务器：优先 GitHub Actions。

Docker 便于统一挂载配置和日志；GitHub Actions 更轻，但要管理好 Secrets 和执行频率。

风险与使用边界

这类工具有明确边界，建议先想清楚：

1. 抓包数据里有敏感认证信息，不要放到公开仓库。
2. 频率和并发过高可能触发风控，参数要保守。
3. 用途建议限定在学习研究与自动化实践，并自行评估账号和平台规则风险。

密钥、token、cookie 路径都放环境变量或 Secrets，不要硬编码在脚本或仓库配置里。

总结

weread-bot 的优点是链路完整：抓包配置、行为模拟、多用户调度、通知和部署方式都给齐了。建议先从单用户立即执行跑通，再扩展到定时和多用户。

参考

• 项目仓库：funnyzak/weread-bot