MZ魔改漫画app 档案室
READER MOD ARCHIVE · 2026

魔改漫画app 版本档案与改造手册

这里不卖软件,只记录折腾过程。从换源失效、图源校验,到双页排版、进度同步与插件副作用,把每一次改动能复现的部分留下来。

头条 · 实践

换源接口集体失效之后:一份可复现的图源校验流程

近一周多个公共图源返回 403 或空列表,很多人第一反应是重装。其实先做三步:确认请求头、比对列表字段、用单话图片直链验证。本文给出一条从抓包到回填的完整路径,并说明哪些改法会把问题从「图源挂了」变成「客户端自己崩」。

2026-11-18换源与图源约 12 分钟

头条 · 排版

双页跨页与条漫模式打架:重绘排版的三处关键参数

同一部作品在平板上被裁掉对白、在手机上又出现大黑边,多半不是图片分辨率问题,而是跨页判定与容器宽度算法不一致。这篇拆开 scaleType、双页合并阈值、页边距补偿三个参数,给出两套稳定组合,并附上验证用的测试页骨架。

2026-11-17排版与翻页约 9 分钟

版本档案

Version Ledger

从 2.x 到 3.x:旧配置文件迁移的五个坑

字段改名、默认值变化、布尔值被当成字符串读取——迁移前先备份 config 目录,再逐项对照。

迁移2026-11-12 · 配置

第三方构建版本怎么辨认来源与改动幅度

看包名后缀、签名指纹与资源目录哈希,三步判断是不是同一分支。

辨识2026-11-10 · 构建

降级安装失败:签名冲突与数据目录残留

卸载后数据仍在,导致新版本读到旧数据库;给出清理顺序与验证方法。

降级2026-11-08 · 安装

更新日志里最容易被忽略的一行:默认阅读方向

右起左翻被重置后,很多人误判为排版坏掉。

日志2026-11-05 · 细节

换源与图源

Source & Feeds

换源接口集体失效之后:一份可复现的图源校验流程

请求头、列表字段、单话直链三层验证,把「图源挂了」和「客户端崩了」分开。

校验2026-11-18 · 排查

图源列表返回空数组的六种原因

从编码、分页参数到反爬策略,逐条给出判断特征。

空列表2026-11-16 · 排错

图片直链带防盗链时,客户端该怎么补请求头

Referer 与 UA 的最小组合,以及不要盲目模仿浏览器完整头的原因。

反盗链2026-11-13 · 请求

多图源合并排序:按更新时间还是按章节完整度

两种排序在追更场景下的实际差异,以及混合策略。

排序2026-11-09 · 策略

排版与翻页

Layout & Paging

双页跨页与条漫模式打架:重绘排版的三处关键参数

scaleType、合并阈值、边距补偿,给出两套稳定组合。

跨页2026-11-17 · 排版

翻页动画掉帧:不是渲染引擎的锅

大图预解码与缓存上限设置不当,会让滑动明显迟滞。

性能2026-11-11 · 翻页

刘海屏与挖孔屏的安全区补偿写法

全屏阅读时上下被裁的常见原因与最小改动方案。

安全区2026-11-07 · 适配

夜间模式反色后,彩色页发灰的处理顺序

先调亮度曲线再改对比度,避免文字边缘出现色晕。

配色2026-11-03 · 阅读

插件与脚本

Plugins & Scripts

脚本注入的边界:哪些插件改动会触发校验失败

加载器顺序、签名校验、热更新回滚,三类问题的复现条件。

注入2026-11-15 · 安全

自写小脚本读取本地书库的正确姿势

只读权限、路径白名单、避免锁住数据库。

脚本2026-11-06 · 本地

插件冲突排查:二分法禁用清单

从十个插件里定位元凶,比逐个卸载更快。

冲突2026-11-02 · 排查

进度同步

Sync

阅读进度在设备之间乱跳,先别怪云端

时间戳格式、章节 ID 映射、离线队列冲突,逐项排查。

同步2026-11-14 · 排查

手动备份的最小集合:三个文件就够

书库索引、进度库、配置文件,恢复顺序不能反。

备份2026-11-04 · 数据

换机迁移时章节 ID 对不上的处理办法

用标题归一化重建映射,避免进度全部归零。

迁移2026-10-30 · 数据

换源接口集体失效之后:一份可复现的图源校验流程

换源与图源 · 2026-11-18 · 约 12 分钟

