CodeWF.Avalonia 文档
dotnet9
CodeWF.Avalonia / 文档 / Markdown 基准报告

Markdown 基准报告

⏱ 预计阅读 5 分钟 适用于 net10.0 同步于 2026-11-08 来源: CodeWF · docs/基准报告.md ✎ 在 GitHub 编辑此页

测量工具:bench/CodeWF.Avalonia.Markdown.Benchmarks(控制台 harness,dotnet run -c Release -- all)。 每个优化落点在此登记"改动前 / 改动后"数据对照;没有数据的优化不合并。

环境

  • .NET 10.0.303 / Windows 11 x64 / Release
  • 文档样本:确定性生成(标题/段落/列表/表格/代码块/引用/任务列表循环,见 DocumentBuilder)
  • 分配统计:GC.GetTotalAllocatedBytes(precise: true)

基线(2026-10-19,流式内核实施前)

场景 数据
整篇解析 5 KB 平均 0.78 ms,最小 0.70 ms,分配 241.9 KB/次
整篇解析 20 KB 平均 3.11 ms,最小 2.62 ms,分配 958.8 KB/次
整篇解析 100 KB 平均 16.86 ms,最小 12.51 ms,分配 4955.3 KB/次
逐 token 追加 20 KB / 4 字符 5120 步,总 1278 ms,步均 0.25 ms,总分配 2507.8 MB
逐 token 追加 20 KB / 32 字符 640 步,总 168 ms,步均 0.26 ms,总分配 313.8 MB

基线读数

  • 逐 token 追加场景中,块级 diff 只占步均耗时的 1%,其余 99% 是整篇 Markdig 解析 ——现状管线对追加型输入的成本严格 O(全文),diff 优化救不了解析。
  • 20KB 文档按 4 字符/token 流完一遍,产生约 2.5 GB 分配(每步 substring 前缀 + 全篇解析),GC 压力全部落在流式期间。

阶段 1 落地后(2026-10-19,流式内核 MarkdownStreamingDocument)

场景 前(现状管线) 后(流式内核) 提升
20 KB / 4 字符逐 token 追加 1278 ms,2507.8 MB 墙钟 30 ms,105.6 MB 42× 提速,24× 降分配
20 KB / 32 字符逐块追加 168 ms,313.8 MB (同机制,冻结粒度不变,略) —

读数说明:

  • 流式引擎把 5120 次追加在后台合并为少量解析——冻结边界之外只有尾部参与 重解析,冻结前缀的块模型跨快照对象级共享;墙钟含 ~1ms 轮询粒度。
  • 分配残余(105 MB)主要来自每次 Append 的字符串拼接与尾部临时文本解析, 量级已与文档大小而非步数相关。
  • 渲染端复用:快照模型交给现有块级 diff,冻结块哈希不变 → 视觉树只替换尾部 (headless 测试断言首帧 Full、后续 Incremental)。

优化记录

2026-10-21,Mermaid 图鉴对照:Windows / .NET 10.0.303 / Release / Avalonia.Headless + Skia,1280 × 820,22 张真实图表,同一 Vex 工作台代码,仅替换 12.1.4.35 与 12.1.4.36 本地包,顺序运行避免 CPU 争用。首次从源码切到即时编辑首帧 307.54 → 200.78ms,第一张图完成 706.91 → 626.44ms;阅读显示就绪 115.11 → 96.31ms。三次热切换中位数 188.98 → 162.58ms,单次存在调度波动,不作为稳定帧率保证。完整 22 图 × 明暗 × 阅读/即时编辑的 88 项组合另行通过。

同轮 bench ... -- all:5 / 20 / 100KB 全文解析均值 0.77 / 3.29 / 16.26ms,分配 241.9 / 958.8 / 4952.7KB;20KB / 4 字符流式墙钟 14ms、110.4MB。该基准覆盖解析内核,没有测量图表布局;图表收益以工作台对照为准。

2026-10-26,开放围栏快速路径对照(bench ... -- fence):50KB 单一代码块按 4 字符/token 逐片追加(12803 步),引擎(快速路径命中)墙钟 62.3 ms / 754.9 MB;常规路径等价成本对照(每步 remend 补全 + Markdig 解析尾块,不含切分与快照组装)3747.5 ms / 9362.6 MB——代码块流式场景约 60× 提速、12× 降分配。混合文档 20KB / 4 字符场景墙钟 31 ms / 103.2 MB,与 2026-10-19 基线持平:工作者的合并策略会把突发追加合并成少量解析,混合文档的尾部大多不是围栏形态,快速路径收益在「长代码块」这一最高频 AI 回答形态上兑现。

日期 改动 前 后 备注
2026-10-19 流式内核(append-only 缓冲 + 冻结边界 + 尾部容错) 1278 ms / 2507.8 MB 30 ms / 105.6 MB 20KB 文档 4 字符/token;等价性由 StreamingEquivalenceTests 保障
2026-10-26 开放围栏尾部快速路径(规格 §4.4) 3747.5 ms / 9362.6 MB 62.3 ms / 754.9 MB 50KB 单一代码块 4 字符/token;对照为逐步补全+解析尾块,不含切分与快照组装

2026-11-01,全文查找改为模型计数与可见块高亮。600 段离屏查找回归确认:命中总数 600,查找前后物化块数相同且少于 100;跳到末项后仍少于 100。跨粗体、斜体和链接边界反复查找/清除,正文字符、逐字符格式及原始 Run 对象均保持。该回归验证正确性和物化预算,不以测试耗时声称搜索加速。

同机 Release bench ... -- all 前/后:全文解析 5/20/100KB 平均 0.55/2.20/9.78 → 0.57/2.18/8.71ms,分配 241.9/958.7/4954.9 → 241.8/958.7/4954.9KB;20KB/4 字符流式内核 15ms/116.3MB → 14ms/113.7MB;50KB 长代码块快速路径 43.1ms/760.7MB → 45.6ms/768.1MB。解析与流式代码未改,读数含运行时调度波动,不作为性能提升结论。