跳到主内容

novel-plus 十天连发四版到底该不该追着升?我用 3 组验证给了个答案

最初的三个假设

一个开源小说系统十天之内连发四个版本,你的第一反应是跟着升,还是先按住不动?这篇文章就是冲着这个问题来的。先把结论放在最前面:能追,但不能一把梭——增量 SQL 要按版本顺序补、管理后台的账号体系整个换掉了、AI 创作助手也不是开箱即用。怎么得出这三句话的,下面用三个假设、三组验证摊开讲。

先画整张图。novel-plus 是一套 Java 技术栈的原创文学 CMS,链路用文字画出来是:读者请求 → novel-front(前台门户与作家后台,默认 8085)→ Sharding-JDBC → MySQL 8.0,旁边 Redis 做缓存;运营侧 → novel-admin(平台管理后台,默认 8088);内容生产侧 → novel-crawl(爬虫采集,默认 8083)。官方源码安装文档给出的前置要求是 JDK 21、MySQL 8.0、Redis、Maven,内存建议至少 2 GB、硬盘预留 10 GB。三个服务共享同一个数据库,配置都落在各自的 config/shardingsphere-jdbc.yml 和 config/application.yml 里——记住这两个文件的位置,后面验证二会用到它们,因为 10 月 25 日那版把其中一份配置里的东西抽走了。

三个服务各管一段,边界用一张表划清——每层都要说清它不负责什么,这是后面所有验证的地基:

服务默认端口输入输出不负责什么
novel-front8085读者请求、作者投稿阅读页、书架书评、作家后台不管后台账号授权,不管采集
novel-admin8088运营操作会员、内容、收入、权限管理不管前台渲染,不管数据存储本身
novel-crawl8083采集源配置入库的小说数据不管版权审查,不管会员与支付

存储层还有一处可插拔设计值得画进图里:novel-plus 支持两种内容存储方式——内置数据库分表存储,靠 Sharding-JDBC 在代码层完成分库分表,把海量章节摊到多张表上;以及 TXT 文本存储,章节正文落盘成文件、数据库只存索引。小说站的数据特点是读多写少、章节表无限膨胀,两条路线各有代价:分表方便事务与检索,TXT 对超大正文更友好。这对升级决策的影响是直接的:SQL 备份策略要跟着存储方式走,TXT 路线的站除了备库还要备正文目录,升级清单里那步「备份数据库」对这类站是不完整的。

站在「该不该追着升」这个决策点,我列出三个朴素假设:假设一,升级就是替换安装包、补上最新的增量 SQL,一步到位;假设二,升完之后管理员还是那个管理员,密码和权限原样保留;假设三,v6.0.0 主打的 AI 长篇小说创作助手,升上去就能用。这三个假设分别对应升级的三层风险:数据层、账号层、能力层。如果三个全对,追新就是无脑操作;只要有 一个被推翻,升级就得变成带清单的工程动作。带着这三个假设,我去翻官方 Releases 和安装文档做验证——口径先说死:版本数据全部以 GitHub 仓库 201206030/novel-plus 的 Releases 页为准,不走任何二手转述。

怎么设计验证

这一层做的是验证设计,它只回答「拿什么当证据」,不回答结论。方法有三条。第一条,把仓库的 tags 列表和 releases 正文逐条读完:用 GitHub API 实测,v5.5.0 之后共有七个 tag,其中能对上发布日期的是 10 月 21 日 v6.0.0、10 月 25 日 v6.2.0、10 月 29 日 v6.3.1、10 月 31 日 v6.3.2——十天四个已核实版本,这就是标题里「十天连发四版」的出处,v6.1.0 和 v6.1.1 两个小版本的日期没有逐条核到,这个缺口在第八站交代。

第二条,把每个版本「升级须知」字段单独摘出来。升级须知是作者写给存量站长的,跟新功能宣传相比,这里写的是「你不动它就会坏」的部分:要执行哪些增量 SQL、哪些配置作废、哪些行为变了。验证一和验证二的主要证据都来自这里。第三条,用官方文档互证:docs.xxyopen.com 的安装教程给出源码、包、宝塔、Docker、Docker Compose 五种安装路线和升级指南入口,源码教程里有端口、环境变量、hosts 配置这些硬信息,用来核对 release 正文里提法是否一致。

证据链的上下游也要划清边界:Releases 正文是一手来源,开源中国的发布新闻(10 月 23 日那篇 v6.0.0 报道)和几个公众号解读是一手内容的转述,用来补充上下文,不单独当证据;如果转述和一手打架,信 Releases。这条纪律在这类迭代飞快的项目上已经验证过太多次——源码二开改造边界那篇里也提过,二手教程的版本号经常停在几个月前。这层不负责给结论,只负责让结论站得住。设计完毕,进验证。

