Skip to content
SomnusWeiPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

📖 WxReadAssistant

微信读书自动阅读助手,提供两个独立发行版:

  • 🖥️ 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 一条命令

第一部分:🖥️ Windows 桌面版(v2.3.1)

基于 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% 的书;单章阅读 45 次后换章;100% 换书;跳过封面/版权页(uid 133)
混合完成度检测 本地实时累加阅读秒数 + 每 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 不阻塞

📊 阅读统计 4 项

通过微信读书 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 位注册码激活,激活方式:⚙️ 配置中心 → 🔑 授权管理。
  • 注册码在本地校验,无需联网;激活后永久使用全部功能。
  • 注册码不绑定设备,同一注册码可在多台机器激活。

🔐 获取注册码请联系开发者

技术架构

┌──────────────────────────────────────────────────────────────┐
│                    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. 命中软风控(连续空响应/连续失败)→ 停止上报,指数退避冷却后自动试探

CDP 登录流程

  1. 启动 Chrome(--remote-debugging-port=9223)
  2. 程序连接 CDP WebSocket
  3. 用户在 Chrome 中扫码登录微信读书
  4. 通过 Network.getCookies 获取 wr_* Cookie(按名称前缀白名单过滤)
  5. 登录成功后保持 WebSocket 活跃,直到书架与章节池拉取完成
  6. Cookie 持久化,后续请求动态生成 baggage/sentry-trace 头绕过风控

Skill API 端点

端点 用途
/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 会定期清理。

首次使用

  1. 主页 → 「📷 扫码登录」按提示使用 Chrome CDP 扫码获取 Cookie。
  2. 主页 → 「获取数据」拉取书架与章节池。
  3. (可选)进入「⚙️ 配置中心」填入 Skill API Key / WxPusher Token。
  4. (可选)试用期结束后,「⚙️ 配置中心 → 🔑 授权管理」输入注册码激活。
  5. 点「开始阅读」。

🔐 获取注册码: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 天保留,便于即时排查)。

第二部分:🐳 Docker 版(v2.4.0)

面向 NAS / Linux 服务器的 7×24 挂机发行版。Web 管理面板替代桌面 UI,全部代码位于独立目录 wxread_docekr/(去 Qt 化,与 Windows 版互不影响)。详细部署文档见 wxread_docekr/DEPLOY.md。

功能特性(相对 Windows 版的差异)

能力 说明
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

首次使用

  1. 浏览器打开 http://<NAS_IP>:5911
  2. 「配置」Tab → Skill 区填入 API Key → 「验证 Skill」
  3. 「总览」Tab → 「扫码登录」,手机微信扫码(二维码 90 秒有效,可点「重新获取」)
  4. 登录成功后调度器自动启动开始阅读,无需手动点开始
  5. (可选)推送区配置 WxPusher 并点「测试推送」验证双通道(见下)
  6. (可选)「授权」区输入注册码激活(12 小时免费试用到期前)

端口与安全

  • compose 默认发布 "5911:5911",局域网内可直接访问;不可信环境改为 "127.0.0.1:5911:5911"(仅本机/SSH 隧道/反代可达)
  • 公网暴露必须:① 设置 WXREAD_WEB_TOKEN 启用 Bearer 鉴权;② 外层套 Nginx/Caddy 启用 HTTPS
  • 信任内网(家用局域网)可留空 Token,面板免输入直达

配置

环境变量(编辑 docker-compose.yml 的 environment 段)

变量 说明
WXREAD_LICENSE_CODE 启动自动激活注册码;推荐留空,首次启动后在面板激活(激活状态持久化,只填一次)
WXREAD_WEB_TOKEN 面板 Bearer Token,留空不启用鉴权
TZ 时区,默认 Asia/Shanghai
WXREAD_LICENSE_ADV 设为 "1" 时面板显示「取消激活」入口(调试用)
HTTPS_PROXY 容器出网代理,家宽直连无需设置

数据持久化

全部运行数据存于命名卷 wxread_data(挂载到容器 /data):配置、Cookie、书架进度、章节池、日志、授权状态。删除容器不丢数据,重建/升级镜像自动继承。

