zerx-plugin

name

zerx-plugin

description

zerxLabKit 编译期插件机制:以低侵入方式新增后台管理模块(后端 RPC + 表 + 前端动态页 + 菜单 + 授权),不破坏单二进制 / CGO-free / Casbin 唯一授权 / proto 唯一契约。当用户要用插件方式扩展、用 task new-plugin 脚手架、新增/启用/禁用/卸载插件、或排查插件注册/校验/动态前端页问题时使用。Keywords: plugin, 插件, plugin system, 插件机制, task new-plugin, task plugin-pack, 脚手架, scaffold, 上传插件, 安装插件, 卸载插件, install plugin, uninstall plugin, upload, zip, InstallPlugin, UninstallPlugin, internal/plugin, installer, all.go, ValidateAll, RegisterHandlers, 动态路由, import.meta.glob, p.$, pub.$, plugin-components, 编译期插件, compile-time plugin, 插件注册, 插件禁用, 插件卸载, teardown, PLUGIN_UPLOAD_ENABLED

zerxLabKit 编译期插件机制

编译期静态插件(源码内置 + 重新构建):自带 RPC/表/迁移/菜单/授权声明/可选 job;显式 Register() 注册;启动期 ValidateAll 强校验;前端单一动态路由按 menu.component 加载页。有意不用 WASM/.so/go-plugin/init() 魔法(理由见设计裁决)。

加一个插件(脚手架,推荐)

task new-plugin -- <name> [field:type,...]   # 例: task new-plugin -- blog title:string,views:int(shop 已作为内置示例)
task gen                                       # 生成 proto Go/TS + connect-query hook
# 填 internal/plugin/impl/<name>/service.go 业务逻辑(脚手架已给 CRUD stub)
task build && 重启

• name 须匹配 ^[a-z][a-z0-9_]{0,30}$。字段类型:string|int|int32|bool|float;id/name 为内置字段,传入会被忽略(避免重复)。
• 生成器产出:proto/zerx/v1/<name>.proto、internal/plugin/impl/<name>/{plugin,model,service}.go、<name>_teardown.sql、web/src/plugin-components/<name>/<Pascal>.tsx,并在 internal/plugins/all.go 两处锚点插行(// plugin-import-anchor / // plugin-register-anchor)后 gofmt。

手动新增插件的核心改动 = 仅 all.go 两行

装配点(server.New / main.go)各只接一次钩子,之后永不再改。新增插件唯一核心改动是 internal/plugins/all.go:import 块加一行 + 体加一行。