标准插件的结构与版本发布

标准包结构

以演示插件为例，ZIP 顶层保留插件目录，不能把内部文件直接放在压缩包根目录。

demo/
  plugin.json
  Plugin.php
  migrations/
  controller/
  view/

元数据与依赖

plugin.json 是标准包的元数据来源。format 为 1，dir 应与目录一致；version 使用版本号，requires 声明 PHP、CMS 与扩展要求，dependencies 声明插件依赖。后台菜单地址应属于插件自身目录。

数据库迁移

标准插件通过 migrations 维护结构变化。新版本新增迁移，已经发布的迁移文件保持原样。迁移需考虑重复执行；MySQL 的结构变更可能已经提交，不能假定文件恢复等于数据库回滚。

代码权限

标准包扫描和依赖检查不会执行包内 PHP，但安装及运行的插件代码与 CMS 共享进程和数据库权限。permissions 是权限说明，当前并不提供 PHP 沙箱。仅部署经过审查且来源可信的插件。

发布前验证

1. 在独立测试站验证新安装、启用、停用与配置保存。
2. 测试从已发布版本升级，确认迁移与启用状态符合预期。
3. 分别验证保留数据和清除数据的卸载方式。
4. 提高版本号，保留历史迁移，打包完整插件目录。
5. 通过发布工具校验兼容性与包信息后再发布。

已发布的同一版本不能覆盖，不应通过改回旧版本号绕过检查。官网发布管理属于发布站功能，不随普通客户安装包分发。