为读小说，准备好了一切

AI 一键生成书源

把小说站 URL 交给装了 booksource-generator skill 的 Agent，自动逆向出搜索、目录、正文的选择器，体检到全绿后导入即用。

trn doctor my-source.v2.json

TTS 听书

内置 Kokoro 中文语音合成，边听边高亮当前句，解放双眼。

本地 + 网络双源

自动识别 UTF-8 / GBK，阅读进度自动记录，trn -q 一键续读。

智能分卷目录

规则引擎切分「卷、章」层级，生成可折叠目录树，长篇不迷路。

声明式规则引擎

取值后端 CSS、XPath、JSONPath、正则任选；clean 流水线内置 AES/DES、Base64、MD5/SHA、繁简转换，正文加密纯声明式拿下。

反爬与浏览器辅助

撞上 Cloudflare 时复用系统浏览器解挑战，拿到 cookie 后继续走快速请求，必要时点一下「我是真人」即可。

跨平台单二进制

Windows、macOS、Linux 通吃，主题可自定义，基于 ratatui-kit 构建。

让 AI 帮你做书源

别人做书源要手写一堆规则，TRNovel 把「逆向、校验、导入」交给 AI 串成闭环：给一个小说站 URL，Agent 自动探站并逆向出选择器，trn doctor 逐项体检到全绿，导入后立刻能读。

书源是结构化 JSON，对 AI 友好，schema 由 Rust 类型自动生成。详见 书源参考与反爬与浏览器辅助。

从 URL 到能读,三条命令

# 给 Agent 装上 skill,然后把站点 URL 交给它
npx skills add https://github.com/yexiyue/TRNovel/tree/main/skills/booksource-generator

# 全流程体检生成的书源,逐项检查到全绿
trn doctor example.v2.json

# 导入后即可在网络小说模式里阅读
trn import example.v2.json && trn -n

看它跑起来

沉浸式阅读 正文分页流畅，主题颜色可配置。

清爽主页 本地、网络、历史三个入口一目了然。

可折叠分卷目录 「卷、章」层级清晰，跳转不迷路。

快捷键面板 随时呼出，所有操作有迹可循。

30 秒上手

macOS / Linux

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

Windows

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

Homebrew

brew install yexiyue/tap/trnovel

cargo

cargo install trnovel

npm

npm i -g @trnovel/trnovel

装好后即可开读：

trn            # 打开主页
trn -q         # 续读上一次的位置
trn -n         # 网络小说
trn -l ./书库   # 读某个目录下的本地小说

提示

还有 trn doctor <书源.json> 体检书源、trn import <书源.json> 一键导入。完整命令见 CLI 参考。

继续深入

使用指南 从安装到阅读、网络小说、听书、主题，逐步上手。

书源参考 书源结构、规则语法，以及如何制作一个书源。

反爬与浏览器辅助 Cloudflare 挑战的工作方式与降级策略。

CLI 命令参考 trn 的全部子命令与参数。