开发 Monitor 应用
Monitor 应用是位于 store/apps/<publisher>.<name>/ 下的 Docker Compose 包。Monitor 会读取其中的
manifest.toml 和 Compose 文件,并在桌面中以窗口显示已安装的应用。
创建或修改应用时,请先阅读
serverbox-webapp skill。
其中的manifest 参考
介绍了各个字段。供编辑器使用的 schema 位于
docs/schemas/monitor-app.schema.json。
skill 中的 scripts/validate.py 还会检查 schema 无法表达的规则,并可执行 Compose 校验。
要在开发 Monitor 上试用应用,请将应用包放入某个目录,并在该 Monitor 的 config.toml 中将
[stacks] local_apps 指向包含 <publisher>.<name>/ 文件夹的目录。例如:
[stacks]local_apps = "/srv/sbm-apps"修改本地应用包后,请重启 Monitor。App Store 会读取本地目录条目,因此可以安装并测试部署流程,
无需先将应用加入随 Monitor 附带的目录。若要校验 store/apps/example.web,请在仓库根目录运行:
python3 .claude/skills/serverbox-webapp/scripts/validate.py store/apps/example.web --compose