扩展开发

可信扩展放在 app/extensions/<extension-id>/,随 APay 在构建期打包。扩展不依赖当前主题,可以提供后台页、要求登录的用户页、后台 API 和用户 API。

路由固定为 /admin/plugins/<id>/**、/user/plugins/<id>/**、/api/admin/plugins/<id>/** 和 /api/plugins/<id>/**。后台页面与 API 共用 plugin:<id>:<capability>:view|edit 权限。扩展停用后,页面与 API 会同时不可访问。

修改扩展后运行 node scripts/generate-extension-build.mjs 和 node scripts/check-extension-system.mjs。当前不支持运行时上传 ZIP 或执行不可信第三方代码。

扩展私有迁移放在自身的 database/sqlite、database/postgresql 和 database/mysql 目录,并由 extension.json 声明;三种方言缺一不可。构建 registry 会固化 SQL statement 与 checksum,因此部署时不依赖运行时文件系统。

管理员必须先在“设置 → 扩展”执行待处理迁移,成功后才能启用。已经执行的迁移文件不可修改,后续变更只能追加更大的迁移 ID;私有表统一使用 ext_<extension_id>_ 前缀。停用扩展不会删除私有表或迁移记录,checksum 冲突会同时阻止迁移和启用。