KOReader Android 网络检测修复插件

这是一个面向 Android 版 KOReader 的极简兼容插件，用于解决以下情况：

• Android 设备已经连接网络。
• 翻译、维基百科或第三方 AI 插件访问的目标服务可以正常连接。
• KOReader 用于判断“是否在线”的检测域名在当前网络环境中无法解析。
• KOReader 因而错误判定离线，反复提示打开或重新连接 Wi‑Fi，实际联网功能无法执行。

工作原理

KOReader 的 NetworkMgr:isOnline() 默认通过解析 dns.msftncsi.com 判断外网是否可用。runWhenOnline() 和 willRerunWhenOnline() 等流程会依据这个结果决定直接执行联网操作，还是进入 Wi‑Fi 连接流程。

本插件只在 Android 上覆盖 NetworkMgr:isOnline()，让它返回 true。这样翻译、维基百科和第三方 AI 插件可以直接发起真实请求，不会因为检测域名不可用而被提前拦截。

插件本身：

• 不提供代理、VPN、DNS 或网络加速服务。
• 不修改 Android 系统网络设置。
• 不发起任何网络请求。
• 不读取或保存用户数据。
• 不会让原本无法访问的服务变得可访问。

安装

1. 下载发布页中的 networkfix.koplugin.zip。

2. 解压后确认目录结构为：

   koreader/
   └── plugins/
       └── networkfix.koplugin/
           ├── _meta.lua
           └── main.lua
   

3. 将整个 networkfix.koplugin 文件夹复制到 Android 设备的 koreader/plugins/。

4. 完全退出并重新启动 KOReader。

插件会显示在 KOReader 的“插件管理”中，名称为“Android 网络检测修复”。

卸载

删除 koreader/plugins/networkfix.koplugin 文件夹，然后重启 KOReader。

重要限制

• 仅 Android 会改变行为，其他平台保持 KOReader 原逻辑。
• 插件会跳过 KOReader 的预先在线检测。如果设备确实离线，翻译、维基百科或 AI 插件会尝试请求，并显示各自的真实网络错误。
• 若其他插件也修改 NetworkMgr:isOnline()，最终行为可能受插件加载顺序影响。
• KOReader 内部网络接口未来如有变化，插件可能需要同步更新。

来源与致谢

• 初始版本由 HarrySuen626 编写并以 networkfix.koplugin.zip 的形式提供；原包仅包含一个 259 字节的 main.lua。
• 本仓库在不改变核心修复思路的前提下，补充了标准 KOReader 插件对象、元数据、防重复加载保护、文档和发布包。
• 感谢 KOReader 项目及所有贡献者。

本项目是非官方第三方插件，与 KOReader 项目无隶属或官方认可关系。详细来源说明见 NOTICE.md。

许可证

Copyright © 2026 HarrySuen626。

本项目采用 GNU General Public License v3.0 发布。安装 ZIP 内也包含相同许可证。