机器翻译正文由机器翻译自项目原始文档（英文），排版经程序统一处理，可能存在偏差，请以原项目仓库为准。

功能 • 计划功能 • 截图 • 下载 • 文档 • 入门 • 故障排除 • 支持 • 许可证

功能

计划功能

敬请关注持续改进和更新！欢迎提供贡献和建议——让我们共同打造终极阅读体验。😊

截图

下载

移动应用

特定平台下载

• macOS / iOS / iPadOS：在 App Store 上搜索并安装 Readest，_也_可通过 TestFlight 进行测试版体验（将您的 Apple ID 发送至 readestapp@gmail.com 申请访问权限）。
• Windows / Linux / Android：访问并下载 Readest，网址为 https://readest.com 或 GitHub 版本发布。
• Linux 用户也可以通过 Flathub 安装 Readest。
• 网页：访问并使用 Readest 网页版，网址为 https://web.readest.com 。

Nix

无需安装即可尝试。--accept-flake-config 会选择加入项目的二进制缓存；若不加入，Nix 将从源代码构建整个 Rust/Tauri 堆栈。

nix run --accept-flake-config github:readest/readest

要安装它，请将输入添加到您的 flake.nix ：

# Due to a limitation in how Nix fetches submodules, a regular GitHub input type will fail to evaluate.
inputs.readest = {
  url = "https://github.com/readest/readest.git";
  type = "git";
  submodules = true;
};

然后在 configuration.nix 中添加包和缓存。这里也需要缓存，因为 Flake 输入自身的 nixConfig 不适用于你的系统构建：

environment.systemPackages = [
  inputs.readest.packages.${pkgs.stdenv.hostPlatform.system}.default
];

nix.settings = {
  substituters = [ "https://readest.cachix.org" ];
  trusted-public-keys = [
    "readest.cachix.org-1:KvKAePcZZCZB8ytFIAOGdgN3VRdmFHGRMHqMVckbt5c="
  ];
};

文档

关于安装和使用 Readest 的指南、教程和常见问题解答，请参阅官方文档：

📖 https://readest.com/docs

贡献者参考资料位于仓库中：架构、代码布局 和 测试。

从源代码构建

要从最新提交构建 Readest，请参阅 入门指南。

故障排除

1. Readest 无法在 Windows 上启动（缺少 Edge WebView2 运行时）

症状

• 当你双击 readest.exe 时，什么也没有发生。没有窗口出现，任务管理器中也看不到该进程。
• 这可能影响标准安装程序和便携版。

原因

• 你的系统中缺少 Microsoft Edge WebView2 运行时，或者版本过旧，或安装不正确。Readest 依赖 WebView2 在 Windows 上呈现界面。

解决方法

1. 检查 WebView2 是否已安装
   • 在 Windows 上打开“添加或删除程序”（也叫“应用和功能”）。查找“Microsoft Edge WebView2 运行时”。
2. 安装或更新 WebView2
   • 直接从微软下载 WebView2 运行时：链接。
   • 如果你更喜欢离线安装程序，可以下载离线包并以管理员身份运行。
3. 重新运行 Readest
   • 安装/更新 WebView2 后，再次启动 readest.exe。
   • 如果仍然遇到问题，重启电脑再试。

附加提示

• 如果重新安装一次无效，完全卸载 Edge WebView2，然后以管理员权限重新安装。
• 确保你的 Windows 安装了微软的最新更新。

仍然卡住？

• 查看问题 readest/readest#358 获取更多详情，或前往我们的 Discord 服务器，并提供你环境的详细日志和已采取的步骤以开启支持讨论。

Linux 无法在 Wayland / Niri 上启动

当前的 Linux 构建版本，包括 Flatpak，使用带有 X11 窗口后端的 CEF。因此，Wayland 会话需要 XWayland。没有 DISPLAY，较旧的构建会在打开窗口之前以 Runtime(CreateWindow) 退出。

在 Niri 上，使用您的发行版包管理器安装 xwayland-satellite 0.7 或更高版本，并重启您的 Niri 会话。Niri 25.08 及更高版本可以按需启动它，并为应用程序设置 DISPLAY。请参阅 Niri 的 XWayland 设置说明。

在该会话中的终端，检查 printenv DISPLAY，然后启动 Readest:

flatpak run com.bilingify.readest

Flatpak 已经请求了 X11 套接字。如果你自定义了其沙箱权限，也请允许该套接字。将 DISPLAY 设置为任意值不会启动 XWayland；请使用你的会话提供的值。--ozone-platform=wayland 无法在此运行时启用原生 Wayland 支持，并且 WebKitGTK 环境变量不会影响 CEF。

支持

如果 Readest 对你有帮助，请考虑在 donate.readest.com 支持其开发，你将在那里找到所有可用的捐赠方式，包括 GitHub Sponsors、PayPal、信用卡支付和加密货币。你的支持帮助我们更快修复漏洞、提升性能，并持续开发优秀功能。

许可证

Readest 是自由软件：您可以根据自由软件基金会发布的 GNU Affero 通用公共许可证 条款重新分发和/或修改它，许可证版本为第 3 版，或者（由您选择）任何更高版本。详情请参阅 LICENSE 文件。

本软件使用了以下库和框架：

• foliate-js，遵循 MIT 许可。
• zip.js，遵循 BSD-3-Clause 许可。
• fflate，遵循 MIT 许可。
• PDF.js，遵循 Apache 许可证 2.0。
• daisyUI，遵循 MIT 许可。
• marked，遵循 MIT 许可。
• next.js，遵循 MIT 许可。
• react-icons，有多种开源许可。
• react，遵循 MIT 许可。
• tauri，遵循 MIT 许可。

本软件使用了以下字体，这些字体可能随应用捆绑或通过网页字体提供：

Bitter, Fira Code, Inter, Literata, Merriweather, Noto Sans, Roboto, LXGW WenKai, MiSans, Source Han, WenQuanYi Micro Hei

我们还要感谢 Web Chinese Fonts Plan 提供开源工具，使网页能够使用中文字体。