配置文件系统 —— 按书类自动套用整套设置
为什么用配置文件
不同类型的书对排版和阅读设置的需求不同：
- 小说：字号适中、行距 1.5、标准边距
- 技术论文：字号稍大、行距宽松、双栏
- 漫画：字号无所谓、刷新频率加快、翻页方向日系
- 扫描书：启用 K2pdfopt 重排、启用 OCR
如果每次换书都重新调这些参数——很麻烦。KOReader 的配置文件系统就是为自动化这个过程设计的。
什么是配置文件
配置文件 = 一套排版和设备设置的集合。每个配置文件可以绑定到特定文件类型、目录或书籍。
KOReader 支持三种绑定方式：
| 绑定方式 | 触发条件 | 适用场景 |
|---|---|---|
| 按文件扩展名 | 打开 .epub 用配置 A，打开 .pdf 用配置 B | 最常用，按格式分 |
| 按目录 | 打开 Books/技术/ 目录下的书用配置 C | 按主题分 |
| 按书籍 | 指定某本书用配置 D | 特例 |
创建配置文件
第一步：手动调整一本的设置
假设你正在看一本小说，把排版调到满意：
- 字号 18px
- 行距 1.5
- 字体 思源宋体
- 夜间模式开启
- 自动色温开启
第二步：保存为配置文件
- 进入文档设置 → 配置文件
- 点击「保存当前设置为配置文件」
- 命名（如"小说默认"）
- 选择绑定规则（按
.epub扩展名）
第三步：自动套用
之后你任何时候打开 EPUB 格式的书，KOReader 自动套用"小说默认"配置——不需要再手动调。
多配置文件层级
KOReader 允许配置文件叠加：
全局默认 → 按扩展名配置 → 按目录配置 → 按书籍配置 → 当前手动调整
例如：
- 全局默认：字号 16px
.epub配置：字号 18px（覆盖全局）Books/科幻/目录配置：字号 20px（覆盖扩展名）- 某本书：字号 22px（覆盖目录）
- 当前手动调到 21px（临时覆盖所有）
层级从高到低，高的覆盖低的。
建议配置方案
├── 全局默认
│ └── 字号 16px、行距 1.3
├── EPUB/流式文档
│ └── 字号 18px、字体思源宋体
├── PDF
│ └── 启用裁边、K2pdfopt 重排
├── CBZ/漫画
│ └── 翻页方向右到左、图像预处理
├── 目录配置
│ ├── Books/技术论文/
│ │ └── 字号 20px、行距 2.0、分栏
│ └── Books/睡前读物/
│ └── 夜间模式 + 暖光色温编辑配置文件
配置文件以 Lua 表格式存储在 KOReader 配置目录的 profile.lua（或类似命名）中。
建议通过 KOReader 界面编辑，不要手动改——改坏了 KOReader 可能无法启动。
用户补丁（User Patches）
更高级的定制方式——用户补丁。这是 KOReader 深度定制的隐藏武器：
什么是用户补丁
KOReader 允许你替换或扩展内置的 Lua 模块——修改渲染逻辑、添加新功能、改变默认行为。
社区补丁库
KOReader 社区维护了一批现成补丁：
- 改变刷新频率策略
- 改变翻页动画
- 添加新的手势
- 修改排版算法
- 替换菜单文案
如何安装补丁
- 找到你想用的补丁代码
- 放到 KOReader 配置目录下的
patch/子目录 - 重启 KOReader
- 在「设置 → 用户补丁」中启用
警告：用户补丁是 Lua 代码，可能导致 KOReader 不稳定。使用前务必备份配置目录，新补丁先在测试版本上试用。
常见问题
配置文件被覆盖了？
配置文件是最后一次手动调整保存的。如果你临时调了字号没保存，下次打开书还是用配置文件的值。想让临时调整成为永久配置——记得"保存为配置文件"。
多配置文件冲突？
用叠加层级就能解决——高优先级覆盖低优先级。如果还有问题，删掉冲突的配置文件重新建。
用户补丁让 KOReader 崩了？
- 手动删除 patch 目录下的问题补丁文件
- 重启 KOReader（应该能正常启动）
- 反馈到 KOReader 社区