Slate v2 全量发布回归审计如何把删除即完成改造成门禁即事实的发布工程【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本文以 docs/plans/2026-04-07-slate-v2-full-release-regression-audit-plan.md 为主体结合当前仓库的packages/slate源码结构、docs/slate-v2决策文档与benchmarks/targets基准产物讲解 Slate v2plate 仓库中的新一代事务型富文本内核在替换 legacy Slate这一目标上如何通过全量回归审计、删除表面盘点、发布门禁重建与声明纪律把发布姿态从看起来完成了推进到每一个断言都有对应证明。导读本篇技术指南围绕 Slate v2 的全量发布回归审计计划展开它回答一个非常实际的问题——当一次大重构删除了上千个历史测试与源码文件之后凭什么声称可以替换旧版文章会给出该计划的七大工作流、1239 条删除路径的处置方法、发布门禁的完整构成、Target B 翻绿的六项验收标准以及可直接复现的审计命令读完你可以把这套删除表面盘点 → 逐桶处置 → 门禁强制 → 声明收窄的方法论直接迁移到自己的大型重构发布流程中。一、审计动机为什么删除即完成站不住脚这份审计计划的开篇立场非常直接Slate v2 的目标是让目标仓库文档中记为/Users/zbeyens/git/slate-v2对应审计时正在进行的全新分支达到诚实的生产发布姿态以替换 legacy Slate。计划毫不回避地指出三个难听的事实battle-tested久经战场考验这一说法不成立——因为旧证明体系中有大块内容是在没有明确替代品的情况下被直接删除的字面意义上的零回归风险是幻想真正可兑现的门槛只有四条已声明覆盖的功能族family内没有已知行为回归没有任何被删除的证明表面proof surface处于未分诊状态没有超出门禁套件gated suite实际验证范围的发布声明没有比已测量车道measured lanes更宽的性能声明。这四条构成了全文的总纲发布声明的宽度必须等于证明的宽度。任何我删了旧测试但新测试还没补上先发布再说的路径都不被这份计划接受。二、当前判定Target B 今天还不能翻绿计划给出的当前判定是Target B: Go尚不诚实原因有四点历史回归语料仍远大于重建后的 oracle 表面——旧版有上千个测试文件重建的契约测试只是其中一小部分贡献者可见面的恢复虽然关闭但加宽后的功能族证明深度仍落后于笼统声明公共/包级声明仍然窄于完全替换 legacy Slate性能证据仍是逐车道lane-by-lane的且当前结果参差不齐mixed。与此同时早前审计草案中暴露的问题里有一部分已经关闭贡献者可见槽位恢复contributor-facing slot recoveryandroid-tests、check-lists、code-highlighting、custom-placeholder、inlines、search-highlighting、slate-hyperscript七个槽位均已恢复实时文档不再指向已删除的贡献者槽位根替换命令图replacement command graph已恢复包括替换兼容性命令、替换基准命令、slate-browser根证明命令根tsconfig.json不再指向已删除的*-v2包路径。这些已关闭清单很重要它说明审计不是停留在批判层面而是边审计边把能修复的洞补上。当前仓库中 docs/slate-v2/release-readiness-decision.md2026-04-18 更新延续了这一立场判定依然是Not release-ready并把主阻塞点收窄为最终同轮same-turn集成/构建/类型/检查/性能闭合。三、七大有序工作流从声明纪律到性能复审审计计划把全部工作组织为七个按顺序执行的工作流每一节都包含状态Status、当前读法Current read、退出条件Exit condition。3.1 Claim Discipline声明纪律——已完结核心问题发布文档与 README 说的必须与真实能力一致不能假装全面替换。当前读法实时判定文档保持Target B: No-Go实时文档以诚实口径描述加宽后的当前功能族表面不再假装整体替换。相关文件已转换为仓库相对路径docs/slate-v2/overview.mddocs/slate-v2/release-readiness-decision.mddocs/slate-v2/replacement-gates-scoreboard.md各包的 README如 packages/slate/README.md退出条件保持现状直到下面列出的其余阻塞项真正关闭。这一节的工程价值在于文档不撒谎本身就是一个可追踪的工作流。当前仓库的 docs/slate-v2/replacement-gates-scoreboard.md 就是这套纪律的产物——它用一张表格逐行记录每个 tranche 门禁的状态、当前 owner、证明命令并写下三条硬规则一个门禁不会因为旁边的证明是绿的而变绿一个门禁不会因为有草稿价值而变绿一个门禁只有在所属 tranche 诚实退出时才变绿。3.2 Contributor-Facing Concept Recovery贡献者可见概念恢复——首轮已关闭核心问题重构中删除的贡献者可见概念比如某个示例、某个测试入口必须落到一个最近的当前概念槽位否则贡献者会面对死链接或凭空消失的功能。当前读法当前恢复批次seven-slot matrix中的每个被删除贡献者概念现在都有一个当前概念槽位current conceptual slot一个证明 owner一个文档 owner。该工作流不再阻塞第一轮恢复而是作为后续删除的规则留存以后删除概念必须先落到槽位而不是一个活跃的缺失槽位队列。3.3 Rebuild The Real Release Gate重建真实发布门禁——命令图已恢复核心问题发布路径必须运行发布声明所依赖的证明而不是在发布时绕开测试。当前状态目标 clone 的根package.json中恢复了如下脚本族test:replacement:compat:localtest:replacement:gate:localtest:slate-browser:*bench:replacement:*并且prerelease现在会依次经过yarn build:rollupyarn test:replacement:gate:localyarn lint:release仍然待办同轮绿色发布证据same-turn green release evidence维护者需要能一句话解释为什么lint:release是发布检查下限而不是噪音较大的全仓yarn lint。要求的门禁发布栈Required gated release stackyarn test:mochayarn workspace slate-react run testyarn workspace slate-dom testyarn test:replacement:compat:local或 CI 安全等价命令所有已声明功能族的浏览器车道已测量的基准车道退出条件一条发布命令强制执行文档所依赖的同一套证明栈且维护者能不假思索地解释这条命令。说明yarn test:replacement:gate:local等命令定义在审计文档所指的 slate-v2 目标 clone 中当前 plate 仓库根 package.json 采用 pnpm Bun Turbo 的工具链对应的基准门禁命令以bench:*前缀呈现例如bench:core:huge-document:compare:local、bench:react:huge-document:legacy-compare:local其产物与证据元数据记录在 benchmarks/targets/history/slate-v2-latest.json。3.4 Rebuild The Package Regression Oracle重建包级回归预言机——进行中核心问题被删除的历史包级测试必须逐功能族分诊不能让一个微小的契约壳假装替换庞大的旧语料库。当前读法snapshot-contract.ts已镜像77 行 legacy oracle rows覆盖moveEditor.beforeEditor.afterselectsetPointdeselectwrapNodesunwrapNodesliftNodesdelete计划承认这是真实的进展但与旧语料相比仍然很小。对照当前仓库 packages/slate/src 的源码结构可以看到这些能力确实存在于实现中transforms/目录下有moveNodes.ts、select.ts、setPoint.ts、deselect.ts、wrapNodes.ts、unwrapNodes.ts、liftNodes.ts、deleteText.ts等实现且多数带同目录.spec.tsx测试如 packages/slate/src/transforms/wrapNodes.spec.tsx、packages/slate/src/transforms/setPoint.spec.tsxinternal/editor/下保留了getPointBefore.ts、getRange.ts、last.ts、next.ts、parent.ts、previous.ts、unhangRange.ts等一批带.spec.tsx的方法级测试interfaces/editor/下同时保留editor-api.ts与legacy-editor.ts与审计计划新 API 与 legacy 兼容面并存、但 legacy 只保留仍值得保留的部分的路线一致。对每个被删除的包测试桶要求做三分类mirrored now现已镜像supportable next下一步可支撑explicit skip显式跳过。退出条件包测试收缩要么被解释清楚要么被重建要么被显式地从范围内切除——不允许既没解释也没重建地悬着。3.5 Rebuild Direct Browser Proof For Deleted Family Lanes重建被删除功能族的直接浏览器证明——进行中核心问题replacement-compatibility.test.ts有用但它不能完全替代针对当前功能族的直接浏览器证明。当前读法当前功能族浏览器证明已存在richtext、markdown、forced-layout、styling、hovering-toolbar、editable-voids、images、embeds、tables、scroll-into-view被删除的直接车道如iframe、plaintext、read-only、shadow-dom、select现在被显式映射而不是静默消失。被删除的浏览器车道必须二选一恢复为直接的当前功能族车道显式移入仅对比comparison-only/范围外out-of-scope。退出条件没有任何被删除的浏览器车道停留在悬而未决状态。3.6 Re-Audit Public Package Scope Deletions重新审计公共包范围删除——进行中核心问题包移除与公共表面删除属于发布范围决策不是内部清理必须逐项给出结论。已关闭的决策slate-hyperscript作为活跃包槽位恢复根 Mocha smoke 证明已补旧 fixture 语料留在发布门槛之外根tsconfig.json移除过期的*-v2包引用根命令图替换与slate-browser命令恢复Rollup / React 19 互操作react/jsx-runtime命名导出处理恢复slate-browser包集成根 workspace 依赖恢复包级 Node 类型声明补齐。仍需审计packages/slate/src/**packages/slate-react/src/**packages/slate-dom/src/**退出条件每个公共/包级删除要么恢复、要么被替换、要么被显式切出发布承诺。3.7 Only Then Revisit Perf最后才回到性能核心问题当前测出的单个 richtext 回归不是主要阻塞点在行为与证明欠债关闭之前性能措辞必须保持狭窄。保持原样的已测车道placeholderhuge-document1000-blockrichtext blockquote togglemarkdown blockquote shortcuteditable-void insertx5table cell edit退出条件先关闭行为/测试回归性能语言仍然只匹配已测车道。这条顺序原则值得强调性能数字只有在行为正确的前提下才有意义。这也解释了为什么计划把性能放在第七位而不是第一位。四、贡献者可见概念矩阵七槽位恢复的脊柱这份矩阵是概念恢复的脊柱——Target B翻绿之前每个被删除的贡献者可见概念都必须落到一个最近的当前概念槽位。完整矩阵如下Legacy 概念当前状态最近的当前概念槽位证明 owner文档 owner备注android-tests已恢复android-tests当前中心指向 IME/移动输入车道android-tests.test.tsdocs/general/contributing.md、实时文档恢复为贡献者可见的 IME 测试中心check-lists已恢复check-lists当前交互式清单槽位check-lists.test.ts示例文档 替换文档在当前的EditableBlocks接缝上恢复code-highlighting已恢复code-highlighting当前可编辑 token 高亮槽位code-highlighting.test.ts示例文档 替换文档在当前 projection 接缝上恢复custom-placeholder已恢复custom-placeholder当前占位符接缝槽位placeholder.test.ts示例文档 替换文档当前接缝用placeholderprop而非旧的renderPlaceholder接缝inlines已恢复inlines当前槽位由links及内联族表面支撑inlines.test.ts根/示例文档 替换文档当前槽位比旧的单体示例更窄search-highlighting已恢复search-highlighting当前槽位由当前高亮投影支撑search-highlighting.test.ts示例文档 替换文档当前槽位使用投影驱动高亮slate-hyperscript已恢复slate-hyperscript包槽位带当前 smoke 证明根 mocha 车道 包 smoke文档 包声明旧 fixture 语料留在发布门槛之外这张表的用途不只是记录恢复更是未来的删除协议任何新的概念删除都必须先找到它的最近的当前概念槽位否则不允许删除。五、发布门禁清单Release-Gate Manifest这是恢复期间对当前替换声明所要求的本地证明栈规范命令yarn test:replacement:gate:local清单成员yarn testyarn test:replacement:compat:local当前浏览器车道android-testscheck-listscode-highlightinginlinescustom-placeholdersearch-highlightingrichtextmarkdown-shortcutsmarkdown-previewforced-layoutstylinghovering-toolbareditable-voidsimagesembedstablesscroll-into-view基准车道placeholderhuge-documentrichtextmarkdowneditable-voidstables开放缺口Open gap清单存在并已接入根命令但真正重要的是加宽功能族声明背后证明的深度与真实性而不是命令名是否存在。这一句点出了审计计划的方法论核心门禁脚本只是形式脚本背后每一条断言是否有真实证明才是实质。六、删除表面全量清单1239 条路径的处置分区这份清单是审计计划的账本。所有计数来自命令cd /Users/zbeyens/git/slate-v2 git diff --diff-filterD --name-only计划定义了四个处置桶disposition bucketsblocked-restore-or-cut直接影响发布声明、仍需要显式决策的删除表面closed-by-note之后由实时证明 专门关闭说明协调的删除表面internal-rewrite-audit可能没问题、但仍需导出/API 审计的删除源码表面release-doc-noise本身不阻塞声明的删除文档。全部删除路径的精确分组删除路径数量处置桶packages/slate/test/interfaces/**576blocked-restore-or-cutpackages/slate/test/transforms/**408blocked-restore-or-cutpackages/slate/test/operations/**31blocked-restore-or-cutpackages/slate/test/normalization/**20blocked-restore-or-cutpackages/slate/test/utils/**11blocked-restore-or-cutpackages/slate/test/index.js1blocked-restore-or-cutpackages/slate/test/jsx.d.ts1blocked-restore-or-cutpackages/slate-react/test/**8blocked-restore-or-cutpackages/slate-history/test/**17closed-by-noteplaywright/integration/examples/**2closed-by-notesite/examples/ts/**1closed-by-notepackages/slate-dom/src/**13internal-rewrite-auditpackages/slate-react/src/**30internal-rewrite-auditpackages/slate/src/**116internal-rewrite-auditpackages/slate-dom/CHANGELOG.md1release-doc-noisepackages/slate-history/CHANGELOG.md1release-doc-noisepackages/slate-react/CHANGELOG.md1release-doc-noisepackages/slate/CHANGELOG.md1release-doc-noise分组总计1239 条删除路径0 条未匹配路径。也就是说每一条删除都被纳入了某个处置桶——这正是没有删除证明表面处于未分诊状态这条发布门槛的可验证体现。6.1 A 类被删除的包测试表面packages/slate/test删除1048 条精确桶划分interfaces/**— 576transforms/**— 408operations/**— 31normalization/**— 20utils/**— 11index.js、jsx.d.ts各 1发布动作在声称完全替换置信度之前必须重建或显式切除每个功能族。packages/slate-react/test删除8 条精确文件chunking.spec.tsdecorations.spec.tsxeditable.spec.tsxreact-editor.spec.tsxtsconfig.jsonuse-selected.spec.tsxuse-slate-selector.spec.tsxuse-slate.spec.tsx发布动作为每个删除的接缝重建直接运行时覆盖或从声明中切除。packages/slate-history/test删除17 条状态为 closed-by-note由 docs/plans/2026-04-09-slate-v2-slate-history-deleted-test-family-closure.md 对照实时history-contract.ts证明表面关闭。精确文件包括isHistory/after-edit.js、isHistory/after-redo.js、isHistory/after-undo.js、isHistory/before-edit.js、undo/delete_backward/block-join-reverse.tsx、undo/insert_break/basic.tsx、undo/insert_fragment/basic.tsx、undo/insert_text/basic.tsx等 15 个测试文件外加index.js与jsx.d.ts。发布动作按专门关闭说明保持该测试族关闭slate-history包删除工作已完全关闭依据是 docs/plans/2026-04-09-slate-v2-slate-history-deleted-test-family-closure.md 与 docs/plans/2026-04-09-slate-v2-slate-history-package-residue-closure.md。6.2 B 类被删除的浏览器证明表面Playwright 示例测试删除2 条closed-by-note依据 docs/plans/2026-04-09-slate-v2-playwright-integration-examples-deleted-family-closure.md 对照当前浏览器证明栈关闭playwright/integration/examples/huge-document.test.tsplaywright/integration/examples/select.test.ts当前映射select在直接当前 richtext 浏览器接缝上恢复huge-document是显式更优切割由冻结的基准车道持有。这一点在当前仓库的基准产物中可得到印证——benchmarks/targets/history/slate-v2-latest.json 记录了core-huge-document-compare、react-huge-document-full、react-huge-document-browser-trace等车道及其问题描述、运行命令与证据产物路径。6.3 C 类被删除的示例表面TypeScript 示例删除1 条site/examples/ts/custom-types.d.tsclosed-by-note依据 docs/plans/2026-04-09-slate-v2-site-examples-ts-custom-types-closure.md——在当前结构化类型契约下显式跳过。JavaScript 示例删除0 条site/examples/js/**下无剩余删除路径。发布动作示例/浏览器族按专门关闭说明保持关闭示例表面恢复实质完成。6.4 D 类与被移除表面绑定的贡献者文档漂移已发现的精确漂移docs/general/contributing.md引用了playwright/integration/examples/check-lists.test.ts与/examples/android-testssite/examples/Readme.md仍写着replacement-candidate仍把Rich Inline当作替换候选锚点。发布动作贡献者文档已重新定向到恢复后的当前表面剩余维护工作是记录漂移而非寻找死链。6.5 E 类被删除的公共包表面整包移除早期审计快照packages/slate-hyperscript/**共 39 条删除路径包括CHANGELOG.md、Readme.md、package.json、src/creators.ts、src/hyperscript.ts、src/index.ts、src/tokens.ts以及test/fixtures/下 30 余个*.tsxfixturecursor-across-element.tsx、element-nested-string.tsx、fragment-string.tsx、text-full.tsx等、test/index.js、test/jsx.d.ts、tsconfig.json。发布动作已解决slate-hyperscript作为活跃包槽位恢复README/文档引用恢复根 Mocha smoke 证明覆盖该贡献者可见包槽位旧 fixture 语料留在发布门槛之外。早期审计快照中的大型源码表面删除精确桶划分packages/slate/src/editor/**— 56packages/slate/src/interfaces/**— 19packages/slate/src/transforms-node/**— 11packages/slate/src/utils/**— 9packages/slate/src/core/**— 8packages/slate/src/transforms-selection/**— 7packages/slate/src/types/**— 3packages/slate/src/transforms-text/**— 3packages/slate-react/src/hooks/**— 16packages/slate-react/src/components/**— 7packages/slate-react/src/chunking/**— 6packages/slate-react/src/plugin/**— 2packages/slate-react/src/utils/environment.ts、custom-types.ts、types/direction.d.ts— 3packages/slate-dom/src/utils/**— 10packages/slate-dom/src/plugin/**— 2packages/slate-dom/src/custom-types.ts— 1发布动作对照三个维度逐桶审计公共导出public exports、被替换的证明replaced proof、文档承诺docs promise。6.6 F 类被删除的 CHANGELOG 文件精确文件packages/slate/CHANGELOG.md、packages/slate-dom/CHANGELOG.md、packages/slate-history/CHANGELOG.md、packages/slate-hyperscript/CHANGELOG.md、packages/slate-react/CHANGELOG.md。发布动作低优先级仅当发布工具或包文档仍假设这些文件存在时才需要处理。当前仓库中 packages/slate/CHANGELOG.md 依然存在说明这一族文件在 plate 仓库中已被保留。七、Target B 翻绿的六项验收标准只有全部满足Target B才能从No-Go翻回Go本计划中的每一条被删除证明表面都有已记录的处置restored恢复/ replaced替换/ explicit scope cut显式范围切除实时文档与仓库文档与该处置一致发布脚本运行真实替换门禁包测试收缩由重建的覆盖来解释而不是靠一厢情愿贡献者文档不再指向已删除表面性能措辞仅限于已测车道。这六条其实是声明纪律的落地形式每一条都可以被机械地检查而不是靠维护者的口头保证。八、可复现的审计命令Repro Commands刷新本计划时使用以下精确命令cd /Users/zbeyens/git/slate-v2 git diff --diff-filterD --name-only git diff --diff-filterD --name-only | rg ^packages/slate/test/ git diff --diff-filterD --name-only | rg ^packages/slate-react/test/ git diff --diff-filterD --name-only | rg ^packages/slate-history/test/ git diff --diff-filterD --name-only | rg ^playwright/integration/examples/ git diff --diff-filterD --name-only | rg ^site/examples/ts/ git diff --diff-filterD --name-only | rg ^site/examples/js/ git diff --diff-filterD --name-only | rg ^packages/slate-hyperscript/这套命令的工程含义值得展开git diff --diff-filterD是 Git 的只看删除过滤配合rg按包目录分桶就可以把一次大型重构的所有删除路径机械地产出再与计划的处置清单逐行核对。这正是1239 条删除、0 条未匹配这个数字的由来——它是可重复执行的账目不是一次性的估算。九、审计之后仓库中的延续证据这份审计计划并非孤立文档当前仓库中保留了它后续状态的延续证据docs/slate-v2/release-readiness-decision.md2026-04-18判定仍为未达发布就绪但明确表示包运行时阻塞阶段已过活跃 owner 是最终声明宽度闭合并给出了packages/slate、slate-history、slate-hyperscript、slate-dom、slate-react各包的实质性进展清单docs/slate-v2/replacement-gates-scoreboard.md2026-04-18逐门禁记录 tranche 1–8 状态与 v2 北极星门禁overlay 架构闭合、源码作用域 overlay 失效、React 运行时局部性、超大文档 overlay 姿态等及其证明命令docs/slate-v2/overview.md把审计计划放在slate-v2迁移程序的阅读顺序中并定义了文档所有权矩阵docs/slate-v2/references/pr-description.md作为维护者面向的 PR 描述来源把哪些 issue 修复了、哪些只是相关、哪些未声明逐条记账并明确规则——不要因为听起来相关就添加 issue 编号那是 PR 正文变成 bullshit 的方式。这些文件共同说明一个事实这份 2026-04-07 的审计计划不是一次性的而是被后续文档持续继承和推进的发布基线。它确立的方法论——删除表面逐条记账、门禁命令强制执行、声明宽度等于证明宽度、性能措辞不越界——已经内化成了整个 slate-v2 迁移程序的日常工作方式。十、可迁移的工程要点把这份计划的思路提炼成可复用的检查清单发布前先做删除账本git diff --diff-filterD --name-only配合按目录分桶的rg把每一次重构的删除路径全部枚举出来逐条标注处置桶删除必须落到槽位任何被删除的贡献者可见概念示例、测试入口、文档锚点都必须找到最近的当前概念槽位否则不允许删除门禁脚本必须等于发布声明prerelease跑什么文档就声称什么不存在文档说全绿、发布脚本跳过测试的组合性能声明永远收窄性能数字只在行为正确、回归关闭之后才有发布意义措辞只匹配已测车道用关闭说明代替口头承诺每类删除表面用一份专门的 closure note 记录处置依据链接到对应证明文件使任何后来的维护者都能回溯为什么这条可以删。这套方法论对任何大重构替换旧系统的项目都成立发布不是功能完成的时刻而是证据链闭合的时刻。【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考