XIUNOX Plugin Dev Skill

XIUNOX（XiunoBBS Next）插件开发知识库，为 AI 编码助手提供专业上下文，辅助插件开发、规范检查和旧插件迁移。

适用于 TRAE、Codex (OpenAI)、Claude Code、Cursor、Windsurf、WorkBuddy、Cline、Aider 等 AI 编码工具。

功能

• 插件架构设计与开发（hook 系统、编译时合并机制）

• 插件规范检查（安全、性能、兼容性）

• 旧插件迁移（jQuery/Alpine.js → htmx 4）

• 调试插件不生效问题

• 用户封禁系统接入

• AIEditor 富文本编辑器集成

• 路由表扩展与缓存系统

文件结构

.
├── SKILL.md                    # 主文件（触发条件 + 完整开发手册）
├── README.md                   # 本文件
└── references/
    ├── ai-rules.md             # AI 代码生成规则清单（禁止/必须/检查流程）
    ├── api-cheatsheet.md       # 核心 API 速查（DB/输入输出/安全/缓存/分页）
    └── hooks-catalog.md        # Hook 完整目录（所有可用注入点）

各 AI 工具接入方式

已有 6 人解锁

使用示例

在 AI 对话中直接提出 XIUNOX 插件开发需求：

• "帮我写一个签到插件，标识是xxx_checkin,你规划一下需要哪些功能"

• "调试插件不生效的问题"

• "检查 xnx_checkin 插件是否符合规范"

• "帮我给插件加上用户封禁场景化检查"

• "AIEditor 工具栏加一个自定义按钮"

核心规则

• 前端使用 htmx 4 + Bootstrap 5.3 + Tabler Icons（禁止 jQuery/Alpine.js）

• XSS 防护使用 esc_html()/esc_attr()/esc_js()

• 所有 POST 表单必须带 CSRF 保护

• 缓存使用 CacheHelper::remember() 替代裸 cache_get/cache_set

• URL 生成使用 url() 函数，禁止硬编码 .htm 后缀

• 插件命名必须带前缀，禁止使用 xn_/xnx_ 官方预留前缀

• 数据库表必须使用 utf8mb4

• 生产环境（DEBUG=0）走 tmp/model.min.php 合并加载，调用核心 Service 前必须 include_once

许可证

MIT