墨水屏上看扫描版 PDF 不再眯眼：KOReader K2pdfopt 重排完整上手指南
【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader
地铁上打开扫描版 PDF，字小到眯眼，放大又得来回拖动。KOReader 内置了 K2pdfopt 引擎，能把扫描版 PDF"重新排版"成随屏幕宽度自动换行的流式格式。本文带你把它用起来、看懂它怎么工作，再学会调参排错。
官方 README.md 里的一句话概括了这个功能："Scanned PDF/DjVu documents can also be reflowed with the built-in K2pdfopt library。"——直白点说：扫描版 PDF 和 DjVu 不再是"一张图"，而是能按你的屏幕重新排版的文字。
📖 快速上手：5 步开启文档重排
- 把扫描版 PDF 放进阅读器目录，用 KOReader 打开。PDF 会走 K2pdfopt 引擎，和 EPUB 那种 HTML 排版是两套体系。
- 点按屏幕中央唤出阅读器菜单，操作区域见下图。
- 进入"设置"打开排版面板，按图标分了裁剪、缩放、字号、对比度等几个标签页，全部参数定义在 frontend/ui/data/koptoptions.lua。
- 在"字号"标签页里把Reflow（重排）：off切到on。
- 翻一页等几秒：第一页是实时重排的，第二页会在后台预渲染，往后翻会越来越快。
两个小提醒：行距、提取质量这几项属于"高级选项"，需在设置面板里勾选"显示高级选项"才会出现；文档语言默认是英语（eng），中文书记得先改。
它是怎么工作的：像把扫描书重新打字一遍
重排（reflow）可以想象成一位编辑拿到扫描照片后做四件事：
- 认字：逐页分析图像，找出文字和图片区域；页面没有文字层时，就用内置的 Tesseract OCR 识别（所以有"文档语言"选项）。
- 拆版重排：打散原来的版面，按屏幕宽度和阅读顺序重新排版，原版的栏位、留白都不再照搬。
- 按你的口味渲染：套用字号比例、行距、字间距、对比度等参数输出成品。
- 缓存：重排结果按页缓存，回翻不重算；下一页后台提前算好。
真正的活由 frontend/document/koptinterface.lua 调用 libk2pdfopt 完成，而 frontend/apps/reader/modules/readerkoptlistener.lua 负责协调重排与缩放、语言切换等行为。
重排开启后有个有意思的行为：KOReader 会强制"整页适配"缩放，不再让你反复放大缩小——这正是当初最烦的那件事被自动处理了。语言切换时也有自动逻辑，源码里能直接看到：
-- readerkoptlistener.lua：切换文档语言时自动改字间距 if lang == "chi_sim" or lang == "chi_tra" or lang == "jpn" or lang == "kor" then self.document.configurable.word_spacing = G_defaults:readSetting("DKOPTREADER_CONFIG_WORD_SPACINGS")[1] else self.document.configurable.word_spacing = G_defaults:readSetting("DKOPTREADER_CONFIG_WORD_SPACINGS")[3] end白话：中文、日文、韩文默认收紧字间距，拉丁文字放宽，不用你手动猜。
🛠 参数调优实战：遇到什么问题改哪个
默认值统一写在 defaults.lua（DKOPTREADER_CONFIG_ 开头的配置块），下表每个参数都只列一次。
| 参数（菜单名） | 作用 | 推荐范围（默认） | 遇到什么情况调它 |
|---|---|---|---|
| Reflow（重排） | 总开关，on 才走 K2pdfopt 重排 | on（默认 off） | 字太小眯眼、来回缩放，直接开它 |
| font_size（字号比例） | 按原稿字体大小的倍率缩放文字 | 0.1–3.0，常用 0.8–1.6（1.0） | 重排后字还是偏小或偏大 |
| line_spacing（行距） | 重排模式的行间距 | 1.0/1.2/1.4 小/中/大（1.2） | 行挤在一起，压眼睛 |
| word_spacing（字间距） | 词与词之间的间隙 | 小 0.05 / 自动 −0.2 / 大 0.375 | 中文太密、英文太散 |
| page_margin（页边距） | 裁剪与适配之后的页边距 | 0.05–1.0（0.10） | 文字贴边、想留白呼吸感 |
| quality（提取质量） | 文字/图片提取与输出的质量 | 0.5/1.0/1.5 低/默认/高（1.0） | 发虚调高；嫌慢调低 |
| contrast（对比度） | 伽马对比 | 0.8–2.0 常用（1.0） | 发灰、对比不足 |
| white_threshold（白化阈值） | 高于阈值的像素一律渲染成白 | 255 关闭，128/96 更强（255） | 灰底、水印、扫描件脏背景 |
| auto_straighten（自动摆正） | 倾斜扫描页的最大纠正角度 | 0–25°（0） | 扫描页歪斜 |
| max_columns（文档栏数） | 原稿最多按几栏识别 | 1–3（2） | 双栏文章被读串、段落错乱 |
| trim_page（页面裁剪） | 裁掉原页空白边 | 不裁/自动/半自动/手动（自动） | 页边过宽、有污渍干扰 |
| doc_language（文档语言） | OCR 识别语言 | eng、chi_sim 等（eng） | 中文选词、重排识别不准 |
调参思路一句话：先 font_size 和 line_spacing 定骨架，再 quality 和 white_threshold 治模糊，最后 word_spacing 抠细节。
❓ 常见问题解答
Q1：重排后文字发虚、有灰蒙蒙的感觉现象：放大后边缘模糊，背景偏灰。 原因：提取质量偏低，灰阶像素被原样保留。 解决：quality 调"高"（1.5）；背景仍灰就把 white_threshold 从 255 降到 128 或 96，把浅灰清成纯白。
Q2：双栏论文被搅成一栏，段落顺序乱现象：左栏读半截跳到右栏，或整段错位。 原因：K2pdfopt 栏数检测判断错了。 解决：max_columns 改成 1 或 2 再试；对齐（justification）切到"auto"，它会尽量跟随原稿排版。
Q3：第一页等很久，重排太慢现象：打开文档卡住十几秒。 原因：重排是"识别＋重新排版"，第一页最贵，而且只做一次。 解决：先翻页，下一页是后台预渲染的，稍等再回来看；实在慢就把 quality 调"低"（0.5）。结果有缓存，下次打开同一本书不会重算。
Q4：中文书重排后选词不准、查词典查不到现象：划选出的词是乱码或错词。 原因：文档语言还是默认的英语。 解决：在"设置"标签页把 doc_language 改成 chi_sim；字间距也会自动按 CJK 收紧（上面那段代码干的活）。
写在最后
对大多数扫描版 PDF，打开重排再把字号拉到舒服的位置，阅读体验就有明显改善；图文混排多的书再按上表微调 quality 和 white_threshold。更多细节可以看 doc/Development_guide.md 和 README.md，遇到个别"疑难杂症"文档，欢迎到 KOReader 的 issue 系统里描述你的文档情况，社区响应一向不错。现在就可以挑一本扫描版 PDF，点一下那个 Reflow 开关试试。
【免费下载链接】koreaderAn ebook reader application supporting PDF, DjVu, EPUB, FB2 and many more formats, running on Cervantes, Kindle, Kobo, PocketBook and Android devices项目地址: https://gitcode.com/GitHub_Trending/ko/koreader
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
