MoonBit CBOR 项目申报补充说明
面向 2026 MoonBit 国产开源生态大赛的项目说明与验收整改记录。
项目名称:MoonBit CBOR
项目方向:基础软件组件与二进制序列化协议
项目简介:纯 MoonBit 实现的 RFC 8949 CBOR 编解码库,服务于 Wasm、服务端、边缘计算和协议互操作场景。
核心能力
- 覆盖有符号/无符号整数、字节串、文本串、数组、map、tag、simple value 和浮点数据模型。
- 支持半精度、单精度和双精度浮点解码,以及 bytes/text/array/map 的 indefinite-length 解码。
- 提供
CborEncode、CborDecode和decode_as类型化接口。 - 保留完整
UInt64,校验整数/长度边界、preferred encoding、非法 UTF-8 和尾随字节。 - 提供 CLI、52 项自动化测试、跨平台 CI、验收脚本和多负载 benchmark。
- 提供应用消息封装、批量传输、流式分帧、嵌套查询、patch、校验报告、重试死信和脱敏 API。
实现边界
- 编码器以
Buffer为核心,适合二进制数据的连续写入。 - 当前实现不是全局零分配:文本 UTF-8 编码和规范 map 键排序会使用临时缓冲区。
- 性能说明以 benchmark 输出为证据,不将未经测量的性能目标写成保证。
公开交付
本轮整改重点
- 补齐可用的
CborDecode与常用目标类型转换。 - 修复 UInt64 全范围、Int64 最小值和负整数边界。
- 强化 UTF-8 合法性检查和非 BMP 文本编码路径。
- 修复 CLI 参数偏移,补充标准向量、错误路径、边界测试和真实负载 benchmark。
- 清理文档编码问题,使安装、运行、许可证和性能边界与源码一致。