技术栈全面升级：php8 + mysql8 + htmx

{

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

“content”: “

还记得当年风靡一时的 Xiuno BBS 吗？它凭借轻量、高效、简洁的设计，成为许多站长搭建社区的首选。但随着 PHP 和 MySQL 版本的快速迭代，以及前端交互从“整页刷新”向“无刷新体验”的转变，老旧的 Xiuno 4.0.4 逐渐显得力不从心——PHP 7 以下的兼容问题、缺少响应式布局、插件生态停滞……直到 XIUNOX 的出现，这一切都开始改变。

XIUNOX 并不是一个简单的升级补丁，而是基于 Xiuno BBS 4.0.4 源码、从里到外重写的“现代化重构版”。它全面拥抱 PHP 8.0+ 和 MySQL 8，摒弃了陈旧的模版引擎，用 Bootstrap 5.3 和 HTMX 4 构筑起一套全新的无刷新交互体系。同时保留了原版优秀的插件机制（hook + overwrite），并在此基础上加入多语言、RESTful API、AI 编辑器、积分系统等一系列现代社区必要的能力。可以说，XIUNOX 让这个曾经“死掉”的轻量论坛框架，重新焕发了生机。

技术栈全面升级：php8 + mysql8 + htmx

XIUNOX 的技术选型可以用“新、稳、快”三个字概括。后端直接要求 PHP 8.0+ 和 MySQL 8（通过 pdo_mysql 扩展连接），这意味着你可以利用 PHP 8 的 JIT 编译器、命名参数、匹配表达式等新特性，同时享受 MySQL 8 对 JSON、窗口函数、CTE 等高级查询的原生支持。前端则完全抛弃了老旧的 jQuery 生态，转而使用 Bootstrap 5.3 搭建响应式 UI，配合 HTMX 4.1 实现“服务端渲染 + 局部刷新 + 乐观更新”。

HTMX 是 XIUNOX 最亮眼的创新之一——你不再需要写任何前端 JavaScript 路由或 Ajax 请求框架；发帖、回复、点赞、禁言等操作统统由 HTMX 属性驱动，浏览器在后台发送异步请求，服务器返回 HTML 片段，HTMX 自动替换目标 DOM 节点。配合 hx-live、hx-optimistic 扩展，界面甚至能实现“先更新 UI，再异步验证”的丝滑体验，而 morph DOM 保留 技术则保证了表单输入、滚动位置等状态不会丢失。

编辑器方面，XIUNOX 内置了 AIEditor，它并非简单富文本编辑器，而是集成了 AI 续写和优化 功能，对接了抽象层 AIService，允许接入 OpenAI、文心一言等不同 Provider。发帖时如果思路卡顿，点一下“AI 续写”即可自动生成内容；写完后还可以让 AI 润色语言。图片管理支持自动缩略、视频信息提取（需 ffprobe），甚至裁剪功能也一并内置。

其他组件包括：anime.js 负责过渡动画，highlight.js 仅在帖子详情页加载，Chart.js 用于后台数据可视化，qrcode.js 快速生成分享二维码。整站字体图标统一使用 Tabler Icons 2.1，风格现代且开源免费。

核心特性：无刷新、多语言、防攻击、易扩展

响应式布局是基础要求。无论是手机、平板还是 PC，页面都会自动适配，用户不再需要缩放或横向滚动。得益于 Bootstrap 5.3 的网格系统，XIUNOX 的每一个页面（包括后台管理）都做到了完整响应式。

无刷新交互覆盖了所有社区操作。比如在主题列表页点击“点赞”，HTMX 会向服务端发送 POST 请求，服务器返回更新后的点赞数和按钮样式，用户看到的是瞬间变化，没有任何页面闪烁。甚至发帖和回复也都是局部刷新——你提交表单后，HTMX 替换帖子列表区域，同时乐观更新策略会先显示一个“占位内容”，等服务器确认后再替换为正式数据，体验非常流畅。

多语言支持是原生就有的功能。目前内置简体中文、繁体中文、英文三种语言包，且通过键值对方式管理翻译资源。插件开发者也可以轻松添加自己的语言包。对于面向国际用户的社区，这一点省去了二次开发的语言适配成本。

安全防护被提升到了全新高度。CSRF 防护使用一次性 Token，XSS 防护通过 EscapeService 对所有输出进行上下文转义。所有数据库操作全部参数化查询，杜绝 SQL 注入。此外还内置了登录限速（防止暴力破解）、IP 黑名单、敏感词过滤、操作审计日志（记录谁什么时候做了什么操作）。后台管理员可以一键开启验证码，或者配置全局密码强度策略。

积分系统支持多类型积分（例如经验、威望、金币等），并可以设置每日获取上限、以及不同操作的积分增减规则。所有积分变动都会记录审计日志，方便管理员查证异常。

AI 服务是 XIUNOX 区别于其他论坛的亮点。AIService 抽象层支持多 Provider 并行接入，管理员在后台配置好 API Key，用户即可在发帖时使用 AI 续写、优化功能。但要注意，AI 功能是可选开启的，如果你不需要，完全可以在后台关闭。

RESTful API 提供了 v1 版本接口，采用 Token 认证（非 Cookie），支持获取主题、帖子、用户信息等，第三方客户端（APP、小程序）可以直接调用，让 XIUNOX 不仅是 Web 论坛，也能成为开放数据平台。

插件开发入门：下载源码、学习技能、快速上手

要开发 XIUNOX 插件，第一步是获取主程序源码。官方仓库在 GitHub 和 Gitee 均有镜像，建议直接 clone 最新 release 分支。

• 主程序 GitHub：https://github.com/domidesign/xiunox
• 主程序 Gitee：https://gitee.com/poisonkid/xiunox

同时强烈建议阅读官方提供的《应用开发技能》项目，里面包含了完整的插件开发教程、Hook 列表、Overwrite 示例以及最佳实践：

• 开发技能 GitHub：https://github.com/domidesign/xiunox-plugin-dev-skill
• 开发技能 Gitee：https://gitee.com/poisonkid/xiunox-plugin-dev-skill

XIUNOX 的插件机制沿用 Xiuno 经典的 hook + overwrite 模型。你不需要修改核心文件，只需在