# 本轮交付记录

日期：2026-11-17。项目位于独立目录 `moon-raptorq`，模块名 `cauchyQ/moon-raptorq`。

## 代码数量

`python tools/source_lines.py` 的统计不包含标准常量、自动参考向量、依赖、构建产物及 Python 工具。

| 非生成 MoonBit 代码 | 源文件行数 | 去空行与整行注释 |
| --- | ---: | ---: |
| 核心库 | 1698 | 1386 |
| 测试 | 1939 | 1759 |
| 对照实验和基准 | 578 | 531 |
| 示例与 CLI | 463 | 432 |
| 合计 | 4678 | 4108 |

另有标准常量 216 行、自动生成的独立参考测试 736 行，单独计数。4108 行包含测试、实验和示例，不是声称生产编解码逻辑本身有 4000 行。统计是文本口径，不能代替代码质量或比赛工作量认定。

## 已实现

- RFC 6330 的 GF(256)、Rand、Tuple、系统参数、LDPC/HDPC 约束与中间符号。
- 标准 OTI、源块号和 24 位 ESI；正确处理 K' 补齐与修复符号 ISI 映射。
- 批量与逐包消元、独立秩进度、重复检测、冲突和资源限制。
- 可复用编码计划；多源块划分与恢复，最多 16 个块，每块最多 256 个源符号。
- 两类字节流分帧器，输入块失败时回滚。
- 单块检查点保存、CRC32C 校验、跨解码器恢复、CLI 保存和续传。
- 五个可运行示例、中文说明、来源声明、CI 配置与复现脚本。

## 验证证据

`reports/local-checks.json` 记录 Wasm、Wasm GC、JavaScript 的严格检查、构建、测试和五个示例，另有独立进程的 CLI 编码、保存、续传、等待状态和错误参数测试。每个后端 102 个测试通过。

`reports/interop.json` 记录与独立 Rust raptorq 2.0.0 的 12 组单块双向恢复、834 个参考包的逐字节比较，以及两组多块对象的独立划分和逐块验证。多块参考入口的限制见比较报告。

`reports/MEASUREMENTS.md`、`comparison-*.jsonl` 保存两后端三场景的实际发布库对照，保留预热与失败样本。`reports/SCALING.md`、`scaling-wasm.jsonl` 保存 48 次规模测量与 192 次仅修复符号试验。没有宣称所有参数都更快，也没有把结构内存估算当成实测进程峰值。

## 正式提交前的边界

本轮完成的是有界实现与本地交付。每块 K≤256、T≤4096，N=Al=1；多块对象最多 16 MiB。稀疏失活译码、完整标准规模、真实设备集成和整个多块对象的统一检查点不在当前范围。

源码仓库为 https://github.com/cauchyQ/moon-raptorq，原本单个本地快照按实际功能整理为 12 个提交，最终源码树保持一致；这些提交属于同一轮开发，不能当成跨日持续开发记录。mooncakes 发布版本为 `cauchyQ/moon-raptorq@0.1.0`，远程 CI 结果以仓库 Actions 为准。正式参赛还需核对发布版本、远程 CI，并由参赛者依据实际成果自行完成申报材料。后续开发记录应真实积累，不补造空提交，也不能保证验收结果。
