Plate 仓库 slate-v2 的 withReact 恢复路径研究Android pending-selection 兼容分支与文档取证方法【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate导读本文基于仓库内 2026-04-16-withreact-recovery.findings.md 这份研究结论文档结合packages/slate-react、packages/slate、packages/core的实际源码与相关计划文档完整梳理withReact在 slate-v2 重写中的真实恢复路径。读完本文你将掌握为什么恢复withReact不等于简单补回一个withDOM(...)辅助函数Android 输入管理器下 pending-selectioninsertText兼容分支在withReact恢复中的真实地位以及仓库中同路径 legacy diff 当前文档取证这一恢复方法论如何落地。本文中引用的packages/slate-react相关计划文件位于 docs/plans 目录恢复工作的执行记录见 2026-04-16-withreact-recovery.progress.md。一、研究结论概览三条 Findings 及其意义2026-04-16-withreact-recovery.findings.md 全文共三条核心结论它们共同决定了withReact恢复工作的边界当前 slate-v2 没有withDOM(...)辅助函数可用于恢复进withReact真正的同路径恢复目标是 Android pending-selection 的insertText兼容分支。Legacy 与当前的 Android 输入管理器代码实质相同因此输入管理器存在这一事实本身并不能替代被删除的withReact分支。分块chunking在 chunking-review.md 中已被明确标记为历史遗留所以getChunkSize/movedNodeKeys在本仓库中不是活跃的恢复目标。这三条结论直接划定了后续with-react.ts补丁见 2026-04-16-withreact-recovery.progress.md的取证范围既不能靠虚构withDOM接口也不能靠搬回 chunking 历史实现唯一诚实的目标是 Android 输入路径上那个被删除的兼容分支。二、为什么不能靠withDOM(...)恢复withReact2.1 从源码结构看 DOM 层的真实导出在当前仓库中slate-dom的导出被收口在 packages/slate/src/slate-dom.ts。该文件确实导出了withDOM见packages/slate/src/slate-dom.ts第 43 行export { applyStringDiff, CAN_USE_DOM, // ... 其他 DOM 辅助工具 withDOM, } from slate-dom;但这里的关键是slate-dom.ts是一个转发桶re-export barrel它只说明slate-dom包中存在withDOM这个名字。Findings 第一条所指的没有可用来恢复进withReact的withDOM(...)辅助函数指的是在 slate-v2 的slate-react侧并不存在把withDOM组合进 React 编辑器的既有接线代码——也就是说withDOM与 React 渲染桥mounted bridge之间没有现成的构造路径可走。2.2withReact在当前slate-react中的定位从 2026-04-09-slate-v2-slate-react-surface-recovery.md 的结果描述可以确认withReact在早期批次中已经被恢复为一种兼容性构造辅助函数restoredwithReactas a compatibility construction helper that records the current clipboard fragment format key without wrapping the editor instance这意味着当前仓库对withReact的定位是记录剪贴板 fragment 格式键的构造辅助函数而不是像 legacy 那样对编辑器实例做整体包裹wrap。因此恢复工作不能回到把整个 DOM 插件栈包进编辑器的旧模型而只能在当前 React DOM 桥能真正证明prove的接缝处补回缺口。在packages/core侧withReact的消费方式也印证了这一点withPlateReact.ts 中withPlateReact只是把withReact(editor)作为扩展函数调用而其导入来源是 slate-react.ts 第 18 行的export { withReact, useSlateStatic } from slate-react;。也就是说withReact是slate-react公共表面上被udecode/plate-core/react再导出的兼容名packages/core/CHANGELOG.md也记录了从slate-react迁移到udecode/plate-core/react的导入路径变更。2.3 结论因此 Findings 第一条的工程含义是恢复工作不能造一个withDOM组合层而必须在with-react.ts原路径上针对真实存在的缺口做最小补丁。这正对应 2026-04-16-withreact-recovery.md 中同路径 legacy diff 和当前文档取证same-path legacy diff and current-doc proof的目标设定。三、真正的恢复目标Android pending-selectioninsertText兼容分支3.1 为什么这个分支是同路径目标Findings 第一条明确指认真实的同路径恢复目标是Android pending-selection 的insertText兼容分支。其背景是 Android 输入体系尤其是 IME 组合输入与软键盘在处理文本插入时会出现待定选区pending selection状态——选区在 DOM 中尚未就位但文本已经需要被插入。legacyslate-react的withReact中有一段针对该状态的兼容处理负责在 Android 上把输入文本正确落到 Slate 模型而 slate-v2 重写过程中这段分支随旧with-react.ts被删除。3.2 第二条 Findings 的取证意义Findings 第二条指出legacy 与当前 Android 输入管理器代码实质相同materially the same。这句话堵住了一个常见的偷懒恢复路径——即既然 Android 输入管理器还在那withReact里的分支就不需要恢复。从取证逻辑看这是对代码存在 ≠ 行为等价的严格区分输入管理器input manager是运行时组件它仍然存在且被使用但withReact中被删除的分支是编辑器构造时的行为接线。两者虽然都服务于 Android 输入但处于不同的代码路径前者的存在不能证明后者已被覆盖。因此恢复工作的验收标准必须落在补丁后的with-react.ts重新包含该兼容分支而不是输入管理器还在所以没问题。3.3 恢复工作的实际落地执行记录 2026-04-16-withreact-recovery.progress.md 给出了恢复工作的完整动作打开 skill 指导对 legacy/current 两版with-react.ts做 diff阅读本地 learnings/docs排除虚构 chunking 恢复和不存在的withDOM恢复补丁packages/slate-react/src/plugin/with-react.ts恢复 Android pending-selection 兼容分支新增聚焦测试packages/slate-react/test/with-react-contract.tsx验证新测试通过更广的react-editor-contract.tsx与包级 typecheck 被既有的无关符号setSimpleTextDomSelection、isRedoHotkey、isUndoHotkey阻塞。这一执行记录说明Findings 文档的每条结论都直接转化为具体动作第一条决定补丁位置第二条决定补丁的验收口径第三条决定不做什么不做 chunking 恢复。四、为什么 chunking 不是恢复目标历史文档取证4.1chunking-review.md的明确表态Findings 第三条引用 docs/slate-v2/references/chunking-review.md。该文档在开头就写明Historical/reference doc. Chunking is not a live remaining-work lane.并在正文中给出两个关键判断子节点数量分块child-count chunking只是 legacy 对比基线不是设计约束如果巨型文档工作重新开启应该以语义岛semantic islands/ 活跃走廊active corridor/ 遮挡优先occlusion-first的模型来推进而不是复活数值型分块 API。4.2getChunkSize/movedNodeKeys为何被排除历史上legacyslate-react的分块树通过editor.getChunkSize(...)显式开启把节点的子节点拆成嵌套的 memo 化分块组件仅在子节点全为块级元素时有效还被推荐作为content-visibility: auto的载体详见 chunking-review.md。由于该机制已在文档层面被判定为仅 legacygetChunkSize、movedNodeKeys等符号自然不在withReact恢复的候选范围内——恢复它们是重新引入被否决的运行时模型而不是补回被删除的兼容面。五、恢复方法论same-path legacy diff 与 current-doc proof将 2026-04-16-withreact-recovery.md 的目标与 2026-04-16-withreact-recovery.findings.md、2026-04-16-withreact-recovery.progress.md 对照可以还原出这套恢复方法论的完整闭环读文档与当前属主learnings/docs current owners先确认哪些符号是活跃的、哪些已被文档否决同路径 legacy diff对 legacy 与 current 的with-react.ts逐段比对找出被删除但行为仍被依赖的分支即 Android pending-selectioninsertText兼容分支当前文档取证current-doc proof用当前仓库的权威文档如 chunking-review.md、slate-react-surface-recovery.md验证恢复目标的真实性排除代码存在即等价与虚构接口两类错误路径最小补丁 聚焦测试补丁with-react.ts新增with-react-contract.tsx契约测试并验证通过记录阻塞项把与本次恢复无关的既有阻塞符号setSimpleTextDomSelection、isRedoHotkey、isUndoHotkey显式留档避免误判为本次回归。这套流程与该仓库一贯的诚实取证、不伪造兼容面原则一致只恢复能被当前 React DOM 桥证明的接缝对 legacy 面过宽的部分宁可裁剪文档中的过度声明也不在代码里撒谎见 slate-react-surface-recovery.md 的 Notes 一节。六、可继续深入的相关文件恢复执行记录2026-04-16-withreact-recovery.progress.md恢复目标计划2026-04-16-withreact-recovery.md分块历史审查判定 chunking 为 legacychunking-review.mdslate-react公共面早期恢复withReact定位为兼容构造辅助函数2026-04-09-slate-v2-slate-react-surface-recovery.mdwithReact在plate-core侧的接线与再导出withPlateReact.ts、slate-react.tsslate-dom导出桶确认withDOM存在但无 React 组合路径slate-dom.ts【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考