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），就当作纯静态文件，禁止写任何 代码