第一步：确认插件基础结构是否合规

在项目根目录下的`addons/`目录中新建一个文件夹，名称必须是**全英文小写字母与下划线，且首字母必须小写**。比如，`hello_world`是标准答案，`HelloWorld`或`hello-world`则直接导致系统无法识别。进入`hello_world`目录后，再新建一个PHP文件，**文件名必须与目录名完全一致**，即`hello_world.php`。别自作聪明改成`index.php`、`main.php`或`HelloWorld.php`，系统只认死规矩。打开`hello_world.php`，写入标准入口代码。这里有两个关键点：**命名空间**必须正确设置——TP6+为`addons\hello_world`，TP5为`app\common\controller\Addons`；**类名**首字母大写（如`HelloWorld`），并继承对应基类。切记，**命名空间前缀`addons`绝不能少**，少了系统扫描插件时直接跳过你，连个招呼都不打。

第二步：AI生成的$info数组必须带齐五要素

AI自动生成的`$info`数组就像是插件的身份证，必须信息完整、格式规范。别指望它能自己补齐，它常常遗漏关键字段，或者在键名两边带上多余的空格和双引号。**方法一**：让AI严格按照下面这个格式输出，一个都不能少：* `'name' => 'hello_world',` // 纯小写+下划线，与目录名一致最稳妥 * `'title' => 'Hello World 示例插件',` // 后台显示的名称，可以写中文 * `'identifier' => 'hello_world.lwwan.plugin',` // 全局唯一标识，重复会导致安装失败 * `'version' => '1.0.0',` // **三段式版本号，缺了它，插件根本不会出现在后台列表里**，这是致命伤 * `'author' => 'lwwan',` // 作者名，不能是空字符串 **方法二**：如果AI生成的数组键顺序混乱，或者键名用了双引号（比如`"version"`），你得手动将其整理成**单引号键名且无多余空格**的标准格式。ThinkPHP的解析器非常挑剔，格式不对直接报错。

第三步：install()方法必须返回true且runtime可写

在`HelloWorld`类中定义`install()`方法，内容只有一行：`return true;`。返回字符串、空数组、`null`，或者干脆没写`return`，都会导致你点击安装按钮后页面毫无反应，像死链接一样。另一个常见问题是`runtime/`目录权限。Linux下，执行`chmod -R 775 runtime`，确保Web进程用户（通常是`www-data`）有写权限；Windows下，则要确认IIS或Apache的服务账户对该目录有修改权限。权限不对，后端所有操作都寸步难行。最后，别忘了清空缓存：执行`php think clear`，或者手动删除`runtime/cache/`下的所有文件。旧的缓存会像一层屏障，屏蔽新插件的扫描结果，让你白白浪费时间排查。

第四步：验证插件是否被系统识别

走完前三步，我们来做快速检测。① 打开浏览器，访问后台的插件管理页（通常是`/admin/addons/index`），刷新页面，看列表里有没有出现“Hello World 示例插件”。② 如果没出现，打开命令行，执行`php think addons:list`，看输出中是否有`hello_world`这个条目。没有，说明插件压根没被系统加载。③ 如果`list`里有，但后台不显示，那很可能是`config/app.php`里的插件开关没打开：TP6是`'addon' => true`，TP5是`'addons' => ['status' => true]`。④ 如果插件出现了，点击“安装”，观察页面是否能正常跳转回列表页并显示“已启用”状态。如果卡在loading或提示“安装失败”，别慌，立刻去查`runtime/log/`下的最新日志。那里通常会暴露具体是哪一行代码出了问题，是调试的黄金线索。