WxPusher 推送(文本 + 图片双通道)

  • 文本通道:配置区填 SPT(wxpusher.zjiecode.com 首页扫码获取),承担每日开始/完成、Cookie 失效、风控告警等文字通知
  • 图片通道:wxpusher.zjiecode.com/admin 创建应用获取 AT_ appToken + 关注应用 + 「我的 UID」获取 UID_,用于 Cookie 失效自动推送登录二维码
  • 开启「失效后自动推扫码二维码」开关,并按需调整「自动扫码冷却(分钟)」(默认 30,防轰炸)

飞牛 fnOS 桌面图标(可选)

安装社区应用 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   # (可选)清理镜像

CHANGELOG

v2.4.0 — 2026-09-14(🐳 Docker 版首发)

  • 全新 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 版章节。

v2.3.1 — 2026-09-13(🖥️ Windows 桌面版)

📊 今日阅读统计修复

  • 修复主界面统计卡片「目标 120 分钟」与阅读状态区「今日目标」不一致:卡片目标改为读取当日计划 daily_plan.target_minutes(与调度器同源,不再硬编码 120),周/月/年参考进度同步联动;当日计划未生成时显示「目标待生成」。
  • 修复 Skill 官方统计刷新后今日时长不更新:旧逻辑对本地估算与官方值取 max,本地每次固定 +45s 的估算系统性偏大(如本地 49 分钟 vs 官方 36 分钟),导致官方数据永远无法纠正显示。改为官方值 >0 时以官方数据为权威基线覆盖、随后本地继续实时累加;官方返回 0/接口失败时保留本地值不清零;跨天丢弃外部旧值。
  • 统计卡片改为每轮上报后实时刷新,卡片与状态区时长保持一致;Skill 校准幅度 ≥1 分钟时日志输出「今日时长已按微信读书官方数据校准上调/下调 X → Y 分钟」。
  • 构建:增量补丁删除清单自动过滤 Inno 卸载器(unins000.*),避免补丁更新后无法卸载;复制/压缩环节增加杀软文件锁重试。

v2.3.0 — 2026-09-13

🛡️ 阅读风控自动防线

  • 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() 不影响黑名单。

v2.2.6 — 2026-08-28

🔑 本地授权系统(新功能)

  • 新增 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)。
  • 新增 app/ui/license_dialog.py:启动 0.8s 后若试用过期,弹出激活对话框(支持「稍后再说」;激活成功自动关闭)。
  • 「⚙️ 配置中心」新增「🔑 授权管理」卡片:实时显示剩余试用期 / 已激活 / 已过期状态 + 注册码输入与激活。
  • 门禁:过期后点「开始阅读」弹激活提示,跳转配置中心完成激活后再开始阅读。
  • 注册码不绑定设备;获取注册码请联系开发者:QQ 37784552 / Email somnusweiwei1989@outlook.com。

📦 发布形态升级(Windows 安装包)

  • 新增 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 小体积)。

🎨 应用图标对齐(EXE/安装器/任务栏 同源)

  • 新增 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) 而不可见,现已改为白色笔,主视觉真正呈现。

📨 WxPusher 消息时长格式优化

  • app/core/notifier.py 新增 format_duration():推送消息中的时长改为人类可读形式。
    • 例:8小时12分钟(原 492 分钟),480 分钟→8小时,12 分钟→12分钟,0→0分钟。

v2.2.5 — 2026-08-28

  • v2.2.4 基础上新增:原生应用图标对齐(EXE/安装器/快捷方式)+ 封面白字 W 主视觉修复。

v2.2.4 — 2026-08-27

  • 可视化报告页面 + stop/start 重入修复 + Skill 统计刷新 KeyError 修复 + 扫码登录主窗口闪烁修复。

v2.2.3 — 2026-08-26

  • 修复「重置今日目标」按钮功能错误。

v2.2.2 — 2026-08-26

  • 配置中心新增「重置今日目标」按钮。

v2.2.1 — 2026-08-25

  • 修复跨天后 today_seconds 未重置导致的「误判完成」bug。

v2.2.0 — 2026-08-25

  • 主界面(米白纸 Paper Studio)+ 配置中心大改版 + 版本可见性胶囊 + 发布管线 + 增量补丁机制。

v2.1.0 — 2026-07

  • 历史基线:米白纸 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 清单。

🔐 获取注册码

注册码仅由开发者生成与分发(纯本地校验)。需要购买或咨询请联系:

License

仅供学习交流使用,请遵守微信读书用户协议。使用风险自负。

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages