ARTICLE · 1364531
排版插件开发手记5:算对了却送不进去,四级链路与隔离世界,隔离世界、四级写入口、落地判定
一 · 隔离世界:你读不到页面的接口
第 4 篇把样式算对了。按理说,拿着算好的 HTML 调编辑器的写入接口,一步到位。
我第一版就是这么想的,也这么写的。结果:每台机器都稳定亮黄——自检报告里那一项,永远判定「编辑器未识别」。
我在内容脚本里读页面 window 上的接口,读出来是 undefined。
根因是「隔离世界」(isolated world)。Chrome 的内容脚本运行在一个独立的 JavaScript 世界里,它看不到页面自己那个世界里的全局变量。所以 window.__editorBridge__ 在内容脚本眼里恒为空——不是没装,是它压根看不见。
任何「页面有没有挂某个全局」的判据,只要写在内容脚本里,就是恒定假。比假红更糟的是假黄:它不报错,但每次都误导你。
二 · 解法:站到主世界去读,但只读 typeof
修法是把探测挪到主世界:经 chrome.scripting.executeScript({ world: 'MAIN' }) 执行一段函数,让它站到页面的世界里去读。
但「站到主世界」不等于「可以为所欲为」。我给自己三条硬约定:
- 只读不 invoke。
探测函数只判断 typeof,绝不调用页面的任何函数。调用会污染用户的草稿,也会引入不可控行为。 - 函数自包含。
这段探测代码不依赖任何外部变量,单独能跑。 - 超时降级。
8 秒内读不到就降级处理,不卡死导入。
这么做,自检面板才能「随时可点、不污染草稿」——这是第 2 篇第三条规矩「出问题能说清」的前置条件。

三 · 四级写入口:一条主路,三条退路
读到了接口,怎么写进去?我设计了四级链路,主路优先,逐级降级:
- L0 编辑器接口。
优先调 invoke('mp_editor_insert_html')——这是编辑器正规写入通道,最干净。 - L1 DOM 覆盖。
接口不可用,直接操作编辑区 DOM,把算好样式的子树挂上去。 - L2 execCommand。
调 document.execCommand('insertHTML', ...)。 - L3 剪贴板。
最后兜底,把 HTML 写进剪贴板,提示用户 Ctrl+V。
为什么 L2 不能当主路径?因为 execCommand('insertHTML') 会剥掉 h1–h6 的 font-weight(700 / bold / 800 都剥),p 不剥。两层重解析之后,标题的字重全没了。加粗只能靠标签语义兜底。所以 L2 是退路,不是主路。
四 · 插入前规整与落地判定
写入口确定后,还要处理两件事。
插入前规整(四步):给叶子节点套 span[leaf] 标;清掉 colgroup(表格列宽容器,进了编辑器反而坏排版);吃掉多余空白;图片先占位,避免一次性拽入大图阻塞。
落地判定:插入前记录正文长度,插入后比对。增量 ≥ 50% 且 ≥ 10 字符,才判「成功」。这条判定救过我:有次接口其实没生效,但「返回成功」了,靠落地判定当场抓出来——这正是第 1 篇说的「返回成功但排版错且不说为什么」的反面:我们要的是「成功」真的发生了。

五 · 衔接:功能在跑,没人知道跑什么
这一篇,把第 1 篇的「坑二」拆完了:隔离世界的假黄、四级链路、落地判定。功能从「算对」走到「能送进去」。
但第 1 篇的「坑三」还在:功能在跑,可你不知道它到底跑了什么、哪一步出了问题。用户只会说一句「不对」,然后呢?
下一篇,讲我怎么让每一次导入「可解释」。
最后
送不进去,往往不是接口难调,而是你站错了世界。隔离世界是 Chrome 的安全设计,但它是「安静地挡住你」——你在内容脚本里读到的,永远是 undefined。
站到主世界去读、只 typeof 不调用、四级降级、落地判定。这一套下来,「算对了送进去」才真正成立。
下一篇,从那句最让人头疼的「不对」说起。














































































