Moke

Moke 是 Talebook 自托管电子书服务器的桌面客户端。在电脑上浏览、搜索、下载你的电子书库，内嵌专业阅读器，离线也能随时打开阅读。

功能

书库浏览 — 按分类、标签、作者、出版商等方式浏览服务器上的电子书
元数据搜索 — 快速检索书名、作者、简介等元数据
离线下载 — 将书籍下载到本地，断网也能阅读
专业阅读 — 内嵌 readest 阅读器，支持 EPUB、PDF 等多种格式
局域网友好 — 支持自签名证书和纯 HTTP 局域网服务器
完整认证 — 支持访问码、登录、注册等 Talebook 服务器的全部认证方式

安装

从 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）

使用

启动 Moke，输入你的 Talebook 服务器地址（例如 http://192.168.1.100:8080 或 https://mytalebook.example.com）
根据服务器设置，输入访问码或登录账号
开始浏览、搜索、下载和阅读

下载的书籍存储在本地，在书架页面可以离线打开阅读。

Reader 开发与构建

Reader 是独立递归子模块。全新检出或从旧 Readest 子模块迁移后执行：

git submodule sync --recursive
git submodule update --init --recursive
pnpm install --frozen-lockfile
cd readest && pnpm install --frozen-lockfile &&cd ..
pnpm build:reader

pnpm build:reader 会自动执行 Reader app 的 setup-vendors 子脚本，生成 PDF.js、SimpleCC 和 Jieba 资源；只启动开发服务器时可先在 readest/ 执行根脚本 pnpm setup:vendors（它会转调上述 app 子脚本）。.env.moke-reader 已随 Reader 仓库提交，无需本地创建。产物位于 readest/out/readest，Moke 打包时复制到 /readest。开发服务器通过 pnpm dev:reader 启动在 http://localhost:3001/readest/reader。协议、鉴权、错误和版本兼容说明见子模块的 docs/MOKE_CONTRACT.md；mokeServerUrl 始终是用户配置的 Talebook 地址，不是 Reader 服务地址。

真实桌面联调可使用 pnpm tauri:reader-e2e 启用仅绑定 127.0.0.1 的可选 WebDriver 插件。reader-e2e 与 release profile 同时启用会编译失败，不能进入发布产物。经过脱敏的环境、命令轮廓与实测结果见子模块的 docs/E2E_EVIDENCE.md。

Reader 原生命令仅授予顶层 Reader UI；书稿必须保持在 Foliate 的 sandbox iframe 内，不能接触顶层 Tauri IPC bridge。桌面 allow_paths_in_scopes 只能复用宿主已授权的 fs_scope，Moke 的 open_reader 也只为 AppData 书籍或文件选择器已授权路径扩展 scope。升级 Foliate、Reader 命令或 capability 时必须保留这些边界并运行 tests/reader-only-build.test.mjs。

开发者

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

致谢

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

支持

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

微信

支付宝

感谢以下用户的打赏支持

微信用户金海先生

说明

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

许可证

GPLv3

Moke

Moke 是 Talebook 自托管电子书服务器的桌面客户端。在电脑上浏览、搜索、下载你的电子书库，内嵌专业阅读器，离线也能随时打开阅读。

功能

书库浏览 — 按分类、标签、作者、出版商等方式浏览服务器上的电子书
元数据搜索 — 快速检索书名、作者、简介等元数据
离线下载 — 将书籍下载到本地，断网也能阅读
专业阅读 — 内嵌 readest 阅读器，支持 EPUB、PDF 等多种格式
局域网友好 — 支持自签名证书和纯 HTTP 局域网服务器
完整认证 — 支持访问码、登录、注册等 Talebook 服务器的全部认证方式

安装

从 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）

使用

启动 Moke，输入你的 Talebook 服务器地址（例如 http://192.168.1.100:8080 或 https://mytalebook.example.com）
根据服务器设置，输入访问码或登录账号
开始浏览、搜索、下载和阅读

下载的书籍存储在本地，在书架页面可以离线打开阅读。

Reader 开发与构建

Reader 是独立递归子模块。全新检出或从旧 Readest 子模块迁移后执行：

git submodule sync --recursive
git submodule update --init --recursive
pnpm install --frozen-lockfile
cd readest && pnpm install --frozen-lockfile &&cd ..
pnpm build:reader

