Moke · 墨客

连接你的 Talebook 书库，让阅读触手可及。

下载安装 · 快速开始 · 问题反馈 · 参与贡献

Moke 是为 Talebook 自托管电子书服务器打造的开源客户端，基于 Next.js、React 和 Tauri 构建，提供桌面与移动平台安装包。你可以浏览、搜索自己的书库，下载书籍离线阅读，或通过内嵌的 readest-reader 在线阅读 EPUB。

使用前请准备一个可访问的 Talebook 服务器。Moke 是客户端，书库管理与账号服务由 Talebook 提供。

应用预览 · 主要功能 · 安装 · 快速开始 · 本地开发 · 贡献与反馈 · 许可证

应用预览

桌面书库

查看书籍详情与移动端书库

书籍详情

移动端书库

截图来自当前代码的 Web 开发预览，使用虚构书库与原创示例封面；原生应用的窗口和可用操作可能有所不同。截图来源与更新方法。

主要功能

• 浏览与搜索：按分类、标签、作者、出版商浏览书库，检索书名、作者与简介。
• 多种视图：在封面网格、列表和桌面表格之间切换，查看书籍详情。
• 离线阅读：将书籍下载到本地，在书架中打开已下载的书籍。
• 内嵌阅读器：集成 readest-reader，支持 EPUB、PDF 等多种格式。
• 漫画阅读：按服务端书籍类型打开 Talebook 同款漫画阅读器，在线支持 CBZ/ZIP/CBR/RAR，保存并恢复页码；格式与离线限制。
• 在线 EPUB：通过 Talebook 授权的 Range 接口按需读取，无需先下载整本书。
• 局域网连接：支持纯 HTTP 与自签名 HTTPS 的自托管服务器。
• 账号与访问控制：支持访问码、登录和注册，遵循服务器权限设置。
• 墨水屏模式：提供高对比度界面，减少阴影与装饰效果。

应用内置一本约 2 KB 的原创示例 EPUB，默认不导入。在「关于」页面连续点击版本号 8 次解锁开发者选项后，可在「设置 → 开发者选项 → 示例书籍」手动导入，并进入离线书库体验阅读。导入后同一按钮变为「删除示例书籍」，删除后可重新导入。

安装

前往 GitHub Releases 下载适合设备的安装包，具体可用平台以对应版本的发布资产为准。

平台	安装包格式
Windows	.msi / .exe
macOS	.dmg
Linux	.AppImage / .deb
Android	.apk
iOS/iPadOS	.ipa（自签名安装，需将设备 UDID 加入开发者描述文件）
OpenHarmony（鸿蒙）	.hap（alpha，未签名，可能需要自签名安装）

系统要求：Windows 10 1809+ / macOS 11+ / Linux（glibc 2.31+）/ Android 8+ / iOS/iPadOS 17+ / HarmonyOS NEXT 5.0+（API 12）

OpenHarmony 安装包目前处于 alpha 阶段，建议在测试设备上体验；iOS/iPadOS 和 OpenHarmony 的签名、安装要求见对应版本的发布说明。

快速开始

1. 连接服务器：启动 Moke，输入 Talebook 地址，例如 http://192.168.1.100:8080 或 https://mytalebook.example.com。
2. 完成认证：根据服务器配置输入访问码，或登录账号。
3. 浏览书库：打开「书库」，通过搜索、格式和分类筛选找到书籍。
4. 开始阅读：在原生应用的书籍详情页选择「在线阅读」，或点击旁边的下载按钮「下载后阅读」。已下载的书籍可以离线打开。

在线 EPUB 按需读取，不会自动加入离线书库。服务器不支持在线阅读接口、权限失效或网络异常时，可以重试，或明确选择下载后阅读。在线阅读的接口要求和兼容性说明见 Reader 集成文档。

本地开发

推荐使用 Node.js 24（与 CI 一致）和 pnpm 9.15.9（由 package.json 固定）。运行桌面应用还需要 Rust 工具链和 Tauri 系统依赖。

Web 界面开发

只开发 Moke 的书库与设置界面时，可以先启动 Web 预览：

git clone https://github.com/talebook/moke.git
cd moke
pnpm install --frozen-lockfile
pnpm dev-web

打开 http://localhost:3000。Web 预览用于界面开发，原生文件访问、离线阅读和内嵌 Reader 联调需要完整应用环境；连接真实服务器时还需满足浏览器的跨域访问要求。

Reader 开发与构建

完整应用需要初始化递归子模块并安装 Reader 依赖，详见 Reader 开发与构建。完成准备后：

git submodule sync --recursive
git submodule update --init --recursive
cd readest
pnpm install --frozen-lockfile
pnpm setup:vendors
cd ..

然后使用以下命令：

命令	用途
pnpm tauri dev	启动桌面应用，同时启动 Moke 与 Reader 开发服务
pnpm tauri build	构建生产安装包，自动构建并复制 Reader 资源
pnpm lint	检查 ESLint 规则
pnpm typecheck	检查 TypeScript 类型
pnpm test	运行 API、离线存储和平台分支等测试

测试前至少执行 git submodule update --init readest，Reader 契约测试会读取子模块内容。详细的环境准备、代码规范和提交流程见 贡献指南。

贡献与反馈

• 报告 Bug 或提出建议：请附上应用版本、系统环境与复现步骤。
• 参与贡献：了解开发流程与提交规范。
• 安全政策：安全漏洞请通过私密渠道报告。
• 隐私政策：了解应用的数据处理方式。

相关项目

• Talebook：自托管电子书服务端，提供书库与账号服务。
• readest-reader：从 Readest 抽离、按 moke.readest.embed.v1 契约集成的阅读器。

开发者

• houheya（@hehetoshang）— Moke 客户端开发

致谢

• Rex（@talebook）— Talebook 服务器作者，Moke 项目指导者

支持

如果 Moke 对你有帮助，欢迎请维护者喝杯咖啡~

微信

支付宝

感谢以下用户的打赏支持

• 金海先生
• 千成

说明

本项目部分代码由 AI 编程工具（Codex、cc-haha、multica-agent）辅助生成，所有代码均经过人工审查。

许可证

Moke 使用 GNU General Public License v3.0 许可证。