跳到主要内容
万能墙开放平台
开发者工具

插件包自检

和「提交审核」用的是同一套规则(插件 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_ui
registerAdminPage() 在后台「插件」分组下加一个管理页;不声明会被平台拒绝注册。
🎨 前台页面与钩子注入 低风险 front_ui
registerFrontView() 提供前台页面,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 语法、设置项声明、生命周期函数与资源文件是否存在。