moon

项目概述

moon 是一个为 KOReader 阅读系统编写的 Lua 插件（book.koplugin），面向使用电子墨水阅读器的用户，把云端同步、本地书库、AI 助手等能力装进阅读器内部。它坚持本地优先的设计：书籍与阅读进度默认保存在设备本地，多源同步与 AI 功能按需启用，避免阅读数据离开设备。

项目	内容
运行平台	KOReader（Android 等平台的电子阅读应用）
开发语言	Lua（KOReader 插件 API）
许可协议	开源（随 KOReader 生态）
分发方式	GitHub 仓库获取插件源码后加载

一个把多源同步、本地优先阅读与 AI 助手装进 KOReader 的增强插件。

主要功能

• 多源同步：支持多种云存储与下载渠道作为书源，按需启用，互不干扰
• 本地优先：书籍文件与阅读进度默认留存设备本地，不强制上云
• AI 助手：在阅读界面调用大模型能力，辅助理解内容
• 锁屏与远程管理：通过锁屏界面与远程指令管理阅读器状态
• 下载渠道：内置多个下载源，可按来源筛选与获取书籍
• 插件化结构：以 book.koplugin 标准形态接入 KOReader，安装即用

适用人群

• 使用 KOReader 的电子阅读器用户
• 希望统一管理多个书源的用户
• 重视阅读数据本地存储的用户
• 想给阅读器加装 AI 助手的用户
• 喜欢折腾插件自定义功能的用户

快速上手

1. 安装 KOReader 并确认版本支持插件加载
2. 从仓库获取 moon 插件文件
3. 将插件放入 KOReader 的插件目录
4. 重启 KOReader，在插件管理列表中启用 moon

核心优势

• 本地优先：阅读数据默认不出设备，隐私可控
• 多源一体：把分散的同步渠道收进同一套插件管理
• 非侵入：以标准插件形态加载，不影响 KOReader 本体

系统要求

项目	要求
运行环境	KOReader 支持的 Android 等平台
开发语言	Lua
依赖	KOReader 插件 API

注意事项

• 版本适配：KOReader 更新后插件 API 可能变化，需使用对应版本的插件
• 渠道合规：部分下载与 AI 渠道涉及外部服务，使用与可用性需自行评估
• 本地数据：同步与远程功能启用前请确认网络与账号配置正确