pnpm build:reader 会自动执行 Reader app 的 setup-vendors 子脚本，生成 PDF.js、SimpleCC 和 Jieba 资源；只启动开发服务器时可先在 readest/ 执行根脚本 pnpm setup:vendors（它会转调上述 app 子脚本）。.env.moke-reader 已随 Reader 仓库提交，无需本地创建。产物位于 readest/out/readest，Moke 打包时复制到 /readest。开发服务器通过 pnpm dev:reader 启动在 http://localhost:3001/readest/reader。协议、鉴权、错误和版本兼容说明见子模块的 docs/MOKE_CONTRACT.md；mokeServerUrl 始终是用户配置的 Talebook 地址，不是 Reader 服务地址。

真实桌面联调可使用 pnpm tauri:reader-e2e 启用仅绑定 127.0.0.1 的可选 WebDriver 插件。reader-e2e 与 release profile 同时启用会编译失败，不能进入发布产物。经过脱敏的环境、命令轮廓与实测结果见子模块的 docs/E2E_EVIDENCE.md。

Reader 原生命令仅授予顶层 Reader UI；书稿必须保持在 Foliate 的 sandbox iframe 内，不能接触顶层 Tauri IPC bridge。桌面 allow_paths_in_scopes 只能复用宿主已授权的 fs_scope，Moke 的 open_reader 也只为 AppData 书籍或文件选择器已授权路径扩展 scope。升级 Foliate、Reader 命令或 capability 时必须保留这些边界并运行 tests/reader-only-build.test.mjs。

开发者

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

致谢

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

支持

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

微信

支付宝

感谢以下用户的打赏支持

微信用户金海先生

说明

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

许可证

GPLv3

Moke

Moke 是 Talebook 自托管电子书服务器的桌面客户端。在电脑上浏览、搜索、下载你的电子书库，内嵌专业阅读器，离线也能随时打开阅读。

功能

书库浏览 — 按分类、标签、作者、出版商等方式浏览服务器上的电子书
元数据搜索 — 快速检索书名、作者、简介等元数据
离线下载 — 将书籍下载到本地，断网也能阅读
专业阅读 — 内嵌 readest 阅读器，支持 EPUB、PDF 等多种格式
局域网友好 — 支持自签名证书和纯 HTTP 局域网服务器
完整认证 — 支持访问码、登录、注册等 Talebook 服务器的全部认证方式

安装

从 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）

使用

启动 Moke，输入你的 Talebook 服务器地址（例如 http://192.168.1.100:8080 或 https://mytalebook.example.com）
根据服务器设置，输入访问码或登录账号
开始浏览、搜索、下载和阅读

下载的书籍存储在本地，在书架页面可以离线打开阅读。

Reader 开发与构建

Reader 是独立递归子模块。全新检出或从旧 Readest 子模块迁移后执行：

git submodule sync --recursive
git submodule update --init --recursive
pnpm install --frozen-lockfile
cd readest && pnpm install --frozen-lockfile &&cd ..
pnpm build:reader

pnpm build:reader 会自动执行 Reader app 的 setup-vendors 子脚本，生成 PDF.js、SimpleCC 和 Jieba 资源；只启动开发服务器时可先在 readest/ 执行根脚本 pnpm setup:vendors（它会转调上述 app 子脚本）。.env.moke-reader 已随 Reader 仓库提交，无需本地创建。产物位于 readest/out/readest，Moke 打包时复制到 /readest。开发服务器通过 pnpm dev:reader 启动在 http://localhost:3001/readest/reader。协议、鉴权、错误和版本兼容说明见子模块的 docs/MOKE_CONTRACT.md；mokeServerUrl 始终是用户配置的 Talebook 地址，不是 Reader 服务地址。

真实桌面联调可使用 pnpm tauri:reader-e2e 启用仅绑定 127.0.0.1 的可选 WebDriver 插件。reader-e2e 与 release profile 同时启用会编译失败，不能进入发布产物。经过脱敏的环境、命令轮廓与实测结果见子模块的 docs/E2E_EVIDENCE.md。

