跳转到内容

开发 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