Skip to content

更新日志 ​

MengStack 版本迭代记录,基于 Git 仓库提交历史整理。

v2.5.8 ​

纯内核发行 — 服务引擎去插件化,首发"干净内核"发行版。

架构(服务引擎去插件化) ​

  • 注册表驱动装配 — 引擎不再逐个硬编码插件参数,改由单一可剥离的插件清单装配,业务插件与内核彻底解耦
  • 纯内核发行版 — 新增 mengstack-kernel-dist:仅含 9 大核心模块(认证 / 权限 / 组织 / 审计 / 配置 / 通知 / 仪表盘 / 菜单 / 用户)+ 示例插件,不绑定任何业务插件,基座更轻、边界更清晰
  • 三层版本体系落地 — 明确基座版本(v2.x)/ 解决方案版本(Portal v1.x)/ 插件语义化版本各自独立演进、互不绑架(见版本说明)

业务插件保持各自独立发行,按项目需求自由组合、按需装配。


v2.4.0 ​

性能减法 + 数据一致性 + 3 款官方插件。

P1 韧性工程 ​

  • 搜索索引 — ILIKE 全表扫描改 pg_trgm 三元组 GIN 索引(迁移 000022),子串检索不再拖库
  • Redis 统一超时 — 所有 Redis 调用点包 2s 超时;限流由 fail-closed 改 fail-open,缓存故障不再全站 429
  • N+1 修复 + 慢查询日志 — 5 处读路径批量化;GORM 慢查询 >200ms 告警、SQL 错误入库

P2 减法工程 ​

  • 事务保护 — 关键多表写操作全面事务化(context 承载 UnitOfWork),杜绝部分成功导致的数据错乱
  • 无界查询封顶 — 分页参数夹下界、全量加载补 LIMIT,修复多处列表恒空 / 恒全量缺陷
  • IM 会话数据库级分页 — 替代"全量捞 + 内存排序"的假分页;WebSocket 连接泄漏竞态修复
  • 依赖安全 — 修复可达 CVE(govulncheck 纳入 CI,可达漏洞清零);SELECT * 清零

官方插件(3 个新增) ​

  • site-settings — 站点配置
  • analytics — 数据统计
  • ad-manager — 广告位管理

v2.3.0 ​

工程质量强化 + 5 个生态插件首次公开发行。

P0 韧性工程(内核加固) ​

  • Redis 客户端韧性 — 增加 DialTimeout / ReadTimeout / WriteTimeout / PoolTimeout / MaxRetries / MinIdleConns,连接异常可快速失败并自动重试
  • 限流降级 — RateLimitRedis 增加 rdb == nil 降级分支,Redis 不可用时限流自动放行不阻塞业务
  • 查询超时 — 新增 QueryTimeout 中间件(10s),慢查询主动中断保护数据库
  • WebSocket 连接上限 — Hub 三级连接数限制(全局 10000 / 租户 2000 / 单用户 5),防连接耗尽

工程质量 ​

  • 安全边界契约测试 — tenant 隔离 + rbac 防提权测试(MS-基座-T-002)
  • 静态检查修复 — 修 staticcheck 弃用 API + unused 死代码、errcheck 未检查 error(MS-基座-X-002)
  • CI/CD 上线 — Gitea Actions 流水线:build / vet / test-race+PG / lint 三 job 全绿

生态插件(5 个首次公开发行) ​

插件版本说明
publish-site0.1.0多站发布 — 文章按站点归属(both/main/news)发布与过滤
seo-multisite0.1.0SEO 多域名 — 按站点分流 TDK canonical 与 sitemap
bidding0.1.0招投标信息管理 — 结构化录入、按地区/金额/状态筛选、到期自动流转
market-data0.1.0行情数据 — 算力/储能价格卡片、走势数据、录入与自动涨跌幅
daily-report0.1.0日报 — 早报/晚报 AI 生成、定时发布、人工审核