Reader 原生命令仅授予顶层 Reader UI；书稿必须保持在 Foliate 的 sandbox iframe 内，不能接触顶层 Tauri IPC bridge。桌面 allow_paths_in_scopes 只能复用宿主已授权的 fs_scope，Moke 的 open_reader 也只为 AppData 书籍或文件选择器已授权路径扩展 scope。升级 Foliate、Reader 命令或 capability 时必须保留这些边界并运行 tests/reader-only-build.test.mjs。

开发者

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

致谢

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

支持

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

微信

支付宝

感谢以下用户的打赏支持

微信用户金海先生

说明

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

许可证

GPLv3

Moke

Moke 是 Talebook 自托管电子书服务器的桌面客户端。在电脑上浏览、搜索、下载你的电子书库，内嵌专业阅读器，离线也能随时打开阅读。

功能

书库浏览 — 按分类、标签、作者、出版商等方式浏览服务器上的电子书
元数据搜索 — 快速检索书名、作者、简介等元数据
离线下载 — 将书籍下载到本地，断网也能阅读
专业阅读 — 内嵌 readest 阅读器，支持 EPUB、PDF 等多种格式
局域网友好 — 支持自签名证书和纯 HTTP 局域网服务器
完整认证 — 支持访问码、登录、注册等 Talebook 服务器的全部认证方式

安装

从 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）

使用

启动 Moke，输入你的 Talebook 服务器地址（例如 http://192.168.1.100:8080 或 https://mytalebook.example.com）
根据服务器设置，输入访问码或登录账号
开始浏览、搜索、下载和阅读

下载的书籍存储在本地，在书架页面可以离线打开阅读。

Reader 开发与构建

Reader 是独立递归子模块。全新检出或从旧 Readest 子模块迁移后执行：

git submodule sync --recursive
git submodule update --init --recursive
pnpm install --frozen-lockfile
cd readest && pnpm install --frozen-lockfile &&cd ..
pnpm build:reader

pnpm build:reader 会自动执行 Reader app 的 setup-vendors 子脚本，生成 PDF.js、SimpleCC 和 Jieba 资源；只启动开发服务器时可先在 readest/ 执行根脚本 pnpm setup:vendors（它会转调上述 app 子脚本）。.env.moke-reader 已随 Reader 仓库提交，无需本地创建。产物位于 readest/out/readest，Moke 打包时复制到 /readest。开发服务器通过 pnpm dev:reader 启动在 http://localhost:3001/readest/reader。协议、鉴权、错误和版本兼容说明见子模块的 docs/MOKE_CONTRACT.md；mokeServerUrl 始终是用户配置的 Talebook 地址，不是 Reader 服务地址。

真实桌面联调可使用 pnpm tauri:reader-e2e 启用仅绑定 127.0.0.1 的可选 WebDriver 插件。reader-e2e 与 release profile 同时启用会编译失败，不能进入发布产物。经过脱敏的环境、命令轮廓与实测结果见子模块的 docs/E2E_EVIDENCE.md。

Reader 原生命令仅授予顶层 Reader UI；书稿必须保持在 Foliate 的 sandbox iframe 内，不能接触顶层 Tauri IPC bridge。桌面 allow_paths_in_scopes 只能复用宿主已授权的 fs_scope，Moke 的 open_reader 也只为 AppData 书籍或文件选择器已授权路径扩展 scope。升级 Foliate、Reader 命令或 capability 时必须保留这些边界并运行 tests/reader-only-build.test.mjs。

开发者

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

致谢

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

支持

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

微信

支付宝

感谢以下用户的打赏支持

微信用户金海先生

说明

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

许可证

GPLv3

Moke

Moke 是 Talebook 自托管电子书服务器的桌面客户端。在电脑上浏览、搜索、下载你的电子书库，内嵌专业阅读器，离线也能随时打开阅读。

功能

书库浏览 — 按分类、标签、作者、出版商等方式浏览服务器上的电子书
元数据搜索 — 快速检索书名、作者、简介等元数据
离线下载 — 将书籍下载到本地，断网也能阅读
专业阅读 — 内嵌 readest 阅读器，支持 EPUB、PDF 等多种格式
局域网友好 — 支持自签名证书和纯 HTTP 局域网服务器
完整认证 — 支持访问码、登录、注册等 Talebook 服务器的全部认证方式

