XIUNOX：基于Xiuno BBS重构的现代化轻量论坛，全面适配PHP 8与MySQL 8

一、项目背景与定位

XIUNOX（前身为Xiuno BBS v4.5+、Xiuno Next）是在经典开源论坛系统Xiuno BBS 4.0.4基础上进行现代化重构的全新版本。项目由社区开发者domidesign主导，旨在让轻量级论坛焕发新生，在保持极简高效核心的同时，全面适配PHP 8+与MySQL 8，并融入现代前端技术栈与安全实践。

当前最新版本为v1.1.0，经过前期的积累与迭代，已具备生产环境部署能力。无论你是个人站长、小型社区运营者，还是希望二次开发的企业团队，XIUNOX都能提供称心如意的体验。

二、核心技术栈

后端

• PHP 8.0+：充分利用命名参数、联合类型、匹配表达式等新特性，性能与安全性大幅提升。
• MySQL 8：支持窗口函数、CTE、JSON增强等，结合参数化查询，杜绝SQL注入。
• pdo_mysql：统一数据库驱动，方便迁移与扩展。

前端

• Bootstrap 5.3：响应式网格、组件、主题，自适应手机、平板、PC。
• htmx 4.1：核心交互引擎，实现无刷新发帖、回复、操作。使用hx-live、hx-optimistic扩展，支持乐观更新与morph DOM保留（仅更新变化部分，保留输入焦点与滚动位置）。
• Tabler Icons 2.1：开源图标库，风格统一。
• anime.js：轻量动画库，用于UI动效。
• highlight.js：帖子详情页按需加载，代码高亮。
• Chart.js：后台数据可视化。
• qrcode.js：生成二维码。

编辑器

AIEditor：内置AI续写/优化能力，对接AIService，支持多Provider接入（如OpenAI、本地模型）。用户可在发帖时轻松获得智能写作辅助。

缓存

支持MySQL内部查询缓存、Redis、Memcached、Yac（共享内存缓存），按需选择，降低数据库压力。

三、核心特性详解

1. 无刷新交互体验

基于htmx 4的纯净架构，服务端渲染HTML片段，通过htmx局部替换实现无刷新操作。无需编写大量JavaScript代码，前后端分离更简洁。乐观更新机制让用户操作得到即时反馈，morph DOM保留技术则保证了表单输入、滚动位置等状态不丢失。

2. 安全防护体系

XIUNOX内置多层次安全措施：

• CSRF防护：每个表单携带Token，校验来源。
• XSS防护：EscapeService对所有输出进行安全转义。
• 参数化查询：所有数据库操作使用预处理语句。
• 登录限速：限制失败尝试次数，防止暴力破解。
• 操作审计：记录管理员与用户的关键操作，便于追踪。
• IP黑名单、验证码、敏感词过滤等常规功能一应俱全。

3. 多语言支持

原生支持简体中文、繁体中文、英文，语言包可通过后台或插件扩展，轻松适配国际化社区。

4. 积分系统与附件管理

支持多类型积分（如经验、金币），每日限额、日志审计完整。附件管理提供图片缩略图生成、视频信息获取（集成ffprobe，可选）、图片裁剪功能，方便多媒体内容管理。

5. AI服务与编辑器集成

AIService抽象层支持对接多个AI供应商（OpenAI、Azure、本地模型等），AIEditor提供AI续写、优化、翻译等能力，让用户撰写帖子更高效。

6. RESTful API

提供v1版本RESTful API，支持Token认证（Bearer）。开发者可以基于API构建移动端、第三方客户端或进行自动化集成。

7. 插件机制

采用hook + overwrite模式，方便二次开发。内置插件扫描器，自动检测新插件；插件崩溃时可自动禁用，保障论坛稳定。插件开发文档与示例仓库（xiunox-plugin-dev-skill）让开发者快速上手。

8. 后台管理完善

用户管理、版块管理、插件管理、主题设置、安全防护、AI配置等模块一应俱全。管理员可以轻松驾驭整个论坛运营。

四、插件开发快速入门

XIUNOX的插件开发遵循以下步骤：

1. 下载源码：从GitHub或Gitee拉取主程序（GitHub仓库 / Gitee仓库）。
2. 学习开发技能：参考应用开发技能仓库，了解hook点、overwrite机制、模板继承、数据库迁移等。
3. 创建插件目录：在 /plugin/ 下新建文件夹，编写info.json描述文件，注册hook。
4. 测试与发布：插件扫描器会自动检测，确保不崩溃即可发布到社区分享。

受益于Bootstrap 5.3和htmx架构，插件的前端交互可以轻松实现无刷新效果，无需侵入核心代码。

五、总结与展望

XIUNOX不仅是对Xiuno BBS的简单升级，更是一次全面的现代化转型。它在保持原本轻量、快速特质的同时，引入了现代安全实践、前沿前端技术、AI赋能与完整的API体系。无论是个人轻社区、企业内网论坛还是产品社区，XIUNOX都值得尝试。

未来项目计划包括：移动端深度优化、插件市场官方平台、更多缓存驱动支持、以及更丰富的AI集成场景。如果你对轻量论坛有特殊情怀，不妨关注XIUNOX，甚至参与贡献代码或插件。