xiuno-bbs-plugin-generator
<![CDATA[---
name: "xiuno-bbs-plugin-generator"
description: "根据用户自然语言需求，自动生成符合Xiuno BBS规范的完整插件代码。当用户需要创建Xiuno BBS插件、开发论坛功能扩展、或提到'写插件'、'开发插件'、'生成插件'时调用。"
---
# Xiuno BBS 插件自动生成技能
## 技能定位
本技能使AI能够根据用户的自然语言需求描述，按照标准化流程自动生成符合Xiuno BBS 4.0规范的完整插件代码。AI将执行：需求分析 → 结构规划 → 代码生成 → 校验输出的完整流程。
## 技术栈约束
- **后端**: PHP 7.2+（推荐8.0+），面向过程风格
- **数据库**: MySQL 5.7+ / MariaDB 10.2+，InnoDB引擎
- **前端**: Bootstrap 5 + HTMX + 原生JS/jQuery
- **模板**: PHP原生模板语法（.htm文件）
- **编码**: UTF-8 无BOM，LF换行符
## 核心机制速查
### Hook机制（编译时合并）
- PHP标记: `// hook 文件名.php`
- HTM标记: `<!--{hook 文件名.htm}-->`
- PHP Hook文件以 `<?php exit;` 开头（防直接访问，编译时自动去除）
- HTM Hook文件为纯HTML/JS/PHP片段
- hooks_rank: 数值越大越后执行，负值优先执行
### Overwrite机制（文件级替换）
- 路径: `plugin/{插件名}/overwrite/{相对APP_PATH的文件路径}`
- overwrites_rank: 数值越大优先级越高
### 路由机制
- URL格式: `route-action-subaction.htm`
- `param(0)` = route, `param(1)` = action, `param(2)` = subaction
- 前台路由注册: `hook/index_route_case_end.php`
- 个人中心路由: `hook/my_end.php`（URL: `my-action.htm`）
- 后台路由注册: `hook/admin_index_route_case_end.php`
### 数据存储
- Setting: `setting_set/get/delete('plugin_name', $array)` — 插件配置专用
- KV: `kv_set/get/delete('key', $value)` — 持久键值
- KV+Cache: `kv_cache_set/get/delete` — 持久+缓存加速
- Cache: `cache_set/get/delete('key', $data, $ttl)` — 临时缓存
- 数据库表: `db_create/update/delete/find/find_one/count/maxid/exec`
### 安全规范
- 用户输入: 始终使用 `param()` 获取（自动htmlspecialchars防XSS）
- SQL: 使用db_*封装函数（addslashes防注入）
- CSRF: 表单必须含 `<input type="hidden" name="form_hash" value="<?php echo $form_hash; ?>" />`
- 权限: `user_login_check()` 登录检查，`$gid` 权限检查
---
## 模块一：需求分析
当用户描述插件需求时，AI必须先完成以下分析，并向用户确认后再生成代码：
### 1.1 功能分类判定
将用户需求归入以下类别之一：
| 类别 | 特征 | 典型示例 |
|------|------|---------|
| **数据展示型** | 读取现有数据并展示 | 热帖排行、用户排行、统计面板 |
| **用户交互型** | 用户可操作并产生数据 | 点赞、收藏、签到、评分 |
| **内容增强型** | 增强帖子/版块展示 | 标签、图章、编辑器、代码高亮 |
| **系统扩展型** | 扩展系统功能 | 积分、VIP、权限、搜索 |
| **页面新增型** | 添加全新页面 | 自定义页面、工具页、数据看板 |
| **后台管理型** | 后台管理功能 | 批量操作、数据导入导出 |
### 1.2 必须确认的信息
AI必须明确以下信息（可从用户描述中推断，无法推断时需询问）：
1. **插件名称和ID**: 遵循 `作者标识_功能名称` 格式
2. **核心功能列表**: 插件需要实现的每个功能点
3. **数据存储需求**: 是否需要新建数据库表？需要哪些字段？
4. **UI展示位置**: 在哪些页面展示？使用哪些Hook点？
5. **是否需要设置页面**: 用户可配置哪些选项？
6. **是否需要后台管理**: 管理员需要哪些管理功能？
7. **依赖插件**: 是否依赖其他插件（如积分插件）？
8. **权限需求**: 哪些用户组可以使用？是否需要登录？
### 1.3 Hook点选择指南
根据功能需求选择合适的Hook点：
| 需求场景 | 推荐Hook点 | 说明 |
|---------|-----------|------|
| 首页添加面板 | `index_site_brief_after.htm` | 站点简介后 |
| 首页注入JS | `index_js.htm` | 首页JS区域 |
| 帖子底部按钮 | `thread_plugin_body.htm` | 首帖底部操作区 |
| 帖子标题后标记 | `thread_subject_end.htm` | 标题区域 |
| 帖子列表标记 | `thread_list_inc_subject_after.htm` | 列表标题后 |
| 发帖表单增强 | `post_message_after.htm` | 发帖内容区后 |
| 帖子页JS | `thread_js.htm` | 帖子页JS区域 |
| 发帖页JS | `post_js.htm` | 发帖页JS区域 |
| 导航栏添加项 | `header_nav_user_start.htm` | 导航栏用户区前 |
| 全局JS | `footer_js_after.htm` | 页面底部JS后 |
| 注册Model | `model_inc_file.php` | 注入Model文件（末尾需逗号） |
| 注册前台路由 | `index_route_case_end.php` | switch-case内添加case |
| 注册个人中心路由 | `my_end.php` | elseif分支 |
| 注册后台路由 | `admin_index_route_case_end.php` | switch-case内添加case |
| 帖子创建后 | `model_thread_create_end.php` | 可用$tid, $arr |
| 帖子删除前 | `model_thread_delete_start.php` | 可用$tid |
| 回帖创建后 | `model_post_create_end.php` | 可用$pid, $arr |
| 回帖删除前 | `model_post_delete_start.php` | 可用$pid |
| 回帖更新后 | `model_post_update_end.php` | 可用$pid, $arr |
| 用户登录后 | `user_login_post_end.php` | 可用$uid |
| 版块格式化 | `model_forum_end.php` | 注入forum_format扩展 |
| 主题格式化 | `model_thread_format_end.php` | 注入thread_format扩展 |
---
## 模块二：插件结构生成
### 2.1 目录结构决策树
```
需要新建数据库表？
├─ 是 → 需要 install.php + unstall.php + model/
└─ 否 → 不需要
需要独立页面？
├─ 是 → 需要 route/ + view/htm/ + hook/index_route_case_end.php
└─ 否 → 仅通过hook注入UI
需要用户配置？
├─ 是 → 需要 setting.php + setting.htm
└─ 否 → 不需要
需要后台管理？
├─ 是 → 需要 admin_*.php + hook/admin_index_route_case_end.php
└─ 否 → 不需要
需要静态资源？
├─ 是 → 需要 static/ + static/index.htm
└─ 否 → 不需要
```
### 2.2 标准目录结构模板
```
{plugin_id}/
├── conf.json # 必须
├── icon.png # 推荐(64x64)
├── install.php # 需要建表时
├── unstall.php # 需要建表时
├── upgrade.php # 有版本升级需求时
├── setting.php # 需要设置页面时
├── setting.htm # 需要设置页面时
├── hook/ # 必须
│ └── (根据需求选择)
├── model/ # 需要自定义数据模型时
│ └── {plugin_id}.func.php
├── route/ # 需要独立页面时
│ └── {page_name}.php
├── view/ # 需要独立页面时
│ └── htm/
│ └── {page_name}.htm
└── static/ # 需要静态资源时
├── index.htm
└── (资源文件)
```
---
## 模块三：代码模板调用
### 3.1 conf.json 模板
```json
{
"name": "{插件中文名}",
"brief": "{一句话描述}",
"version": "1.0.0",
"bbs_version": "4.0",
"installed": 0,
"enable": 0,
"hooks_rank": {},
"overwrites_rank": {},
"dependencies": {}
}
```
**hooks_rank填充规则**:
- 默认不填（权重0）
- 需要优先执行时填负值（如积分扣除: `-10`）
- 需要延后执行时填正值（如VIP标记: `100`）
- 多插件竞争同一hook时明确设置
### 3.2 install.php 模板
```php
<?php
!defined('DEBUG') AND exit('Forbidden');
$tablepre = $db->tablepre;
// === 创建数据表 ===
$sql = "CREATE TABLE IF NOT EXISTS {$tablepre}{表名} (
`id` int(11) unsigned NOT NULL AUTO_INCREMENT,
`uid` int(11) unsigned NOT NULL default '0',
`tid` int(11) unsigned NOT NULL default '0',
`pid` int(11) unsigned NOT NULL default '0',
`create_date` int(10) unsigned NOT NULL default '0',
`create_ip` int(10) unsigned NOT NULL default '0',
PRIMARY KEY (id),
KEY (uid),
KEY (tid)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;";
db_exec($sql);
// === 给核心表添加字段（安全方式） ===
$col_exists = db_find_one("SHOW COLUMNS FROM {$tablepre}post LIKE '{字段名}'");
if (empty($col_exists)) {
db_exec("ALTER TABLE {$tablepre}post ADD COLUMN {字段名} int(11) DEFAULT '0';");
}
// === 初始化配置 ===
setting_set('{plugin_id}', array(
'{option_key}' => '{default_value}',
));
```
### 3.3 unstall.php 模板
```php
<?php
!defined('DEBUG') AND exit('Forbidden');
$tablepre = $db->tablepre;
// 删除数据表
db_exec("DROP TABLE IF EXISTS {$tablepre}{表名};");
// 删除添加的字段
$col_exists = db_find_one("SHOW COLUMNS FROM {$tablepre}post LIKE '{字段名}'");
if (!empty($col_exists)) {
db_exec("ALTER TABLE {$tablepre}post DROP COLUMN {字段名};");
}
// 清理配置和缓存
setting_delete('{plugin_id}');
cache_delete('{plugin_id}_cache');
```
### 3.4 Model文件模板
```php
<?php
!defined('DEBUG') AND exit('Forbidden');
// === 原始CRUD（双下划线，仅操作单表） ===
function {table}__create($arr) {
return db_create('{table}', $arr);
}
function {table}__update($id, $arr) {
return db_update('{table}', array('id'=>$id), $arr);
}
function {table}__read($id) {
return db_find_one('{table}', array('id'=>$id));
}
function {table}__delete($id) {
return db_delete('{table}', array('id'=>$id));
}
function {table}__find($cond = array(), $orderby = array(), $page = 1, $pagesize = 20) {
return db_find('{table}', $cond, $orderby, $page, $pagesize);
}
function {table}__count($cond = array()) {
return db_count('{table}', $cond);
}
// === 关联CRUD（含缓存清理和数据格式化） ===
function {table}_create($arr) {
$r = {table}__create($arr);
cache_delete('{table}_list');
return $r;
}
function {table}_read($id) {
$data = {table}__read($id);
if ($data) {table}_format($data);
return $data;
}
function {table}_read_cache($id) {
$key = '{table}_' . $id;
$data = cache_get($key);
if ($data === NULL) {
$data = {table}_read($id);
cache_set($key, $data, 3600);
}
return $data;
}
function {table}_update($id, $arr) {
$r = {table}__update($id, $arr);
cache_delete('{table}_' . $id);
cache_delete('{table}_list');
return $r;
}
function {table}_delete($id) {
$r = {table}__delete($id);
cache_delete('{table}_' . $id);
cache_delete('{table}_list');
return $r;
}
function {table}_find($cond = array(), $orderby = array('id'=>-1), $page = 1, $pagesize = 20) {
$datalist = {table}__find($cond, $orderby, $page, $pagesize);
if ($datalist) foreach ($datalist as &$data) {
{table}_format($data);
}
return $datalist;
}
function {table}_format(&$data) {
if (empty($data)) return;
$data['create_date_fmt'] = date('Y-m-d H:i', $data['create_date']);
}
function {table}_count($cond = array()) {
return {table}__count($cond);
}
function {table}_maxid() {
return db_maxid('{table}');
}
```
### 3.5 Hook文件模板
**model_inc_file.php**（注册Model）:
```php
<?php exit;
APP_PATH.'plugin/{plugin_id}/model/{model_file}.func.php',
```
> **注意**: 末尾必须有逗号！
**index_route_case_end.php**（注册前台路由）:
```php
<?php exit;
case '{route_name}':
include _include(APP_PATH.'plugin/{plugin_id}/route/{route_file}.php');
break;
```
**my_end.php**（注册个人中心路由）:
```php
<?php exit;
elseif ($action == '{action_name}') {
if ($method == 'GET') {
// 读取数据
include _include(APP_PATH.'plugin/{plugin_id}/view/htm/{page}.htm');
} elseif ($method == 'POST') {
// 处理提交
message(0, '操作成功');
}
}
```
**HTM Hook文件**（注入UI）:
```html
<!-- 无PHP保护头，直接写HTML/PHP片段 -->
<div class="card mt-3">
<div class="card-body">
<?php echo $data; ?>
</div>
</div>
```
**JS Hook文件**（注入交互）:
```html
<script>
$(function() {
// 交互逻辑
});
</script>
```
**model_xxx_delete_start.php**（级联删除）:
```php
<?php exit;
db_delete('{table}', array('tid'=>$tid));
```
### 3.6 路由文件模板
```php
<?php
!defined('DEBUG') AND exit('Forbidden');
$action = param(1);
$page = param(2, 1);
$pagesize = 20;
if ($action == 'list') {
$datalist = {table}_find(array(), array('id'=>-1), $page, $pagesize);
$total = {table}_count();
$pagination = pagination(url('{route}-list-{page}'), $total, $page, $pagesize);
include _include(APP_PATH.'plugin/{plugin_id}/view/htm/{page}_list.htm');
} elseif ($action == 'create') {
user_login_check();
if ($method == 'GET') {
include _include(APP_PATH.'plugin/{plugin_id}/view/htm/{page}_create.htm');
} elseif ($method == 'POST') {
$field = param('field');
if (empty($field)) message(-1, '字段不能为空');
{table}_create(array(
'uid' => $uid,
'field' => $field,
'create_date' => time(),
'create_ip' => ip2long($ip),
));
message(0, '创建成功');
}
} elseif ($action == 'delete') {
user_login_check();
$id = param(2, 0);
{table}_delete($id);
message(0, '删除成功');
} else {
include _include(APP_PATH.'plugin/{plugin_id}/view/htm/{page}.htm');
}
```
### 3.7 视图文件模板
**标准页面**:
```php
<?php include _include(APP_PATH.'view/htm/header.inc.htm'); ?>
<div class="row">
<div class="col-lg-8">
<div class="card">
<div class="card-header">{页面标题}</div>
<div class="card-body">
<?php foreach ($datalist as $item): ?>
<div class="media mb-3">
<div class="media-body">
<h5><a href="<?php echo url('xxx-'.$item['id']); ?>"><?php echo $item['title']; ?></a></h5>
<small class="text-muted"><?php echo $item['create_date_fmt']; ?></small>
</div>
</div>
<?php endforeach; ?>
</div>
</div>
<?php echo $pagination; ?>
</div>
<div class="col-lg-4">
<?php include _include(APP_PATH.'view/htm/my_sidebar.inc.htm'); ?>
</div>
</div>
<?php include _include(APP_PATH.'view/htm/footer.inc.htm'); ?>
```
**设置页面**:
```php
<?php include _include(APP_PATH.'view/htm/header.inc.htm'); ?>
<div class="row">
<div class="col-lg-6 offset-lg-3">
<div class="card">
<div class="card-header">{插件名} 设置</div>
<div class="card-body">
<form action="<?php echo url('setting-{plugin_id}'); ?>" method="post">
<input type="hidden" name="form_hash" value="<?php echo $form_hash; ?>" />
<div class="form-group mb-3">
<label>{选项标签}</label>
<input type="text" class="form-control" name="{option_key}" value="<?php echo $config['{option_key}']; ?>" />
</div>
<button type="submit" class="btn btn-primary">保存</button>
</form>
</div>
</div>
</div>
</div>
<?php include _include(APP_PATH.'view/htm/footer.inc.htm'); ?>
```
### 3.8 setting.php 模板
```php
<?php
!defined('DEBUG') AND exit('Access Denied.');
$action = param(3);
if (empty($action)) {
if ($method == 'GET') {
$config = setting_get('{plugin_id}');
empty($config) AND $config = array(
'{option_key}' => '{default_value}',
);
include _include(APP_PATH.'plugin/{plugin_id}/setting.htm');
} elseif ($method == 'POST') {
$config = setting_get('{plugin_id}');
$config['{option_key}'] = param('{option_key}');
setting_set('{plugin_id}', $config);
message(0, '设置成功');
}
}
```
---
## 模块四：功能实现指引
### 4.1 常见功能实现模式
#### 点赞/收藏/关注模式
```
数据: 独立表(uid+pid/tid, UNIQUE KEY防重复) + 核心表字段(count缓存)
操作: toggle(存在则删除+count-1，不存在则创建+count+1)
UI: 按钮+数字，AJAX交互
Hook: thread_plugin_body.htm(按钮) + thread_js.htm(JS) + model_post_delete_start.php(级联删除)
```
#### 签到/打卡模式
```
数据: 独立表(uid+日期, UNIQUE KEY防重复) + setting(奖励配置)
操作: 每日一次，检查今日是否已签到，计算连续签到/首签奖励
UI: 首页面板 + 个人中心记录
Hook: index_site_brief_after.htm(面板) + my_end.php(个人中心) + index_js.htm(JS)
依赖: 常依赖积分插件(tt_credits)
```
#### 积分/虚拟货币模式
```
数据: ALTER TABLE user ADD COLUMN(积分字段) + setting(规则配置) + 独立表(交易记录)
操作: 各场景hook中扣除/奖励积分，增量更新(user_update array('credits+'=>1))
Hook: model_thread_create_end.php(发帖奖励) + model_post_create_end.php(回帖奖励) + model_xxx_delete_start.php(删帖扣除)
权限: forum_access_user()检查 + 自定义权限检查
```
#### 标签/分类模式
```
数据: 标签表 + 关联表(tagid+tid) + ALTER TABLE thread ADD COLUMN tagids(缓存)
操作: 发帖时选择标签(写入关联表+缓存tagids)，查询时按标签筛选
Hook: model_thread_format_end.php(格式化时加载标签) + post_js.htm(发帖表单) + thread_subject_end.htm(显示标签)
```
#### 编辑器增强模式
```
数据: 无需建表，纯前端替换
操作: 通过hook注入编辑器JS，替换默认textarea
Hook: post_js.htm(注入编辑器) + index_route_case_end.php(图片上传路由)
```
#### 排行榜/统计面板模式
```
数据: 读取现有数据 + cache缓存结果
操作: 定期从核心表聚合数据，缓存到cache
UI: 首页面板或独立页面
Hook: index_site_brief_after.htm(面板) + index_js.htm(异步加载)
```
### 4.2 数据库设计规范
| 字段类型 | 推荐定义 | 说明 |
|---------|---------|------|
| 主键 | `id int(11) unsigned NOT NULL AUTO_INCREMENT` | 自增主键 |
| 用户ID | `uid int(11) unsigned NOT NULL default '0'` | 关联bbs_user |
| 主题ID | `tid int(11) unsigned NOT NULL default '0'` | 关联bbs_thread |
| 帖子ID | `pid int(11) unsigned NOT NULL default '0'` | 关联bbs_post |
| 版块ID | `fid int(6) NOT NULL default '0'` | 关联bbs_forum |
| 时间戳 | `create_date int(10) unsigned NOT NULL default '0'` | Unix时间戳 |
| IP地址 | `create_ip int(10) unsigned NOT NULL default '0'` | ip2long()转换 |
| 文本 | `message longtext NOT NULL` | 长文本 |
| 短文本 | `title varchar(255) DEFAULT ''` | 短文本 |
| 整数 | `count int(11) DEFAULT '0'` | 计数类 |
| 开关 | `status tinyint(1) DEFAULT '0'` | 0/1开关 |
### 4.3 安全检查清单
生成代码时必须确保：
- [ ] 所有用户输入通过 `param()` 获取
- [ ] 表单包含 `form_hash` CSRF防护
- [ ] 需要登录的操作调用 `user_login_check()`
- [ ] 需要权限的操作检查 `$gid`
- [ ] PHP Hook文件以 `<?php exit;` 开头
- [ ] 非Hook PHP文件以 `!defined('DEBUG') AND exit('Forbidden');` 开头
- [ ] ALTER TABLE前检查字段是否已存在
- [ ] 数据库操作使用db_*封装函数
- [ ] 输出到JS的PHP变量使用 `json_encode()`
- [ ] 静态资源路径使用 `./` 相对路径
- [ ] URL使用 `url()` 函数生成
---
## 模块五：代码生成执行流程
当用户提出插件需求时，AI按以下步骤执行：
### Step 1: 需求分析
1. 解析用户需求，归类功能类型
2. 确定插件ID、功能列表、数据需求
3. 选择所需Hook点
4. 如有不确定项，向用户确认
### Step 2: 结构规划
1. 确定目录结构（哪些文件需要创建）
2. 设计数据库表结构
3. 确定Hook点映射
4. 规划设置项
### Step 3: 代码生成（按顺序）
1. **conf.json** — 插件配置
2. **install.php** — 安装脚本（建表+初始化配置）
3. **unstall.php** — 卸载脚本（删表+清理配置）
4. **model/*.func.php** — 数据模型（CRUD函数）
5. **hook/model_inc_file.php** — 注册Model
6. **hook/index_route_case_end.php** — 注册路由
7. **hook/my_end.php** — 个人中心路由
8. **route/*.php** — 路由处理文件
9. **view/htm/*.htm** — 视图模板
10. **hook/*.htm** — UI注入Hook文件
11. **hook/*.php** — 逻辑注入Hook文件
12. **setting.php + setting.htm** — 设置页面
13. **admin_*.php** — 后台管理（如需要）
### Step 4: 校验输出
1. 检查所有文件的安全规范
2. 检查Hook文件名与Hook点匹配
3. 检查model_inc_file.php末尾逗号
4. 检查PHP保护头
5. 检查form_hash
6. 检查数据库操作安全性
### Step 5: 输出说明
1. 列出所有创建的文件
2. 说明每个文件的作用
3. 说明使用的Hook点
4. 提供安装步骤
5. 提示可能需要注意的坑
---
## 附录A：核心Model API速查
### thread.func.php
```
thread_create($arr, &$pid) / thread_read($tid) / thread_read_cache($tid)
thread_update($tid, $arr) / thread_delete($tid)
thread_find($cond, $orderby, $page, $pagesize)
thread_find_by_fid($fid, $page, $pagesize, $order)
thread_find_by_fids($fids, $page, $pagesize, $order)
thread_inc_views($tid, $n=1) / thread_count($cond)
thread_format(&$thread) / thread_safe_info($thread)
thread_list_access_filter(&$threadlist, $gid)
```
### post.func.php
```
post_create($arr, $fid, $gid) / post_read($pid) / post_read_cache($pid)
post_update($pid, $arr, $tid=0) / post_delete($pid)
post_find($cond, $orderby, $page, $pagesize)
post_find_by_tid($tid, $page, $pagesize)
post_count($cond) / post_maxid()
post_format(&$post) / post_safe_info($post)
post_brief($s, $len=100)
```
### user.func.php
```
user_create($arr) / user_read($uid) / user_read_cache($uid)
user_update($uid, $arr) / user_delete($uid)
user_read_by_email($email) / user_read_by_username($username)
user_find($cond, $orderby, $page, $pagesize)
user_count($cond) / user_format(&$user) / user_safe_info($user)
user_login_check() / user_token_get() / user_token_set($uid)
user_find_by_uids($uids)
```
### forum.func.php
```
forum_create($arr) / forum_read($fid) / forum_update($fid, $arr) / forum_delete($fid)
forum_find($cond, $orderby, $page, $pagesize)
forum_list_cache() / forum_list_cache_delete()
forum_list_access_filter($forumlist, $gid, $allow='allowread')
forum_access_user($fid, $gid, $access) / forum_access_mod($fid, $gid, $access)
forum_is_mod($fid, $gid, $uid)
```
### group.func.php
```
group_read($gid) / group_list_cache() / group_name($gid)
```
### kv.func.php
```
kv_get($k) / kv_set($k, $v) / kv_delete($k)
kv_cache_get($k) / kv_cache_set($k, $v) / kv_cache_delete($k)
setting_get($k) / setting_set($k, $v) / setting_delete($k)
```
### cache.func.php
```
cache_get($k) / cache_set($k, $v, $life) / cache_delete($k) / cache_truncate()
```
### runtime.func.php
```
runtime_get($k) / runtime_set($k, $v) // 支持 'key+' 增量操作
```
## 附录B：常用全局变量
| 变量 | 类型 | 说明 |
|------|------|------|
| `$uid` | int | 当前用户ID（0=未登录） |
| `$user` | array | 当前用户数据 |
| `$gid` | int | 当前用户组ID |
| `$conf` | array | 系统配置 |
| `$method` | string | 请求方法（GET/POST） |
| `$ip` | string | 客户端IP |
| `$time` | int | 当前时间戳 |
| `$plugins` | array | 所有插件信息 |
| `$db` | object | 数据库实例 |
| `$tablepre` | string | 表前缀（在install/unstall中用`$db->tablepre`获取） |
| `$form_hash` | string | CSRF令牌 |
| `$header['title']` | string | 页面标题 |
## 附录C：常见错误与修复
| 错误现象 | 可能原因 | 修复方法 |
|---------|---------|---------|
| 白屏/500错误 | hook文件PHP语法错误 | 检查tmp/编译文件，修复语法 |
| hook不生效 | DEBUG不是2 / 文件名不匹配 | 设DEBUG=2，核对hook文件名 |
| 安装报错 | ALTER TABLE字段已存在 | 添加字段前先检查 |
| 数据不更新 | 缓存未清理 | 更新后cache_delete() |
| AJAX返回HTML | 请求未带正确头 | 使用$.xpost() |
| URL 404 | 路由未注册 | 检查index_route_case_end.php |
| 权限不足 | 未检查gid | 添加权限检查代码 |
| 重复提交 | 缺少form_hash | 表单添加CSRF令牌 |
]]>