安装

从 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）

使用

启动 Moke，输入你的 Talebook 服务器地址（例如 http://192.168.1.100:8080 或 https://mytalebook.example.com）
根据服务器设置，输入访问码或登录账号
开始浏览、搜索、下载和阅读

下载的书籍存储在本地，在书架页面可以离线打开阅读。

Reader 开发与构建

Reader 是独立递归子模块。全新检出或从旧 Readest 子模块迁移后执行：

git submodule sync --recursive
git submodule update --init --recursive
pnpm install --frozen-lockfile
cd readest && pnpm install --frozen-lockfile &&cd ..
pnpm build:reader

pnpm build:reader 会自动执行 Reader app 的 setup-vendors 子脚本，生成 PDF.js、SimpleCC 和 Jieba 资源；只启动开发服务器时可先在 readest/ 执行根脚本 pnpm setup:vendors（它会转调上述 app 子脚本）。.env.moke-reader 已随 Reader 仓库提交，无需本地创建。产物位于 readest/out/readest，Moke 打包时复制到 /readest。开发服务器通过 pnpm dev:reader 启动在 http://localhost:3001/readest/reader。协议、鉴权、错误和版本兼容说明见子模块的 docs/MOKE_CONTRACT.md；mokeServerUrl 始终是用户配置的 Talebook 地址，不是 Reader 服务地址。

真实桌面联调可使用 pnpm tauri:reader-e2e 启用仅绑定 127.0.0.1 的可选 WebDriver 插件。reader-e2e 与 release profile 同时启用会编译失败，不能进入发布产物。经过脱敏的环境、命令轮廓与实测结果见子模块的 docs/E2E_EVIDENCE.md。

Reader 原生命令仅授予顶层 Reader UI；书稿必须保持在 Foliate 的 sandbox iframe 内，不能接触顶层 Tauri IPC bridge。桌面 allow_paths_in_scopes 只能复用宿主已授权的 fs_scope，Moke 的 open_reader 也只为 AppData 书籍或文件选择器已授权路径扩展 scope。升级 Foliate、Reader 命令或 capability 时必须保留这些边界并运行 tests/reader-only-build.test.mjs。

开发者

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

致谢

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

支持

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

微信

支付宝

感谢以下用户的打赏支持

微信用户金海先生

说明

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

许可证

GPLv3

Moke

Moke 是 Talebook 自托管电子书服务器的桌面客户端。在电脑上浏览、搜索、下载你的电子书库，内嵌专业阅读器，离线也能随时打开阅读。

功能

书库浏览 — 按分类、标签、作者、出版商等方式浏览服务器上的电子书
元数据搜索 — 快速检索书名、作者、简介等元数据
离线下载 — 将书籍下载到本地，断网也能阅读
专业阅读 — 内嵌 readest 阅读器，支持 EPUB、PDF 等多种格式
局域网友好 — 支持自签名证书和纯 HTTP 局域网服务器
完整认证 — 支持访问码、登录、注册等 Talebook 服务器的全部认证方式

安装

从 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）

使用

启动 Moke，输入你的 Talebook 服务器地址（例如 http://192.168.1.100:8080 或 https://mytalebook.example.com）
根据服务器设置，输入访问码或登录账号
开始浏览、搜索、下载和阅读

下载的书籍存储在本地，在书架页面可以离线打开阅读。

Reader 开发与构建

Reader 是独立递归子模块。全新检出或从旧 Readest 子模块迁移后执行：

git submodule sync --recursive
git submodule update --init --recursive
pnpm install --frozen-lockfile
cd readest && pnpm install --frozen-lockfile &&cd ..
pnpm build:reader

pnpm build:reader 会自动执行 Reader app 的 setup-vendors 子脚本，生成 PDF.js、SimpleCC 和 Jieba 资源；只启动开发服务器时可先在 readest/ 执行根脚本 pnpm setup:vendors（它会转调上述 app 子脚本）。.env.moke-reader 已随 Reader 仓库提交，无需本地创建。产物位于 readest/out/readest，Moke 打包时复制到 /readest。开发服务器通过 pnpm dev:reader 启动在 http://localhost:3001/readest/reader。协议、鉴权、错误和版本兼容说明见子模块的 docs/MOKE_CONTRACT.md；mokeServerUrl 始终是用户配置的 Talebook 地址，不是 Reader 服务地址。

