一探究竟：XIUNOX 如何用 Bootstrap 5.3 和 HTMX 4 实现丝滑无刷新？

{

“title”: “XIUNOX v1.1.0：基于Xiuno BBS的现代化重构，让轻量论坛重焕新生”,

“content”: “

如果你曾经用过或了解过 Xiuno BBS，一定对它极致的轻量和简洁印象深刻。但时代在变，PHP 7 逐渐退役，原生 JavaScript 交互体验也已经满足不了现代用户的需求。现在，有一款基于 Xiuno BBS 4.0.4 原版打造的现代化重构版本——XIUNOX，它带着 v1.1.0 版本正式到来，全面拥抱 PHP 8 和 MySQL 8，并用新一代前端技术彻底重塑了论坛的使用体验。

为什么要重新打造 XIUNOX？

Xiuno BBS 是一款经典且高效的论坛程序，但原版代码在安全性、扩展性和现代兼容性方面逐渐显露出不足。XIUNOX 项目团队（曾用名 Xiuno Next、Xiuno BBS v4.5+）决定进行一次彻底的“手术式”重构，而不只是修修补补。他们保留了 Xiuno 轻量、快速的核心基因，但将底层技术栈全面升级，让这个老牌论坛程序能够适应 2025 年及以后的服务器环境和用户需求。

从 v1.1.0 版本开始，XIUNOX 已经稳定运行于 PHP 8.0+ 和 MySQL 8（使用 pdo_mysql 扩展），彻底抛弃了对过时版本的支持。与此同时，前端全面换装 Bootstrap 5.3 和 htmx 4，并引入了内置 AI 能力的 AIEditor 编辑器，让论坛不仅好看，更“聪明”。

技术栈：当轻量论坛遇上现代架构

后端：PHP 8.0+ / MySQL 8

XIUNOX 采用 PHP 8.0 及以上版本，充分利用了 JIT、命名参数、属性等新特性，性能和安全均得到显著提升。数据库方面只支持 MySQL 8，利用其原生 JSON 支持、窗口函数等特性，让查询更高效。所有数据库操作均使用参数化查询，从根本上预防 SQL 注入。

前端：Bootstrap 5.3 + htmx 4.1 的奇妙组合

传统论坛的页面刷新体验已经被时代淘汰。XIUNOX 没有选择重前端框架（如 Vue、React），而是使用了 htmx 4.1 来驱动交互。这种“服务端渲染 + 局部刷新”的架构，让页面加载更快，且保留了 SEO 友好的特性。htmx 的乐观更新（optimistic update）和 morph DOM 保留能力，使得发帖、回复、点赞等操作完全无刷新，流畅得就像原生应用。

UI 组件库选用了 Bootstrap 5.3，配合 Tabler Icons 2.1，界面现代且响应式，手机、平板、PC 都能获得舒适的浏览体验。动画方面使用了轻量级的 anime.js，让微交互更加生动。

编辑器：内置 AI 能力的 AIEditor

发帖编辑器不再只是简单的富文本框。XIUNOX 集成了 AIEditor，后者内置 AI 续写和优化能力，对接 AIService 抽象层。当你写帖子卡壳时，AI 可以帮你续写；写完后还可以一键优化语句。这个特性对于内容创作者来说非常实用。

核心特性：不止于重构，更是进化

1. htmx 驱动的无刷新交互

这是 XIUNOX 最亮眼的功能。无论是发帖、回复、编辑，还是操作管理后台，页面均不再整页刷新。htmx 通过属性（如 hx-post、hx-target）让任何 HTML 元素都可以发起 AJAX 请求，并且支持 CSS 过渡动画。XIUNOX 还使用了扩展 hx-live（实时更新）、hx-optimistic（乐观更新），让用户操作立刻反映在界面上，无需等待服务器响应。

2. 完善的安全防护体系

安全是论坛程序的生命线。XIUNOX 内置了多层防护：CSRF 双重校验（Token + Referer 检查）、XSS 防护（EscapeService 对输出进行过滤）、参数化查询、登录限速（防止暴力破解）、操作审计（记录管理员关键操作）。此外还提供验证码、IP 黑名单、敏感词过滤等功能，让站长省心。

3. 多语言与国际化

XIUNOX 原生支持多语言，目前已内置简体中文、繁体中文和英文。语言包采用键值对方式，方便翻译和扩展。后台可以一键切换语言，方便搭建面向不同区域的社区。

4. 附件管理与媒体处理

上传图片自动生成缩略图，支持图片裁剪；视频上传后可调用 ffprobe（可选）获取元信息（时长、分辨率等）；文件存储支持本地和云存储扩展。

5. 积分系统与日志

支持多种积分类型（如经验、金币、威望），每日获取限额、积分变动日志审计。非常适合做游戏化社区或付费阅读论坛。

6. 插件机制与开发者友好

XIUNOX 保留了 Xiuno 的 hook + overwrite 插件模式，并且内置了插件扫描器和崩溃自动禁用机制。当插件导致白屏时，系统会自动禁用该插件，保障论坛正常运行。开发者可以从 xiunox-plugin-dev-skill 学习完整的插件开发技能。

7. RESTful API 与 Token 认证

提供 v1 版本 RESTful API，支持 Token 认证，方便移动端或第三方客户端接入。这对于想要开发 App 或对接其他服务的站长来说极为关键。

插件开发与源码开源

XIUNOX 主程序源码已完全开源，且无需重复购买（原 Xiuno BBS 的商业授权问题已处理）。你可以从 GitHub 或 Gitee 直接克隆：

• 主程序：GitHub / Gitee
• 插件开发技能库：GitHub / Gitee

文档和示例插件也在持续完善中。如果你熟悉 PHP 和前端，完全可以基于 XIUNOX 二次开发出属于自己的特色社区。

总结

XIUNOX v1.1