后端社交即时通讯【免费下载链接】NodeBBNode.js based forum software built for the modern web项目地址https://gitcode.com/gh_mirrors/no/NodeBB点击查看免费下载本指南以 CHANGELOG.md19138 行、约 110 个版本条目、926 个分类小节为唯一主体系统梳理 NodeBB 从 v1.15.02020-11-04到 v4.16.02026-09-16的完整演进脉络并对照仓库源码src/upgrades/、src/upgrade.js、src/cli/upgrade.js、src/start.js说明版本记录背后的升级机制。读完本文你将掌握 NodeBB 版本号的读写方法、各里程碑版本的核心变更尤其是 v4.0.0 的 ActivityPub 联邦化、以及./nodebb upgrade的底层执行链路能够据此规划自己的升级路径与变更排查。一、CHANGELOG 的整体结构与版本体系1.1 文件规模与版本跨度当前仓库的 CHANGELOG.md 是 NodeBB 官方变更日志的完整快照采用新版本在顶部、旧版本在底部的倒序组织方式最早条目#### v1.15.0 (2020-11-04)文件末尾最新条目#### v4.16.0 (2026-09-16)文件首行版本总数约 110 个正式版本含 v1.15.x、v1.16.x、v1.17.x、v1.18.x、v1.19.x、v2.x、v3.x、v4.x 八条大版本主线每条版本记录以#### vX.Y.Z (YYYY-MM-DD)起头随后按变更类型划分二级小节。这一结构保证了任何版本的回溯可读性——只要知道目标版本号就能在文件中准确定位其全部变更。1.2 版本条目的分类骨架CHANGELOG 中出现的分类标签及其语义如下表分类标签语义实例取自 v4.16.0 / v4.0.0Breaking Changes破坏性变更升级前必须关注v4.0.0getPostSummaryByPids新增escape选项、移除filter:teasers.configureStripTagshookNew Features新功能全局 hashtag 关注、聊天消息联邦化、消息已读 hookBug Fixes缺陷修复登录时序加固、webfinger 缓存投毒防护Performance Improvements性能优化减少重复 map、并行加载已读/未读通知Refactors代码重构以workerpool替换自建 worker 池、抽取ssrf.js模块Tests测试相关ActivityPub 测试消除外部网络调用、sendWorker/SendPool 单元测试Documentation Changes文档与 OpenAPI schema 更新/api/config路由新增resizeImageWidth定义Chores/deps/i18n工程杂项、依赖升级、翻译回退串smtp-server、sass-embedded、webpack等依赖例行升级每个条目末尾都附有短提交哈希如(3861ee1a)这是 NodeBB 通过 commitlint见 commitlint.config.js强制约定式提交Conventional Commits的直接产物——变更类型feature/fix/chore与 CHANGELOG 分类一一对应使得日志生成完全可机械化。1.3 CHANGELOG 与升级脚本目录的对应关系CHANGELOG 中的每个版本号都能在 src/upgrades/ 目录中找到对应子目录。当前该目录下有 75 个按版本命名的子目录1.0.0、2.8.7、3.0.0、4.0.0、4.16.0等外加一个TEMPLATE模板文件。这意味着凡是涉及数据库结构或存量数据迁移的变更CHANGELOG 记录的是发生了什么而src/upgrades/记录的是如何把旧数据变成新数据。例如 v4.0.0 阶段就有修复用户名含句点时旧 slug 的升级脚本d1c27b4d被实际落地。二、如何生成与读懂这份 CHANGELOG2.1 版本号的自增机制从 CHANGELOG 的 Chores 分类可以看到一条规律每个补丁版本如 v4.14.1 → v4.14.2 → v4.14.3都对应一条incrementing version number - vX.Y.Z (提交哈希)记录随后紧跟一条update changelog for vX.Y.Z。这说明版本号与 CHANGELOG 是同一提交流程内自动完成的二者始终保持同步。当前仓库的基准版本可通过 install/package.json 确认version: 4.16.0这正是 CHANGELOG 顶部版本号一致的原因。2.2 版本节奏三个典型阶段从日期密度可以清晰看出 NodeBB 的发布节奏变化v1.15.02020-11→ v2.0.02022-05约 1.5 年稳定补丁迭代v1.19.x 密集发布v1.19.0 至 v1.19.7 均有独立条目v3.0.02023-04→ v3.12.42025-013.x 大版本与 v4.0.0 之间仅隔 9 天说明 v4.0.0 的 RC/beta 阶段与 v3.12.x 的收尾并行v4.0.02025-01→ v4.16.02026-09约 20 个月、17 个大版本平均每月一个 minor 版本是最活跃的功能迭代期。三、v4.0.02025-01-20ActivityPub 联邦化的里程碑3.1 破坏性变更Breaking Changesv4.0.0 明确列出两项破坏性变更getPostSummaryByPids新增escape选项调用方必须显式决定是否对帖子摘要做 HTML 转义不再默认转义移除filter:teasers.configureStripTagshook核心层在 plaintext 输出时统一做 HTML 剥离从摘要生成流程中移除了 HTML 剥离逻辑插件不再能通过该 hook 自定义剥离标签集。这两项变更与帖子摘要在联邦ActivityPub场景下的安全输出直接相关——联邦出去的纯文本内容需要统一、可控的转义策略。对应实现位于 src/posts/summary.jsgetPostSummaryByPids与 src/posts/parse.jsHTML 剥离逻辑。3.2 联邦功能大爆发v4.0.0 的New Features是 CHANGELOG 中单版本功能密度最高的段落之一核心集中在 ActivityPub 联邦化聊天消息联邦化federating out chat messages、handle incoming non-public activities as chat message、编辑/删除/恢复时发送Update(Note)或Tombstone#12834话题同步与回填Topic Synchronization via resolvable context#12695、topic backfill logic via resolvable context#12647远程用户管理logic for remote user deletion, cronjob, and ACP options for pruning、ability to query remote users by webfinger handle帖子与对象生命周期软删帖子提供Tombstone对象、Note deletion logic and refactoring#12551、update mdidleware.assert.message so roomId is optional联邦基础设施basic retry queue、sign public key requests、add assertion lock on activitypub.notes.assert、add TTL cache for Actors.assert新端点与 Web 协议add nodeinfo endpoint#12589、所有外链先经/ap探测是否启用 ActivityPub 再决定解析或重定向#12822。这些功能在源码中的对应物非常完整src/activitypub/ 目录包含actors.js、inbox.js、send.js、sendWorker.js、signatures.js、jobs.js、relays.js、webfinger相关处理等 20 个模块test/activitypub/ 下则有inbox.js、outbox.js、signatures.js、sendPool.js、sendWorker.js、webfinger.js等 18 个测试文件。可以说 v4.0.0 的 CHANGELOG 条目就是这套联邦子系统的交付清单。3.3 基建与安全性增强同一版本还包含dynamic category icon generation、enable web-push plugin on first install、service worker icon and badge support、notification rescind support以及 OpenAPI 文档大量同步更新openapi spec for acp category federation page、add activitypub file to translations。CHANGELOG 中Documentation Changes与功能条目成对出现说明该版本对 API 契约public/openapi/ 下的 read/write YAML 规范的维护是强制的。四、v4.x 持续演进v4.1.0 至 v4.16.04.1 功能主线联邦、标签、消息与内容安全以最新版本 v4.16.02026-09-16为观察窗口可以看到 v4.x 后期联邦能力的深化RFC 9421 签名体系sign activities with rfc 9421, fall back to draft、verify incoming rfc 9421 signatures、use RFC 9421 registered algorithm identifiers in Signature-Input header并兼容 Mitra 的Content-Digest (RFC 9530)对应 src/activitypub/signatures.js发送架构升级implement send worker child process for offloaded federation、replace bespoke worker pool with workerpool、use os.availableParallelism() * 2的 worker 数量策略对应 src/activitypub/sendWorker.js 与 src/activitypub/send.jshashtag 关注add global hashtag follow feature、add category selector to hashtag follow、hashtags.js被独立成模块并纳入 OpenAPI schema内容警告CWsupport content warnings on incoming remote posts、include contentWarning in post summaries and teasers、hide content and thumbs behind CW in templates自定义 emoji 联邦render custom emoji in topic titles、hostname-aware custom emoji cache and proxy、re-download stale emoji on serve安全加固harden login timing, user status, and groupTitle、prevent cross-domain webfinger cache poisoning、enforce response size during streaming and require Digest for inbox requests。同期值得关注的非联邦功能add case-sensitive tag support with caseSensitiveTags config#14690、allow admins to hide topic event types#14824、expose category privilege copying via v3 API#14670、mark flag notifications read when the flag detail page is viewed#14747。4.2 配置项与源码的对应关系v4.16.0 新增的caseSensitiveTags配置项是CHANGELOG 条目 → 配置 → 源码链条的典型示例配置在 src/meta/configs.js 中注册默认值标签处理逻辑在 src/topics/tags.js 中读取该配置决定大小写敏感与否。当你在升级后遇到标签大小写行为变化时通过 CHANGELOG 关键词caseSensitiveTags反查即可定位到具体配置项。4.3 依赖治理节奏v4.x 每个版本都包含大量deps更新反映的是 NodeBB 的持续依赖跟进策略。仅 v4.16.0 就例行升级了smtp-server、sass-embedded、nodemailer、multer、webpack、express、postcss、cronstrue等数十个依赖同时在Bug Fixes中也会出现对核心依赖如mongodbv7.6.0、undiciv8.10.2、sharpv0.35.4的同步升级。升级依赖密集出现在 CHANGELOG 中意味着每次 NodeBB minor 升级后都应重新执行一次./nodebb build或至少完整重启服务因为编译链webpack/sass/postcss的版本变化会影响静态资源产物。五、v3.x 时代v3.0.02023-04-26与其后演进5.1 v3.0.0 的破坏性变更v3.0.0 明确列出两项 Breaking Changes维护模式改用 v3 风格错误#11426维护状态下的请求不再走旧错误渲染而是返回统一风格的 v3 错误响应便于 API 客户端识别普通版主regular mods同样受帖子队列post queue约束#11362此前版主发帖可绕过审核队列v3 起一视同仁。5.2 v3.x 的功能积累v3.x 阶段v3.0.0 ~ v3.12.42023-04 至 2025-01的功能条目包括管理 APIv3 API扩展add new GET routes to retrieve pending and invited members of a group, plus accept/reject pending#11420、api v3 route to add email to user, optionally bypassing validation email#11009、display when an api key was last used, in ACP#10873插件与 CLI 能力add ./nodebb install plugin_name、add force flag to plugin install in cli#11089主题与渲染update readme with new screenshot and updated copy for Harmony——这是 NodeBB v3 引入 Harmony 主题的标志性记录对应 public/src/modules/theme.js 相关的主题加载机制技术债清理up connect-redis to 7.x, drop node 14#11376——明确记录了运行时的 Node.js 版本门槛变化。5.3 从 v3 到 v4 的过渡CHANGELOG 显示 v3.12.42025-01-20与 v4.0.02025-01-20同一天发布且 v3.12.4 的 Chores 中出现bump harmony、bump persona to new major versions等为 v4 铺路的动作。这是 NodeBB 采用新旧大版本同时维护、平滑衔接策略的直接证据如果你的插件仍依赖 v3 的旧 hook如被移除的filter:teasers.configureStripTags应在升级 v4 前先验证插件兼容性。六、v2.x 与 v1.x早期功能积累6.1 v2.0.02022-05-04要点帖子队列批量操作post queue bulk actions#10520——审核员可批量接受/拒绝队列中的帖子对应 src/posts/queue.js 的批量处理逻辑启动信息增强output canonical URL as last line on NodeBB boot——服务启动完成后在日志末尾输出站点规范 URL对应 src/start.js 中printStartupInfo()的实现打印Initializing NodeBB v%s %s其中url即来自 nconf 配置。6.2 v1.19.x 与 v1.15.0 的早期积累v1.19.x 系列2022-01 至 2022-04值得记录的变更包括make it simpler to use redis sentinels#10483、closes #10501, minimum reputation to chat聊天最小声望门槛、allow unblocking admin/mod#10502、以及remove node 12, add 18的测试矩阵调整Tests 分类——这是 NodeBB 测试矩阵随 Node.js LTS 演进的记录。v1.15.02020-11-04作为 CHANGELOG 的起点其后的 v1.16.x 至 v1.19.x 覆盖了包括scroll anchoring移除、皮肤资源包含插件 LESS、username trim on login#6894、允许用户名含方括号#6921等大量细节修复是了解 NodeBB 中早期功能的入口。七、从 CHANGELOG 到实战./nodebb upgrade的底层执行链路7.1 CLI 升级五步骤CHANGELOG 记录的每个版本变更最终都要通过 nodebb 脚本require(./src/cli)驱动的升级流程落地。./nodebb upgrade由 src/cli/upgrade.js 实现其步骤定义如下步骤说明底层调用package用默认值更新 package.json保留已安装的额外插件packageInstall.updatePackageFile()/preserveExtraneousPlugins()install安装基础依赖packageInstall.installAll()plugins检查已安装插件是否有更新upgradePlugins(options.unattended)schema更新数据存储 schemaupgrade.run()见 src/upgrade.jsbuild重新构建前端资源meta.build.buildAll()7.2 升级脚本的版本匹配机制src/upgrade.js 是整个 schema 升级的核心它遍历 src/upgrades/ 目录按目录名版本号用 semver 排序同一版本内再按脚本timestamp字段排序然后逐批执行尚未运行的脚本跳过名为TEMPLATE的模板文件并检测重复脚本。TEMPLATE文件头部的注释即开发者文档——新增升级脚本需要复制TEMPLATE到唯一文件名 → 填写用户友好名称与时间戳 → 在method属性下实现迁移逻辑。7.3 启动时的自动升级检查src/start.js 的start.start()在服务启动时会执行runUpgrades()先upgrade.check()判断 schema 是否过期若抛出schema-out-of-date则自动调用upgrade.run()完成迁移同时meta.dependencies.check()会校验依赖版本一旦发现dependencies-out-of-date或dependencies-missing控制台会提示运行./nodebb upgrade。这一机制解释了为什么升级版本后首次启动会出现自动迁移 自动构建的流程——正是 CHANGELOG 中schema changes、rebuild assets类条目的运行时对应物。八、CHANGELOG 中的安全与稳定性信号8.1 安全修复的呈现方式CHANGELOG 中安全相关修复以两种形式出现独立security前缀条目如 v4.16.0 的harden login timing, user status, and groupTitle、prevent cross-domain webfinger cache poisoning以及散落在 Bug Fixes 中的高危项如 v3.x 的 CSRF 解析器更新、v1.x 的 SSRF 防护。建议把每个版本的security条目视为必须跟进升级的信号而非可延迟的常规 bugfix。8.2 用 CHANGELOG 做回归排查的实践方法在排障场景下CHANGELOG 是最快的定位工具定位行为发生变化的功能关键词如teaser、hashtag、post queue用关键词反查 CHANGELOG.md 找到引入变更的版本号对照 src/upgrades/ 目录确认是否存在数据迁移脚本阅读对应模块源码如 src/posts/summary.js、src/topics/tags.js确认当前行为结合 test/ 下的测试文件如 test/activitypub/、test/posts/验证预期行为。8.3 升级决策清单综合全文基于 CHANGELOG 的升级决策可归纳为四条先读 Breaking Changes 段v4.0.0、v3.0.0 等大版本的首个 minor 版本集中列出破坏性变更这是升级前必须逐条对照的清单核对 deps 更新是否触及你使用的运行时如 v3.0.0 的drop node 14升级前应确认服务器 Node.js 版本满足新要求验证插件 hook 兼容性被移除的 hook如filter:teasers.configureStripTags会在 CHANGELOG 中明确标注[breaking]升级后插件可能静默失效升级后重建资产所有涉及build/schema条目的版本都应完整执行一次./nodebb upgrade或让 src/start.js 完成启动时自动迁移与构建。结语NodeBB 的 CHANGELOG.md 不仅仅是一份变更清单它是一份按版本号索引的、可与src/upgrades/迁移脚本、src/activitypub/等功能模块、test/测试矩阵交叉验证的工程档案。从 v1.15.0 到 v4.16.0 的六年记录中可以清晰读出 NodeBB 从传统论坛系统向 ActivityPub 联邦化社区平台转型的完整轨迹。对使用者而言掌握版本号 → 变更分类 → 升级脚本 → 源码模块 → 测试这条追溯链就等于掌握了 NodeBB 整个演进史的检索入口。赞分享后端社交即时通讯【免费下载链接】NodeBBNode.js based forum software built for the modern web项目地址https://gitcode.com/gh_mirrors/no/NodeBB点击查看免费下载相关推荐解读 CodeMirror 5 的 CHANGELOG从 2.0.0 到 5.65.21 的十五年版本演进与升级决策指南解读 CodeMirror 5 的 CHANGELOG从 2.0.0 到 5.65.21 的十五年版本演进与升级决策指南 CHANGELOG.md https前端代码编辑器UI组件openFrameworks CHANGELOG 深度解读从 0.12.1 到 002 的版本演进与技术全景openFrameworks CHANGELOG 深度解读从 0.12.1 到 002 的版本演进与技术全景 openFrameworks简称 oF是一个图形学音视频Grommet 版本演进全解从 v0.1 到 v2.57 的 Changelog 解读与升级选型指南Grommet 版本演进全解从 v0.1 到 v2.57 的 Changelog 解读与升级选型指南 本文基于 Grommet 仓库根目录的 CHANGELO前端UI组件上一篇终端美学革命用iTerm2打造ASCII与Unicode艺术画廊下一篇3分钟完成Flomo到Obsidian笔记迁移的完整方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考