能力清单核对
插件的权限由 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 等能力时,请在插件描述里写明用途与数据范围;中等/高风险能力还需要在提交时填写「权限用途说明」。
自检结果怎么看
阻断项(error)
HOOK_UNKNOWN出现阻断项时不能提交,按规则号逐条修好再传。
警告(warning)
CAP_MISSING不拦提交,但建议改掉(例如用了能力却没声明)。
提示(info)
README_MISSING可选优化建议,看到就顺手补一下。
想先本地验证:把 zip 传到 插件包自检,规则与提交审核完全一致。