# 性能测量与结果边界

从 v0.0.6 开始固定 [基准清单](../benchmarks/manifest.json) 和输入种子 `20261017`。`scripts/performance.py` 从提交 `b9df1eddaacdefebc2e32eee468fada8cc9e6020` 取出 v0.0.5 源码，仅加入相同开发计时适配器，再用同一工具链构建对照。

```powershell
.venv\Scripts\python.exe scripts/performance.py --baseline-only
.venv\Scripts\python.exe scripts/performance.py
```

数据覆盖 16 MiB 密集数组、16 MiB 复数、4 MiB 递归混合树、100,000 项 CSC、压缩随机数据、全零压缩和从 16 个变量选择一个。大端读取单列。生成和启动不计入核心耗时；写入对象在计时前准备。每个目标使用三个新进程批次，每批预热 5 次、测量 10 次，报告 30 个原始样本、中位数与 p95。比较版本交错测量；历史基线另行保留。

内存单独启动新进程，不预热，执行一次操作；重复三个进程，记录全部峰值及其中位数。Windows 为峰值工作集，Linux 为峰值 RSS。输入、宿主和写入准备成本都计入峰值；不能把它解释为纯输出缓冲的大小。JS 在计时外主动 GC，native 采用自身运行时，两者只各自与同目标的旧版本比较。

计时与内存适配器位于独立开发包，不进入 Windows 产品命令行的依赖。宿主只提供读文件、时钟和进程内存统计，编解码继续执行 MoonBit 实现。

正式结果放在 `verification/reports/performance-*.json`。`measured` 表示已获得数据，目标是否达到需按每个场景和宿主分别判断；不能把总体平均值作为某项通过证明。兼容性失败、输入被超限拒绝或工具崩溃都不能作为有效速度成绩。

工程目标：指定未压缩写入耗时降低 30%、峰值降低 25%；未压缩文件选择一个变量达到 2 倍速度、峰值降低 40%。它们是工程目标，未达到时明确报告。完整兼容及赛事验收不由这些数字代替。

## 本轮实测与交付汇总

v0.0.7 正式测量：Windows 11 x64，同机 MoonBit 0.1.20260920、GCC 16.2.0、Node 24.13.0。固定样例保留全部 30 个核心样本、30 个命令行样本和 3 个独立峰值样本。以下为与固定 v0.0.5 相比的核心结果；完整 p95、吞吐、大小端/压缩/CSC 结果及命令行耗时见原始报告。

| v0.0.7 写入场景 | 宿主 | 核心提速 | 进程峰值下降 |
| --- | --- | --- | --- |
| 16 MiB 密集数组 | native | 12.232 倍 | 38.6% |
| 16 MiB 密集数组 | JS | 10.905 倍 | 87.0% |
| 4 MiB 嵌套混合树 | native | 105.552 倍 | 35.2% |
| 4 MiB 嵌套混合树 | JS | 59.987 倍 | 87.4% |

这四组写入目标均通过；固定场景没有可重复的超过 10% 退化。v0.0.7 的选择读取目标尚未通过，原始不利结果保留，不能计为当版已完成。

v0.0.8 使用相同场景和规则复测全部 24 个操作/宿主组合；选择读取的两个目标和其他场景的回归逐项列在 `performance-v0.0.8.json` 与 `performance-evaluation-v0.0.8.json`。不要用某宿主的通过结果代替另一宿主。

| v0.0.8：16 个各 1 MiB 变量中选一个 | 核心提速 | 峰值下降 | 2 倍 / 40% 工程目标 |
| --- | --- | --- | --- |
| native | 14.187 倍 | 38.3% | 内存目标未达；速度通过 |
| JS | 10.349 倍 | 48.1% | 通过 |

native 峰值为 23,736,320 字节，对照为 38,445,056 字节。保持原定样例和包含输入的进程测法，未将 38.3% 写成 40%。四组写入目标继续通过，最终 24 组无超过 10% 的退化。首轮原生 CSC 退化与压缩读取偏慢的全部数据保留在 `performance-attempt-17c4f0d-v0.0.8.json`；调整热路径后用相同协议完整复测。

v0.0.9 冻结运行时，仅版本描述及验收资料变化。`scripts/performance-summary.py` 验证其运行时代码与 v0.0.8 一致（排除版本文字、规范化换行），并生成 `performance-summary-v0.0.9.json`，明确引用历史测量版本和哈希；不伪称 v0.0.9 又测出了新加速成绩。若一致性检查失败，应重新测量，不能直接继承结论。