Files
gin-vue-admin/aiDoc/examples/backend/plugin-go-example.md
T
15e6e7685c update:发布2.9.2版本 (#2211)
* feat: 调整AI工作模式,更符合harness基准

* feat: 添加BusinessDB字段到PluginInitializeGorm结构体,并增加相关测试用例

* [middleware/jwt.go]: fix #2192 issues bug

* docs: add auto plugin design spec

* chore: ignore worktrees directory

* feat: 调整代码辅助能力至插件

* feat: 添加警告条组件,提示授权用户访问限制

* fix: 修正商业用途版权声明链接

* feat: 调整agent.md 更加节省token

* fix: 修改casbin版本为v3

* feat: 更新JSONMap和JSONSlice类型,优化GORM数据类型处理

* feat: 添加数据库就绪通知机制,优化插件注册流程

* feat: 重构API路径和描述,优化代码生成器和模板配置分组

* feat: 优化 person 页面的 css 作用域限制

* feat: 更新 vite 至 vite8

* 新增:MCP工具为指定URL的角色ID授权

* fix: 增加文件名合法性检查,拒绝包含非法字符的文件写入

* chore: 更新CI配置,升级Node.js和Go版本,调整checkout和setup动作版本

* feat: 为数据库连接增加最大复用时间配置

* feat: 为各数据库连接配置增加最大连接生命周期设置

* feat: 更新插件注册逻辑并优化API和菜单组件的标签显示

* feat: 更新版本号至v2.9.2并添加新插件路径信息

---------

Co-authored-by: taincheng <zhangtc@gmail.com>
Co-authored-by: Azir-11 <2075125282@qq.com>
Co-authored-by: lanxi <1220lanxi@gmail.com>
2026-05-11 13:48:18 +08:00

62 lines
1.4 KiB
Markdown

# plugin.go 示例
## 这个文件负责什么
插件入口负责把插件注册进系统,并在系统启动时完成路由、菜单、字典、表结构等初始化。
## 什么时候应该这样写
- 新增一个标准 gin-vue-admin 插件
- 需要接入插件注册机制
- 需要把插件初始化逻辑收敛到统一入口
## 推荐写法示例
```go
package announcement
import (
"context"
"github.com/flipped-aurora/gin-vue-admin/server/plugin/announcement/initialize"
interfaces "github.com/flipped-aurora/gin-vue-admin/server/utils/plugin/v2"
"github.com/gin-gonic/gin"
)
var _ interfaces.Plugin = (*plugin)(nil)
var Plugin = new(plugin)
type plugin struct{}
func init() {
interfaces.Register(Plugin)
}
func (p *plugin) Register(group *gin.Engine) {
ctx := context.Background()
initialize.Api(ctx)
initialize.Menu(ctx)
initialize.Dictionary(ctx)
initialize.Gorm(ctx)
initialize.Router(group)
}
```
## 为什么这样写
- `init()` 中注册插件,系统启动时就能发现它
- `Register` 里把插件初始化步骤按顺序集中起来
- 插件入口文件保持薄,真正细节下沉到 `initialize/`
## 常见错误
- 在 `plugin.go` 里塞过多业务细节
- 忘记调用 `interfaces.Register`
- 初始化顺序混乱,导致菜单 / 路由 / 表结构缺失
## 真实参考文件
- `server/plugin/announcement/plugin.go`
- `server/plugin/announcement/initialize/router.go`