安装

一键安装脚本（推荐）

无需配置开发环境，复制对应平台的命令即可自动下载并安装最新版本：

macOS / Linux

使用 Shell 脚本安装

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/yexiyue/TRNovel/releases/latest/download/trnovel-installer.sh | sh

Windows

使用 PowerShell 安装

powershell -ExecutionPolicy Bypass -c "irm https://github.com/yexiyue/TRNovel/releases/latest/download/trnovel-installer.ps1 | iex"

Homebrew

使用 Homebrew 安装（macOS / Linux）

brew install yexiyue/tap/trnovel

TRNovel 只分发 trnovel、trn，默认提供听书界面。听书需独立安装 Talechime。0.18.0 起使用统一发行；旧 basic、捆绑 worker 和加速包停止更新。

0.18.2 起支持 Apple Silicon / Intel macOS、x86_64 Linux GNU、x86_64 / ARM64 Linux musl，以及 x86_64 Windows MSVC。musl 包为静态阅读器，不需要 ALSA 或 ONNX Runtime；ARM64 musl 已纳入统一发行。Talechime 的平台范围独立，新增平台可正常阅读，听书仍需要该平台可用的 Talechime。

Shell / PowerShell 默认安装到 Cargo bin 目录；安装后确认该目录在 PATH 中。

包管理器安装

如果您已安装 Rust 或 Node.js 环境，可通过以下命令快速安装 TRNovel：

cargo

使用 Cargo 安装

cargo install trnovel

pnpm

使用 pnpm 安装

pnpm add -g @trnovel/trnovel

npm

使用 npm 安装

npm i -g @trnovel/trnovel

安装完成后，运行以下命令验证安装是否成功：

trnovel -h

手动下载二进制文件

也可前往 GitHub Releases 页面，根据平台下载预编译的压缩包（.tar.xz / .zip），解压后将可执行文件添加到系统 PATH 环境变量中。

注意

手动下载的用户需确保将可执行文件正确添加到 PATH 环境变量中，否则将无法在命令行中直接使用 trnovel 命令。

从当前源码构建

git clone https://github.com/yexiyue/TRNovel.git
cd TRNovel
cargo build --release --locked -p trnovel --bins

无需递归检出。Talechime 独立安装或在它自己的仓库构建。worker 查找顺序为 --tts-program → [tts].program → PATH 中的 talechime；指定路径无效直接报错，不自动下载、更新或回退旧名称。

数据目录已更新，首次正常启动会自动复制旧数据，保留原文件且不覆盖新版数据，见自动迁移。回退应用时使用对应旧版二进制和备份目录；协议主版本不匹配只影响听书。