验证一:升级是不是覆盖包加最新 SQL 就够

这一层验证的是数据边界。假设一说「补上最新 SQL」就行,验证过程是从 v6.0.0 到 v6.3.2 把增量 SQL 逐版排开:v6.2.0 要求按顺序执行 doc/sql/20261023.sql(把存量小说默认置为上架)和 doc/sql/20261024.sql(RBAC 权限基线数据);v6.3.1 要求执行 doc/sql/20261025.sql(作者资料、章节发布状态相关字段)。也就是说,从 5.x 直接跳到 6.3.2 的站长,中间隔着三份按日期命名、有先后顺序的脚本,漏一份或者倒着跑,轻则字段缺失报错,重则权限数据残缺。

更要紧的是 v6.2.0 升级须知里那句话:「RBAC 脚本会清理旧版权限数据,执行前自动备份至 bak_ 前缀表(可回滚)」。作者做了兜底——出问题可以回滚——但兜底的存在本身就说明这一步有破坏性。更值得展开的是部署动作本身,因为官方源码教程把每个服务的启动写得非常具体:打包用 mvn clean package -Dmaven.test.skip=true,每个模块在 target/build/ 下出同名 zip,解压后改两个配置文件——config/shardingsphere-jdbc.yml 配 MySQL、config/application.yml 配 Redis——再用 bin/novel-front.sh start 这类脚本起服务,起停重启状态四个子命令齐全。教程里还埋了一个看似离题的坑:部分环境拿不到主机 IP,要手动往 /etc/hosts 写「真实内网 IP + 主机名」的映射,写 127.0.0.1 是错误示范。这条跟升级有什么关系?关系在于 SQL 之外,「起不来」的原因经常藏在部署层,把锅甩给升级脚本之前先核对这一层。所以验证一的结论是:假设一部分成立、一部分要修正。「覆盖包、跑 SQL」的大方向没错,但「最新 SQL」这个说法是错的,正确说法是「按版本顺序补齐中间所有增量 SQL」。这层只管数据,它不负责账号——账号的坑在下一个验证里,而且比 SQL 顺序更深。

验证二:密码和权限是不是原样保留

这一层验证的是账号边界,也是三个假设里唯一被干净利落推翻的。过程不复杂:v6.2.0 的 release 正文写明,登录认证改为读取 sys_user 表,取消配置文件账号——application.yml 里不再配置 admin.username/password。这意味着老版本里写在配置文件里的管理员凭证,升上去就作废了;取而代之的是一套用户、角色、权限三页的 RBAC 体系,侧栏菜单与授权树共用 sys_menu 表。

用第一站的边界语言重说一遍这个变化:升级前,shardingsphere-jdbc.yml 这层只管数据源,application.yml 这层管 Redis 外加管理员凭证——账号这个职责原本挂在配置文件上。升级后职责搬家:账号认证整体迁进数据库的 sys_user 体系,配置文件「不再负责」管理员凭证,它退回只管缓存与本地参数。职责搬家在架构上是更干净了,但搬家那天旧地址不再收件——还往 application.yml 里写 admin 密码的运维习惯,从 10 月 25 日起就是无效操作。真正的雷在下一句:「admin 及示例账号 editor、service 的密码统一重置为初始密码 admin,部署后请第一时间登录并修改密码」。我原本以为升级不动密码,验证到这里才发现是整套重置——任何在 10 月 25 日之后升级、又没读升级须知的站长,后台就是一个用 admin/admin 就能登进去的系统,公网上等于敞着门。这不是安全漏洞,是迁移成本被写进了升级须知,但升级须知恰恰是最没人读的那个位置。作者还加了工程化保护:内置 admin 与超管角色在管理页整行锁定,后端权威拦截,禁止禁用当前登录账号;公共头部有「修改密码」入口,任何已登录账号可自助改密、需校验原密码。

顺带把另一条安全线也钉在这里:从 v5.5.0 起前台要求配置环境变量 JWT_SECRET,官方建议用 openssl rand -base64 64 | tr -d '\n' 生成;站内几个公众号解读还提到 v6.0.0 的生产安装包在 prod 环境下未设置或空白密钥会直接终止启动——「不安全就不启动」这个设计取向,值得在验证结论里记一笔:这一层对「忘配」是零容忍的。验证二结论:假设二被推翻。这层不管功能,它管的是「谁能进门」,而它恰恰是升级动作里最容易漏的一步。

