MortarMQ用 MoonBit 原生实现的消息队列

完整 MQ 闭环 —— 协议接入、生产/消费、分区 topic、at-least-once 投递（DLQ）、持久化崩溃恢复

快速开始

线协议（v0）

30 秒演示

15 op 线协议

9 核心 + 6 扩展；帧格式 [u32_be len][u8 op][payload]；四段式错误码注册表；codec golden 用例全绿是准入门槛。

at-least-once 投递

投递台账与消息记录分离；5 次重试后进 DLQ；kill -9 后的重放恢复由确定性仿真把关。

增量 rebalance

broker 侧协调器；membership / assignment / epoch 三层版本；只有受影响的分区才会移动。

诚实的边界

v0 不含 TLS / 热加载 / authz / Raft 元数据 —— 每一项裁剪都附带文档化的升级路径。

本站按「你要做什么」组织，而不是按「你是谁」

每一章是一种性质不同的文档。找到匹配你当前任务的那一章，其余可以跳过。

章节	什么时候读	从这里开始
入门	想最快跑通一个闭环	快速开始
核心概念	想弄懂系统为什么这么表现	架构
使用指南	有具体的运维任务：部署、升级、恢复	故障处置手册
参考手册	要查一个确切的值：帧布局、配置项、退出码	线协议
开发	要改代码或提 PR	测试

第一次来？按 快速开始 → 架构 → 回到本表 走。

关于翻译

中英是两棵平行树：/cn/ 与 /en/ 同名文件两边都有，/ 是语言选择页，谁也不占根。代码围栏（mermaid、ASCII 时间线、规范记法）与 reference/ 章的表格在两种语言下都保持英文（标识符、配置键、CLI 子命令与错误码统一用英文，这是项目惯例）。