hook 文件名（含扩展名）必须和源标记一模一样：

• PHP 源码标记：// hook thread_create_thread_end.php
• 模板标记：

模型三层命名： __ 原始层（纯DB）→ 单 _ 业务层（缓存/计数/通知）→ _format 装饰层。插件永远调单下划线业务层。

硬规则（不可违反）

禁止

• ❌ jQuery（$()、.on()、.ajax()）
  • 07-17 起项目内置 jQuery 兼容 shim（view/js/xiuno-modern.js 暴露 window.jQuery = $），让 20 个存量插件 JS 和 .htm 模板内联 $ 代码继续工作。新插件/新代码强制用 XN API（XN.toast() / XN.ajax() / XN.confirm() / XN.$()），存量 $ 代码暂不强制重写、留待后续阶段逐个迁移
  • shim 已覆盖（存量代码可继续用）：$() 选择器链式、$.fn.*（BS5 桥接 modal/dropdown/tooltip/tab/collapse + loading/checked/serializeObject 等 17 个扩展）、$.ajax/$.get/$.post/$.getJSON、$.alert/$.confirm/$.ajax_modal、$.Event、xn.* PHP 函数库（intval/json_encode/url 等 30+）
  • shim 不支持（写了会静默失败或报错，必须改用 XN.ajax() + async/await 或原生 fetch）：jqXHR.done/.fail/.always 链式回调、同步 xhr（async: false）、jsonp/script dataType、$.when() 多请求编排、.animate() 队列动画
• ❌ Alpine.js（x-data、x-show、x-bind、x-model 等）
• ❌ idiomorph / alpine-morph 扩展
• ❌ htmlspecialchars 裸写 → 用 esc_html() / esc_attr() / esc_js()
• ❌ POST 表单不带 CsrfService::input() + CsrfService::check()
• ❌ 裸 include → 用 _include()
• ❌ window.__xxxData → 状态放 DOM（data-*、hidden input）
• ❌ 后台（admin/）用 htmx
• ❌ htmx 4 的 htmx:config:request 事件中修改 DOM 元素 → 该事件触发时 FormData 已构建完成，修改 DOM（如动态添加 input）不会影响请求体。必须直接修改 evt.detail.ctx.request.body（FormData 对象）来追加参数。
  • ❌ 错误写法：在 htmx:config:request 中 document.createElement('input') + appendChild
  • ✅ 正确写法：evt.detail.ctx.request.body.append('key', 'value')
• ❌ 用 APP_PATH 生成 '; echo '';

  // static/js/poll_post.js（纯静态）
  var I18N = window.XNX_POLL_I18N_POST || { options: '选项', min_options: '至少需要 2 个选项' };
  XN.toast(I18N.min_options, 'warning');
  

• 💡 判断规则：只要文件扩展名是 .js（非 .htm/.php），就当作纯静态文件，禁止写任何 代码

❌ 后台插件设置页/管理页模板（view/htm/setting.htm、view/htm/xxx_admin.htm）不 include 后台 header/footer → 这些模板是独立页面，必须首尾分别 include _include(ADMIN_PATH . 'view/htm/header.inc.htm') 和 footer.inc.htm，否则页面没有后台顶部导航栏和侧边栏（光秃秃只有表单）。前台插件页面则应 include APP_PATH . 'view/htm/header.inc.htm'（非 ADMIN_PATH）。⚠️ 已违反 1 次（xnx_poll setting.htm + poll_admin.htm 两个模板都漏 include）

• ✅ 正确范式：

  
  ...
  
  

• 💡 参考：xnx_related/view/htm/setting.htm、xnx_appcenter/view/htm/setting.htm 已有正确 include

❌ .htm 模板 hook 文件以 开头（会白屏！只能用 ）

❌ .htm 模板 hook 文件用 .php 扩展名（文件名必须和源码标记一模一样）

❌ 数据库表用 utf8（必须 utf8mb4 支持 emoji）

❌ 后台 setting.php 缺少 $gid != 1 && $gid != 2 AND message(-1, '无权限'); 权限检查

❌ SQL 拼接用户输入（必须 intval() 转义）

❌ 裸用 db_sql_find / db_sql_find_one / db_exec 做普通查询 → 优先用 db_find / db_find_one / db_count / db_find_group / db_find_one_group（防 SQL 注入）

❌ 保留复杂 SQL（JOIN/系统表/复杂 DML）时不加注释 → 必须加包含 保留 db_sql_find 或 保留 db_exec 关键字的注释（扫描器据此跳过报告）

