夜雨聆风学习资料网

ARTICLE · 1395303

排版插件开发手记8:边界在哪,下一步去哪诚实标注未验证边界、给出后续方向

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

一 · 必须说清的边界

我不希望读者拿去用,却以为它无所不能。所以先把边界摆出来。

一类边界是环境限制。浏览器端到端测试,本轮在本机没跑起来。本机容器可用内存约 1.6 GB,测试框架加载阶段因 Wasm 申请不到连续内存崩了。我重试过,不是代码问题,是瞬时内存不足——隔一段时间重试反而能起来。但我如实标注:这一项未经浏览器端到端验证。

另一类边界是真机报告。第 1 篇那些「被真机打回来」的结论,是某位伙伴在本机测的,不是我测的。伙伴化名为「某位伙伴」——这是真实协作,但我不替他背书、也不暴露他是谁。真机报告由他出,我做的是把它变成可复现的判据。

承认没验过,比含糊说「应该没问题」可信。这是第 2 篇第三条规矩「出问题能说清」的最后一环:说清,也包括说清「我还没说清的」。

二 · 已验与未验对照

把账摊开:

已验:

  • 纯逻辑单测 276 项(自有数据)。
  • 静态闸门负向验证:故意构造错误输入,确认判据会红。
  • 自研二维码编码器的黄金向量:12 条用例用外部解码器回读,逐字节对账。
  • 运行包逐字节 SHA256 比对。

未验:

  • 真实 DOM 观感:靠静态断言守,没在真浏览器里逐像素看。
  • 多浏览器、多版本编辑器的兼容性矩阵:只在目标宿主验证过。

对照的意义,是让读者自己判断风险边界,而不是我替他乐观。

三 · 下一步方向

以下是我规划中的方向,非承诺,看实际取舍:

  1. 更多主题与语言高亮覆盖。
     现在主题套数有限,代码高亮语言覆盖不全。
  2. 导入前可视化预览。
     在送进编辑器之前,先本地渲染一份预览,所见即所得。
  3. 适配更多宿主编辑器。
     现在主要验证目标宿主,其他富文本编辑器逐步适配。
  4. 把「可解释」做成可分享报告。
     七行日志升级成带图表的诊断报告,一键分享。

这些方向里,我最看重第 2 个——它把「算对」从「靠判据守」变成「用户自己一眼看见」。

四 · 收束:三样比功能值钱的东西

回到第 1 篇那句话:难的不是塞进去,是「返回成功但排版错且不说为什么」。

七篇下来,我留下来三样东西,比任何一个单一功能都值钱:

  • 尺子(黄金对照)。
     拿真浏览器渲染逐元素比,分不清「本来就这样」和「被我改坏」的时候,它是裁判。
  • 取证(计数快照)。
     一次导入一份七行日志,把「不对」翻译成「最早出错的那一步」。
  • 闸门(静态断言)。
     判据自己也要被审,判据错比功能错更危险。

这三样,是「排版工坊」真正的内核。功能会过时,尺子、取证、闸门不会。

最后

八篇写到这里。从拆一个收费插件、定三条规矩开始,到一条流水线、一把尺子、一份日志、一个可信的包结束。

我没把它写成「我多厉害」。我写的是:哪些坑我栽过,哪些我靠构造绕过去,哪些我到现在还没验完。

如果你也在手搓工具,希望这八篇能当一面镜子——照见你自己的尺子、取证和闸门。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料