Leko Reader

欢迎使用 Leko Reader。

它是 Kindle 第三方阅读器里的网络小说插件，有自己的书架、搜书、目录和阅读界面，也可以缓存全书并导出 TXT、EPUB 或 MOBI。

Leko = Legado + KOReader。

说明： Leko Reader 不提供、收集、维护、推荐或分发任何第三方网络书源，也不提供小说、电子书或其他第三方阅读内容。请仅使用您有权访问和使用的内容。完整说明见下文“使用与版权声明”。

主要功能

全程本地运行。 书源解析和阅读流程均在 Kindle 端完成，无需手机端 Legado 或外部阅读服务器。

• 独立书架与阅读进度
• 多书源搜索，结果可陆续显示
• 搜索结果直接试读，再决定是否加入书架
• 目录浏览、章节跳转与阅读排版
• 书籍换源与封面换源
• 手动刷新书籍信息、目录与当前章节
• 全书缓存与离线阅读
• TXT、EPUB、MOBI 导出
• 书源启用、停用、排序、检测与备份恢复
• 手机扫码导入书源
• 存储与缓存管理
• JavaScript 引擎检查与错误诊断

开始前，先看一眼 Kindle

第一次安装其实只需要做三件事：把文件夹复制进 Kindle、重启第三方阅读器、打开《欢迎来到 Leko》。下面一步一步来。

用数据线把 Kindle 连接到电脑，打开 Kindle 磁盘。

如果里面已经有一个名为 koreader 的文件夹，就可以继续安装 Leko。这里的 KOReader，就是大家常说的“Kindle 第三方阅读器”。

如果没有这个文件夹，说明第三方阅读器还没有安装好。Leko 需要在 KOReader 里面运行，所以要先完成 KOReader 的安装。

联网搜书还需要一份你自己的书源。没有书源也没关系，Leko 书架会自带一本《欢迎来到 Leko》，可以先熟悉所有主要功能。

安装 Leko

1. 解压下载的 ZIP

下载的文件名类似：

Leko-Reader-KOReader-<版本号>.zip

在电脑上解压后，会得到一个名为 leko.koplugin 的文件夹。打开这个文件夹，应该能直接看到 main.lua 和 Leko 文件夹。

如果解压后看到两层同名文件夹，以实际包含 main.lua 的那一层为准。

2. 复制到 Kindle

依次打开 Kindle 磁盘里的：

koreader → plugins

把整个 leko.koplugin 文件夹复制进去。

复制完成后，文件位置应该是：

koreader/plugins/leko.koplugin/main.lua

plugins 文件夹不存在时，可以在 koreader 里面新建一个。

3. 重启第三方阅读器

在电脑上安全弹出 Kindle，然后完全退出 KOReader，再重新打开。只回到文件列表不会重新加载插件。

4. 打开 Leko 书架

进入 KOReader 的文件管理器主界面，顶栏通常会出现 Leko 书架图标，点一下就能打开。

有些 KOReader 版本或 SimpleUI 会调整顶栏。如果没有看到图标，可以打开右上角菜单，在“更多工具”或“插件”中找到 Leko Reader。

看到标题为“Leko 书架”的页面，安装就完成了。

如果入口没有出现，可以重新确认两件事：文件是不是位于 koreader/plugins/leko.koplugin/main.lua，以及 KOReader 是否已经完全退出并重新启动。

第一次打开，从《欢迎来到 Leko》开始

第一次进入 Leko 书架时，会看到一本《欢迎来到 Leko》。它是放在 Kindle 本地的完整使用说明书，不需要 Wi-Fi。

直接打开它，就能一边翻页一边了解书架、书源、搜索、试读、排版、换源、更新、全书缓存、导出和故障排查。它共有九章，可以从目录自由跳转，不必一次读完。

如果这本书能够正常打开、翻页和显示目录，说明 Leko 书架与内置阅读器已经正常工作。

如果想确认联网书源所需的 JavaScript 引擎也能工作，可以运行：

菜单 → 书源 → 管理书源 → JavaScript 引擎检查

看到“JavaScript 引擎工作正常”，就可以继续导入书源和搜书。

准备联网搜书

书源是什么？

书源可以理解成一份“网站使用说明”。它告诉 Leko 去哪里搜索、哪里是书名和作者、怎样找到目录，以及怎样取得章节正文。

书源通常是一份 .json 文件，也可能是一个导入网址。Leko 的安装包不预装网络书源，网络书源由用户自行配置。

用手机导入（推荐）

不想在 Kindle 上输入长网址时，可以直接用手机发送书源：

