微信读书自动阅读助手,提供两个独立发行版:
- 🖥️ Windows 桌面版(v2.3.1):PySide6 桌面应用,CDP 扫码登录,前往 GitHub Releases 下载
- 🐳 Docker 版(v2.4.0):NAS / Linux 服务器 7×24 挂机,Web 管理面板,容器内无头扫码,支持 Cookie 失效自动推送二维码到微信
两版共享同一套阅读调度内核(进度驱动选书 / 8 类风控防线 / Skill 官方数据校准),代码各自独立维护、互不影响。
| 🖥️ Windows 桌面版 | 🐳 Docker 版 | |
|---|---|---|
| 运行平台 | Windows 10/11(x64) | NAS(飞牛/群晖…)/ Linux 服务器(Docker 24+) |
| 管理界面 | PySide6 桌面窗口 | 浏览器 Web 面板(http://<IP>:5911,4 Tab + ECharts 报告) |
| 扫码登录 | 本机 Chrome CDP 扫码 | 容器内 Playwright 无头扫码;Cookie 失效后自动推二维码到微信,长按即恢复 |
| 运行形态 | 手动启动,关机即停 | 7×24 常驻、开机自启、异常自动拉起 |
| 代码目录 | app/ |
wxread_docekr/(独立副本,去 Qt 化) |
| 部署难度 | 双击安装包 | docker compose up -d --build 一条命令 |
基于 PySide6 的微信读书自动阅读桌面助手(Windows 平台) CDP 扫码登录 + Skill API 拉取书架/章节池 + 本地数据库驱动进度阅读
| 功能 | 说明 |
|---|---|
| CDP 扫码登录 | 通过 Chrome DevTools Protocol 连接本地 Chrome 浏览器扫码登录,自动提取并持久化 Cookie(wr_skey 长度 ≥ 8 即视为有效) |
| Skill API 集成 | 独立 skill_api 模块对接微信读书 Skill 网关,获取书架、章节池、阅读进度、阅读统计 |
| 本地数据库兜底 | local_db.json 持久化书架/进度/统计,chapter_cache.json 按 bookId 分桶存储章节池;Skill 不可用时本地继续驱动阅读 |
| 进度驱动选书选章 | 按进度排序优先选进度最高且 <100% 的书;单章阅读 4 |
| 混合完成度检测 | 本地实时累加阅读秒数 + 每 30 分钟 Skill 官方数据权威校准双保险,精准判断当日达标 |
| 阅读统计 4 项 | 通过 /readdata/detail 获取今日 / 本周 / 本月 / 总累计 4 项权威时长;今日时长以官方数据为基线定期校准,本地估算仅在基线之上实时累加 |
| 套装书自动跳过 | 遇到 CB_/MP_ 等非数字 bookId 的套装书、公众号合集(无法自动上报)时立即永久拉黑并自动换书;黑名单持久化,重启/书架重同步不丢失 |
| 阅读风控自动防线 | read 上报结果 8 类精细分类;连续 3 次空响应(软风控特征)或 8 次连续失败即自动停止一切上报,指数退避冷却(60→120→…→360 分钟),冷却结束自动试探、成功自动恢复 |
| 可视化报告 | 聚合 LocalDB + Skill 数据,弹出报告页:读者画像 / 书架归一化饼图(进度+可见性双维度)/ 阅读趋势线 / 月度热力图 / 20 条阅读高光,纯 QPainter 绘制无额外依赖 |
| 风控规避 | 随机书籍/章节切换、±15% 间隔抖动、每 N 次成功插入长休息、动态 baggage/sentry-trace 请求头;软风控时自动冷却并 WxPusher 告警(同类 3 小时限频,持久化不重复轰炸) |
| WxPusher 推送 | 每日任务开始/完成、Cookie 失效、阅读风控告警、Skill 登录成功等事件推送(消息中时长以「X小时Y分钟」呈现) |
| 开机自启 + 托盘 | 注册表写入自启项,支持 --minimized 启动即最小化到托盘,单例防多开 |
| 异步 UI | Skill 调用 / CDP 登录 / 书架拉取全部走 QThread,UI 不阻塞 |
通过微信读书 Skill 网关获取官方统计数据:
- 今日阅读时长 — 当日累计秒数(官方数据为权威基线,每 30 分钟校准一次)
- 本周累计时长 — 本周一至今累计
- 本月累计时长 — 本月累计
- 总累计时长 — 账号历史总阅读时长
今日时长口径:每次上报本地固定 +45s 仅为实时估算(会略偏大),Skill 刷新时若官方值 > 0 则以官方值覆盖为新基线、随后继续累加;官方暂时返回 0(接口抖动/当天无数据)时保留本地值不误清零;跨天自动重置。校准时日志会显式输出「已按微信读书官方数据校准上调/下调」。
- read 接口每次响应被分为
ok / empty_200 / errcode_xxx / bad_response / http_error / network / internal_error / session_invalid八类,失败日志直接附带类型。 - 软风控识别:登录态正常(chapterInfos 等接口可用)但 read 连续 3 次返回 HTTP 200 空
{}(服务端静默丢弃),即判定软风控。 - 自动冷却:命中后立即停止一切上报进入冷却,60 → 120 → 240 分钟逐档翻倍(360 分钟封顶),主界面实时显示冷却倒计时;冷却结束自动试探,成功一次即恢复。
- 告警:WxPusher 推送「🚨 阅读风控提醒」,同类告警 3 小时最多一条,限频时间戳持久化,重启也不会重复轰炸。
- 阈值均在配置文件
risk节可调(判定阈值、冷却时长、告警间隔)。
套装书 / 公众号合集的 bookId 为 CB_/MP_ 等非数字格式,其"章节"实际是多本完整子书,read 接口对这类 ID 一律返回空响应。选书时识别到即自动拉黑并立即换书,黑名单保存在 local_db.json 顶层 blacklist,书架重新同步后标记仍保留。
- 首次安装后获得 12 小时免费试用(时间戳双备份防重置)。
- 试用期结束后需输入 16 位注册码激活,激活方式:
⚙️ 配置中心 → 🔑 授权管理。 - 注册码在本地校验,无需联网;激活后永久使用全部功能。
- 注册码不绑定设备,同一注册码可在多台机器激活。
🔐 获取注册码请联系开发者
- 📱 QQ:37784552
- 📧 Email:somnusweiwei1989@outlook.com
┌──────────────────────────────────────────────────────────────┐
│ WxReadAssistant │
├──────────────────────────────────────────────────────────────┤
│ UI 层 │
│ ┌──────────────────┬──────────────────────────────────────┐ │
│ │ settings_page │ main_page(主界面) │ │
│ │ - 时长/间隔范围 │ ┌─────────────┬──────────────────┐ │ │
│ │ - 启动延迟 │ │ 上左:状态 │ 上右:操作+统计 │ │ │
│ │ - 长休息/失败冷却│ │ + 控制按钮 │ - 阅读统计卡 │ │ │
│ │ - Skill Key │ └─────────────┤ - CDP 登录 │ │ │
│ │ - WxPusher │ ┌─────────────┤ - 查看/获取书架 │ │ │
│ │ - 系统设置 │ │ 下:工作日志 │ - 获取章节池 │ │ │
│ │ - 🔑 授权管理 │ └─────────────┴──────────────────┘ │ │
│ └──────────────────┘ └──────────────────────────────────┘ │
├──────────────────────────────────────────────────────────────┤
│ 业务逻辑层 │
│ ┌───────────┬──────────────┬────────────┬─────────────────┐ │
│ │ scheduler │ weread_api │ skill_api │ licensing │ │
│ │ 阅读调度 │ 阅读上报 │ Skill 调用 │ 注册码/试用期 │ │
│ │ 进度管理 │ 签名算法 │ 书架/章节 │ 纯本地校验 │ │
│ │ 完成检测 │ 续期 │ 进度/统计 │ 12h 免费试用 │ │
│ └───────────┴──────────────┴────────────┴─────────────────┘ │
├──────────────────────────────────────────────────────────────┤
│ 数据持久化层 │
│ ┌──────────────┬───────────────┬──────────────────────────┐ │
│ │ config.json │ local_db.json │ chapter_cache.json │ │
│ │ 用户配置 │ 书架+进度+统计 │ 章节池(按 bookId 分桶)│ │
│ │ +风控告警限频 │ +不支持书黑名单│ │ │
│ │ │ +授权状态(哈希,无明文) │ │
│ └──────────────┴───────────────┴──────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
启动 → 单例检测 → 加载样式/日志 → 构造主窗口 → 授权检查(过期弹激活窗)
↓
调度循环:
1. 检测登录态(wr_skey 有效性) + 授权门禁(试用过期禁止开始阅读)
2. 启动随机延迟(默认 15~25s,可配置)
3. 健康检查 + 完成度检查
4. 选书(进度最高且 <100%)→ 选章(跳过封面/版权页)
5. read_once 单次阅读上报(30~45s ± 15% 抖动),响应分类写入风控判定
6. 本地累加进度与今日阅读秒数,触发 UI 更新(卡片与状态区同源实时刷新)
7. 计算下次间隔(成功/失败/长休息不同策略)
8. 每 30 分钟用 Skill 官方数据校准进度与统计
9. 命中软风控(连续空响应/连续失败)→ 停止上报,指数退避冷却后自动试探
- 启动 Chrome(
--remote-debugging-port=9223) - 程序连接 CDP WebSocket
- 用户在 Chrome 中扫码登录微信读书
- 通过
Network.getCookies获取wr_*Cookie(按名称前缀白名单过滤) - 登录成功后保持 WebSocket 活跃,直到书架与章节池拉取完成
- Cookie 持久化,后续请求动态生成
baggage/sentry-trace头绕过风控
| 端点 | 用途 |
|---|---|
/shelf/sync |
获取书架(电子书 + 专辑 + 文章收藏) |
/book/chapterinfo |
获取指定书籍的章节池 |
/book/getprogress |
获取阅读进度 |
/readdata/detail |
获取阅读统计(日 / 周 / 月 / 总) |
/weread/report |
获取微信读书报告聚合数据(书架构成 / 阅读高光等,4xx 时自动熔断退回本地) |
WxRead/
├── app/
│ ├── core/
│ │ ├── config.py # 全局配置(%APPDATA%/WxReadAssistant/config.json)
│ │ ├── licensing.py # 注册码生成/校验 + 12h 试用期 + 激活持久化(纯本地)
│ │ ├── scheduler.py # 进度驱动阅读调度器
│ │ ├── weread_api.py # 微信读书阅读上报 + 签名算法
│ │ ├── skill_api.py # Skill 网关调用(书架/章节/进度/统计/报告)
│ │ ├── report_aggregator.py # 报告数据聚合(LocalDB + Skill → 16 字段统一结构)
│ │ ├── local_db.py # 本地数据库(书架/进度/章节池/授权段持久化)
│ │ └── notifier.py # WxPusher 推送(format_duration: X小时Y分钟)
│ ├── ui/
│ │ ├── main_page.py # 主界面(状态+操作+统计+日志单页布局)
│ │ ├── main_window.py # 主窗口(组装各模块 + 托盘 + 启动授权检查)
│ │ ├── settings_page.py # 设置页(时长/间隔/Skill Key/推送/系统/授权管理)
│ │ ├── shelf_dialog.py # 书架查看对话框
│ │ ├── report_dialog.py # 可视化报告对话框(QPainter 图表 · 纯绘制无依赖)
│ │ ├── cdp_login_dialog.py# CDP 扫码登录对话框
│ │ ├── license_dialog.py # 注册码激活对话框(启动过期时弹出)
│ │ ├── icon_store.py # 运行时图标(含 EXE 内嵌图标 资源源)
│ │ └── styles.py # 全局 QSS 样式
│ └── utils/
│ ├── logger.py # 日志(APPDATA 14 天 + 项目根 3 天)
│ └── autostart.py # 开机自启(注册表 HKCU\...\Run)
├── installer/ # Inno Setup 安装包脚本(wxread_assistant.iss + 中文语言包)
├── assets/app_icon.ico # EXE/安装器内嵌图标(scripts/make_icon.py 渲染生成)
├── main.py # 入口(单例 + --minimized)
├── WxReadAssistant.spec # PyInstaller 打包配置(已指定 icon)
├── requirements.txt
├── scripts/
│ ├── build_release.py # 一键构建:full.zip + setup.exe + 增量补丁 + release_note
│ └── make_icon.py # 从 icon_store 渲染合成多尺寸 app_icon.ico
├── tools/
│ └── keygen_app.py # 【开发者专用】注册码生成器(tkinter GUI,可 PyInstaller 打成独立 exe)
└── release/ # 发布区(full 目录 / full.zip / setup.exe / patch / sha1 / release_note)
- Windows 10/11(x64)
- 本地 Chrome 浏览器(CDP 扫码登录需要)
正式二进制见 GitHub Releases,每个版本仅提供一个安装包:
下载 WxReadAssistant-vX.Y.Z-setup.exe,双击安装向导完成安装(自动创建开始菜单/桌面快捷方式,自带卸载器)。
大二进制不进入 git 历史(
.gitignore已过滤);GitHub 仅发布 setup.exe,历史旧版本 release 会定期清理。
- 主页 → 「📷 扫码登录」按提示使用 Chrome CDP 扫码获取 Cookie。
- 主页 → 「获取数据」拉取书架与章节池。
- (可选)进入「⚙️ 配置中心」填入 Skill API Key / WxPusher Token。
- (可选)试用期结束后,「⚙️ 配置中心 → 🔑 授权管理」输入注册码激活。
- 点「开始阅读」。
🔐 获取注册码:QQ 37784552 或 Email somnusweiwei1989@outlook.com
重新运行最新 WxReadAssistant-vX.Y.Z-setup.exe 即可:安装器使用固定 AppId,会原地升级到安装目录,不触碰 %APPDATA% 下的用户数据(Cookie / 配置 / 进度 / 日志)。升级前请先退出程序(含托盘图标 → 右键 → 退出)。
开发者构建仍支持免安装 full 目录与增量补丁(
build_release.py产物),但不再随 GitHub Release 分发。
pip install -r requirements.txt
python main.py # 直接运行
python main.py --minimized # 启动即最小化到托盘
# 打包 EXE + setup.exe + 增量补丁
python scripts\build_release.py --version 2.3.1 --previous 2.3.0
# 打包开发者专用注册码生成器(单文件 GUI exe,输出到 tools\dist\)
pyinstaller --onefile --windowed --name WxReadKeygen --paths . --icon assets\app_icon.ico --distpath tools\dist tools\keygen_app.py增量补丁的删除清单会自动过滤 Inno 卸载器(
unins000.*),补丁更新不影响正常卸载;构建内置杀软文件锁重试。WxReadKeygen.exe含注册码算法密钥,仅供开发者本地使用,禁止随 Release 公开发布。
依赖:PySide6(含 QtWebEngine)、requests、urllib3、websocket-client、Pillow、pyinstaller。
配置文件位于 %APPDATA%\WxReadAssistant\config.json,可在「设置」页可视化编辑,主要项:
| 配置组 | 项 | 默认值 |
|---|---|---|
| 阅读参数 | 每日目标时长范围 | 8~10 小时 |
| 阅读参数 | 单次阅读间隔 | 30~45 秒(±15% 抖动) |
| 阅读参数 | 启动延迟范围 | 15~25 秒 |
| 阅读参数 | 长休息 | 每 20 次休息 60~180 秒 |
| 阅读参数 | 失败冷却范围 | 30~60 秒 |
| 阅读参数 | Skill 数据刷新间隔 | 30 分钟 |
| 🛡️ 风控 | 软风控判定阈值 | 连续 3 次 HTTP 200 空响应 |
| 🛡️ 风控 | 连续失败判定阈值 | 连续 8 次失败 |
| 🛡️ 风控 | 冷却时长 | 60 分钟起指数翻倍,封顶 360 分钟 |
| 🛡️ 风控 | 风控告警限频 | 同类 180 分钟最多一条(持久化) |
| Skill | API Key | (在设置页填入) |
| 推送 | WxPusher 开关 / Token | 可选 |
| 系统 | 开机自启 / 最小化到托盘 | 可选 |
| 🔑 授权 | 注册码 | 联系开发者获取(QQ 37784552 / Email somnusweiwei1989@outlook.com) |
各设置的 inline 提示位于「⚙️ 配置中心」对应组框底部,建议首次使用先浏览。
- 进度驱动选书:优先选进度最高且 <100% 的书,100% 换书,避免单一章节重复触发风控。
- 本地兜底:Skill 不可用时由
local_db.json继续驱动阅读循环,保证连续运行。 - 混合完成度:本地实时累加秒数(每 30~45 秒 +45s 估算)+ 每 30 分钟 Skill 官方数据权威校准(官方值 >0 覆盖为新基线、0 保留本地、跨天丢弃旧值),双保险判定当日达标。
- 风控规避:随机书籍/章节切换、间隔抖动、长休息、动态
baggage/sentry-trace请求头匹配浏览器指纹。 - 软风控自动冷却:read 响应 8 分类,连续空响应/连续失败即指数退避冷却,停止全部上报,到期自动试探、成功自动恢复,WxPusher 限频告警。
- 不支持书黑名单:
CB_/MP_类 bookId 永久拉黑,持久化在local_db.json,书架重同步不复活。 - Cookie 安全:CDP 抓取按名称前缀白名单过滤,
wr_skey全量存储不截断,PySide6 6.11+ SameSite 枚举序列化时转.value。 - 授权安全(纯本地):注册码算法使用 HMAC-SHA256 截断 40-bit,本地恒时比对;首次启动时间戳在
local_db.json与注册表双备份取最早值防删除重置;激活只存代码哈希,不存明文。 - 日志双写:APPDATA(14 天保留,便于长期追溯)+ 项目根(3 天保留,便于即时排查)。
面向 NAS / Linux 服务器的 7×24 挂机发行版。Web 管理面板替代桌面 UI,全部代码位于独立目录
wxread_docekr/(去 Qt 化,与 Windows 版互不影响)。详细部署文档见wxread_docekr/DEPLOY.md。
| 能力 | 说明 |
|---|---|
| Web 管理面板 | 总览(KPI/控制/扫码/书架)+ 配置(表单热生效)+ 报告(ECharts 14 图)+ 日志(实时 SSE)4 个 Tab,http://<IP>:5911 直接访问 |
| 无头扫码登录 | 容器内 Playwright 驱动 Chromium 生成登录二维码,无需宿主机安装 Chrome |
| 失效自动恢复 | Cookie 硬失效时自动唤起扫码会话,二维码图片经 WxPusher 推送到微信,手机长按识别 → 确认登录即自动写回登录态并恢复阅读,全程无需打开面板 |
| WxPusher 双通道 | 文本通道(SPT 极简推送)负责日常通知;图片通道(AppToken + UID 标准推送)负责登录二维码 |
| REST API | 40+ 端点:调度器控制 / 配置读写 / 书架同步 / 报告 / 日志流 / 登录态管理,便于脚本化运维 |
| 同源调度内核 | 与 Windows 版同一套 scheduler / weread_api / skill_api / 风控防线 / 本地授权,行为口径一致 |
| 开箱镜像 | python:3.14-slim 两阶段构建,内置 Chromium 运行库与 Noto CJK 中文字体,HEALTHCHECK 心跳自检 |
- Docker 24+ 与 Docker Compose v2(飞牛 fnOS、群晖、unraid、裸 Linux 均可)
- 空闲内存 ≥ 1GB(无头 Chromium 实例)
- 网络可达微信读书与 Skill 网关
git clone https://github.com/SomnusWei/WxRead.git
cd WxRead/wxread_docekr
docker compose up -d --build- 首次构建约 5~15 分钟(拉取基础镜像 + Chromium 运行库),之后增量构建走缓存秒级完成
- 国内网络构建慢可加速:
docker compose build --build-arg PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple- 查看启动日志:
docker logs -f wxreadassistant
- 浏览器打开
http://<NAS_IP>:5911 - 「配置」Tab → Skill 区填入 API Key → 「验证 Skill」
- 「总览」Tab → 「扫码登录」,手机微信扫码(二维码 90 秒有效,可点「重新获取」)
- 登录成功后调度器自动启动开始阅读,无需手动点开始
- (可选)推送区配置 WxPusher 并点「测试推送」验证双通道(见下)
- (可选)「授权」区输入注册码激活(12 小时免费试用到期前)
- compose 默认发布
"5911:5911",局域网内可直接访问;不可信环境改为"127.0.0.1:5911:5911"(仅本机/SSH 隧道/反代可达) - 公网暴露必须:① 设置
WXREAD_WEB_TOKEN启用 Bearer 鉴权;② 外层套 Nginx/Caddy 启用 HTTPS - 信任内网(家用局域网)可留空 Token,面板免输入直达
| 变量 | 说明 |
|---|---|
WXREAD_LICENSE_CODE |
启动自动激活注册码;推荐留空,首次启动后在面板激活(激活状态持久化,只填一次) |
WXREAD_WEB_TOKEN |
面板 Bearer Token,留空不启用鉴权 |
TZ |
时区,默认 Asia/Shanghai |
WXREAD_LICENSE_ADV |
设为 "1" 时面板显示「取消激活」入口(调试用) |
HTTPS_PROXY |
容器出网代理,家宽直连无需设置 |
全部运行数据存于命名卷 wxread_data(挂载到容器 /data):配置、Cookie、书架进度、章节池、日志、授权状态。删除容器不丢数据,重建/升级镜像自动继承。
- 文本通道:配置区填 SPT(wxpusher.zjiecode.com 首页扫码获取),承担每日开始/完成、Cookie 失效、风控告警等文字通知
- 图片通道:wxpusher.zjiecode.com/admin 创建应用获取
AT_appToken + 关注应用 + 「我的 UID」获取UID_,用于 Cookie 失效自动推送登录二维码 - 开启「失效后自动推扫码二维码」开关,并按需调整「自动扫码冷却(分钟)」(默认 30,防轰炸)
安装社区应用 WatchCow 后,取消 compose 文件中 labels: 段注释并上传一张图标,飞牛桌面/手机 App 自动出现「微信读书助手」图标,点击直达面板。
cd WxRead/wxread_docekr
git pull
docker compose up -d --build数据在卷中,升级不丢登录态与进度。升级后建议看一眼 docker logs --tail 50 wxreadassistant 确认正常。
cd WxRead/wxread_docekr
docker compose down # 停止并删除容器(数据卷保留,可随时重来)
docker compose down -v # ⚠️ 连数据卷一起删除:登录态/进度/配置/日志全部清除,不可恢复
docker rmi wxreadassistant:2.4.0 # (可选)清理镜像- 全新 Docker 发行版(独立目录
wxread_docekr/,与 Windows 版代码互不影响,去 Qt 化)。 - FastAPI + Alpine.js + ECharts Web 管理面板:总览 / 配置 / 报告 / 日志 4 Tab,40+ REST 端点 + SSE 实时日志。
- 容器内 Playwright 无头 Chromium 扫码登录;镜像内置 Chromium 运行库与 Noto CJK 中文字体(两阶段构建,HEALTHCHECK 心跳自检)。
- Cookie 失效自动恢复:硬失效自动唤起扫码会话,二维码经 WxPusher 推送到微信,长按识别即自动写回登录态并恢复阅读(真机闭环验证通过)。
- WxPusher 双通道:SPT 文本通知 + AppToken/UID 图片推送;未配图片通道自动降级文字提醒。
- 与 Windows 版同源的调度内核:进度驱动选书、8 类风控防线、Skill 30 分钟校准、本地授权(12h 试用)。
- 数据持久化于命名卷
wxread_data,删容器不丢数据;部署/配置/升级/卸载见上文 Docker 版章节。
- 修复主界面统计卡片「目标 120 分钟」与阅读状态区「今日目标」不一致:卡片目标改为读取当日计划
daily_plan.target_minutes(与调度器同源,不再硬编码 120),周/月/年参考进度同步联动;当日计划未生成时显示「目标待生成」。 - 修复 Skill 官方统计刷新后今日时长不更新:旧逻辑对本地估算与官方值取 max,本地每次固定 +45s 的估算系统性偏大(如本地 49 分钟 vs 官方 36 分钟),导致官方数据永远无法纠正显示。改为官方值 >0 时以官方数据为权威基线覆盖、随后本地继续实时累加;官方返回 0/接口失败时保留本地值不清零;跨天丢弃外部旧值。
- 统计卡片改为每轮上报后实时刷新,卡片与状态区时长保持一致;Skill 校准幅度 ≥1 分钟时日志输出「今日时长已按微信读书官方数据校准上调/下调 X → Y 分钟」。
- 构建:增量补丁删除清单自动过滤 Inno 卸载器(
unins000.*),避免补丁更新后无法卸载;复制/压缩环节增加杀软文件锁重试。
weread_api.read_once响应 8 类精细分类(ok / empty_200 / errcode / bad_response / http_error / network / internal_error / session_invalid),失败日志直接附带类型。- scheduler 新增软风控检测:登录态正常但 read 连续 3 次返回 HTTP 200 空
{}即判定软风控;连续 8 次任意失败判通用失败。 - 命中后指数退避自动冷却(60 → 120 → … → 360 分钟封顶),期间停止一切上报,主界面显示冷却倒计时;冷却结束自动试探,成功一次即恢复。
- WxPusher 新增「🚨 阅读风控提醒」推送,同类告警 3 小时限频,时间戳持久化重启不重复轰炸;阈值全部可在
config.json的risk节配置。
- read 端点对
CB_/MP_等非数字 bookId 一律返回空{};选书识别后立即永久拉黑并自动换书。 - 黑名单持久化于
local_db.json顶层blacklist,书架重新同步后标记保留;clear_all()不影响黑名单。
- 新增
app/core/licensing.py:- 16 位注册码(格式
XXXX-XXXX-XXXX-XXXX,Crockford Base32 + HMAC-SHA256 截断),全程零网络校验。 - 12 小时免费试用期:首次启动时间戳双备份(
local_db.json+ HKCU 注册表),取最早值防删除重置。 - 激活持久化:仅存注册码哈希,不存原文;
LocalDB.clear_all()保留授权段(清 Cookie 不掉激活)。 - 易混字符自动归一(O→0 / I、L→1)。
- 16 位注册码(格式
- 新增
app/ui/license_dialog.py:启动 0.8s 后若试用过期,弹出激活对话框(支持「稍后再说」;激活成功自动关闭)。 - 「⚙️ 配置中心」新增「🔑 授权管理」卡片:实时显示剩余试用期 / 已激活 / 已过期状态 + 注册码输入与激活。
- 门禁:过期后点「开始阅读」弹激活提示,跳转配置中心完成激活后再开始阅读。
- 注册码不绑定设备;获取注册码请联系开发者:QQ 37784552 / Email somnusweiwei1989@outlook.com。
- 新增 Inno Setup 6 安装包管线:
installer/wxread_assistant.iss安装脚本(简体中文向导,ArchitecturesAllowed=x64compatible,卸载器不动用户数据)。scripts/build_release.py新增第 7 步自动调用 ISCC,未安装 Inno Setup 时优雅跳过;新增安装器图标。- 新增
installer/Languages/ChineseSimplified.isl(kira-96 翻译,Inno Setup 6.5.0+ 兼容)。
- 产物新增
WxReadAssistant-vX.Y.Z-setup.exe(≈169 MB),推荐新手直接下载双击安装。 - 同时保留
full.zip(免安装)与patch.zip(增量升级,≈6 MB 小体积)。
- 新增
scripts/make_icon.py:基于运行时icon_store.make_app_icon()离屏渲染 16~256 共 7 个尺寸,Pillow 合成多尺寸assets/app_icon.ico。 WxReadAssistant.spec绑定icon='assets/app_icon.ico';SetupIconFile指向同一 ico。- 顺手修复 icon_store 既有 bug:封面白字斜体 W 之前因
setPen(NoPen)而不可见,现已改为白色笔,主视觉真正呈现。
app/core/notifier.py新增format_duration():推送消息中的时长改为人类可读形式。- 例:
8小时12分钟(原492 分钟),480 分钟→8小时,12 分钟→12分钟,0→0分钟。
- 例:
- v2.2.4 基础上新增:原生应用图标对齐(EXE/安装器/快捷方式)+ 封面白字 W 主视觉修复。
- 可视化报告页面 + stop/start 重入修复 + Skill 统计刷新 KeyError 修复 + 扫码登录主窗口闪烁修复。
- 修复「重置今日目标」按钮功能错误。
- 配置中心新增「重置今日目标」按钮。
- 修复跨天后
today_seconds未重置导致的「误判完成」bug。
- 主界面(米白纸 Paper Studio)+ 配置中心大改版 + 版本可见性胶囊 + 发布管线 + 增量补丁机制。
- 历史基线:米白纸 Paper Studio + 三列 3:4:4 布局 + 配色令牌体系。
- 版本号源:
app/ui/icon_store.py::APP_VERSION(打包脚本会自动改写) - Build ID:
app/ui/icon_store.py::APP_BUILD_ID=<git short sha> · <YYYYMMDD> - 显示位置:窗口标题 / 托盘 ToolTip / 主界面日志区右下胶囊 / 「⚙️ 配置中心」标题旁小胶囊 / 启动日志 banner。
- 一致性校验:Releases 页每个二进制附带对应 sha1 清单。
注册码仅由开发者生成与分发(纯本地校验)。需要购买或咨询请联系:
- 📱 QQ:37784552
- 📧 Email:somnusweiwei1989@outlook.com
仅供学习交流使用,请遵守微信读书用户协议。使用风险自负。