v1.3.0：锁屏、在线用户与系统监控、三档界面材质

新功能

• 锁屏：密码与 Passkey 解锁，闲置自动锁屏，跨标签页状态同步
• 在线用户：管理员查看全部在线会话，支持按设备或整用户强制下线
• 系统监控：主机 CPU/内存/磁盘/网络、Go 运行时、数据库连接池与缓存探测，10 分钟实时趋势与采样间隔
• 界面材质：纯色 / 毛玻璃 / 液态玻璃三档；液态玻璃在 Chromium 提供边缘折射，其他浏览器自动降级
• 页签与滚动：页签栏随滚动方向自动隐藏，内容可滚动到视口边缘

优化

• 移除不必要的 backdrop-filter，滚动时用静态霜面替代实时模糊，命令栏按需开启磨砂
• 404 页面重做，未知路径不再创建页签，提供当前账号可访问的快捷入口
• 背景光斑与 KPI 柔光改用径向渐变，减少大尺寸滤镜图层

升级说明

• 迁移 000016_online_monitor 启动时自动执行，注册在线用户/系统监控菜单与权限，无需手工操作
• 前端偏好升级到 v4：旧“液态玻璃”开关自动映射为液态材质，其余用户默认使用新的纯色材质
• 默认界面材质由毛玻璃调整为纯色，可在「偏好设置 → 界面材质」切回毛玻璃或液态玻璃
• 新增依赖 github.com/shirou/gopsutil/v4

完整变更：v1.2.0...v1.3.0

v1.2.0：异步导出框架与主题色板

新功能

• 异步 XLSX 导出框架：用户、操作日志、登录日志列表页一键按当前筛选提交导出任务，后台 worker 游标分批生成 xlsx；「导出记录」页轮询进度、取消、删除、下载；文件名模板可视化配置（模块/标题/时间/自定义文本片段，白名单时间格式）。设计与新模块接入指南见 docs/export.md。
• 主题色板系统：偏好设置弹层新增 6 套配色（珊瑚橙 / 海洋蓝 / 森野绿 / 暮光紫 / 玫瑰粉 / 曜石灰），与浅色/深色模式相互独立，写入 <html data-palette> 与 CSS 变量同步切换。

优化与修复

• 消除前端控制台告警（antd Drawer、输入框 autocomplete、ECharts outerBounds）。
• 前端接入 vitest 覆盖率（64.1% → 71%），后端覆盖率提升至 92.6%。
• README 换用真实运行界面截图（宫格展示）并新增异步导出使用说明。

工程与构建

• 依赖装配迁移 google/wire，make wire 重新生成。
• 配置模板化：入库为 configs/config.example.yaml，真实 config.yaml 不再入库。

v1.1.0

新特性

• 移动端卡片列表适配：DataTable 在紧凑视口自动切换为卡片列表，复用列定义、选择、树形展开与分页；新增 Loading 骨架屏/轻量刷新指示、toast 通知、页签保活切换与菜单管理界面优化 (#7f407d4)

修复

• 滚动条行为优化：全局滚动条改用标准 scrollbar-width / scrollbar-color 属性，macOS 触控板下保持系统默认的悬浮滚动条（默认隐身、滚动时浮现、停止后淡出），Windows 等经典平台为常显细滚动条；颜色走主题令牌，深浅主题自动切换；表格滚动条与页面滚动条同色 (#baea214)

工程

• 新增 CI 测试与 Release 产物自动化工作流：发布时自动构建 linux/darwin/windows（amd64 & arm64）后端二进制、前端产物及 SHA256 校验和并附加到 Release (#00ef92e)
• GitHub Actions 升级到 Node 24 运行时 (#e34f5d1)

Full Changelog: v1.0.0...v1.1.0

x-admin v1.0.0 · 首个正式版本

x-admin v1.0.0

首个正式版本。x-admin 是一套可直接落地的中后台全栈脚手架：Go + Gin + GORM 提供 API，React 19 + antd 6 + Vite 8 提供 SPA，开箱即用 RBAC、安全认证、系统管理与 Workbench Liquid Glass 界面。

亮点

• RBAC 权限模型：用户 → 角色 → 菜单/按钮，super_admin 跳过校验，其余按 模块:资源:动作 权限码授权。
• 完整认证链路：图形验证码、登录失败锁定、JWT access token + refresh 轮换、TOTP 二次验证、一次性恢复码、Passkey（WebAuthn）、接口限流。
• 系统管理模块：看板、用户、角色、菜单、部门、字典、参数、文件、定时任务、操作日志、登录日志、个人中心、站内通知。
• 工程化交付：版本化 SQL 迁移嵌入二进制、启动自动迁移与种子数据、Swagger/OpenAPI、Excel 导入导出、Go 单元/集成测试、Vitest 前端测试。
• 部署友好：单二进制后端、Docker Compose 完整栈、非 root 镜像、健康检查、Nginx SPA 与反代配置齐全。
• 界面体验：两级导航、多标签页保活、右键页签操作、暗色模式、登录趋势图表、可复用文件选择器，基于 MIT 协议开源。

下载说明

文件	平台	内容
x-admin_1.0.0_linux_amd64.tar.gz	Linux x86_64	后端二进制 + 配置样例 + README/LICENSE
x-admin_1.0.0_linux_arm64.tar.gz	Linux arm64	同上
x-admin_1.0.0_darwin_amd64.tar.gz	macOS Intel	同上
x-admin_1.0.0_darwin_arm64.tar.gz	macOS Apple Silicon	同上
x-admin_1.0.0_windows_amd64.zip	Windows x86_64	x-admin.exe + 配置样例 + README/LICENSE
x-admin-web_1.0.0.zip	通用	前端静态资源（dist 内容）
checksums.txt	—	全部产物的 SHA-256 校验和

快速开始

Docker Compose（推荐）

git clone https://github.com/xgd16/x-admin.git
cd x-admin
cp .env.example .env
# 编辑 .env，至少填写 JWT_SECRET（建议 32+ 位随机字符）
docker compose -f deploy/docker-compose.yml up -d --build

启动后访问：

• 前端：http://localhost
• Swagger：http://localhost:8080/swagger/index.html

默认账号：admin / Admin@123456（首次登录后请立即修改）。

使用发布产物

tar -xzf x-admin_1.0.0_linux_amd64.tar.gz
cd x-admin_1.0.0_linux_amd64
# 按需修改 configs/config.yaml，或使用 X_ADMIN_* 环境变量覆盖
./x-admin -config configs/config.yaml

要求 MySQL 8.0+；生产环境必须使用 Redis 7.x。启动时自动执行数据库迁移与种子数据。前端将 x-admin-web_1.0.0.zip 解压到 Nginx 站点目录，并参考仓库内 deploy/nginx.conf 配置 /admin/v1、/uploads、/swagger 与 SPA fallback。

校验产物

sha256sum -c checksums.txt   # macOS: shasum -a 256 -c checksums.txt

升级与注意事项

• 这是首个版本，无升级兼容负担。
• 部署到生产前请替换 JWT_SECRET、数据库密码，收紧 CORS_ORIGINS 与 TRUSTED_PROXIES，并启用 HTTPS。
• Passkey 仅在 localhost 或 HTTPS 安全上下文中可用，不支持 IP 地址。
• 多副本部署时请使用 Redis，定时任务依赖缓存锁避免重复执行。

相关文档

• 使用与部署文档：README.md
• 接口与实现契约：SPEC.md
• OpenAPI：internal/docs/openapi.yaml

完整变更记录：https://github.com/xgd16/x-admin/commits/v1.0.0