企业官网建设流程全解析

编辑器架构原始语料摄入（Raw Ingest）方法论：用 Lexical、ProseMirror、Tiptap 源码证据驱动 Slate v2 read/update 运行时架构

【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate

本文是 Plate 仓库中 2026-04-23 编辑器架构原始语料摄入计划 的完整技术解读。该计划回答了一个贯穿整个编辑器架构研究的核心问题：当 Slate v2 需要重构 read/update 运行时与扩展体系时，应当从三大主流编辑器引擎（Lexical、ProseMirror、Tiptap）的原始源码中借鉴什么、拒绝什么、暂缓什么。读完本文，你将掌握这套"官方源码克隆 → 语料归一化 → 证据台账 → 编译摘要 → 架构决策"的完整研究流水线，并理解其最终产出的editor.read/editor.update公共运行时契约。

一、为什么需要"原始语料摄入"：从二手资料到一手证据

在编辑器架构设计中，最危险的做法是基于文档博客、营销宣传或他人转述来决定架构方向。本计划的核心前提是：架构结论必须建立在可核验的一手源码证据之上。为此，计划以"raw ingest（原始语料摄入）"为名，定义了一条严格的证据流水线：

1. 将三大编辑器的官方源码仓库完整克隆到本地归一化目录；
2. 为每个语料族生成 README 元数据与文件目录（catalog）；
3. 盘点已有的编译层覆盖，定位本地最强的原始命中点；
4. 基于原始源码编写面向架构的编译摘要；
5. 更新语料的 README / 索引 / 操作日志；
6. 用"证据处置台账"（evidence disposition ledger）对每个语料族做收口。

该计划的适用范围（scope）明确锁定四个语料族：Lexical、ProseMirror、Tiptap 源码、Tiptap Docs 文档。它不是泛泛的"编辑器调研"，而是一次以 Slate v2 read/update 架构决策为目标的定向取证。

二、源码真相（Source Truth）：官方来源与归一化入口

计划对每个语料族都固定了官方来源，避免使用第三方镜像或不可信副本：

