Slate v2 大文档 Shell 渲染证明岛屿化渲染层如何把万级块文档的编辑成本真正降下来【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本篇文章基于 plate 仓库内docs/plans/2026-04-11-slate-v2-large-document-shell-proof-batch.mdSlate v2 大文档 Shell 证明批次的完整记录展开结合同仓库中 Proof-First 大文档层计划、DOM 协调修复方案、rerender 广度车道方案等配套文档还原这一批次的工程脉络它证明了远端岛屿只渲染廉价 Shell、不再挂载可编辑子树这条路线能够真实削减运行时开销并定位了后续激活路径与模型级全选/粘贴两条主攻方向。读完本文你将理解 Slate v2 大文档层的岛屿分类模型、结构化 DOM 协调在部分挂载下的正确性约束、三条基准车道的用法与判读方式以及该批次的边界哪些问题明确未解决。背景为什么需要 Shell 证明批次Slate v2 在 1 万块10000-block级别的文档上一直面临可编辑渲染成本问题。此前提出的语义岛屿semantic islands第一版原型被否决原因是它并不诚实远端岛屿仍然渲染了完整的后代树CtrlA、粘贴等宽操作broad ops仍会回退到昂贵的整树路径层架构付出了复杂度却没有真正移除运行时工作。这一教训被记录在 Proof-First 大文档层计划 中grouped wrappers plus CSS hints are not enough分组包装加 CSS 提示不够。于是有了三条非协商规则non-negotiable rules分块chunking不作为基础架构局部订阅local subscriptions仍作为基础层活动走廊active corridor仍使用实时 DOM 真相Pretext 仍只是规划层不是活动编辑真相DOM 保持足够的在场性以满足浏览器行为不直接跳到虚拟化不再交付另一个仅包装器的原型。Shell 证明批次就是在这个前提下第一次以诚实的方式验证 Shell 路线远端岛屿停止挂载可编辑后代。这正是本批次标题中 shell-only proof 的含义——只证明 Shell 本身成立不与宽操作集成。岛屿模型与 Shell 设计岛屿种类Island KindsProof-First 计划把第一版刻意收窄为四类顶层结构顶层段落/块组top-level paragraph/block group表格子树table subtree空元素/嵌入块void/embed block列表子树list subtree。暂不从标题推断章节Do not infer sections from headings yet。Shell 必须做什么、禁止做什么Shell 模型的核心纠正是活动/邻近岛屿渲染真实的可编辑后代树远端岛屿渲染廉价 Shell而非可编辑后代。Shell 仍须暴露有用的 DOM可见文本内容支撑滚动与粗略阅读稳定的 Shell 根属性供激活activation使用内在高度提示intrinsic height hints。Shell 严禁挂载EditableDescendantNodeEditableText逐叶子订阅per-leaf subscriptions昂贵的覆盖层投影工作。即渲染更少、只变更实际挂载的内容、精确保留远端子树文本这是真正的收益所在其余都是表象。本批次保留的工作Kept Work批次文档记录本批次新增了内部大文档规划器与 Shell 渲染器并接入了现有渲染入口新增large-document内部模块create-island-plan.ts岛屿规划器、classify-island-kind.ts岛屿种类分类器、island-shell.tsxShell 渲染器通过editable-text-blocks.tsx为EditableBlocks接入可选的 Shell 化opt-in shelling在huge-document.tsx演示中增加查询参数控制query-param control用于 A/B 运行新增专用证明车道replacement/huge-document-islands.mjs基准修复既有广度车道slate-react-rerender-breadth-benchmark.tsx的 JSX-runtime 假设使其恢复为被保留的车道。需要说明的是上述文件路径来自文档所记录的外部源码仓库slate-v2 / plate-2。在当前 plate 仓库中与之对应的可查阅物证包括大文档演示的实现 huge-document-demo.tsx、官方示例说明 huge-document.mdx以及基准车道的注册信息 slate-v2.json其中登记了react-rerender-breadth、react-huge-document-full等车道及其运行命令。关键修复结构化 DOM 协调必须变为子集感知这是本批次中如果不修复就会静默损坏文档文本的关键点单独成篇记录在 Shell-only 大文档岛屿必须在 DOM 协调期间保留远端子树。问题根源EditableBlocks通过读取[data-slate-nodetext]节点并按快照顺序重建文本内容来从 DOM 协调。这只有在整棵可编辑树都已挂载时才成立。一旦远端岛屿变成廉价 Shell这个假设就失效了远端岛屿有意停止渲染EditableTextDOM 协调仍然只扫描已挂载的文本节点在一个活动岛屿中输入时协调游标会提前耗尽已挂载文本列表然后用空字符串填满远端 Shell 文本节点——导致一个活动岛屿的输入把远端文本全部清空。修复方案让 DOM 协调只作用于已挂载的顶层岛屿活动岛屿仍从 DOM 文本节点协调Shell 化的顶层岛屿直接从已提交快照committed snapshot拷贝协调游标只为已挂载的顶层运行时 id 消费 DOM 文本。这样 Shell 模式保持诚实渲染更少、只变更实际挂载的内容、远端子树文本被精确保留。方案文档给出的预防性结论同样值得记录任何 Shell 或遮挡层在相信性能收益之前都必须审计 DOM 协调假设整棵树已挂载这一假设在 Shell 模式下必然错误基准收益本身不够还要检查快照模型在部分挂载下是否仍然正确。三条基准车道与判读车道 1默认运行时1000 块pnpm bench:replacement:huge-document:local在 1000 块下的记录结果指标Shell 批次v2Legacyready527.95ms720.87mstype12.48ms19.85msselect-all3.59ms75mspaste34.85ms107.75ms注意 select-all 从 75ms 降到 3.59ms、paste 从 107.75ms 降到 34.85ms这组数据说明在 Shell 层未启用或处于默认状态时运行时本身并未退化。车道 2rerender 广度车道pnpm bench:react:rerender-breadth:local记录读取结果#5131宽 hookbroad hook按契约仍然宽useSlate()本就是整编辑器级响应式#3656兄弟叶子重渲染数 0#4141祖先节点重渲染数 0。广度车道方案在 Slate React rerender 广度大多已局部化useSlate 是仅剩的宽 hook 中有完整记录它把两个长期被混为一谈的故事分开——宽 hook 按设计是宽的与后代失效已经局部化。批量记录中该车道还包含更细的读数20 次选择变更产生 20 次useSlate()与useSlateSelection()重渲染、无关顶层块切片重渲染 0编辑叶子重渲染 1、兄弟叶子 0、父块 0深层编辑叶子 1、重渲染祖先 0、兄弟分支 0。车道 3Shell 证明车道10000 块pnpm bench:replacement:huge-document:islands:local在 10000 块下的记录结果ready527.86mstop typing顶部输入38.85msshell promotionShell 提升54.10msshell countShell 数量99与上一次干净的未启用 Shell 的 10000 块基线相比ready 1229.49ms、top typing 97.47ms本次 Shell 证明削减了ready 约 701.63mstop typing 约 58.62ms。批次文档的结论是That is real enough to keep.——这个收益真实到值得保留。Verdict证明了什么、没证明什么已证明Shell-only 远端岛屿可以移除真实运行时工作收益大到足以支撑继续投入局部提升local promotion足够廉价是一条可行的路径。明确未证明宽操作broad ops尚未解决Shell 支撑的选择shell-backed selection尚未解决远端 Shell 粘贴far-shell paste尚未解决。批次文档因此给出的下一步是显而易见的Proof-First 计划的 Phase 2 与 Phase 3激活路径、模型级宽操作快路径交互时提升到可编辑 DOMpromotion into editable DOM on interaction对 Shell 支撑的选区执行模型驱动的全选与粘贴。后续方向的仓库佐证该批次之后的相关方案在当前仓库中有连续记录可作为继续追踪的入口激活路径要求Shell 提升必须把选区移入被提升的岛屿否则只是表面工作见 Shell 提升必须把选区移入被提升的岛屿mousedown 时提升岛屿、在模型中选中该顶层岛屿起点、聚焦真实编辑器根并以promote then type而非只测 promote 来验证宽操作快路径要求Shell 支撑的选区在 DOM 中必须 fail closed宽操作走模型见 Shell-backed 大文档选区必须在 DOM 中 fail closed 并通过模型执行宽操作输入性能前置条件要求大文档输入需要先削减 selector fanout 再做岛屿见 大文档输入需要 selector fanout 削减粘贴性能约束要求大文档粘贴不应重渲染未变更的后代见 大文档粘贴不应重渲染未变更的后代执行批次可参考 active-corridor-promotion-batch 与 large-document-broad-ops-batch。小结Shell 证明批次的意义不在于交出一套完整的大文档层而在于用可复现的基准车道证明了方向本身远端岛屿渲染 Shell、活动走廊保持实时 DOM 真相、提升局部化是比分组包装 CSS 提示和分块叙事更值得继续投入的大文档策略。它同时把正确性问题部分挂载下的 DOM 协调与性能问题宽操作、Shell 支撑选区、远端粘贴明确分开为后续 Phase 2/3 的推进划出了清晰的边界与验收标准。【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Slate v2 大文档 Shell 渲染证明：岛屿化渲染层如何把万级块文档的编辑成本真正降下来
Slate v2 大文档 Shell 渲染证明岛屿化渲染层如何把万级块文档的编辑成本真正降下来【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本篇文章基于 plate 仓库内docs/plans/2026-04-11-slate-v2-large-document-shell-proof-batch.mdSlate v2 大文档 Shell 证明批次的完整记录展开结合同仓库中 Proof-First 大文档层计划、DOM 协调修复方案、rerender 广度车道方案等配套文档还原这一批次的工程脉络它证明了远端岛屿只渲染廉价 Shell、不再挂载可编辑子树这条路线能够真实削减运行时开销并定位了后续激活路径与模型级全选/粘贴两条主攻方向。读完本文你将理解 Slate v2 大文档层的岛屿分类模型、结构化 DOM 协调在部分挂载下的正确性约束、三条基准车道的用法与判读方式以及该批次的边界哪些问题明确未解决。背景为什么需要 Shell 证明批次Slate v2 在 1 万块10000-block级别的文档上一直面临可编辑渲染成本问题。此前提出的语义岛屿semantic islands第一版原型被否决原因是它并不诚实远端岛屿仍然渲染了完整的后代树CtrlA、粘贴等宽操作broad ops仍会回退到昂贵的整树路径层架构付出了复杂度却没有真正移除运行时工作。这一教训被记录在 Proof-First 大文档层计划 中grouped wrappers plus CSS hints are not enough分组包装加 CSS 提示不够。于是有了三条非协商规则non-negotiable rules分块chunking不作为基础架构局部订阅local subscriptions仍作为基础层活动走廊active corridor仍使用实时 DOM 真相Pretext 仍只是规划层不是活动编辑真相DOM 保持足够的在场性以满足浏览器行为不直接跳到虚拟化不再交付另一个仅包装器的原型。Shell 证明批次就是在这个前提下第一次以诚实的方式验证 Shell 路线远端岛屿停止挂载可编辑后代。这正是本批次标题中 shell-only proof 的含义——只证明 Shell 本身成立不与宽操作集成。岛屿模型与 Shell 设计岛屿种类Island KindsProof-First 计划把第一版刻意收窄为四类顶层结构顶层段落/块组top-level paragraph/block group表格子树table subtree空元素/嵌入块void/embed block列表子树list subtree。暂不从标题推断章节Do not infer sections from headings yet。Shell 必须做什么、禁止做什么Shell 模型的核心纠正是活动/邻近岛屿渲染真实的可编辑后代树远端岛屿渲染廉价 Shell而非可编辑后代。Shell 仍须暴露有用的 DOM可见文本内容支撑滚动与粗略阅读稳定的 Shell 根属性供激活activation使用内在高度提示intrinsic height hints。Shell 严禁挂载EditableDescendantNodeEditableText逐叶子订阅per-leaf subscriptions昂贵的覆盖层投影工作。即渲染更少、只变更实际挂载的内容、精确保留远端子树文本这是真正的收益所在其余都是表象。本批次保留的工作Kept Work批次文档记录本批次新增了内部大文档规划器与 Shell 渲染器并接入了现有渲染入口新增large-document内部模块create-island-plan.ts岛屿规划器、classify-island-kind.ts岛屿种类分类器、island-shell.tsxShell 渲染器通过editable-text-blocks.tsx为EditableBlocks接入可选的 Shell 化opt-in shelling在huge-document.tsx演示中增加查询参数控制query-param control用于 A/B 运行新增专用证明车道replacement/huge-document-islands.mjs基准修复既有广度车道slate-react-rerender-breadth-benchmark.tsx的 JSX-runtime 假设使其恢复为被保留的车道。需要说明的是上述文件路径来自文档所记录的外部源码仓库slate-v2 / plate-2。在当前 plate 仓库中与之对应的可查阅物证包括大文档演示的实现 huge-document-demo.tsx、官方示例说明 huge-document.mdx以及基准车道的注册信息 slate-v2.json其中登记了react-rerender-breadth、react-huge-document-full等车道及其运行命令。关键修复结构化 DOM 协调必须变为子集感知这是本批次中如果不修复就会静默损坏文档文本的关键点单独成篇记录在 Shell-only 大文档岛屿必须在 DOM 协调期间保留远端子树。问题根源EditableBlocks通过读取[data-slate-nodetext]节点并按快照顺序重建文本内容来从 DOM 协调。这只有在整棵可编辑树都已挂载时才成立。一旦远端岛屿变成廉价 Shell这个假设就失效了远端岛屿有意停止渲染EditableTextDOM 协调仍然只扫描已挂载的文本节点在一个活动岛屿中输入时协调游标会提前耗尽已挂载文本列表然后用空字符串填满远端 Shell 文本节点——导致一个活动岛屿的输入把远端文本全部清空。修复方案让 DOM 协调只作用于已挂载的顶层岛屿活动岛屿仍从 DOM 文本节点协调Shell 化的顶层岛屿直接从已提交快照committed snapshot拷贝协调游标只为已挂载的顶层运行时 id 消费 DOM 文本。这样 Shell 模式保持诚实渲染更少、只变更实际挂载的内容、远端子树文本被精确保留。方案文档给出的预防性结论同样值得记录任何 Shell 或遮挡层在相信性能收益之前都必须审计 DOM 协调假设整棵树已挂载这一假设在 Shell 模式下必然错误基准收益本身不够还要检查快照模型在部分挂载下是否仍然正确。三条基准车道与判读车道 1默认运行时1000 块pnpm bench:replacement:huge-document:local在 1000 块下的记录结果指标Shell 批次v2Legacyready527.95ms720.87mstype12.48ms19.85msselect-all3.59ms75mspaste34.85ms107.75ms注意 select-all 从 75ms 降到 3.59ms、paste 从 107.75ms 降到 34.85ms这组数据说明在 Shell 层未启用或处于默认状态时运行时本身并未退化。车道 2rerender 广度车道pnpm bench:react:rerender-breadth:local记录读取结果#5131宽 hookbroad hook按契约仍然宽useSlate()本就是整编辑器级响应式#3656兄弟叶子重渲染数 0#4141祖先节点重渲染数 0。广度车道方案在 Slate React rerender 广度大多已局部化useSlate 是仅剩的宽 hook 中有完整记录它把两个长期被混为一谈的故事分开——宽 hook 按设计是宽的与后代失效已经局部化。批量记录中该车道还包含更细的读数20 次选择变更产生 20 次useSlate()与useSlateSelection()重渲染、无关顶层块切片重渲染 0编辑叶子重渲染 1、兄弟叶子 0、父块 0深层编辑叶子 1、重渲染祖先 0、兄弟分支 0。车道 3Shell 证明车道10000 块pnpm bench:replacement:huge-document:islands:local在 10000 块下的记录结果ready527.86mstop typing顶部输入38.85msshell promotionShell 提升54.10msshell countShell 数量99与上一次干净的未启用 Shell 的 10000 块基线相比ready 1229.49ms、top typing 97.47ms本次 Shell 证明削减了ready 约 701.63mstop typing 约 58.62ms。批次文档的结论是That is real enough to keep.——这个收益真实到值得保留。Verdict证明了什么、没证明什么已证明Shell-only 远端岛屿可以移除真实运行时工作收益大到足以支撑继续投入局部提升local promotion足够廉价是一条可行的路径。明确未证明宽操作broad ops尚未解决Shell 支撑的选择shell-backed selection尚未解决远端 Shell 粘贴far-shell paste尚未解决。批次文档因此给出的下一步是显而易见的Proof-First 计划的 Phase 2 与 Phase 3激活路径、模型级宽操作快路径交互时提升到可编辑 DOMpromotion into editable DOM on interaction对 Shell 支撑的选区执行模型驱动的全选与粘贴。后续方向的仓库佐证该批次之后的相关方案在当前仓库中有连续记录可作为继续追踪的入口激活路径要求Shell 提升必须把选区移入被提升的岛屿否则只是表面工作见 Shell 提升必须把选区移入被提升的岛屿mousedown 时提升岛屿、在模型中选中该顶层岛屿起点、聚焦真实编辑器根并以promote then type而非只测 promote 来验证宽操作快路径要求Shell 支撑的选区在 DOM 中必须 fail closed宽操作走模型见 Shell-backed 大文档选区必须在 DOM 中 fail closed 并通过模型执行宽操作输入性能前置条件要求大文档输入需要先削减 selector fanout 再做岛屿见 大文档输入需要 selector fanout 削减粘贴性能约束要求大文档粘贴不应重渲染未变更的后代见 大文档粘贴不应重渲染未变更的后代执行批次可参考 active-corridor-promotion-batch 与 large-document-broad-ops-batch。小结Shell 证明批次的意义不在于交出一套完整的大文档层而在于用可复现的基准车道证明了方向本身远端岛屿渲染 Shell、活动走廊保持实时 DOM 真相、提升局部化是比分组包装 CSS 提示和分块叙事更值得继续投入的大文档策略。它同时把正确性问题部分挂载下的 DOM 协调与性能问题宽操作、Shell 支撑选区、远端粘贴明确分开为后续 Phase 2/3 的推进划出了清晰的边界与验收标准。【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考