清单配置 (scenario.json)

scenario.json 是场景的清单配置文件，位于项目根目录。它定义了场景的元数据、身份、能力、UI 和权限。

完整字段参考

基础元数据

字段	类型	必填	说明
id	string	是	场景唯一标识，小写字母+数字+连字符，如 my-scenario
version	string	是	语义化版本号，如 1.0.0
name	string	是	英文名称
nameZh	string	是	中文名称
description	string	否	英文描述
descriptionZh	string	否	中文描述
author	string	否	作者名称
icon	string	否	图标名称（lucide-react 图标名）
category	string	否	分类（见下方分类表）
tags	string[]	否	标签列表
license	string	否	开源协议，如 MIT
type	string	是	场景类型：declarative 或 programmatic

版本与兼容性

字段	类型	必填	说明
minAppVersion	string	否	最低客户端版本要求，如 1.2.0
dependencies	array	否	场景间依赖列表

发布信息

字段	类型	必填	说明
entryPoint	string	编程式必填	入口文件路径，如 src/index.ts
permissions	string[]	否	所需权限列表
sharedDeps	object	编程式	共享依赖声明

分类 (category)

值	说明
productivity	生产力
development	开发工具
education	教育
business	商业
creative	创意
data	数据
health	健康
finance	金融
legal	法律
custom	自定义

依赖声明

场景可以依赖其他场景：

{
  "dependencies": [
    {
      "scenarioId": "document-parser",
      "version": ">=1.0.0"
    },
    {
      "scenarioId": "code-formatter",
      "version": "^2.0.0"
    }
  ]
}

版本号支持 semver 范围语法：

• >=1.0.0 - 大于等于 1.0.0
• ^2.0.0 - 兼容 2.x.x
• ~1.2.0 - 约等于 1.2.x
• 1.0.0 - 精确匹配

编程式场景额外配置

{
  "type": "programmatic",
  "entryPoint": "src/index.ts",
  "sharedDeps": {
    "react": "^18.3.0",
    "react-dom": "^18.3.0",
    "zustand": "^5.0.0",
    "lucide-react": "^0.562.0"
  }
}

声明式场景额外配置

声明式场景的配置分布在 identity、capabilities、ui、database、scripts 等子对象中，详见 声明式场景。