开发者工具
插件包自检
和「提交审核」用的是同一套规则(插件 API 1.2.0, 36 个钩子 / 32 个函数 / 21 条规则)。 自检通过,提交就不会再因为包本身的问题被拒。
包内应当是一个以插件标识命名的目录:my_plugin/plugin.json、my_plugin/plugin.php……
自检不会保存你的包,也不会入库。
自检结果(按严重级别分组)
上传 zip 后,这里会按 error / warning / info 分组列出结果:error 是阻断项,必须修好才能提交。
阻断项(error)(0)
无
警告(warning)(0)
无
提示(info)(0)
无
能力清单核对
对照 plugin.json 的 capabilities 逐项核对:只声明真正用到的能力,
风险等级与用途说明会展示在插件详情页。
🗄️ 自建数据表 低风险
db用 pluginCreateTable() / pluginTableName() 建表读写。表名固定带 plugin_<slug>_ 前缀,不会碰核心表。
📁 文件与静态资源 中等风险
files用 pluginUploadDir() 存上传文件、用 pluginAssetUrl() 暴露自己的 assets/ 目录(只读白名单)。
注意:可读写插件目录与上传文件
🌐 外部网络请求 中等风险
http用 pluginHttp() 请求站外接口(有超时与体积上限)。自己写 curl 也能跑,但自检会提示且不受平台超时/体积保护。
注意:会把数据发往站外
✉️ 发送邮件 高风险
mail调用 sendEmailTracked() 走站点已配置的发件通道(会记入发件台账、失败自动入队重试)。
注意:可消耗站点发件额度(可能触发服务商限流)
⚙️ 后台页面 低风险
admin_uiregisterAdminPage() 在后台「插件」分组下加一个管理页;不声明会被平台拒绝注册。
🎨 前台页面与钩子注入 低风险
front_uiregisterFrontView() 提供前台页面,addShortcode() 提供短代码,或用 plugin_render_* 过滤器往页面注入 HTML(含个人中心/设置页槽位)。
声明了 db / http / mail 等能力时,请在插件描述里写明用途与数据范围;中等/高风险能力还需要在提交时填写「权限用途说明」。
自检规则速览(编号与核心的
plugin_lint 一致,详见
清单字段与自检规则):
MANIFEST_MISSING
MANIFEST_FIELD
SLUG_MISMATCH
VERSION_FORMAT
CAP_UNKNOWN
HOOK_UNKNOWN
ROUTE_INVALID
ROUTE_NO_DESC
ROUTE_NO_PARAMS
PHP_SYNTAX
FORBIDDEN_CALL
READ_ENV
TOUCH_CORE
CAP_MISSING
SETTING_UNDECLARED
ASSET_MISSING
ASSET_EXT
CALLBACK_ARGS
LIFECYCLE_MISSING
NO_PLUGIN_PHP
README_MISSING
有服务器权限的开发者建议在本地直接跑:
php backend/plugin_lint_cli.php backend/plugins/你的标识
—— 除了上面这些,还会检查 PHP 语法、设置项声明、生命周期函数与资源文件是否存在。