验证三:AI 创作助手是不是开箱即用

这一层验证的是能力边界。v6.0.0 的主打的 AI 长篇小说创作助手,工作流是六步:创作问答(题材、核心创意、主角设定、核心冲突,深度设定可跳过用默认值)→ 书名建议(可挑可选可重新生成)→ 创作方案(一次生成故事简介、世界观、人物档案、故事总纲、分卷大纲、伏笔记录和章节规划)→ 逐章创作(每次只写一章,自动参考总纲、当前章规划、人物档案、世界观规则、前文摘要和未回收伏笔)→ 作者确认制(点「确认保存」才写入章节体系,AI 内容和草稿都不能覆盖已发布章节)→ 断点续写(退出刷新后恢复进度)。断点续写那步承诺的是随时退出、刷新或中断后,重新进入助手即可恢复创作进度、进行中任务和未保存草稿,并支持从指定章节继续——对长篇这种跨天创作的场景,这一条比生成质量更影响日常体验。使用方式也有两个入口:登录作家后台点菜单「AI创作助手」开始新书,或在「我的小说」列表对已有作品点「AI创作」补充设定与续写;创作问答里还支持「随机灵感」一键生成创意,深度设定里的世界观、文风、目标读者、章节数、每章字数都可以跳过用默认值。开源中国 10 月 23 日的报道和几个转述源在六步描述上一致,这一层是可信的。

但「开箱即用」这个假设要拆成两半看。工程上,技术选型表里 v6.0.0 把 Spring AI 写了进去,AI 是平台原生能力、不是外挂脚本;校验机制是双层结构——程序层查字数、重复段落这类确定性问题,AI 层查情节一致性,最多跑三轮。这两处设计都是扎实的。可质量上,Spring AI 只是接入层,生成效果取决于你接的模型,官方原文也明说「AI 功能仍处于实验阶段」。v6.3.2(10 月 31 日)又修了一个细节:创作看板的趋势统计数据统一截止到昨日,避免当天未完整统计的数据影响 AI 解读结果——大版本发布十天之内就为 AI 解读补了一刀,说明这条链路自己还在长。

所以验证三的结论是:假设三一半对一半错。流程开箱即用,菜单点开就能走完六步;效果开箱即用不成立,模型要自己接、质量要自己试。还有一层要单独划出来:作者确认制是这套能力的安全边界,它把「机器产稿、人工把关」写进了代码——如果你的站要走这条能力,别把这层确认流砍掉当「效率优化」。这层不管数据也不管账号,它管产出质量,而质量的下限由你接的模型决定。

被推翻的那个假设

三个假设走完,被干净推翻的是假设二。这一段单独拎出来,因为它对存量站长的杀伤力最直接。整理一下被推翻的完整链条:升级前,管理员凭证写在 application.yml;升级 v6.2.0 后,这个字段作废,认证切到 sys_user 表,admin、editor、service 三个账号密码统一重置成 admin。如果站长只做了「替换包、跑 SQL」两步——这正是假设一说的动作——那么升级完成的瞬间,他的后台就是一个公开已知口令可登入的系统。

把它写成一个升级事故的推演:站长周五晚升的级,周一才发现有陌生登录记录,中间隔着整个周末。修复动作倒是清晰:改掉三个账号密码、检查后台操作日志、核对文章和会员数据有没有被动过——但事故成本已经发生。反过来说,这个假设被推翻得越早,成本越低:它只值「读一遍升级须知」的五分钟。站内讲开源论坛系统本地部署的那篇文章里有一句类似的话,自建系统的安全冗余从来不在软件里,在部署它的人手里。

为什么不用更简单的方案?比如让升级后的首次登录强制改密。这在产品上是更优解,但从 release 正文看,作者选择的是「重置 + 文字提醒 + 锁定内置账号」的组合。可能是工程优先级,可能是考虑 Docker 镜像场景的首次初始化流程——v6.3.1 的资产清单里四个镜像(novel-admin、novel-front、novel-crawl、mysql-novel-plus 各 v6.3.1)本来就带首次初始化路径。作为站长别替作者猜,按最坏情况处理:默认没人替你改密码。

推翻之后结论怎么改