1. 让 Kindle 和手机连接同一个 Wi-Fi。
2. 打开 Leko 书架 → 菜单 → 书源 → 用手机导入。
3. 用手机扫描 Kindle 上的二维码。
4. 在手机页面粘贴书源网址、粘贴书源 JSON 内容，或选择本地 .json 文件。
5. Kindle 会显示下载、解析和保存进度；完成后，手机页面可以继续发送下一份书源，不必重新扫码。

手机页面只在 Kindle 的临时地址上工作，不需要第三方二维码网站，也不会把书源发送到 Leko 之外的服务。

备用：导入 JSON 文件

1. 把书源 JSON 文件复制到 Kindle。
2. 打开 Leko 书架 → 菜单 → 书源。
3. 选择“从文件导入”。
4. 找到刚才复制的文件，确认导入。

备用：使用导入网址

1. 让 Kindle 连上 Wi-Fi。
2. 打开 Leko 书架 → 菜单 → 书源。
3. 选择“通过网址导入”。
4. 输入完整网址，点“导入”。

导入完成后回到书架，打开右上角菜单，选择“查找书籍”，输入书名即可。

搜索结果怎样用

搜索开始后，结果会陆续出现，不需要等全部书源完成。

打开一本书时，Leko 会继续取得书籍详情、目录和第一章，所以会比刚看到搜索结果多等一会儿。进入正文后可以直接试读，退出时再选择：

• “加入书架并退出”：把书留下，以后从 Leko 书架继续读；
• “仅退出”：这次只试读，不加入书架；
• “继续阅读”：回到刚才的正文。

阅读时常用的功能

调整排版

阅读正文时点“排版”，可以选择 KOReader 中已经安装的字体，也可以调整字号、行距、页边距、段间距和首行缩进。设置会立即应用，不需要重新打开书籍。

字体的 Regular、Bold 和 Italic 等样式会分别显示。如果 Kindle 里有几份同名字体，点一下字体名称，再按文件位置选择即可。这里选择的字体只影响 Leko 阅读界面；导出的 TXT、EPUB 和 MOBI 仍由打开它们的阅读器决定字体。

“动画效果”控制阅读时的页面切换，默认开启。需要在跨章时进一步清理墨水屏残影，可以另外开启“跨章净屏动画”；关闭“动画效果”会同时关闭所有页面动画。

打开目录

点正文顶部的“目录”，可以翻页浏览完整目录，也可以按章节序号跳转。

换一个正文来源

打开“书籍详情”，选择“书籍换源”。当某个来源缺章、乱码、正文错误或访问较慢时，可以换另一条书源继续读。

“封面换源”只更换封面，不会改变正文来源。

检查新章节

打开 书籍详情 → 更多 → 刷新目录与书籍信息。

Leko 默认由用户手动检查更新，这样平时阅读和待机时不会为了查更新反复联网。

重新读取当前章

正文异常时，可以点阅读页的“刷新本章”，重新下载这一章。

缓存全书和导出

打开 书籍详情 → 更多，可以开始或暂停全书缓存。Leko 会按章节下载，并保留已经完成的进度。

全书缓存完成后，可以导出：

• TXT：最简单，兼容范围很广；
• EPUB：带封面、目录和电子书排版；
• MOBI：适合放进较老 Kindle 的原生书库。

导出 MOBI 时，默认选择 Kindle 的 documents 根目录，完成后更容易被原生书库发现。导出位置可以在 Leko 书架 → 菜单 → 导出设置 中修改。

导出时还会显示一次章节进度，因为插件需要把缓存逐章读取并转换成目标格式。这一阶段通常不再重新下载正文。

管理书源

打开 菜单 → 书源 → 管理书源，可以查看所有已导入书源。

长按一条书源，可以把它放到优先搜索、自动排序或搜索末尾，也可以启用、停用、删除和检查连通性。

“可使用”表示 Leko 支持这条书源当前检测到的必要功能；网站当时能否连接、书源是否仍然有效，还要看实际使用结果。

每次导入书源时，Leko 都会保留一份原始备份。需要找回时，打开 菜单 → 书源 → 从备份恢复，按日期选择即可；也可以从 存储与缓存 → 书源备份 进入。恢复会添加或更新备份中的书源，不会删除其他现有书源。

如果误删了本地的《欢迎来到 Leko》，可以在书源菜单中选择“把欢迎书放回书架”。这个操作只重新生成本地欢迎书，不会改动已经导入的网络书源。

查看和清理存储空间

打开 菜单 → 存储与缓存，可以查看搜索缓存、详情与目录缓存、图片缓存、临时下载和已下载章节分别占用了多少空间。

搜索、详情和图片缓存可以在需要时重新生成；已下载章节用于离线阅读和导出，属于书籍数据。

遇到问题时

可以按这个顺序检查：

1. 打开书架中的《欢迎来到 Leko》，确认目录和正文可以显示。
2. 运行“JavaScript 引擎检查”。
3. 用另一条书源搜索同一本书。
4. 检查 Kindle 的 Wi-Fi、日期和时间。
5. 打开 存储与缓存 → 最近一次错误 查看原因。

如果《欢迎来到 Leko》可以正常阅读，只有某条网络书源失败，通常与那条书源或网站当前状态有关。如果欢迎书也无法打开，可以先检查安装路径、KOReader 版本和“最近一次错误”。

升级 Leko

1. 完全退出 KOReader。
2. 备份旧的 leko.koplugin 文件夹，并把它移出 plugins。
3. 把新版 leko.koplugin 复制进去。
4. 重新打开 KOReader。

普通升级会保留 Leko 的书架、书源、阅读位置和书源排序设置。

关于 Leko

Leko 得名于 Legado + KOReader。

Leko Reader 是独立实现的 KOReader 插件，通过自己的规则解析、JavaScript 运行时和网络层解析兼容的 Legado 书源，并在 KOReader 中提供完整的书架与阅读流程。

Leko Reader 不包含 Legado 或 KOReader 本体。

Leko Reader 与 Legado、KOReader、书源维护者、内容网站、作者、出版机构及其他第三方均不存在隶属、授权、合作或背书关系。

使用与版权声明

Leko Reader 是一个独立开发的开源阅读工具，用于在 KOReader 中进行本地阅读，以及解析用户自行导入的兼容规则。

本项目仅供合法内容的个人阅读、技术研究与互操作性研究使用。请支持正版阅读，并尊重作者、出版方、内容网站及其他权利人的合法权益。

Leko Reader 不提供、收集、维护、推荐或分发任何第三方网络书源，也不提供小说、电子书或其他第三方受版权保护内容。用户导入、编写或获取的书源、规则、网址及通过这些规则访问的内容，均来自用户自行选择的第三方来源，与本项目无关。

用户应自行确认其有权访问和使用相关内容，并确保使用行为符合所在地适用的法律法规、第三方网站的使用规则及相关权利人的授权要求。请勿使用 Leko Reader 获取、复制、缓存、导出或传播无权访问或使用的内容，亦不得将本项目用于绕过付费机制、数字版权管理（DRM）或其他访问控制措施。

Leko Reader 仅提供通用的规则解析、网络请求、内容阅读、缓存与格式转换能力。项目不对用户自行导入的第三方书源是否合法、安全、准确或持续可用作出保证，也不对任何第三方网站、书源或其提供的内容作任何背书。

因用户自行导入、编写、修改、分享或使用第三方书源，以及由此产生的内容访问、保存、转换或传播行为所产生的责任，应由相应行为的实施者自行承担。

如果您认为 Leko Reader 项目仓库或官方发布内容本身侵犯了您的合法权益，请通过项目 Issue 联系维护者，并提供足以定位相关内容的信息，我们会认真核查并处理。

第三方组件与许可证

Leko Reader 使用 AGPL-3.0-or-later，完整文本见根目录的 LICENSE。

JavaScript 引擎使用官方 QuickJS 2026-06-04，许可证为 MIT。上游源码归档 SHA-256 为：

b376e839b322978313d929fd20663b11ba58b75df5a46c126dd19ea2fa70ad2a

QuickJS 的完整许可证保存在 native/QUICKJS-LICENSE.txt，安装包内也有一份。QuickJS 上游地址为 https://bellard.org/quickjs/ 。

Leko 使用 KOReader 提供的 Lua 插件接口；KOReader 本身不包含在本仓库中，项目源码与许可证以 https://github.com/koreader/koreader 为准。

手机导入页面使用项目内的纯 Lua 标准二维码编码器在 Kindle 本地生成二维码，不依赖网络二维码服务或额外运行时组件。

离线 GBK/GB18030 编码表由 scripts/generate_charset_tables.py 使用 Python 3.12 标准库 codec 生成并验证。Python 只用于生成数据，不包含在插件中。

• gbk-unicode.bin SHA-256：aa0982997b865263040ba6bb335ea790d1b4402d0ed524ba4808aa0f173754c6
• GB18030Ranges.lua SHA-256：6d05492c8172a0e4575a7a68b9916d36fe39ecce0114739f3b4ee63770d38af4

开发者信息

普通用户可以直接忽略这一节。

生成安装 ZIP：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\package.ps1

验证字符编码表：

python .\scripts\generate_charset_tables.py --check

插件源码位于 leko.koplugin/，QuickJS bridge 源码和构建脚本位于 native/bridge/，已打包二进制的设备 ABI 记录在 leko.koplugin/Leko/native/ABI.md。