❌ 帖子列表页 hook 中 new Service() + 查库 N 次（用静态缓存）

❌ db_insert 后不检查返回值就 message(0, '成功')（字段不存在会静默失败）

❌ 卸载脚本用 unstall.php（旧拼写） → 必须用 uninstall.php（标准拼写），核心已兼容回退但新插件禁止用旧拼写

❌ 数据库结构变更在 install.php/setting.php 加字段自愈代码 → 必须走 upgrade.php 幂等迁移 + 递增 conf.json.version

❌ esc_attr(json_encode(array(...))) 嵌套括号写一行（易出错，先存变量再转义）

❌ 硬编码 URL 后缀（如 /thread-{tid}.htm、/forum-{fid}.htm）→ 必须用 url() 函数适配伪静态格式（url_rewrite_on 支持 0~5 六种模式）

❌ 拼接 $site_url . '/xxx.htm' 做缓存刷新/跳转等 → 必须用 $site_url . url("xxx") 适配伪静态

❌ 单行注释 // 和 # 中包含 ?>：PHP 会把单行注释中的 ?> 当作 PHP 代码块结束标签，导致后续代码被当作纯文本输出，触发「headers already sent」错误，页面直接显示代码

• 错误示例：// 模板中调用：
• 正确写法：// 模板中调用示例：echo thread_url($tid);（去掉 和 ?>）
• 块注释 /* */ 中可以包含 ?>，不受影响

❌ 模板里硬编码 url("thread-$tid") 字符串拼接 → 必须用命名快捷函数（thread_url($tid)）或 route_url('thread', ['tid'=>$tid])

❌ 插件自定义路由直接写 url("myplugin-$id") → 必须通过 hook/model_route_table_end.php 注册到路由表

❌ 插件直接调用 route_table() 修改返回值（会破坏静态缓存）→ 只能通过 model_route_table_end.php hook 修改局部 $routes 变量

❌ 跨插件共享配置时，保存和读取用不同的存储键（如存到 setting_set('xnx_checkin', ...) 但从 setting_get('plugin_discover_items') 读取）→ 保存和读取必须用同一个 key

❌ setting_set('key', xn_json_encode($arr)) 然后 setting_get() 后 xn_json_decode() → setting_set/get 原生支持数组存取，不需要 JSON 中转

❌ 模板中

目录

作者最新文章

如何在点击输入框时取消按钮的激活状态并失焦时清空输入内容

2026-11-15 14:47

如何在OCR表格中合并多行单元格的分割文本块

2026-11-15 14:51

如何在泛型拦截器中获取Lambda表达式的实际返回类型

2026-11-15 14:53

如何在泛型拦截器中准确获取 Lambda 表达式的目标返回类型

2026-11-15 14:56

如何避免父组件条件切换时子组件的不必要重渲染

2026-11-15 14:59

如何精准合并OCR识别中多行单元格的分割文本块

2026-11-15 14:59

如何为 Go 微服务设计高效可靠的集成测试策略

2026-11-15 15:15

如何高效将字节字符串中的 \uXXXX 转换为对应 Unicode 字符

2026-11-15 15:16

如何高效地将字节串中的 \uXXXX 转换为对应 Unicode 字符

2026-11-15 15:22

Chart.js 图表不渲染？解决表单提交刷新与重复函数冲突问题

2026-11-15 15:32

热门AI工具

更多

PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

电商工具AI绘画作图

UpDream Hot

一款AI视频创作工具，主要用于哔哩哔哩推出的自研AI视频创作工具，适合需要提升相关任务效率的用户。

AI视频创作视频生成

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AI编程开发AI聊天问答

WorkBuddy

一款AI办公效率工具，主要用于腾讯云推出的AI原生桌面智能体工作台，适合需要提升相关任务效率的用户。

AI办公学习Agent智能体

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

AI编程开发AI大模型

墨刀AI Hot

一款AI图像与设计工具，主要用于产品经理的专属智能体，适合需要提升相关任务效率的用户。

AI设计工具Agent智能体

超级简历WonderCV Hot

一款AI办公效率工具，主要用于免费求职简历模版下载制作，应届生职场人必备简历制作神器，适合需要提升相关任务效率的用户。

AI办公学习工作效率

函子Zion Hot

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

AI大模型AI聊天问答

立刻MV Hot

立刻MV是一款AI文本写作工具，AI 音乐视频（MV）创作工具。

AI视频创作