AmazingDraw 场景库（amazingdraw-scenes）

外部优质场景模版与社区收录库。提交的 JSON 会经过格式校验，便于日后被 AmazingDraw 引擎读取。

用途

• 沉淀可复用的场景条目（id / label / scene_theme / keywords 等）
• 为贡献者提供统一模板与 CI 校验
• Phase 2：引擎将通过配置路径读取本仓库的本地 clone（当前尚未接线）

目录

templates/scene.template.json   # 场景包模板（library + items）
scenes/                         # 正式收录（可含温和示例）
tools/validate_scenes.py        # 本地 / CI 校验
.github/workflows/validate.yml  # PR / push 自动校验

快速开始

git clone https://github.com/AmazingDraw/amazingdraw-scenes.git
cd amazingdraw-scenes
python tools/validate_scenes.py

通过后即可按 CONTRIBUTING.md 新增场景并开 PR。

维护步骤摘要见 docs/维护说明.md。

校验规则（v1）

• JSON 可解析
• 包形式 {library, items:[...]}：library 为非空字符串；每条 item 需要 id、label；建议有 scene_theme 或 keywords；id 在文件内与仓库内唯一
• 单条 item：同样需要 id、label
• 拒绝空 id/label；拒绝重复 id
• 文件名含 template 的文件不参与 scenes/ 校验

引擎接入（Phase 2）

本仓库不会在 Phase 1 自动被引擎拉取。计划中引擎将支持配置本地 clone 路径，例如：

scene_libraries += <path-to-amazingdraw-scenes>/scenes/*.json

届时请在 AmazingDraw 主项目文档中查看具体配置项。

License

MIT