Slate v2 示例对等性恢复Example Parity Recovery以源码差异为第一标准的无回归迁移治理方案【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本文聚焦 Slate v2 从 legacy Slate 全量迁移过程中最容易被低估的一环示例examples层面的对等性恢复。它不是一份泛泛的测试清理清单而是一套以同路径示例源码结构与 legacy 逐行可比为验收标准的执行协议回答了替换兼容行绿了、浏览器行也绿了凭什么说示例故事还不够诚实这一核心问题。读完本文你将掌握 Slate v2 示例对等性恢复计划的完整骨架六分类法、五条工作流、git-diff 重基线审计方法以及mirrored / recovered / extended / mixed / explicit cut / open每一档分类的判定依据与当前进度。为什么示例对等性会成为无回归承诺的拦路虎在 2026-04-13-slate-v2-full-no-regression-story-plan.md 中no regression vs legacy Slate 被拆解为四类独立债务精确 legacy 文件/测试账目穷尽式 API/公共面契约宽度审计最大程度的 legacy 示例对等真实浏览器/输入行为证明。示例对等性之所以单独立项是因为它最容易看起来完成、实际上漂移。而 2026-04-15-slate-v2-example-parity-recovery-plan.md即本文主体文档明确给出了该车道的关闭标准该车道不因以下三点而关闭同路径当前示例文件、同路径当前 Playwright 示例测试、以及只覆盖示例子集的替换兼容行。它只有在全量示例表面上 legacy/current 对等性显式化之后才算关闭。换言之示例删除账目deletion closure≠ 示例对等账目parity closure同路径文件的存在本身也不构成隐式关闭证据。核心规则最大化 legacy 对等 显式标注扩展计划对示例对等提出了三条不可妥协的执行规则对仍然影响整体替换承诺blanket replacement claim的所有示例现在要求与 legacy 达到最大程度对等。当重写确实解锁了更公平的对比面时legacy 示例允许被新增或扩展但这类行必须显式标注为extended禁止用含糊的better cut语言偷渡。对同路径 legacy 示例默认恢复目标是当前运行时诚实可支持的最接近 legacy 源码结构与面向贡献者的外观chrome。这里的标准不是行为等价而是源码层面对等。行为在某处通过是不够的Behavior passes somewhere is not enough一次 scratch 重写从零重写的示例文件只有在当前独有分歧被显式记录时才不算债务。最后一条裁决原则是Git diff 定胜负如果同路径文件在源码上仍然读起来像一次重写那么即使浏览器行为行是绿的该行也必须保持open。六分类法每个示例行必须且只能落在一个桶里example-parity-matrix.mddocs/slate-v2/ledgers/example-parity-matrix.md给出了完整的判定语料。每个 legacy 示例行必须落在且仅落在以下一个分类分类判定语义mirrored当前文件与 legacy 同路径文件源码几乎逐行对应属于直接镜像recovered曾经漂移现已恢复到接近 legacy 的源码形态且有对应行为证明extended重写解锁了更公平对比面legacy 示例被显式新增/扩展扩展理由必须记录mixed外壳接近但关键行为/交互证明仍然偏窄一个 legacy 文件可拆出多个子声明explicit cut该示例不再属于被保留的替换承诺必须给出显式裁剪理由open源码 diff 仍读起来像重写即使浏览器行为行是绿的也不关闭配套的源码优先判定顺序是先看源码 diff文件读起来像 close legacy port → 可判recovered外壳接近但行为证明偏窄 →mixeddiff 中仍是重写 →open即使浏览器行绿。运行时证明可以确认一个源码接近的行但救不了一个源码漂移的行。五条工作流从清单到控制文档闭环计划将恢复工作组织为五条工作流1. Legacy 示例清单Inventory盘点 legacy TS 示例表面盘点 legacy Playwright 示例测试将它们映射到当前示例与证明负责人。2. 镜像 vs 扩展决策Mirror vs Extend默认镜像default to mirror仅当重写明显解锁了更清晰的对比时才扩展每次扩展都必须记录理由。3. 证明所有权Proof Ownership尽可能直接浏览器证明诚实处使用替换兼容证明示例真正属于基准benchmark所有者时由基准负责人接管示例不再属于被保留承诺时给出显式裁剪理由。4. 控制文档同步Control-Doc Sync路线图master roadmap结论release readiness decision证明台账proof ledger发布文件审查台账release file review ledger维护者漂移登记maintainer drift register。5. 源码/UI 恢复默认Source/UI Recovery Default对同路径示例做legacy 源码接近度审计而不仅是行为证明审计对有证明但面向贡献者的示例已漂移的行重新打开reopen优先从 legacy 示例源码恢复保留重写必须给出显式理由。当前进度三个恢复批次与源码/DOM 审计计划文档详细记录了截至 2026-04-15 的执行进度第一批已落地在replacement-compatibility.test.ts中新增替换search-highlighting对等行替换code-highlighting对等行跨仓库定向证明legacy replacement均为绿。第二批已落地在replacement-compatibility.test.ts中新增替换inlines、richtext、custom-placeholder对等行跨仓库定向证明legacy replacement均为绿。第三批结果android-tests恢复为显式extended行当前页面同时承载 legacy 手动用例选择器与新版 IME hub 链接check-lists恢复为带直接 legacy/current 对等行的recovered行huge-document改为显式 benchmark-owned 对等行不再是无主缺口scroll-into-view仍为open当前行绿但在公平的 legacy 扩展尝试后legacy 内层容器滚动行为镜像仍红定向证明已绿legacy replacementandroid-tests、legacy replacementcheck-lists。2026-04-15 源码 DOM 审计结论更宽松的运行时/DOM 审计对源码优先标准而言仍过于慷慨git-diff 重基线使比早期审计更多的行失效custom-placeholder、forced-layout、markdown-preview、markdown-shortcuts、plaintext、read-only、shadow-dom、styling、tablescode-highlighting是最清晰的一档硬open行源码相似度仅0.062一些行在实际移植后合法地接近源码check-lists、embeds、hovering-toolbar、iframe、inlines、mentions部分行源码接近但证明未完全关闭editable-voids、images、paste-html、richtext。延续批次continuation batch关键发现slate-react导出类型审计未发现超出既有显式裁剪的新 legacy barrel 遗漏既有裁剪RenderChunkProps、NODE_TO_INDEX、NODE_TO_PARENT但审计暴露了一个真实的当前公共类型回归EditableTextBlocksProps仍在将原生 textarea 的placeholder?: string与当前自定义的placeholder?: ReactNode求交导致custom-placeholder/placeholder-surface中的 JSX placeholder 宿主在重新省略继承的原生placeholder键之前类型错误forced-layout恢复源码接近恢复了文件内 legacy 布局归一化器、legacy 文案与直接的标题/段落外壳当前定向证明绿初始标题段落外壳、全删恢复search-highlighting恢复源码接近恢复 legacy search/decorate 流程、Slate包装器与面向贡献者的输入外壳剩余强制漂移为当前projectionStorerenderSegment接线取代 legacydecoraterenderLeaf当前定向证明绿输入text产生两个高亮匹配。用数据说话git-diff 重基线后的源码差异统计example-parity-matrix.md 保存了 2026-04-15 重基线的逐文件配对统计这是判断源码接近的量化依据示例相似度Legacy 行数当前行数差异行数台账结果mentions0.970746747233recoverediframe0.917183182117recoveredrichtext0.874328349225recoveredcheck-lists0.861198203122recoveredhovering-toolbar0.856178157135recoveredinlines0.850454432334recoveredpaste-html0.820305294233recoveredembeds0.763160168122recoveredimages0.699222224192recoverededitable-voids0.568166168194recoveredstyling0.3844768103openplaintext0.322243442recoveredread-only0.301253542recoveredcustom-placeholder0.234366177recoveredscroll-into-view0.232136116194opensearch-highlighting0.170141197278recoveredshadow-dom0.120485886openmarkdown-shortcuts0.086247287440openmarkdown-preview0.082138182286opencode-highlighting0.062473277674openforced-layout0.043121151240recoveredtables0.036215145270openhuge-document0.02110405741492explicit cutandroid-tests0.732266281209extended值得注意的解读forced-layout相似度只有0.043却判为recovered因为它是在重基线后由延续批次恢复了 legacy 源码流程与删除证明后升级的——相似度是快照分类是持续审计的结果。相反tables相似度0.036且仍是重写因此保持open。这说明该体系以当前源码是否贴近 legacy为裁决标准而不单纯看相似度数字。台账为什么过去漏掉了真实漂移example-parity-matrix.md自述了旧台账的四个缺陷这正是本计划要纠正的方法论问题一旦存在任何 current legacy 证明行就被提升为 paired parity row标准过宽replacement-compatibility主要证明的是窄行为接缝tokenization、selection、typing而不是面向贡献者的源码形态或控制面control surface对等矩阵缺少显式的源码/UI 对等读取scratch 重写可以躲在绿色行为行后面同路径当前文件被当作环境性关闭而不是用更严格的标准约束最接近的诚实 legacy 源码形态。与整体无回归叙事的关系对等性只是其中一块从 true-slate-rc-proof-ledger.md 和 release-readiness-decision.md 可以确认该计划的定位绿色 harness 行、窄浏览器证明、源码接近度、同路径示例单独任何一项都不能关闭整体 claim width 或对等性。同时Parity alone is not enough——迁移项目还必须保留 v2 的存续理由read/update 生命周期与 primitive-method DX、最佳 React 运行时局部性、显式 decoration/annotation/widget 架构、优于 legacy 的大文档姿态、以及为 cursor/caret 声明服务的生成式浏览器 gauntlet。因此示例对等性恢复不是孤立的车道它和 API 契约宽度审计见 ledgers 下的slate-editor-api.md等审计矩阵、浏览器/输入证明true-slate-rc-proof-ledger.md、以及最终 verdict 对账release-readiness-decision.md共同构成 no-regression 的完整叙事。下一批恢复重点与退出标准example-parity-matrix.md给出了 git-diff 失效后的最高信号恢复顺序先恢复仍是全量重写的行code-highlighting、markdown-preview、markdown-shortcuts、tables恢复其余实质重写的同路径行shadow-dom、styling收尾所有open行code-highlighting、custom-placeholder、markdown-preview、markdown-shortcuts、scroll-into-view、shadow-dom、styling、tables收尾已打开的对等行scroll-into-view将 current-only 重写解锁分类为extended/mixed/explicit cut/open。计划的退出标准Exit共五条每个 legacy 示例行都已分类每次扩展都是显式且有理由的同路径当前文件不再被视为隐式对等关闭控制文档停止假装删除关闭示例对等同路径恢复要么保持接近 legacy 源码要么记录不接近的理由。配套的计数基线来自 example-parity-matrix.mdlegacy TS 示例表面24个、当前 TS 示例表面61个、legacy Playwright 示例测试23个、当前 Playwright 示例测试61个。Legacy Playwright 漂移方面select.test.ts的三击段落选择意图被显式收归当前richtext浏览器接缝recoveredhuge-document.test.ts因断言旧分块内部实现而被显式裁剪行为所有权移交基准车道与large-document-runtime浏览器行explicit cut。实践启示如何把示例对等做成可审计的工程标准从这份计划可以提炼出可迁移到其他富文本/编辑器迁移项目的工程原则同路径文件不是证明文件存在只说明目录结构对齐了不代表源码形态对齐行为绿不能豁免源码漂移先把 git diff 读成像移植还是像重写再决定是否关闭行扩展必须显式任何我们做得更好了都必须落到extended标签 理由而不是含糊的营销措辞控制文档要互相咬合路线图、verdict、proof ledger、release file review ledger、drift register 必须说同一件事防止证明台账与结论文档各说各话给漂移留出显式出口explicit cut是诚实的收尾方式huge-document与android-tests分别示范了裁剪理由与扩展理由两种显式标注。对于关注 Slate v2 迁移质量的读者建议按以下顺序深读仓库内文档本文主体 2026-04-15-slate-v2-example-parity-recovery-plan.md → 台账 example-parity-matrix.md → legacy 测试清单 legacy-playwright-example-tests.md → 证明台账 true-slate-rc-proof-ledger.md → 发布结论 release-readiness-decision.md。这套文档链本身就是示例对等性如何参与一个严肃迁移项目的 claim-width 治理的完整案例。【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考