一、引言：为什么需要 XIUNOX？

{

“title”: “XIUNOX v1.1.0 深度解析：从架构到插件开发，轻量论坛的现代化重生”,

“content”: “

一、引言：为什么需要 XIUNOX？

对于许多站长和技术爱好者来说，Xiuno BBS 4.0.4 曾经是搭建轻量级社区的首选——速度快、代码精简、插件灵活。然而，随着 PHP 8 和 MySQL 8 的普及，以及前端用户对无刷新体验、移动端适配的更高要求，旧版 Xiuno 逐渐显得力不从心。于是，XIUNOX 应运而生。作为 Xiuno BBS 4.0.4 的现代化重构版本（当前 v1.1.0），它全面适配 PHP 8 + MySQL 8，采用 Bootstrap 5.3 与 HTMX 4 构建现代无刷新 UI，大幅提升安全性与可扩展性，并原生支持多语言和 RESTful API，让经典的轻量论坛焕发新生。

二、技术栈：后现代与前沿的碰撞

XIUNOX 的技术选择非常务实且富有前瞻性：

• 后端：PHP 8.0+ 与 MySQL 8（pdo_mysql），充分利用 JIT 编译和性能优化，同时要求严密的参数化查询和错误处理。
• 前端：Bootstrap 5.3 提供响应式布局基础，htmx 4.1 则承担起所有交互重担——包括 hx-live 和 hx-optimistic 扩展，实现真正的“无刷新”发帖、回复和后台操作。图标使用 Tabler Icons 2.1，美观且轻量。
• 编辑器：内置 AIEditor，不仅支持富文本编辑，还内嵌 AI 续写/优化能力，对接统一的 AIService 抽象层，未来可接入多种 AI 提供商（如 OpenAI、文心等）。
• 动画与可视化：anime.js 负责流畅的交互动画，Chart.js 支撑数据统计图表，qrcode.js 生成二维码，highlight.js 提供帖子详情页的代码高亮（按需加载，不拖慢首屏）。
• 架构：坚持 htmx 纯净架构，即服务端渲染 + 乐观更新 + Morph DOM 保留。这意味着每次交互由后端返回 HTML 片段，前端通过 htmx 局部替换，配合 morph 算法保留焦点和动画状态，用户体验直逼 SPA。

三、核心特性：不止于升级

XIUNOX 并非简单地将 Xiuno 升级到新版，而是从底层开始重塑：

• 安全第一：内置 CSRF 防护、XSS 防护（EscapeService 自动转义输出）、参数化查询、登录限速、操作审计日志……这些防护机制开箱即用，极大降低被攻击风险。
• 插件生态：沿用 hook + overwrite 机制，但新增插件扫描器与崩溃自动禁用功能，避免因插件异常导致整个论坛瘫痪。开发者可以参照官方提供的《应用开发技能》仓库快速上手。
• 多语言支持：原生支持简体中文、繁体中文、英文，并且语言包结构清晰，便于扩展。
• 附件与积分：附件管理支持图片缩略、视频信息提取（可选 ffprobe）、图片裁剪；积分系统支持多类型积分、每日限额和完整日志审计。
• RESTful API：v1 版本 API 采用 Token 认证，可方便地与移动端、第三方应用集成。
• 后台管理：覆盖用户、版块、插件、主题、安全、AI 设置等所有管理功能，界面同样采用 Bootstrap + htmx，操作快捷。

四、插件开发指南：快速上手 XIUNOX 扩展

XIUNOX 的插件体系继承了 Xiuno 的灵活性，同时更加健壮。如果你想要开发自己的插件，请按以下步骤进行：

1. 获取源码主程序推荐从 GitHub 或 Gitee 克隆：https://github.com/domidesign/xiunoxhttps://gitee.com/poisonkid/xiunox

2. 学习插件开发技能官方提供了专门的教学仓库：https://github.com/domidesign/xiunox-plugin-dev-skill