真实桌面联调可使用 pnpm tauri:reader-e2e 启用仅绑定 127.0.0.1 的可选 WebDriver 插件。reader-e2e 与 release profile 同时启用会编译失败，不能进入发布产物。经过脱敏的环境、命令轮廓与实测结果见子模块的 docs/E2E_EVIDENCE.md。

Reader 原生命令仅授予顶层 Reader UI；书稿必须保持在 Foliate 的 sandbox iframe 内，不能接触顶层 Tauri IPC bridge。桌面 allow_paths_in_scopes 只能复用宿主已授权的 fs_scope，Moke 的 open_reader 也只为 AppData 书籍或文件选择器已授权路径扩展 scope。升级 Foliate、Reader 命令或 capability 时必须保留这些边界并运行 tests/reader-only-build.test.mjs。

开发者

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

致谢

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

支持

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

微信

支付宝

感谢以下用户的打赏支持

微信用户金海先生

说明

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

许可证

GPLv3

Moke

Moke 是 Talebook 自托管电子书服务器的桌面客户端。在电脑上浏览、搜索、下载你的电子书库，内嵌专业阅读器，离线也能随时打开阅读。

功能

书库浏览 — 按分类、标签、作者、出版商等方式浏览服务器上的电子书
元数据搜索 — 快速检索书名、作者、简介等元数据
离线下载 — 将书籍下载到本地，断网也能阅读
专业阅读 — 内嵌 readest 阅读器，支持 EPUB、PDF 等多种格式
局域网友好 — 支持自签名证书和纯 HTTP 局域网服务器
完整认证 — 支持访问码、登录、注册等 Talebook 服务器的全部认证方式

安装

从 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）

使用

启动 Moke，输入你的 Talebook 服务器地址（例如 http://192.168.1.100:8080 或 https://mytalebook.example.com）
根据服务器设置，输入访问码或登录账号
开始浏览、搜索、下载和阅读

下载的书籍存储在本地，在书架页面可以离线打开阅读。

Reader 开发与构建

Reader 是独立递归子模块。全新检出或从旧 Readest 子模块迁移后执行：

git submodule sync --recursive
git submodule update --init --recursive
pnpm install --frozen-lockfile
cd readest && pnpm install --frozen-lockfile &&cd ..
pnpm build:reader

pnpm build:reader 会自动执行 Reader app 的 setup-vendors 子脚本，生成 PDF.js、SimpleCC 和 Jieba 资源；只启动开发服务器时可先在 readest/ 执行根脚本 pnpm setup:vendors（它会转调上述 app 子脚本）。.env.moke-reader 已随 Reader 仓库提交，无需本地创建。产物位于 readest/out/readest，Moke 打包时复制到 /readest。开发服务器通过 pnpm dev:reader 启动在 http://localhost:3001/readest/reader。协议、鉴权、错误和版本兼容说明见子模块的 docs/MOKE_CONTRACT.md；mokeServerUrl 始终是用户配置的 Talebook 地址，不是 Reader 服务地址。

真实桌面联调可使用 pnpm tauri:reader-e2e 启用仅绑定 127.0.0.1 的可选 WebDriver 插件。reader-e2e 与 release profile 同时启用会编译失败，不能进入发布产物。经过脱敏的环境、命令轮廓与实测结果见子模块的 docs/E2E_EVIDENCE.md。

Reader 原生命令仅授予顶层 Reader UI；书稿必须保持在 Foliate 的 sandbox iframe 内，不能接触顶层 Tauri IPC bridge。桌面 allow_paths_in_scopes 只能复用宿主已授权的 fs_scope，Moke 的 open_reader 也只为 AppData 书籍或文件选择器已授权路径扩展 scope。升级 Foliate、Reader 命令或 capability 时必须保留这些边界并运行 tests/reader-only-build.test.mjs。

开发者

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

致谢

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

支持

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

微信

支付宝

感谢以下用户的打赏支持

微信用户金海先生

说明

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

许可证

GPLv3

Moke

Moke 是 Talebook 自托管电子书服务器的桌面客户端。在电脑上浏览、搜索、下载你的电子书库，内嵌专业阅读器，离线也能随时打开阅读。

