Files
gin-vue-admin/aiDoc/modules/plugin-development.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

902 B

插件开发约束

后端插件结构

后端插件推荐保持以下结构:

  • api/
  • config/
  • initialize/
  • model/
  • model/request/
  • router/
  • service/
  • plugin.go

前端插件结构

前端插件推荐保持以下结构:

  • api/
  • components/
  • view/
  • form/
  • config.js 或等价入口文件

插件入口约束

plugin.go 至少要承担以下职责:

  • 实现项目要求的插件接口
  • init() 中完成插件注册
  • 通过 Register 方法挂载路由
  • 通过 RouterPath 返回插件根路径

插件设计原则

  • 尽量自包含
  • 保持可配置
  • 预留扩展点
  • 与主系统保持一致的风格与约定

推荐开发流程

  1. 先明确插件边界与数据模型
  2. 先完成后端模型、服务、接口与初始化
  3. 再完成前端接口封装、页面与表单
  4. 最后完成菜单、权限、联调与测试