主题开发

theme.json 规范

更新于 2026-11-13 阅读 3 # theme.json 主题信息文件放在主题根目录，用于市场展示与安装校验。 ## 字段说明 | 字段 | 必填 | … Markdown

theme.json

主题信息文件放在主题根目录，用于市场展示与安装校验。

{
  "name": "Aurora 极光",
  "code": "aurora",
  "version": "1.3.0",
  "author": "盘云CMS 官方",
  "description": "暗色玻璃质感主题，适合产品官网",
  "type": "theme",
  "require": {
    "pycms": ">=1.0.0",
    "php": ">=8.0"
  },
  "screenshots": ["preview/home.png", "preview/list.png"]
}

字段说明

字段	必填	说明
`name`	是	主题显示名称
`code`	是	唯一标识，安装目录名
`version`	是	语义化版本，升级比对依据
`author`	是	作者或团队
`description`	否	市场详情简介
`require.pycms`	否	兼容的核心版本范围
`screenshots`	否	详情页截图，相对主题目录

校验规则

code 只允许小写字母、数字、下划线。
版本号建议 主.次.修订，补丁生成依赖版本对比。
包内路径不允许 ../，否则安装会被拒绝。