假设被推翻,开头那句结论就要从「能追,但不能一把梭」展开成一份带顺序的清单。改写后的升级动作是六步:第一步,备份数据库——v6.2.0 的 RBAC 脚本自己都会生成 bak_ 前缀备份表,站长没理由比作者还心大;第二步,按顺序补增量 SQL:20261023 → 20261024 → 20261025,从更低版本上来的先把中间版本的补齐;第三步,替换 novel-admin / novel-front / novel-crawl 三个安装包(或拉对应版本的 Docker 镜像);第四步,登录后台立刻改掉 admin、editor、service 的初始密码;第五步,确认 JWT_SECRET 已按 openssl 生成的六十四字节随机值配好,且生产环境真的加载了它;第六步,重新过一遍后台的「系统管理」三页,按自己的运营岗位重新授权——RBAC 之后权限粒度变了,老站长的权限习惯需要在新体系里重放一遍。

版本已核实日期核心变化升级必做动作
v6.0.02026-10-21移动端 UI 重设计、后台重构、AI 创作助手六步工作流确认 JWT_SECRET(v5.5.0 起)
v6.2.02026-10-25RBAC 权限体系、登录改读 sys_user、小说上下架按顺序跑 20261023/20261024 两份 SQL、改初始密码
v6.3.12026-10-29创作看板与 AI 解读、章节草稿与定时发布、消息中心、收入明细跑 20261025 SQL
v6.3.22026-10-31AI 解读统计截止昨日、展示样式优化无 SQL,覆盖即可

改写后的清单要能自查,补一套读者自测法,动手升级前花十分钟走一遍:第一测,打开你的 config/application.yml,搜 admin.username——还在,说明你跑在旧账号体系上,假设二的风险全部适用于你;已经没有这个字段,说明 6.2.0 的账你补过了。第二测,在服务器上 echo $JWT_SECRET,空值就是没配,生产环境空值等于启动都过不了(prod 模式直接终止);配了但忘了是哪次生成的,也要重新生成再统一写入启动脚本,密钥一换旧 token 全部失效,作者端要重新登录,这点要提前通知。第三测,连上 MySQL 看 sys_menu 表在不在——它是 RBAC 授权树共用的表,表都不在,说明 20261024 这份 SQL 没跑,权限页打开就是空的。三测全绿再动升级包,测试成本十分钟,跳过测试的代价在验证二里已经推演过。

按规模分层,这份清单的代价不一样。单人小站(自用或试水):与其增量升级,不如新库重来——装 v6.3.2 全新初始化,再把小说、章节、会员数据导过去,动作干净,不背 RBAC 之前的权限包袱,代价是要写一份导数据脚本;中等规模(日活几千、有作家入驻):按六步清单走增量,安排在低峰期,改初始密码这步安排专人盯,改完逐个岗位验证权限;规模化部署(多实例、容器化):四个 Docker 镜像统一拉 v6.3.1 对应 tag(novel-admin、novel-front、novel-crawl、mysql-novel-plus),JWT_SECRET 在多实例间复用同一个值——官方口径是密钥只生成一次、重启与多实例间复用——换密钥等于全员 token 失效,要提前公告。v6.3.1 还顺手修了两个账务 bug:作者作品无收入时月度收入统计任务报错、后台收入列表显示异常,追新对这类站多一层「账别算错」的收益。

这份清单对应到表里,就是把「十天四版」的台账变成动作序列:要不要追着升,现在可以给完整答案了:新站直接上 v6.3.2,没有历史包袱,RBAC 和 AI 助手都是原生起点;存量 5.x 站,如果后台一直用配置文件账号,把这份清单当成半天工作量来排期,别当十分钟的事;不急着用 AI 助手的站,可以停在 v6.2.0 之前的版本观察一轮——但停在旧版本就意味着停在「密码写在配置文件」的旧账号体系上,这笔账要算进等待成本里。

残留的不确定性

验证做完了,边界外还有三块没探明的地方,写清楚比装看不见强。第一块,v6.1.0 和 v6.1.1 两个小版本的发布内容与日期没有逐条核到——tags 列表里有它们,我读的 releases 正文覆盖了 6.0.0、6.2.0、6.3.1、6.3.2 四个主节点,中间两个小版本的变化要以仓库 Releases 页实时内容为准;同理 v6.3.0 在我拉取的 releases 接口里没返回正文,它跟 v6.3.1 之间隔了什么,需要升到那个区间的站长自己翻。第二块,AI 创作助手的实际生成质量:验证只覆盖了流程与机制,不覆盖效果,效果取决于所接模型,这一条官方也只承诺到「实验阶段」,任何声称「实测效果」的第三方文章在这个项目上都要先看它的测试日期——项目十天四版,三天前的实测都可能是旧版的结论。