功能

书库浏览 — 按分类、标签、作者、出版商等方式浏览服务器上的电子书
元数据搜索 — 快速检索书名、作者、简介等元数据
离线下载 — 将书籍下载到本地，断网也能阅读
专业阅读 — 内嵌 readest 阅读器，支持 EPUB、PDF 等多种格式
局域网友好 — 支持自签名证书和纯 HTTP 局域网服务器
完整认证 — 支持访问码、登录、注册等 Talebook 服务器的全部认证方式

安装

从 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）

使用

启动 Moke，输入你的 Talebook 服务器地址（例如 http://192.168.1.100:8080 或 https://mytalebook.example.com）
根据服务器设置，输入访问码或登录账号
开始浏览、搜索、下载和阅读

下载的书籍存储在本地，在书架页面可以离线打开阅读。

Reader 开发与构建

Reader 是独立递归子模块。全新检出或从旧 Readest 子模块迁移后执行：

git submodule sync --recursive
git submodule update --init --recursive
pnpm install --frozen-lockfile
cd readest && pnpm install --frozen-lockfile &&cd ..
pnpm build:reader

pnpm build:reader 会自动执行 Reader app 的 setup-vendors 子脚本，生成 PDF.js、SimpleCC 和 Jieba 资源；只启动开发服务器时可先在 readest/ 执行根脚本 pnpm setup:vendors（它会转调上述 app 子脚本）。.env.moke-reader 已随 Reader 仓库提交，无需本地创建。产物位于 readest/out/readest，Moke 打包时复制到 /readest。开发服务器通过 pnpm dev:reader 启动在 http://localhost:3001/readest/reader。协议、鉴权、错误和版本兼容说明见子模块的 docs/MOKE_CONTRACT.md；mokeServerUrl 始终是用户配置的 Talebook 地址，不是 Reader 服务地址。

真实桌面联调可使用 pnpm tauri:reader-e2e 启用仅绑定 127.0.0.1 的可选 WebDriver 插件。reader-e2e 与 release profile 同时启用会编译失败，不能进入发布产物。经过脱敏的环境、命令轮廓与实测结果见子模块的 docs/E2E_EVIDENCE.md。

Reader 原生命令仅授予顶层 Reader UI；书稿必须保持在 Foliate 的 sandbox iframe 内，不能接触顶层 Tauri IPC bridge。桌面 allow_paths_in_scopes 只能复用宿主已授权的 fs_scope，Moke 的 open_reader 也只为 AppData 书籍或文件选择器已授权路径扩展 scope。升级 Foliate、Reader 命令或 capability 时必须保留这些边界并运行 tests/reader-only-build.test.mjs。

开发者

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

致谢

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

支持

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

微信

支付宝

感谢以下用户的打赏支持

微信用户金海先生

说明

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

许可证

GPLv3

Name		Name	Last commit message	Last commit date
.github		.github
CODE_NEED/extensions		CODE_NEED/extensions
ios		ios
packages/moke-ext		packages/moke-ext
public		public
readest @ 8d81894		readest @ 8d81894
scripts		scripts
src-tauri		src-tauri
src		src
tests		tests
vendor		vendor
.browserslistrc		.browserslistrc
.editorconfig		.editorconfig
.env.tauri		.env.tauri
.env.web		.env.web
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
FEATURE_RESEARCH.md		FEATURE_RESEARCH.md
LICENSE		LICENSE
PRIVACY.md		PRIVACY.md
README.md		README.md
RELEASE_vx.x.x.md		RELEASE_vx.x.x.md
SECURITY.md		SECURITY.md
check-acl.ps1		check-acl.ps1
check-acl2.ps1		check-acl2.ps1
eslint.config.mjs		eslint.config.mjs
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package.json		package.json
payload.json		payload.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.mjs		postcss.config.mjs
release.json		release.json
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
.github		.github
CODE_NEED/extensions		CODE_NEED/extensions
ios		ios
packages/moke-ext		packages/moke-ext
public		public
readest @ 8d81894		readest @ 8d81894
scripts		scripts
src-tauri		src-tauri
src		src
tests		tests
vendor		vendor
.browserslistrc		.browserslistrc
.editorconfig		.editorconfig
.env.tauri		.env.tauri
.env.web		.env.web
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
FEATURE_RESEARCH.md		FEATURE_RESEARCH.md
LICENSE		LICENSE
PRIVACY.md		PRIVACY.md
README.md		README.md
RELEASE_vx.x.x.md		RELEASE_vx.x.x.md
SECURITY.md		SECURITY.md
check-acl.ps1		check-acl.ps1
check-acl2.ps1		check-acl2.ps1
eslint.config.mjs		eslint.config.mjs
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package.json		package.json
payload.json		payload.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.mjs		postcss.config.mjs
release.json		release.json
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
.github		.github
CODE_NEED/extensions		CODE_NEED/extensions
ios		ios
packages/moke-ext		packages/moke-ext
public		public
readest @ 8d81894		readest @ 8d81894
scripts		scripts
src-tauri		src-tauri
src		src
tests		tests
vendor		vendor
.browserslistrc		.browserslistrc
.editorconfig		.editorconfig
.env.tauri		.env.tauri
.env.web		.env.web
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
FEATURE_RESEARCH.md		FEATURE_RESEARCH.md
LICENSE		LICENSE
PRIVACY.md		PRIVACY.md
README.md		README.md
RELEASE_vx.x.x.md		RELEASE_vx.x.x.md
SECURITY.md		SECURITY.md
check-acl.ps1		check-acl.ps1
check-acl2.ps1		check-acl2.ps1
eslint.config.mjs		eslint.config.mjs
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package.json		package.json
payload.json		payload.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.mjs		postcss.config.mjs
release.json		release.json
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
.github		.github
CODE_NEED/extensions		CODE_NEED/extensions
ios		ios
packages/moke-ext		packages/moke-ext
public		public
readest @ 8d81894		readest @ 8d81894
scripts		scripts
src-tauri		src-tauri
src		src
tests		tests
vendor		vendor
.browserslistrc		.browserslistrc
.editorconfig		.editorconfig
.env.tauri		.env.tauri
.env.web		.env.web
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
FEATURE_RESEARCH.md		FEATURE_RESEARCH.md
LICENSE		LICENSE
PRIVACY.md		PRIVACY.md
README.md		README.md
RELEASE_vx.x.x.md		RELEASE_vx.x.x.md
SECURITY.md		SECURITY.md
check-acl.ps1		check-acl.ps1
check-acl2.ps1		check-acl2.ps1
eslint.config.mjs		eslint.config.mjs
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package.json		package.json
payload.json		payload.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.mjs		postcss.config.mjs
release.json		release.json
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
.github		.github
CODE_NEED/extensions		CODE_NEED/extensions
ios		ios
packages/moke-ext		packages/moke-ext
public		public
readest @ 8d81894		readest @ 8d81894
scripts		scripts
src-tauri		src-tauri
src		src
tests		tests
vendor		vendor
.browserslistrc		.browserslistrc
.editorconfig		.editorconfig
.env.tauri		.env.tauri
.env.web		.env.web
.gitattributes		.gitattributes
.gitignore		.gitignore
.gitmodules		.gitmodules
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
CONTRIBUTING.md		CONTRIBUTING.md
FEATURE_RESEARCH.md		FEATURE_RESEARCH.md
LICENSE		LICENSE
PRIVACY.md		PRIVACY.md
README.md		README.md
RELEASE_vx.x.x.md		RELEASE_vx.x.x.md
SECURITY.md		SECURITY.md
check-acl.ps1		check-acl.ps1
check-acl2.ps1		check-acl2.ps1
eslint.config.mjs		eslint.config.mjs
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package.json		package.json
payload.json		payload.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
postcss.config.mjs		postcss.config.mjs
release.json		release.json
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

Moke

功能

安装

使用

Reader 开发与构建

相关链接

开发者

致谢

支持

感谢以下用户的打赏支持

说明

许可证

About

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Moke

功能

安装

使用

Reader 开发与构建

相关链接

开发者

致谢

支持

感谢以下用户的打赏支持

说明

许可证

About

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Moke

功能

安装

使用

Reader 开发与构建

相关链接

开发者

致谢

支持

感谢以下用户的打赏支持

说明

许可证

About

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors