manifest.json

清单是插件的唯一元数据来源。基座扫描 plugin/*/manifest.json 完成识别、安装、升级与入口编排。

完整示例

{
  "name": "am_demo",
  "title": "插件示例",
  "version": "1.0.0",
  "support_version": "1.0.1",
  "icon": "/app/am_demo/logo.png",
  "description": "",
  "author": "",
  "type": 1,
  "dependencies": [],
  "is_dev": 1,
  "open_mode": "micro",
  "path": "plugin/am_demo",
  "entry": "/app/am_demo",
  "manage_entry": "/app/am_demo/manage",
  "view_root": "view",
  "is_custom": true,
  "is_core": 0,
  "source": 1,
  "scope": 1,
  "platform": 1,
  "frontend_routes": [],
  "composer": { "require": {} },
  "hook": "plugin\\am_demo\\Plugin"
}

字段说明

字段	含义
name	插件唯一标识，须以 am_ 开头
title	显示名
version	插件版本，用于安装/升级比对
support_version	要求的最低基座版本，基座当前版本低于它则不兼容
icon	图标地址（相对路径会自动补域名）
type	插件类型，默认 1
dependencies	依赖的其它插件标识列表
open_mode	打开方式：micro（qiankun 微应用，默认）或 iframe
path	插件目录，默认 plugin/{name}
entry	前台公开入口路径，默认 /app/{name}
manage_entry	管理入口路径，默认 /app/{name}/manage
hook	生命周期类的全限定类名
composer	插件自有 Composer 依赖声明
view_root / frontend_routes	视图根与前端路由声明（存于 JSON）

入口与"纯插件"

entry / manage_entry 只有在键不存在时才会补默认值；显式写成空串 "" 表示"无该入口"。两者都为空的插件被识别为纯插件（只提供服务/接口、无页面），前端据此隐藏"打开"按钮。

兼容性判定

安装/升级时基座用 versionGte(当前基座版本, support_version) 判断兼容性：support_version 为空视为兼容，否则要求基座版本不低于它。