第三块,前端栈的长期演进成本。Thymeleaf 加 Layui 的服务端渲染路线偏传统,追求前后端分离的团队要么接受它、要么自己承担改造成本;站内讲二开改造边界的文章算过一笔账——直接改核心文件,官方一升级全部白干(改造边界自测法那篇的结论),对 novel-plus 这种十天四版的迭代节奏尤其如此,二次开发请走模板与扩展层,别动核心。

另外把产品矩阵交代完整,因为它直接影响「该上哪个」的答案:novel 家族是一条梯度产品线——学习版 novel 面向入门,配保姆级教程;应用版 novel-plus 是本文主角,功能完整适合实际建站;微服务版 novel-cloud 把单体拆成微服务,应对更大流量与团队协作;多端应用版 novel-app 基于 uni-app(Vue 3 + Vite),一套代码编译 H5、Android、iOS 与微信小程序四个端,与 novel-plus 共用数据库和接口。对应的选型顺序也清楚:个人学习从 novel 入门最平滑;实际建站直接上 novel-plus;流量与团队上来再评估 novel-cloud;多端需求用 novel-app 补齐。先用最小组合验证业务模型再逐级升配,比一步到位上微服务便宜得多——这条不是官方口号,是它把四条产品线分成四个仓库的原因。

如果要追问哪一层最先撑不住:按现在的迭代方向,最先到极限的是内容合规这一层——爬虫采集、AI 生成、会员充值三个能力各自都牵着平台规则与资质要求,功能层面它们都已经在版本清单里就位,但合规边界要每个站长自己划,软件管不了这件事。这层不是技术问题,所以它不会出现在任何一份升级 SQL 里。

常见问题

问:从 v5.x 直接升到 v6.3.2 可以吗?还是要一版一版升?
答:程序包可以直接换到最新,但增量 SQL 必须按顺序补齐。已核实的顺序是 20261023(存量小说默认上架)、20261024(RBAC 权限基线)、20261025(作者资料与章节发布状态字段),脚本都在仓库的 doc/sql 目录下。低版本站还要注意 v5.5.0 引入的 JWT_SECRET 要求。动手前先备份数据库(站内数据落盘备份那篇给过自建服务的备份思路),RBAC 脚本虽有 bak_ 前缀自动备份,但自己的备份是回滚的底座,别把兜底当保险绳。

问:升级后后台登不进去,是不是升级失败了?
答:大概率不是失败,是账号体系换了。v6.2.0 之后登录认证读 sys_user 表,配置文件里的 admin.username/password 不再生效,admin、editor、service 的密码统一重置为初始密码 admin。用 admin/admin 登进去后第一件事就是改密码,公共头部的「修改密码」入口支持自助修改、需校验原密码。内置 admin 与超管角色在管理页整行锁定、后端权威拦截,禁止禁用当前登录账号,这些是设计行为不是故障;如果改完密码还是异常,再回头核对 20261024 这份 SQL 是否真的执行成功。

问:AI 创作助手要不要单独付费或接第三家服务?
答:AI 能力是平台原生集成的,技术选型里是 Spring AI 官方框架,菜单里点「AI创作助手」就能走完创作问答、书名建议、创作方案、逐章创作、确认保存、断点续写六步,官方说明「AI 功能仍处于实验阶段」。但 Spring AI 是接入层,生成质量取决于所接的模型,模型相关的配置与成本要按自己的部署情况核对官方文档,查不到的以官方最新说明为准。

问:AI 生成的内容会直接发布到前台吗?
答:不会。作者确认制是这套能力写在代码里的底线:所有章节正文只在作者点击「确认保存」后才写入现有章节体系,AI 生成内容和草稿都不能覆盖已发布章节;逐章创作阶段还有自动校验修订,程序层查字数与重复段落,AI 层查情节一致性,最多三轮。对运营方来说这层确认流别当成效率障碍去砍,它是「机器产稿、人工把关」的工程化表达,也是内容合规的第一道关口。

问:爬虫模块采集来的内容能直接商用吗?
答:谨慎。novel-crawl 负责采集,8083 端口起服务后在后台配置采集源,官方文档对部署写得很清楚,但对目标站点的条款与版权边界,软件本身不替你把关。商用环境里采集来源的授权、AI 生成内容的平台规则、会员充值涉及的支付资质,三件事都在软件能力之外。这也是全文验证里那句话的落点:最先撑不住的不是代码里的哪一层,是合规这一层,它要站长自己划线。

相关阅读

分享到:

本文链接:https://www.biyeyuanma.cn/post/407.html

服务热线

加我微信

加我微信