Gin-Vue-Admin v3.0 更新内容

AI 能力全面升级

API 一键生成 CLI

支持将 GVA API 一键生成 CLI 工具，可直接接入任意 AI Agent（Claude Code、Codex、Cursor、OpenAI Agent 等）。

新增能力：

• API 一键生成 CLI
• CLI 命令预览
• CLI 下载
• AI Skill 下载
• 自动生成 README.md
• 自动生成 SKILL.md
• 自动打包可执行文件
• API 场景管理
• 本地配置后台 API 地址
• CLI 插件化

MCP 能力增强

新增：

• MCP Tool 管理
• MCP API 管理
• MCP 编排能力
• 页面绘制支持流式输出
• AI 场景管理
• AI 能力独立分组管理

同时：

• 移除旧 AI Workflow
• 优化 AI 页面
• 优化 AI 使用流程

全新主题系统

v3.0 全面重构主题系统，提供更加灵活且统一的主题能力。

支持：

• 自定义主题色
• 自定义语义色
• 全局圆角
• 卡片模式
• 菜单风格
• 标签栏模式
• 顶栏样式
• 顶栏阴影
• 独立深色菜单
• 通栏侧边布局
• 标签栏图标控制
• 面包屑图标控制
• Header 工具栏配置

主题预设

新增：

• 官方主题预设
• 自定义主题预设
• 导入预设
• 导出预设
• 整包配置保存
• 配置版本兼容

内置：

• GVA Classic
• Fresh Blue
• 更多官方主题

全新 Theme Engine

主题系统全面模块化重构。

包括：

• Theme Store
• Theme Adapter
• Runtime Theme
• UnoCSS Theme
• Element Plus Theme Adapter
• Bootstrap 首屏主题注入
• Prism 自动生成语义色板
• Token 化颜色体系

实现一套主题驱动整个后台 UI。

全新基础组件库

基于 reka-ui 构建 GVA 基础组件库。

新增组件：

• Button
• Select
• Switch
• Slider
• NumberField
• ColorPicker
• DropdownMenu
• IconButton
• Menu

所有组件均支持：

• 主题切换
• 暗黑模式
• 语义 Token
• 全局 g-* 注册

全新后台布局

新增：

• 通栏侧边布局
• 三档响应式断点
• 移动端 Drawer 菜单
• 全新标签栏组件
• Chrome 风格标签
• Slider 标签模式
• Button 标签模式

重构：

• Header
• Sidebar
• Layout
• Tab
• Drawer

整体布局与交互更加现代化。

UI 与交互优化

整体界面进行了大量优化。

包括：

• 首页重新设计
• 登录页优化
• 顶栏工具栏重构
• 用户菜单交互优化
• 标签栏优化
• 卡片样式统一
• Dashboard 优化
• 消息弹窗优化
• 页面间距优化
• Hover 效果统一
• SVG 图标体系升级
• 新增 404 页面

安全中心

新增完整安全配置模块。

登录安全

支持：

• 登录失败锁定
• 登录防暴力破解
• 登录限流
• IP 限流
• 验证码策略

密码安全

支持：

• 密码复杂度校验
• 密码过期策略
• 首次登录修改密码
• 强制修改密码
• PasswordUpdatedAt 记录

后台管理

新增：

• 安全配置页面
• 安全配置 API
• 默认安全配置初始化
• 权限菜单

并补充：

• 集成测试
• Swagger 文档

全新缓存体系

新增统一缓存抽象 GVA_CACHE。

支持：

• Memory
• Redis

完成以下能力迁移：

• JWT 黑名单
• 登录失败计数
• 验证码存储
• 登录限流
• IP 限流

移除：

• BlackCache

链路追踪与日志能力

新增完整链路追踪能力。

支持：

• Trace ID
• Span ID
• Request ID
• Device ID
• W3C Trace Context
• HTTP Trace Header 自动传播

日志能力增强：

• Zap 配置增强
• Access Log
• 请求日志
• 响应日志
• Context 日志

SSE 实时消息

新增统一 SSE Hub。

支持：

• SSE 连接管理
• 实时事件推送
• 多客户端订阅
• 完整测试覆盖

权限与组织能力

新增：

• 部门岗位数据权限
• 系统工具菜单
• MCP API 菜单
• 定时任务管理
• 个人信息页面
• 所属架构字段

优化：

• 菜单结构
• 菜单排序
• 关于我们
• 组织管理

AutoCode

重构 AutoCode 模块。

包括：

• AutoCode 独立模块
• Repeat 支持 Context
• 模板读取优化
• Package 读取优化

文件与媒体

调整：

• 文件上传能力迁移至 Media
• 媒体库能力调整

Swagger 与开发文档

完善：

• Swagger 注释
• Router 注释
• Security 注释
• 返回类型生成
• API 文档生成

新增：

• AI 开发文档
• Component Library 规范
• Theme Token 文档
• 前后端协作规范
• 页面点触测试文档
• 后端测试规范

测试能力

新增：

• testutil 测试工具包
• Memory Database
• Memory Cache
• Nop Logger

统一测试初始化流程。

开发体验优化

新增：

• 版本日志
• Go 1.24 支持
• 本地 Workspace Ignore
• 浏览器自动化测试提示
• 页面点触测试
• 插件打包优化
• 插件初始化优化

稳定性优化

修复大量问题，包括：

• Theme 兼容性
• Theme Store
• Layout 层级
• Drawer 遮挡
• SVG 图标
• Captcha 存储
• Zap 配置
• 菜单 Hover
• Vertical 布局
• Select 显示异常
• 系统配置抽屉
• 标签栏事件泄漏
• Dashboard 暗黑模式
• Gin 查询绑定递归
• UnoCSS 样式统一
• 多项 UI 与交互细节优化

总结

Gin-Vue-Admin v3.0 是一次覆盖前端、后端、AI、主题、安全、基础设施等多个方向的重要版本更新。

本次版本重点包括：

• 全新 AI 能力体系，支持 API 一键生成 CLI、AI Skill、MCP 工具及场景编排
• 全新主题系统，支持高度自定义外观、主题预设与语义化设计
• 全新基础组件库与后台布局，整体 UI 与交互体验全面升级
• 完整安全中心，覆盖登录安全、密码策略、限流与安全配置
• 新增统一缓存抽象、链路追踪、SSE 实时消息等底层基础设施
• 文档、测试、开发规范进一步完善，为后续版本持续演进提供基础支撑