发行版插件仓持续扩充:v2.3.0 时共 14 个(9 官方 + 5 生态)。当前基座为 9 核心模块 + 25+ 业务插件(权威清单见 api/plugins.yaml)。生态插件经六门禁合规审查、三级货架定级后收编。


v2.2.0 ​

可观测性增强 + IM 协议定稿 + C 端上传通道。

可观测性(新增) ​

  • Prometheus 指标采集 — 新增 /metrics 端点(默认关闭,server.metrics: true 开启,支持 server.metrics_token 令牌保护,令牌不匹配返回 404 不暴露端点存在性)
    • HTTP 请求计数与耗时直方图(按路由模板聚合,防标签基数爆炸)
    • 数据库连接池(open / in_use / idle)、Redis 连接池(total / idle / hits / misses / timeouts)
    • WebSocket 在线连接数、定时任务执行计数(成功/失败)
  • W3C traceparent 兼容 — 入站携带合法 traceparent 头时提取 trace-id 复用;所有响应回写 traceparent 响应头(00-<trace-id>-<span-id>-01),生成的 trace_id 升级为 32 位十六进制,可直接对接 OpenTelemetry / Jaeger / SkyWalking 等标准链路工具

IM 即时通讯(协议定稿 + 模块落地) ​

  • IM WebSocket 协议 v1.0 — 首帧鉴权、消息收发、已读回执、离线补拉、万人群广播,六项关键决策定稿(docs/im-ws-protocol.md)
  • IM REST 契约 — 历史消息分页、会话列表接口契约定稿,解除 MengHub 客户端联调阻塞
  • IM 模块落地 — WS 首帧鉴权接入、7 个 REST 端点(会话/历史消息/已读)、离线补拉,基于内核 16 分片 WebSocket Hub

媒体上传增强 ​

  • C 端上传通道 — 新增 media.upload 权限与 /api/v1/media/c/upload 独立路由,C 端用户(会员)与后台管理上传分离管控

Bug 修复 ​

  • 集成测试环境修复:种子租户显式 SQL 插入(tenants 表由 SQL 迁移创建,无 settings 列)、auth 测试二次清库导致登录用例恒 401 的潜伏缺陷

v2.1.0 ​

基座能力扩展 + Portal 媒体门户解决方案支撑。

核心模块新增 ​

  • 菜单模块 (menu) — 12 个位置槽位(header_nav / mobile_nav / sidebar / footer 等),树形菜单项管理,PC/手机导航拆分,支持权限控制
  • 用户模块 (user) — 手机号登录、邮箱验证码、用户资料、关注/粉丝、邀请关系、收货地址、偏好设置、注销冷静期(7 天)、C 端用户名自动生成

插件更新 ​

插件版本变更
CMSv0.5.0+会员投稿(/api/v1/me/articles)、Tiptap 富文本双写、工作流优化
Mediav1.1.0全新插件:文件管理/上传管道/图片处理/视频处理/配额管理/样式预设
Authorv0.1.0全新插件:作者入驻/等级体系(L0-L3)/关注粉丝/冗余计数

内核重构 ​

  • KernelModule 提取 — server/website 双二进制共享内核 Provider,消除重复接线;FX 图校验回归测试保障
  • 双应用架构 — 主应用 server(:2222) + 官网 website(:2223) 共享同一内核,独立部署

Portal 支撑 ​

  • P1:基座用户模块 + 菜单模块上线
  • P2:Portal SSR 前台 10 个核心页面(首页/文章详情/频道/分类/标签/快讯/搜索/单页/作者/专题)
  • 三层版本体系确立:基座 v2.x + Portal v1.0 + 插件语义化

Bug 修复 ​

  • 文章元数据更新乐观锁永久 409(非内容变更也必须递增版本)
  • 全局版本号对齐,dist 发行版同步 v2.1.0

