XIUNOX v1.1.0：轻量论坛的现代化重生——全面解析与插件开发指南

从 Xiuno BBS 到 XIUNOX：一场彻底的现代化蜕变

还记得那个以轻量、简洁著称的 Xiuno BBS 4.0.4 吗？它曾是许多中小型社区的首选论坛程序，但由于技术栈老旧、安全漏洞频出，逐渐被时代遗忘。如今，XIUNOX（原名 Xiuno Next）带着 v1.1.0 版本强势回归——基于原版核心逻辑，却用 PHP 8、MySQL 8、Bootstrap 5.3 和 HTMX 4 重新定义了论坛的交互方式。它不再是“旧瓶装新酒”，而是从骨架到皮肤的全新锻造。

如果你正在寻找一个既保留论坛经典功能，又具备现代 Web 体验（无刷新发帖、响应式、AI 加持）的轻量解决方案，那么 XIUNOX 可能是你今年最值得关注的开源项目。

技术栈：站在巨人肩膀上的工程

XIUNOX 的技术选型可以用“精准且克制”来形容——不堆砌框架，但每个组件都经过深思熟虑。

后端：PHP 8.0+ 与 MySQL 8

全面拥抱 PHP 8 的类型系统、命名参数和 JIT 特性，配合 pdo_mysql 实现参数化查询，彻底杜绝 SQL 注入。数据库从 MySQL 5.x 升级到 8，支持原生 JSON、窗口函数和更好的 utf8mb4 支持，为论坛的多语言和积分系统打下坚实基础。

前端交互：HTMX 4 + Bootstrap 5.3

不同于传统前后端分离的 SPA 方案，XIUNOX 使用 HTMX 4 作为核心交互引擎。支持局部刷新、乐观更新（Optimistic Update）和 morph DOM 保留——这意味着页面切换时，表单输入不会被清空，动画不中断，体验接近原生 App。搭配 Bootstrap 5.3 的响应式网格和暗色模式，论坛在手机、平板、PC 上均能自适应。

编辑器与 AI：AIEditor

内置的 AIEditor 不仅支持 Markdown 和富文本，还内置了 AI 续写/优化能力，对接 XIUNOX 的 AIService。发帖时只需输入开头，AI 即可帮你完善内容；回复时也能一键润色，极大降低内容创作门槛。

核心特性：不止是升级，更是进化

XIUNOX v1.1.0 带来了超过 20 项新特性，以下是最值得关注的几项：

• 无刷新交互：发帖、回复、点赞、举报、切换版块——所有操作均通过 HTMX 异步完成，无需整页刷新。
• 多语言原生支持：内置简体中文、繁体中文、英文语言包，通过语言文件切换，无需安装插件。
• RESTful API v1：支持 Token 认证，方便手机 App、小程序或第三方客户端对接。
• 安全加固：CSRF 防护、XSS 过滤（EscapeService）、登录限速、操作审计日志、IP 黑名单、验证码等全套防护。
• 积分与附件管理：多类型积分（如金钱、威望）、每日限额、日志审计；图片自动缩略、视频信息提取（可选 ffprobe）、图片裁剪。
• 插件机制：采用 hook + overwrite 模式，内置插件扫描器，插件若导致崩溃会自动禁用，避免白屏。

插件开发：从零到一的实战指南

XIUNOX 的插件系统足够灵活，官方提供了完整的开发技能文档（GitHub / Gitee）。以下是快速上手的三个步骤：

第一步：下载主程序与开发技能包

从 GitHub 或 Gitee 克隆 xiunox 主仓库，以及 xiunox-plugin-dev-skill 项目（包含示例插件、hook 列表和模板变量文档）。建议使用 PHP 8.1+ 环境和 MySQL 8.0+。

第二步：理解 hook 与 overwrite

XIUNOX 的插件通过 hook（钩子）注入自定义逻辑，比如在用户注册后发送邮件、在帖子列表前插入广告。如果需要对核心模型进行深度修改，可以使用 overwrite 机制覆盖原有类方法。开发技能包中列出了所有可用的 hook 点，例如 post_create_before、user_login_after 等。

第三步：编写插件配置文件

每个插件包含一个 conf.json 文件，声明名称、版本、依赖、hook 绑定等。例如：

{

“name”: “example_plugin”,

“version”: “1.0.0”,

“hook”: {

“post_create_before”: “ExamplePlugin::onPostCreate”

}

}

插件文件放在 plugin/ 目录下，后台即可识别并启用。开发过程中建议开启 插件自动禁用 功能，避免语法错误导致整个论坛挂掉。

结语：旧时代论坛的现代归宿

XIUNOX 并不是一个简单的“升级版”，它从架构、安全、体验三个维度重新定义了轻量论坛的可能性。特别是 HTMX 带来的无刷新体验和 AI 编辑器，让用户既能享受经典论坛的社区氛围，又能获得现代 Web App 的流畅感。如果你正在维护一个老旧的 Xiuno BBS 论坛，或者计划从头搭建一个小清新的社区，不妨试试 XIUNOX——它可能就是你要找的那个“重生”方案。