包规范与开发约定

包结构

zip 根目录即包内容，不要再套一层目录；根目录必须包含 manifest.json，它是市场识别包的唯一入口。

包名（manifest.name）以小写字母开头，后跟小写字母、数字、下划线或连字符，长度 2-50 位。它同时是安装目录名，上架后不可更改。

插件发布为 addon 类型，主题发布为 template 类型；同名包在两种类型下互不冲突，但归属校验分别进行。

manifest 必填字段

name / title / version / description：包标识、展示名称、语义化版本号（如 1.2.0）、功能说明。

author / author_url：作者署名与主页；cms_version：适配的核心版本要求。

pricing：定价声明。免费包也必须显式声明，不允许留空 —— 缺省会被按最严格的规则处理。

版本号约定

使用语义化版本：主版本号.次版本号.修订号，市场端按语义化比较，「1.10.0」高于「1.9.0」。

同一版本号重复上传会覆盖该版本的产物与签名，不会产生两条版本记录。

线上版本在审核期间不会被顶掉：待审版本不可下载，「最新版本」只统计已生效版本。