Trae IDE 子比 Zibll 插件开发完整规则集

作者：小武 | 官网：1z345.cn | 所有子比Zibll主题插件开发必须遵守本规则集。
1. 自动读取项目根目录AGENTS.md、CLAUDE.md、CLAUDE.local.md，全量并入会话上下文
2. 优先遵循上述文档中的开发规范，文档与本规则冲突时以本规则为准
3. 开启全局记忆，自动加载/root/trae-cn/memory/user_profile.md用户配置
4. 跨会话记忆历史插件前缀、目录结构、已确认的例外规则

插件前后台所有UI必须100%优先复用Zibll主题原生实现，禁止私自开发：
1. 按钮、卡片、弹窗、通知、表单、导航全部使用main.css工具类和CSS变量
2. 提示通知必须用notyf()，弹窗必须用zib_modal()或refresh_modal()
3. 禁止自定义独立CSS样式、独立弹窗结构、独立提示组件
4. 仅当确认子比无原生实现时，必须先向用户问询，未获批复禁止编码

所有CSF相关代码必须严格遵守加载顺序，否则会导致致命错误：
1. CSF::createOptions、CSF::createWidget必须挂载zib_require_end钩子
2. 禁止在PHP文件顶层直接实例化CSF或CSF_Widget类
3. CSF配置存储键$options_key必须全局唯一，不可与主题/其他插件重复
4. 统一引用csf-framework/目录，弃用旧版codestar-framework/

插件前端资源必须与主题加载顺序一致，自动适配明暗模式：
1. CSS必须声明依赖['main']，保证在main.css之后加载
2. 所有配色使用:root CSS变量，禁止硬编码#fff/#333等十六进制色值
3. 自定义CSS类名必须添加插件专属前缀，禁止覆盖zib-widget等原生类
4. JS必须声明依赖['jquery']，底部加载，禁止假设WP默认jQuery路径

1. 所有主题函数调用前必须前置主题检测：非zibll主题时终止加载+后台报错
2. AJAX接口必须实现Nonce校验+用户权限校验，按需区分登录/游客nopriv
3. 禁止修改Zibll主题任何源文件，所有功能通过action/filter钩子扩展
4. 输出内容必须做转义处理，防止XSS漏洞

全局统一命名规则，杜绝命名冲突：
1. 插件文件夹名=主PHP文件名，例：zib-donation → zib-donation.php
2. 所有函数、选项键、脚本handle、widget标识使用统一插件前缀
3. 变量名使用snake_case，类名使用PascalCase，常量使用全大写

任何不确定场景必须暂停开发，主动向用户确认： 1. 不确定子比是否原生支持某功能/组件 2. 不确定实现方案是否符合主题规范 3. 不确定样式是否与主题风格统一 4. 任何可能修改主题核心逻辑的操作

固定插件目录结构，禁止随意调整：
插件根目录/
├─ 插件主文件.php（入口：依赖检测+引入子文件）
├─ inc/
│  ├─ options.php（CSF后台配置）
│  ├─ widget.php（CSF侧边小工具）
│  ├─ ajax.php（AJAX业务逻辑）
│  └─ functions.php（通用工具函数）
└─ assets/
   ├─ css/frontend.css（前台样式）
   └─ js/frontend.js（前台脚本）

1. CSF后台配置统一写在inc/options.php，挂载zib_require_end钩子
2. 选项读取必须封装静态缓存函数，避免重复查询数据库
3. 小工具输出函数名必须与CSF::createWidget第一个参数完全一致
4. 小工具容器统一使用zib-widget类，保证与主题侧栏样式一致

优先复用main.js内置API，禁止重复封装：
1. 全局配置使用_win对象（_win.www、_win.ajax_url、_win.is_signin）
2. AJAX请求必须使用zib_ajax()，自动处理loading和验证码
3. 按需使用tbquire异步加载主题模块（swiper、dplayer、clipboard等）
4. 表单序列化使用$.fn.serializeObject()，与主题保持一致