插件目录名

navgcn_auction（作者_功能标识 两段格式）

版本

1.1.0

适配系统

Xiuno BBS X 1.1.x

数据表

5张（拍品/出价/订单/保证金/分类），均使用 utf8mb4

前端框架

Bootstrap 5.3 + Tabler Icons

交互方式

前台 htmx 4 + XN.* API；后台原生 JS + Bootstrap

Service 类

NavgcnAuctionService（静态方法模式，通过 model_inc_file.php 注册）

路由注册

前台 index_route_case_end.php + model_route_table_end.php；后台 admin_index_route_case_end.php

发现页注册

discover_register.php（自注册，带 class_exists 守卫）

定时任务

model_cron_5_minutes_end.php

竞拍列表

?auction-list.htm

拍品详情

?auction-detail-{id}.htm

发布拍品

?auction-post.htm

我的竞拍

?auction-my.htm

后台管理

admin/?navgcn_auction-setting.htm

后台拍品管理

admin/?navgcn_auction-items.htm

后台订单管理

admin/?navgcn_auction-orders.htm

后台保证金管理

admin/?navgcn_auction-deposits.htm

必填字段完整（name/brief/version/bbs_version/type）

通过

bbs_version 为 1.1（与当前系统 XIUNOX_VERSION=1.1.5 前两位一致）

通过

不含 id/installed/enable 废弃字段

通过

hooks_rank 键名含扩展名且与 hook 文件完全匹配

通过

插件目录名 navgcn_auction 符合两段格式

通过

install.php 使用 CREATE TABLE IF NOT EXISTS 幂等建表

通过

install.php 所有表使用 DEFAULT CHARSET=utf8mb4

通过

install.php 以 !defined('DEBUG') AND exit('Access Denied'); 开头

通过

install.php 使用 setting_set() 写入默认配置

通过

uninstall.php 使用标准拼写（非 unstall.php）

通过

uninstall.php 执行 DROP TABLE IF EXISTS 清理全部5张表

通过

uninstall.php 使用 setting_delete() 清理配置

通过

upgrade.php 使用 SHOW COLUMNS + ALTER TABLE 幂等迁移

通过

upgrade.php 以 !defined('DEBUG') AND exit('Access Denied'); 开头

通过

所有 PHP hook 以 <?php exit; 开头

通过

所有 .htm hook 以 <?php 开头（非 <?php exit;）

通过

hook 目录下无 return; 语句

通过

hook 文件名与源码标记完全匹配

通过

所有 POST 表单包含 CsrfService::input()

通过

所有 POST 处理以 CsrfService::check() 开头

通过

setting.php 开头有 $gid != 1 && $gid != 2 AND message(-1, '无权限'); 权限检查

通过

后台路由文件开头有 $gid != 1 && $gid != 2 权限检查

通过

无 esc_textarea() 调用

通过

无裸 htmlspecialchars（全部使用 esc_html/esc_attr/esc_js）

通过

无 jQuery（$()、.on()、.ajax()、$.fn.*）

通过

无 Alpine.js（x-data、x-show、x-bind、x-model）

通过

后台无 htmx 属性（hx-post/hx-get/hx-target 等），使用原生 JS + Bootstrap

通过

无 htmx 2.x 旧事件名（htmx:configRequest 等）

通过

static/*.js 中无 <?php 代码

通过

静态资源放 static/js/ 和 static/css/ 目录

通过

静态资源引用使用 $conf['view_url'] . '../plugin/...'

通过

表名带前缀 navgcn_auction_*

通过

语言键带前缀 navgcn_auction_*

通过

setting 键为 navgcn_auction

通过

hook 内局部变量带前缀（$navgcn_auction_*）

通过

无 xn_ / xnx_ 前缀冲突

通过

db_* 函数传表名不含前缀

通过

无 db_find('user') / db_find_one('user') 绕过核心层

通过

无 SQL 中 SELECT display_name（使用 user_find_by_uids/user_read）

通过

用户信息使用 user_read()/user_find_by_uids()

通过

模板使用 display_name 而非 username

通过

头像使用原生 <img> 仅限拍品封面图（非用户头像）

通过

前台 URL 使用 url() / route_url() 生成

通过

后台 URL 使用 route_url() 生成

通过

后台指向前台的链接使用 ../ 前缀

通过

无硬编码 .htm/.html 后缀

通过

Service 通过 hook/model_inc_file.php 注册

通过

Service 调用 CreditsService 前 class_exists 守卫 + include_once

通过

discover_register.php 调用 DiscoverService 前 class_exists 守卫 + include_once

通过

前台模板 include APP_PATH . 'view/htm/header.inc.htm'/footer.inc.htm

通过

后台模板 include ADMIN_PATH . 'view/htm/header.inc.htm'/footer.inc.htm

通过

Card 组件使用 x-card class

通过

无裸 border/border-* 用于卡片装饰（border-primary 用于缩略图选中状态）

通过

无 global $plugins（前台判断启用使用 plugin_paths_enabled()）

通过

无 kv_delete/kv_set/kv_get 使用（本插件不使用 KV，配置走 setting_get/setting_set）

通过

uninstall.php 标准拼写（非 unstall.php）

通过

单行注释无 ?> 字符

通过

无覆盖核心路径（conf/、xiunophp/、lib/、admin/ 等）

通过

简体中文 lang_zh_cn_bbs.php 完整

通过

繁体中文 lang_zh_tw_bbs.php 同步

通过

英文 lang_en_us_bbs.php 同步

通过