Appearance
更新日志
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-site | 0.1.0 | 多站发布 — 文章按站点归属(both/main/news)发布与过滤 |
| seo-multisite | 0.1.0 | SEO 多域名 — 按站点分流 TDK canonical 与 sitemap |
| bidding | 0.1.0 | 招投标信息管理 — 结构化录入、按地区/金额/状态筛选、到期自动流转 |
| market-data | 0.1.0 | 行情数据 — 算力/储能价格卡片、走势数据、录入与自动涨跌幅 |
| daily-report | 0.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 端用户名自动生成
插件更新
| 插件 | 版本 | 变更 |
|---|---|---|
| CMS | v0.5.0 | +会员投稿(/api/v1/me/articles)、Tiptap 富文本双写、工作流优化 |
| Media | v1.1.0 | 全新插件:文件管理/上传管道/图片处理/视频处理/配额管理/样式预设 |
| Author | v0.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 接口 + 六维权限沙箱:
| 插件 | 版本 |
|---|---|
| example | 0.1.0 |
| cms | 0.2.0 |
| comment-interaction | 0.1.0 |
| topic | 0.1.0 |
| flash | 0.1.0 |
| community | 0.1.0 |
| search | 0.1.0 |
| seo | 0.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,早期版本。
技术栈
| 组件 | 版本/说明 |
|---|---|
| Go | 1.26+ |
| HTTP 框架 | Gin v1.10.0 |
| DI | Uber FX v1.23.0 |
| ORM | GORM v1.25.12 |
| 数据库 | PostgreSQL 16 |
| 缓存 | Redis 7 (go-redis/v9) |
| JWT | golang-jwt/jwt/v5 (HS256) |
| 配置 | Viper v1.19.0 |
| 日志 | Uber Zap v1.27.0 |
| 调度 | gocron/v2 v2.22.0 |
| 存储 | AWS S3 SDK v2 |
| WebSocket | gorilla/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 权限点。 注:上方各版本条目中的模块数 / 插件数 / 权限数均为该版本发布时的历史快照,随基座演进持续增长,不代表当前规模。
下一步
- MengStack v2.0 概述 — 返回产品概述
- 核心能力 — 了解框架核心功能
- API 参考 — 完整接口文档

