XIUNOX 安装教程、使用文档及开发文档

管理

基于 Xiuno BBS 4.0.4 原版打造的现代化重构版本 XIUNOX。 (项目前期曾使用 Xiuno BBS v4.5+、Xiuno Next 作为项目名称,现已更名为 XIUNOX)

全面适配 PHP 8 + MySQL 8,采用 Bootstrap 5.3 与 HTMX 4 构建现代无刷新 UI, 安全与可扩展性大幅提升,原生支持多语言、RESTful API,让轻量论坛重获新生。

技术栈

  • 后端:PHP 8.0+ / MySQL 8(pdo_mysql)

  • 前端:Bootstrap 5.3 / htmx 4.1(含 hx-live、hx-optimistic 扩展)/ Tabler Icons 2.1

  • 编辑器:AIEditor(内置 AI 续写/优化能力,对接 AIService)

  • 动画:anime.js

  • 架构:htmx 纯净架构(服务端渲染 + 乐观更新 + morph DOM 保留)

  • 安全:CSRF 防护 / XSS 防护(EscapeService)/ 参数化查询 / 登录限速 / 操作审计

  • 缓存:MySQL / Redis / Memcached / Yac

  • API:v1 版本 RESTful API,支持 Token 认证

核心特性

  • 响应式布局,自适应手机、平板、PC

  • htmx 4 驱动交互:局部刷新、乐观更新、morph DOM 保留,无刷新发帖/回复/操作

  • 插件机制:hook + overwrite,方便二次开发;内置插件扫描器与崩溃自动禁用

  • 多语言支持:简体中文、繁体中文、英文

  • 附件管理:图片缩略、视频信息获取(ffprobe 可选)、图片裁剪

  • 积分系统:多类型积分、每日限额、日志审计

  • 安全防护:验证码、IP 黑名单、敏感词过滤、登录限速、操作审计

  • AI 服务:内置 AIService 抽象,支持多 Provider 接入;AIEditor 提供 AI 续写/优化

  • 代码高亮:highlight.js(仅帖子详情页加载)

  • 数据可视化:Chart.js

  • 二维码:qrcode.js

  • RESTful API:v1 版本 API,支持 Token 认证

  • 后台管理:用户 / 版块 / 插件 / 主题 / 安全 / AI 等完整管理功能

目录结构

xiunobbs/
├── admin/          # 后台管理(route + view + 菜单配置)
├── api/v1/         # RESTful API v1
├── conf/           # 配置文件(conf / smtp / attach / email 模板)
├── config/         # 安全配置(敏感词、保留词)
├── cli/            # 命令行脚本(密码迁移、积分同步)
├── cron/           # 定时任务
├── docs/           # 文档
│   ├── userguide/  # 前后台使用指南
│   └── plugindev/  # 插件开发手册(多文件版)
├── install/        # 安装程序
├── lang/           # 多语言包(zh-cn / zh-tw / en-us)
├── lib/            # 核心类库(Service、Security、PHPMailer、HTMLPurifier 等)
├── model/          # 数据模型(func.php 函数库)
├── plugin/         # 插件目录
├── route/          # 前台路由
├── service/        # 业务 Service 层
├── view/           # 前台资源
│   ├── htm/        # HTM 模板文件
│   ├── js/         # 自研 JS(xiuno-modern.js、bbs.js、aieditor 等)
│   ├── css/        # 样式(bootstrap-bbs.css、theme.css)
│   ├── img/        # 静态图片
│   └── vendor/     # 前端第三方库(bootstrap / htmx / animejs / chartjs 等)
├── xiunophp/       # 核心框架(db / cache / image / 加密 / 邮件等基础函数)
├── upload/         # 上传文件
└── tmp/            # 编译缓存(_include 编译产物 + cache 数据缓存)

快速开始

详见 安装教程

使用文档

插件开发

详见 插件开发手册(多文件版,推荐); 旧版 plugindev.md 保留作为历史参考。

AI skill https://gitee.com/poisonkid/xiunox-plugin-dev-skill

XIUNOX 应用开发SKILL 小白使用教程 (一)

XIUNOX 应用开发SKILL 小白使用教程 (二)

最新回复

请先登录后再回复 登录

uid:1 管理
关注
随遇而安,随缘而行
发帖 88
评论 357
粉丝 11
关注 1
发新帖
目录
XIUNOX 安装教程、使用文档及开发文档
此广告位招租
此广告位招租
此广告位招租
广告招租
广告招租
广告招租
广告招租
广告招租
广告招租