ARTICLE · 1395303
排版插件开发手记8:边界在哪,下一步去哪诚实标注未验证边界、给出后续方向
排版插件开发手记8:边界在哪,下一步去哪诚实标注未验证边界、给出后续方向七篇写下来,功能、样式、插入、取证、打包都讲了。这一篇不做加法,做减法:老实说清楚,哪些我验过,哪些我没验过。承认没验过,比含糊说验过可信。 

一 · 必须说清的边界
我不希望读者拿去用,却以为它无所不能。所以先把边界摆出来。
一类边界是环境限制。浏览器端到端测试,本轮在本机没跑起来。本机容器可用内存约 1.6 GB,测试框架加载阶段因 Wasm 申请不到连续内存崩了。我重试过,不是代码问题,是瞬时内存不足——隔一段时间重试反而能起来。但我如实标注:这一项未经浏览器端到端验证。
另一类边界是真机报告。第 1 篇那些「被真机打回来」的结论,是某位伙伴在本机测的,不是我测的。伙伴化名为「某位伙伴」——这是真实协作,但我不替他背书、也不暴露他是谁。真机报告由他出,我做的是把它变成可复现的判据。
承认没验过,比含糊说「应该没问题」可信。这是第 2 篇第三条规矩「出问题能说清」的最后一环:说清,也包括说清「我还没说清的」。

二 · 已验与未验对照
把账摊开:
已验:
纯逻辑单测 276 项(自有数据)。 静态闸门负向验证:故意构造错误输入,确认判据会红。 自研二维码编码器的黄金向量:12 条用例用外部解码器回读,逐字节对账。 运行包逐字节 SHA256 比对。
未验:
真实 DOM 观感:靠静态断言守,没在真浏览器里逐像素看。 多浏览器、多版本编辑器的兼容性矩阵:只在目标宿主验证过。
对照的意义,是让读者自己判断风险边界,而不是我替他乐观。
三 · 下一步方向
以下是我规划中的方向,非承诺,看实际取舍:
- 更多主题与语言高亮覆盖。
现在主题套数有限,代码高亮语言覆盖不全。 - 导入前可视化预览。
在送进编辑器之前,先本地渲染一份预览,所见即所得。 - 适配更多宿主编辑器。
现在主要验证目标宿主,其他富文本编辑器逐步适配。 - 把「可解释」做成可分享报告。
七行日志升级成带图表的诊断报告,一键分享。

这些方向里,我最看重第 2 个——它把「算对」从「靠判据守」变成「用户自己一眼看见」。
四 · 收束:三样比功能值钱的东西
回到第 1 篇那句话:难的不是塞进去,是「返回成功但排版错且不说为什么」。
七篇下来,我留下来三样东西,比任何一个单一功能都值钱:
- 尺子(黄金对照)。
拿真浏览器渲染逐元素比,分不清「本来就这样」和「被我改坏」的时候,它是裁判。 - 取证(计数快照)。
一次导入一份七行日志,把「不对」翻译成「最早出错的那一步」。 - 闸门(静态断言)。
判据自己也要被审,判据错比功能错更危险。
这三样,是「排版工坊」真正的内核。功能会过时,尺子、取证、闸门不会。
最后
八篇写到这里。从拆一个收费插件、定三条规矩开始,到一条流水线、一把尺子、一份日志、一个可信的包结束。
我没把它写成「我多厉害」。我写的是:哪些坑我栽过,哪些我靠构造绕过去,哪些我到现在还没验完。
如果你也在手搓工具,希望这八篇能当一面镜子——照见你自己的尺子、取证和闸门。















































