数据库迁移 ​

  • 000012_menu_core — 菜单核心表
  • 000013_menu_locations — 菜单位置槽位
  • 000014_menu_nav_split — PC/手机导航拆分
  • 000015_user_core — 用户核心扩展
  • 000016_user_relations — 用户关系(关注/邀请)

v2.0.0 ​

内核全面升级,包含安全加固、插件系统重构、品牌标识等重大变更。

内核升级 ​

  • Snowflake ID — 分布式唯一 ID 生成器(自定义纪元 2025-01-01,10 机器位 + 12 序列位),替代自增 ID
  • RLS 行级安全 — PostgreSQL Row Level Security 全表启用 + 索引优化
  • EventBus 异步事件总线 — 缓冲通道 1024 + 4 Workers 并发消费,支持 SafePublish 沙箱检查
  • WebSocket Hub — 16 分片架构(splitmix64 哈希),消除单锁瓶颈,支持 10K+ 并发
  • 任务调度 — 基于 gocron/v2,支持间隔/Cron/一次性三种任务类型
  • 文件存储 — 本地 + S3 双后端,SandboxedStore 插件权限检查
  • i18n — 嵌入式 JSON 消息文件,T(lang, key) 查询,中文回退

安全加固 (SEC-01 ~ SEC-12) ​

  • Redis 滑动窗口限流(三级:匿名/认证/管理),返回 X-RateLimit-* 头
  • 安全响应头全套(CSP、HSTS、X-Frame-Options DENY 等)
  • JWT 密钥强度校验(最少 32 字符,禁止占位值)
  • release 模式 CORS 禁止通配符 *
  • 上传文件 magic bytes 内容类型验证
  • bcrypt cost 12 + 防枚举恒定时间比较
  • Refresh Token SHA-256 指纹轮转

插件系统 ​

8 个插件全部重写,实现 Plugin 接口 + 六维权限沙箱:

插件版本
example0.1.0
cms0.2.0
comment-interaction0.1.0
topic0.1.0
flash0.1.0
community0.1.0
search0.1.0
seo0.3.1

品牌标识 ​

  • 全部 .go 文件添加版权声明 Copyright (c) 2026 软盟SoftUnis Inc.
  • 启动 Banner 显示品牌信息
  • X-Powered-By 响应头
  • DISCLAIMER 免责引用

管理后台 ​

  • 7 插件管理页面(9 个视图)
  • 部门管理、敏感词管理、会话管理页面
  • 超级管理员适配、用户 CRUD、版本 API

基础设施 ​

  • 数据库迁移:7 个核心迁移文件(init_schema → rbac → upload → audit → rls → settings → notifications → examples)
  • 每插件独立迁移表 schema_migrations_{plugin_name}
  • RBAC 种子:37 权限 + 3 系统角色
  • Uber FX 依赖注入:15 个模块 + 8 个插件
  • Gitea Actions CI:go vet + go test + go build

v1.3.2 ​

Git 标签 v1.3.2。


v0.3.1 ​

Git 标签 v0.3.1,早期版本。


技术栈 ​

组件版本/说明
Go1.26+
HTTP 框架Gin v1.10.0
DIUber FX v1.23.0
ORMGORM v1.25.12
数据库PostgreSQL 16
缓存Redis 7 (go-redis/v9)
JWTgolang-jwt/jwt/v5 (HS256)
配置Viper v1.19.0
日志Uber Zap v1.27.0
调度gocron/v2 v2.22.0
存储AWS S3 SDK v2
WebSocketgorilla/websocket v1.5.3
迁移golang-migrate/v4 v4.20.1
文档swaggo/swag v1.16.6
许可证Apache 2.0

当前基座规模:9 核心模块 + 25+ 业务插件(权威清单见 api/plugins.yaml)+ 60+ RBAC 权限点。 注:上方各版本条目中的模块数 / 插件数 / 权限数均为该版本发布时的历史快照,随基座演进持续增长,不代表当前规模。


下一步 ​

Released under the Apache 2.0 License.