公共图源在短时间内集体返回 403 或空列表,是改造圈里最常见的场景。第一步不是重装客户端,而是把「客户端请求」与「图源响应」拆开。用系统自带的网络面板或任意抓包工具,只观察一次换源请求:看请求头里的 UA 是否被改成客户端标识、Referer 是否为空、Accept 是否包含图片类型。很多所谓的图源失效,实际是客户端在某一版里把请求头改成了不被接受的组合。

第二步校验列表字段。正常返回应当是一个包含标题、章节数、更新时间的数组;如果返回 HTML 登录页,说明被重定向;如果返回字段名被改过,说明图源换了接口版本。此时把返回体保存下来,与上一版成功记录逐字段比对,能迅速判断是「全部图源挂了」还是「解析规则需要更新」。

最小验证法:随便挑一部作品的最新一话,直接请求第一张图片的直链。能出图,问题在列表解析;不能出图,问题在请求头或网络。

第三步才是回填。回填时不要一次改多个字段,先改请求头,再改列表解析,最后才动排序策略。每改一项,重新跑一次单话直链验证。这样即使再次失败,也能准确知道是哪一步引入了新问题。

双页跨页与条漫模式打架:重绘排版的三处关键参数

排版与翻页 · 2026-11-17 · 约 9 分钟

跨页裁切问题的根源通常在容器宽度与图片宽高比的计算顺序。第一处参数是缩放方式:填满容器会让横图被纵向裁掉,适应容器则容易留下黑边。第二处是双页合并阈值:当相邻两页宽度之和超过容器宽度的某个比例时才合并,比例设得过低会把普通单页也拼在一起。第三处是页边距补偿:安全区与页边距叠加时,实际可用宽度会被重复扣减。

一套稳定的组合是:缩放方式选适应容器,合并阈值设为 1.6 倍容器宽,页边距补偿只作用于全屏模式。这样在平板上跨页不会被裁,在手机上单页也不会缩得太小。验证时准备一张纯色测试页与一张带对白的跨页图,切换三种屏幕宽度各看一次,基本能覆盖大多数异常。

如果只有某一部作品出问题,优先检查该作品图片的宽高比是否异常,而不是全局参数。

脚本注入的边界:哪些插件改动会触发校验失败

插件与脚本 · 2026-11-15 · 约 8 分钟

插件冲突往往表现为启动即闪退或某功能静默失效。加载器顺序是第一嫌疑:后加载的脚本覆盖了先加载的同名方法,导致调用链断裂。第二嫌疑是签名校验:部分构建会在启动时比对资源目录哈希,任何被替换的脚本都会让校验失败。第三嫌疑是热更新回滚:更新包解压失败后残留半成品文件,下一次启动读取到不完整脚本。

排查时采用二分法:先禁用一半插件,观察是否恢复;再对剩下的继续对半禁用。通常三到四轮就能定位。定位后不要急着删除,先看该插件是否依赖了被改名的接口,很多时候只需改一行调用即可恢复。

阅读进度在设备之间乱跳,先别怪云端

进度同步 · 2026-11-14 · 约 7 分钟

进度错乱的三个常见来源:一是时间戳格式不一致,一端用秒级、一端用毫秒级,比较时小的反而被当成更新;二是章节 ID 映射不同,不同图源对同一话编号不同,同步后指向了错误章节;三是离线队列冲突,断网时产生的进度在恢复网络后与云端记录互相覆盖。

处理顺序建议从数据层开始:先导出进度库,检查时间戳单位是否统一;再用标题归一化重建章节映射;最后清理离线队列并重新同步一次。手动备份的最小集合是书库索引、进度库、配置文件三个,恢复时先放索引再放进度,顺序反了会读到空书库。

从 2.x 到 3.x:旧配置文件迁移的五个坑

版本档案 · 2026-11-12 · 约 6 分钟

大版本迁移最常见的五个问题:字段改名后旧键被忽略且不报错;默认值变化让原本开启的功能变成关闭;布尔值被写成字符串导致判断恒为真;列表结构从数组变成对象;以及路径分隔符在不同平台下的差异。迁移前务必备份 config 目录,迁移后逐项对照新版的默认配置。

如果发现某项设置「改了没反应」,先查该键是否在新版中被重命名,再查是否有更高优先级的覆盖文件。很多迁移失败并不是数据丢失,而是读到了另一份配置。