这里的../raw是相对计划文档位置的约定路径，代表归一化后的本地原始语料根目录。README.md与catalog.md在每个语料族根目录下生成，作为后续编译层检索的元数据入口。源码证据台账 read-update-runtime-corpus-ledger.md 中记录了这些语料族的实际落盘结构：../raw/lexical/repo、../raw/prosemirror/repo、../raw/prosemirror/packages/*、../raw/tiptap/repo、../raw/tiptap/docs。

三、六阶段执行流水线

计划将整个摄入工作拆为六个阶段，且全部标记为完成（complete）：

1. 创建 / 刷新 raw 源码族（../raw/lexical、../raw/prosemirror、../raw/tiptap）——完成；
2. 为每个语料库生成 raw README 元数据与 catalog——完成；
3. 盘点既有编译覆盖与本地最强 raw 命中——完成；
4. 为 Lexical、ProseMirror、Tiptap 编译架构源码摘要——完成；
5. 更新源码 README / index / log 入口——完成；
6. 以证据处置台账收口每个语料族——完成。

这套阶段划分本身就是一个可复用的研究方法：摄入（ingest）→ 元数据化（metadata）→ 覆盖盘点（inventory）→ 编译（compile）→ 索引（index）→ 收口（disposition）。后续任何新语料族（如 Milkdown、Obsidian 等，见 docs/research/index.md 的扩展记录）都沿用了同一套流水线。

四、研究问题：借什么、不借什么、证据等级如何

计划在摄入开始前就锚定了三个研究问题，避免摄入过程失控发散：

• Slate v2 应该从每个架构中"偷"什么？（what to steal）
• Slate v2 明确不应该复制什么？（what not to copy）
• 哪些论断有原始源码背书（raw-backed）、哪些只有编译层背书（compiled-backed）、哪些仍属开放问题（open）？

这三个问题直接对应了后续 slate-v2-perfect-plan-steal-reject-defer-map.md 中的Steal / Reject / Defer三分法，也是每个编译摘要文档的标准骨架。证据分级则保证"未经源码确认的结论不得写成事实"这一纪律贯穿始终。

五、摄入结果：语料族落盘与生成物清单

计划的 Raw Ingest Result 记录了完整的落盘与生成物，全部完成：

创建或刷新：

• ../raw/lexical/repo
• ../raw/prosemirror/repo
• ../raw/prosemirror/packages/*
• ../raw/tiptap/repo
• ../raw/tiptap/docs

生成：

• ../raw/lexical/README.md、../raw/lexical/catalog.md
• ../raw/prosemirror/README.md、../raw/prosemirror/catalog.md
• ../raw/tiptap/README.md、../raw/tiptap/catalog.md

更新：

• ../raw/log.md（追加式摄入操作日志）

catalog 的作用是让编译层可以按文件名快速定位原始证据，而不必每次全量 grep 整个克隆仓库。

六、编译输出：架构摘要与决策文档

摄入完成后，计划把最强证据编译为一批面向架构的文档，落盘在 docs/research 的 sources 与 decisions 两个子层：

新增源码摘要（sources）：

• read-update-runtime-corpus-ledger.md——三语料族证据台账
• lexical-read-update-extension-runtime.md——Lexical read/update 与扩展运行时
• prosemirror-transaction-view-dom-runtime.md——ProseMirror 事务 / 视图 / DOM 运行时
• tiptap-extension-command-react-dx.md——Tiptap 扩展 / 命令 / React DX

新增架构决策（decisions）：

• slate-v2-read-update-runtime-architecture.md——read/update 作为公共运行时生命周期

更新：

• editor-architecture 目录 README
• docs/research/index.md
• docs/research/log.md
• slate-v2-data-model-first-react-perfect-runtime.md

这些文档在 docs/research/sources/editor-architecture/README.md 中被统称为 "editor-architecture comparison lane"（装饰/标注架构、React 19.2 性能架构、read/update 生命周期、节点/文本/mark 渲染 DX 四个子范围之一）。

七、语料处置结论：证据收口与剩余缺口

计划的 Corpus Dispositions 为每个语料族给出明确结论：

• Lexical：evidenced（已取证）——editor.update/editor.read是生命周期边界，命令监听运行在 update 上下文中，update tags 覆盖历史、粘贴、协作、滚动、DOM 选择与合成输入策略，脏叶子/脏元素在 DOM 调和前被追踪，扩展集中化配置与注册及依赖。
• ProseMirror：evidenced——编辑器状态通过应用事务更新，事务追踪文档、选择、存储 mark 与元数据，选择通过变换映射（step mappings）映射，书签是独立于文档的持久锚点，视图/输入代码持有唯一的 DOM 观察者与选择导入/导出权，装饰是一等视图数据。
• Tiptap / Tiptap Docs：evidenced——Tiptap 把 ProseMirror 包装为扩展驱动的产品级 DX，扩展拥有节点、mark、属性、命令、事件与快捷键，命令管理器围绕单一事务构建单命令与链式命令 API，React 文档明确建议用选择器订阅规避整事务重渲染。

结论：本次 read/update 架构范围不存在任何 raw 缺口（no raw gap remains），也没有编译层缺口。计划同时诚实标注了未来可能的独立取证方向：表格架构、评论/建议（comments/suggestions）、AI / 编辑器代理工具链（见 read-update-runtime-corpus-ledger.md 的 Remaining Gaps 小节）。

八、纵深：三大引擎的证据要点与"偷 / 拒 / 缓"结论

这是本计划最有工程价值的部分——每个语料族的编译摘要都给出了可执行的借鉴清单。

8.1 Lexical：read/update 生命周期与扩展依赖图

依据 lexical-read-update-extension-runtime.md，Lexical 的最强证据包括：editor.update(...)是变更编辑器状态的常规方式，editor.read(...)与editorState.read(...)是统一的读边界；update/read 闭包同步执行并携带活跃的编辑器状态上下文；命令处理器运行在 update 上下文内；update tags 携带历史、粘贴、协作、滚动、DOM 选择、焦点与合成输入策略；节点 transform 在 DOM 调和前执行；脏叶子与脏元素驱动 transform/调和工作；扩展把配置、注册、依赖声明与运行时输出捆绑在一起。

Slate v2 应借鉴：

• read/update 生命周期命名：editor.read((state) => ...)与editor.update((tx) => ...)；
• 上下文读写合法性：连贯读取归属editor.read，写入归属editor.update，从读上下文写应在开发/测试环境报错；
• 把 update tags 作为提交元数据（history-push、history-merge、paste、collaboration、skip-dom-selection、skip-scroll、composition-start、composition-end）；
• 脏节点纪律：适配为脏路径、脏运行时 id、脏顶层范围与文本/结构/选择/mark 操作类别；
• 扩展依赖图概念（扩展方法、normalizer、命令处理器、提交监听器、依赖/对等依赖、运行时输出）。

明确不复制：类式节点模型、$前缀函数命名、用 Lexical 风格 DOM 调和器取代 React 作为主渲染方案、把命令当作常规用户变更 API。

8.2 ProseMirror：事务权威与 DOM 选择纪律

依据 prosemirror-transaction-view-dom-runtime.md：编辑器状态通过应用事务更新；事务继承自 transform 并追踪文档变化、选择变化、存储 mark、滚动意图与元数据；事务选择随步骤映射累积而映射；选择暴露可在无当前文档情况下映射、稍后再解析的书签；命令接收 state、可选 dispatch 与 view；view/input 独占 DOM 事件处理、DOM observer 刷新、合成输入标志、DOM 选择导入与导出；装饰是视图数据通道而非文档内容。

Slate v2 应借鉴：事务拥有复合本地变更（文档变化、选择前后、mark 状态、元数据、滚动/UI 事件策略）；选择经操作与运行时 id 映射；保留SelectionBookmark式持久锚点模型（无需当前文档即可映射、可延后解析，服务于历史、协作、评论与审阅系统）；"DOM 桥只有一个所有者"（DOM 导入、DOM 导出/修复、合成输入模式各自单一归属，应用命令不得直接读 DOM 选择）；装饰作为映射的视图数据，用投影源与脏源失效替代渲染期decorate作为主 API。

明确不复制：整数文档位置模型、以 schema-first 内容匹配作为 Slate v2 核心身份、把 ProseMirror 风格插件复杂度暴露为常规 Plate/Slate 扩展 API、让 React 成为 ProseMirror 式视图树的包装器。

8.3 Tiptap：扩展人体工程学与 React 选择器姿态

依据 tiptap-extension-command-react-dx.md：Tiptap 的编辑器实例集中了编辑器创建、扩展、内容、可编辑性、输入规则、粘贴规则、编辑器 props 与 ProseMirror 视图装配；扩展打包节点、mark、属性、全局属性、命令、事件与键盘快捷键；自定义扩展添加的命令出现在editor.commands与editor.chain()上；CommandManager围绕单一事务构建单命令与链式命令 API；性能文档建议选择性订阅编辑器状态并禁用事务级重渲染；可组合 API 暴露编辑器上下文、加载态、气泡/浮动 UI 与选择器 hooks。

Slate v2 应借鉴：扩展人体工程学（定义扩展 → 添加扩展 → 获得方法/normalizer/处理器/UI 输出，Plate 无需在 React providers、编辑器构造与命令处理器间手工穿线）；命令可发现性（可发现的编辑器方法与扩展方法，但写生命周期仍是editor.update）；可选链式 API 作为editor.update之上的语法糖（editor.chain().setNodes(props).wrapNodes(wrapper).run()）；React 选择器姿态（选择器 hooks 消费EditorCommit脏度、紧急文本路径走 live reads、无关 React 状态不重渲染编辑器主体）；可组合 UI（provider、content、loading/ready、气泡/浮动 UI 通道、选择器 hooks、工具栏助手）。

明确不复制：把chain().focus().command().run()变成普通工具栏命令的强制仪式、把 ProseMirror 泄漏当作高级用户默认、用"把编辑器与 React 隔离"作为集成策略、用命令替代安全的 read/update 生命周期。

九、收敛为决策：editor.read/editor.update公共运行时契约

原始语料摄入的最终产出不是调研报告，而是一份被接受的架构决策 slate-v2-read-update-runtime-architecture.md。决策确立了以下公共 API 目标形态：

editor.read((state) => { state.selection.get() state.value.get() state.marks.get() }) editor.update((tx) => { tx.value.replace({ children, marks: null, selection: null, }) tx.nodes.unwrap({ match: isList }) tx.nodes.set({ type: 'list-item' }) tx.nodes.wrap({ type: 'bulleted-list', children: [] }) })

配套决策 slate-v2-state-tx-public-api-and-extension-namespaces.md 进一步收紧了命名：state只做只读工作，tx承担读写工作；tx也含读方法，因为更新内的读取必须观察"进行中的事务"而非最后一次提交快照（tx.selection.get()返回事务内最新选择，tx.nodes.get(target)读取事务文档而非陈旧编辑器状态）。扩展以命名组挂载到state/tx而非平铺到编辑器对象：

defineEditorExtension({ key: 'table', state: { table(state) { return { currentCell() {} } }, }, tx: { table(tx) { return { insertRow() {} } }, }, })

内部契约链路为：editor.update→ 激活事务 → 需要时隐式解析一次目标（tx.resolveTarget()保持内部）→ 内部写注册表在省略at时使用事务目标 → 操作 →EditorCommit→ 历史/协作/渲染/DOM 修复。被明确硬切割的公共面包括：公共可变editor.selection/editor.children/editor.marks/editor.operations、以公共Transforms.*作为主要文档/示例 API、公共editor.apply与editor.onChange扩展点、命令策略对象、ReactEditor.runCommand、按子节点数分块的运行时、为每种自定义节点类型爆炸式增长语义方法。

对于 Schema 谓词，最终形态收敛到命名空间化调用：editor.schema.isInline(element)，普通作者应优先通过defineElement({ type: 'mention', inline: true, void: 'markable-inline', selectable: true })配置而非手工覆写谓词。

十、React 运行时方向与战测门槛

决策同时划定了 React 运行时职责边界：React 消费 live reads、脏运行时 id、脏顶层范围、EditorCommit、源作用域投影脏度与直接 DOM 同步能力结果；React不拥有文档模型真相、操作/协作语义、选择导入策略与变更生命周期。

决策还设置了发布质量门槛：任何 release 级论断都必须有生成式浏览器战测（browser gauntlet）背书，断言模型树/文本、模型选择、可见 DOM、可观测处的 DOM 选择/光标、提交元数据、无非法内核迁移、后续键入稳定性。这与仓库中大量2026-04-2x系列的 slate-v2 计划文档（如 2026-04-22-slate-v2-backspace-caret-testing-plan.md）相互印证。

十一、方法论可复制性：从架构决策到更多语料族

这套 raw ingest 方法并不局限于 Lexical / ProseMirror / Tiptap。从 docs/research/index.md 可以看到，同一套流水线已经扩展到 Milkdown（源自../raw/milkdown）、Obsidian（源自../raw/obsidian）、Typora（源自../raw/typora），以及 Slate、Premirror、Pretext、edix、use-editable、rich-textarea、VS Code、TanStack DB、EditContext 等实体页。每条输入规则、自动格式化、表格、评论/建议的新研究都会先走"raw 证据 → 编译摘要 → 决策/开放问题"的闭环，而不是直接写结论。

对希望在本仓库中继续深入研究的读者，推荐按以下顺序阅读证据链：

1. 计划本身：2026-04-23-editor-architecture-raw-ingest-plan.md
2. 证据台账：read-update-runtime-corpus-ledger.md
3. 三份编译摘要：lexical-read-update-extension-runtime.md、prosemirror-transaction-view-dom-runtime.md、tiptap-extension-command-react-dx.md
4. 决策收口：slate-v2-read-update-runtime-architecture.md、slate-v2-state-tx-public-api-and-extension-namespaces.md
5. 全景地图：slate-v2-perfect-plan-steal-reject-defer-map.md、editor-architecture-landscape.md

结语

这份 raw ingest 计划展示了一种可复用的编辑器架构研究方法：先用官方克隆锁定一手事实，再用目录与台账保证证据可追溯，最后用"偷 / 拒 / 缓"三分法收敛出可执行的公共 API 决策。它最终的架构结论——editor.read与editor.update构成公共生命周期、tx持有事务内读写、扩展以命名空间挂载、React 消费脏提交而非全量快照——既吸收了三大引擎各自最强的纪律，又明确拒绝了与 Slate 数据模型和操作语义冲突的核心身份，为 Slate v2 的 read/update 运行时提供了有源码级背书的演进路线。

【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate