freeok /so-novel

小说下载|网文下载 | 网络小说

★ 9,042⑂ 764👁 37⑃ 29● 234▤ 58
JavaAGPL-3.0Created 2022-05-23
Download: v1.12.0v1.12.0 ↓1.12.02026-10-26
+28
Daily
9,042
stars
764
forks
37
watchers
29
prs
234
issues
58
releases

README

So Novel
  











 概述

So Novel 是一款通用的网页内容处理与导出工具,它致力于帮助用户高效地从网页中提取结构化信息,并将其灵活导出为
EPUB、TXT、PDF 等多种标准电子文档格式。适用于学习采集、格式转换、电子书制作等场景。

 预览


  点击查看图片

 TUI 预览 (Text-based User Interface)

!preview-tui.png

 WebUI 预览 (网页版)

!preview-webui.jpg

 CLI 预览 (Command Line Interface)

!preview-cli.png



 安装

 📦 手动下载压缩包



 🪟 Windows

 1. PowerShell

powershell
 powershell
irm https://raw.githubusercontent.com/freeok/so-novel/main/bin/windows-install.ps1 | iex


 2. CMD (命令提示符)

cmd
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/freeok/so-novel/main/bin/windows-install.ps1 | iex"


 🐧 Linux

bash
bash  [!TIP]

 为获得最佳阅读体验,建议使用以下电子书阅读器:

 桌面端

 - Readest
 - Koodo Reader
 - Calibre
 - Neat Reader(网页版)

 移动端

 - Readest
 - Apple Books
 - Moon+ Reader(静读天下)
 - Kindle

 如需转换为其它电子书格式,可使用:

 - FreeConvert
 - Calibre

 修复 WPS、掌阅等软件无法打开 so-novel 下载的 EPUB:https://github.com/freeok/so-novel/discussions/199

 自定义 JVM 系统属性

| 参数            | 说明                     | 默认值          |
|---------------|------------------------|--------------|
| -Dmode        | 启动模式,可选值:tui\|cli\|web | tui          |
| -Dconfig.file | 配置文件路径                 | ./config.ini |

用法

 [!NOTE]

 Windows 修改 sonovel.l4j.ini

 Linux 修改  run-linux.sh

 macOS 修改  run-macos.sh

 使用本地 JDK / JRE 启动

如果你不想使用内置 JRE(runtime 目录),可以通过本地 JDK / JRE 启动程序

Windows 使用脚本 start-custom-jre.cmd:

cmd
REM --------------------------------------------------
REM 高级用户使用自定义 JRE 启动程序
REM 将 "your_path\java.exe" 替换为你的 JRE 路径,例如:
REM "C:\Java\jdk-21\bin\java.exe"
REM --------------------------------------------------
@echo off
your_path\java.exe ^
  -XX:+UseZGC ^
  -XX:+ZGenerational ^
  -Dconfig.file=config.ini ^
  -Dmode=tui ^
  -Dfile.encoding=GBK|Big5 ^
  -jar app.jar


Linux / macOS:run-linux.sh / run-macos.sh 修改 java 路径

 常见问题

https://github.com/freeok/so-novel/issues?q=label%3A%22usage%20question%22

 讨论

https://github.com/freeok/so-novel/discussions?discussions_q=

 支持 & 赞助

如果觉得有所帮助,欢迎扫码赞助☕、点击项目主页顶部的⭐Star 按钮支持!

🚀这将是我们持续更新的动力源泉!同时,你也能第一时间获取到最新的更新动态。💡❤️

| 支付宝赞助                                                           | 微信赞助                                                           |
|-----------------------------------------------------------------|----------------------------------------------------------------|
|  |  |

项目赞助者列表

 免责声明

在使用本工具前,请务必仔细阅读我们的法律免责声明。使用本工具即表示您已阅读、理解并同意遵守所有条款。

 Star History

Top issues

Discussions

Latest release

v1.12.0 v1.12.0 2026-10-26
v1.12.0 (2026-10-26)

 ✨ Features

- 新增 8 个书源并更新书源文档 357

 🐛 Bug Fixes

- 修复 Javet 初始化时可能出现的 SIGSEGV 错误,通过在主线程强制初始化 V8,无需设置环境变量 JAVET_DISABLE_PKU=1 343
- 兼容服务端拒绝 Referer 尾部斜杠的问题 345

 ♻️ Refactor

- 引入 DSL 执行引擎,重构 HTML 提取逻辑
- 将 BookParser.getContentType() 迁移到 HtmlExtractor.java
- 优化 SearchParser.java
- 优化 BookParser.java
- 重构 TocParser.java
- 重构 ChapterParser.java
- 改进项目结构
- 增强 SearchResultsHandler.java 代码健壮性

 ⚡ Performance

- 优化分页目录解析速度

 🔧 Maintenance

- 整理 main.json、rate-limit.json 书源配置
- 清理 main.json 失效书源并更新域名
- 更新书源规则域名
- 更新 Homebrew 安装步骤 340
- 新增终端输入编码不匹配

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON