Slate V2 核心删除测试族关闭Deleted Test-Family Closeout1048 行历史测试的镜像、恢复与显式跳过归档【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本篇技术指南以docs/plans/2026-04-09-slate-v2-core-deleted-test-family-closeout.md为骨架讲解 Slate V2 重写过程中如何关闭被删除的packages/slate/test/**测试族共 1048 行历史测试哪些被现有 proof 栈镜像、哪些被直接恢复、哪些被带理由地显式跳过。读者将掌握删除测试族关闭这一归档作业的完整方法聚合关闭矩阵的核算规则、三态分类法、非冗余门禁、验证门禁以及该批次在 release-file-review-ledger.md 与 true-slate-rc-proof-ledger.md 中的最终落地状态。一、文档定位一次被折叠进总台账的历史批次记录该关闭文档本身明确标注为Historical batch note历史批次记录它在 2026-04-09 记录了Slate Core Deleted Test-Family Closure batch核心删除测试族关闭批次的执行结果而实时live的关闭结论已经被折叠进release-file-review-ledger.md发布文件审查台账。要理解这份文档需要先理解它的历史背景Slate V2 是从旧 Slate 测试体系迁移到全新引擎的fresh-branch 计划迁移过程中旧packages/slate/test/**目录下的 1048 个测试文件行被删除。这些删除行为如果不能被归档解释就会成为未分类的发布谜团unclassified release mystery——维护者无法回答这些测试是被新引擎覆盖了、还是被有意放弃了。本批次的职责就是把这 1048 行删除测试逐族映射到当前引擎的处置结果上。该批次的授权来源是已批准的共识计划 2026-04-09-slate-core-deleted-test-family-closure-consensus-plan.md其任务声明为通过将每一行删除测试映射到当前 proof、恢复未被覆盖的当前价值簇cluster并把不兼容的残留转换为带better-cut 理由的显式跳过条目来关闭剩余的packages/slate/test/**删除族桶。二、聚合关闭矩阵1048 行删除测试的五类最终处置文档的核心是聚合关闭矩阵Aggregate Closure Matrix它把删除测试按族family聚合并给出每个族的删除数量与最终处置disposition。这一矩阵必须完整继承因为它就是整个批次的可审计账本Family测试族删除数量最终处置disposition归档产物Artifactinterfaces/**576helper 密集的表面积已被当前 proof 镜像CustomTypes为显式跳过2026-04-09-slate-v2-interfaces-family-deleted-test-closure.mdtransforms/**408当前窄化 transform 契约被镜像或直接恢复更宽泛的旧版广度是显式跳过2026-04-09-slate-v2-transforms-family-deleted-test-closure.mdoperations/**31原始 operation 接缝被直接恢复显式跳过项被点名2026-04-09-slate-v2-operations-family-deleted-test-closure.mdnormalization/**20当前的默认 vs 显式normalization 切分镜像了被删除的行2026-04-09-slate-v2-normalization-family-deleted-test-closure.mdutils/** 根index.jsjsx.d.ts13幸存的字符串单元价值被镜像被删除的 helper/测试脚手架残留是显式跳过2026-04-09-slate-v2-utils-and-root-test-entrypoint-closure.md总数核算文档明确给出576 408 31 20 13 1048对账后总数1048其中每个族的数量都能在共识计划的Family Closure Matrix中逐项对账到父级审计口径interfaces/** 576、transforms/** 408、operations/** 31、normalization/** 20、utils/** 11、index.js 1、jsx.d.ts 1合计1048。这条矩阵必须与审计数量精确对账的规则是关闭作业的第一纪律不先出矩阵就不允许开始任何恢复工作。2.1 transforms 族的关闭细节261 镜像 147 恢复作为删除量第二大的族408 行transforms 族关闭文档 给出了更细粒度的簇级cluster-level矩阵是理解镜像 vs 恢复区别的最佳样例簇组删除数量状态当前 proof 拥有者delete/*100mirrored nowsnapshot-contract.tsmove/*49mirrored nowsnapshot-contract.tsinsertFragment/*41mirrored nowclipboard-contract.ts、snapshot-contract.tssetNodes/*29recovered nowtransforms-contract.ts、snapshot-contract.tsmoveNodes/path6recovered nowtransforms-contract.ts、range-ref-contract.ts、operations-contract.tsmoveNodes/selectionmoveNodes/voids-true7mirrored nowtransforms-contract.ts、range-ref-contract.ts、operations-contract.tswrapNodes/*、unwrapNodes/*、liftNodes/*、select/*、deselect/*、setPoint/*、unsetNodes/*64mirrored nowsnapshot-contract.tsmergeNodes/*、splitNodes/*、insertNodes/*、insertText/*、removeNodes/*112recovered nowindex.spec.ts、snapshot-contract.ts、operations-contract.ts对账镜像261 恢复147 显式跳过0408。该族特别值得注意的是旧的窄 helper 显式跳过叙事已作废no longer livemergeNodes/splitNodes/insertNodes/insertText/removeNodes的 helper 广度在保留的包声明内被完整恢复而恢复动作中的代表性簇是setNodes/inline/**与moveNodes/path/**的关键行为详见 transforms-setnodes-cluster-recovery.md 与 transforms-movenodes-path-cluster-recovery.md。三、关闭判定从未分类的发布谜团到三态处置文档的Closeout Read关闭判定只有两个要点但它定义了整个批次的验收标准被删除的packages/slate/test/**桶不再是未分类的发布谜团当前有价值的接缝current-value seams要么被现有 proof 栈镜像mirrored by the live proof stack或在当前引擎上直接恢复directly recovered on the current engine或被显式跳过并附带点名理由explicitly skipped with named rationale。这三种处置正是共识计划中定义的分类学taxonomymirrored now已被现有契约覆盖如snapshot-contract.ts、supportable next尚未覆盖但能干净映射到当前引擎与公共契约、explicit skip不再属于当前引擎的旧版行必须直接点名。explicit skip是记账标签better-cut rationale更优裁剪理由是附着在该标签上的解释——跳过不等于丢弃而是换一个更优的裁剪。该分类学背后是一套明确的决策驱动因素packages/slate/test/**曾是最大的剩余删除族桶、维护者需要恢复了什么 vs 有意裁剪了什么的证据、且已恢复的切片已经证明了可行模式代表性族契约 真实包验证。四、范围边界本批次关闭了什么没有关闭什么文档的Important Boundary是一个容易误读的边界必须原样保留本批次只关闭核心删除测试族批次core deleted test-family batch它不关闭更宽泛的major file/test deletion review桶在 release-file-review-ledger.md 中跟踪因为在packages/slate/test/**之外仍有被删除的族packages/slate-react/test/**packages/slate-history/test/**example / browser / supporting-package 的被删除族换句话说核心 不等于 全部。批次关闭采用逐桶推进策略本桶只负责packages/slate/test/**React 层、History 层与示例/浏览器层的删除族由后续批次处理。需要指出的是从当前仓库的 release-file-review-ledger.md 看这些后续族已经陆续闭合台账中packages/slate-react/**、packages/slate-history/**、playwright/integration/examples/**均已标记为[x]完成slate-history的history-contract.ts、integrity-contract.ts与bench:history:compare:local已成为实时live验证项。这说明本批次定义的范围边界在后续执行中得到了逐一兑现。五、方法论代表性契约恢复而非批量复活为什么是镜像 代表性恢复 显式跳过而不是把 1048 行全数复活共识计划给出了三选一的决策分析选项思路优点缺点Option A被选中逐簇恢复代表性族契约真实的包工作、proof 栈可读、比复活数百个小 fixture 更具扩展性需要对什么是代表性的做判断Option B原样批量恢复被删除的 fixture 树最大旧版可见性、前期决策少体量大、维护噪音高、大量行无法干净映射到重写后的引擎、容易在死接缝上浪费时间Option C立即停止恢复并 better-cut 其余最快缩小表面积对维护者来说删除桶仍巨大证据不足时裁剪过于仓促选 A 的理由真实恢复与诚实划界之间的最佳平衡。在 ADR 中被记录为代表性恢复给出最好的信号-成本比比批量恢复噪音更低比过早裁剪拥有更强的维护者叙事。执行顺序遵循uncovered-delta order未覆盖差异优先而非族标签顺序分类该族恢复最高价值的未覆盖簇当扩展现有契约能让 proof 更贴近实时 API 时优先扩展现有契约文件仅当新契约文件能更好地隔离真实声明时才新建仅当恢复的 proof 暴露了真实缺口时才修复包代码重跑验证门禁更新 proof 台账与文件审查台账以显式说明关闭该族未覆盖的公共价值差异已关闭 / 剩余行显式跳过 / 台账反映最终读法。5.1 非冗余门禁Non-Redundancy Gate计划中有一条硬性规则任何恢复落地前关闭矩阵必须引用它不复制的现有 proof 行。已知的 proof 拥有者供审计优先检查包括snapshot-contract.tsinterfaces-contract.tsoperations-contract.tsnormalization-contract.tstext-units-contract.tsrange-ref-contract.tsclipboard-contract.ts风险被明确列出跳过分类直接恢复会造成重复 proof 与虚假进度恢复过多字面旧行会浪费在死接缝上恢复过少会让维护者不信服触碰底层 transform 行为可能回归已绿的 snapshot/clipboard/runtime proof 栈。对应缓解措施就是先分类再恢复、按未覆盖 proof 差异排序、恢复前强制矩阵核算、优先扩展现有 proof 文件、族级代表性策略、每族后全量包验证。六、验证门禁批次内与最终关闭的两级证据文档给出了两级验证证据构成该批次可复验reproducible的完整命令面最终门禁重跑final gate rerun全部通过yarn test:mocha yarn workspace slate-react run test yarn workspace slate-dom test yarn test:custom yarn lint:typescript关闭过程中的针对性重跑supporting focused reruns全部通过yarn exec mocha --require ./config/babel/register.cjs ./packages/slate/test/operations-contract.ts ./packages/slate/test/transforms-contract.ts yarn exec mocha --require ./config/babel/register.cjs ./packages/slate/test/range-ref-contract.ts ./packages/slate/test/operations-contract.ts ./packages/slate/test/transforms-contract.ts \ --grep rebases range refs inside the moved top-level block when moveNodes targets a later slot|rebases selection with the effective move_node target when moving to a later sibling slot|moveNodes can move a top-level block inside the next block container yarn exec mocha --require ./config/babel/register.cjs ./packages/slate/test/snapshot-contract.ts \ --grep supports merge_node on an element path and preserves moved descendant ids|supports path-based mergeNodes helper calls on element nodes|mirrors the legacy wrapNodes/path/block.tsx oracle row这些--grep模式值得关注它们精确点名了本批次恢复的核心行为——moveNodes移到更靠后的槽位时对 range-ref 与 selection 的重基线rebasing、把顶层块移入下一个块容器、merge_node在元素路径上保留被移动后代 id、以及镜像旧版wrapNodes/path/block.tsxoracle 行。这正是恢复的是行为契约而非字面文件的实证。需要说明适用前提上述命令是 2026-04-09 批次执行时基于 Yarn Mocha Babel 的工具链记录。根据 release-file-review-ledger.md 的 tranche 1/2 记录仓库此后已迁移到Bun 工具链bun.lock/bunfig.toml成为实时所有者、config/bun-test-setup.ts承担 workspace 测试桥与路径过滤、包构建经 tsdown 输出 ESM-only 产物因此今天在仓库中重跑验证时应以 Bun/Turbo/Biome 命令面为准这份 closeout 的命令清单应理解为历史批次当时的门禁证据。七、当前仓库的落地证据从归档到合并语料库本批次关闭之后它的结论在 release-file-review-ledger.md 中以当前恢复行Current Recovery Rows的形式持续存在这是理解关闭 ≠ 一切结束的关键packages/slate/test/**在台账的Package-Level Deletion And Recovery Trees中被标记为[x]被删除的核心测试族桶已作为考古学archaeology关闭保留的行正通过合并语料库merged corpus重新驱动。一批恢复/适配行直接落地在packages/slatequery-contract.ts状态restored—— 直接查询拥有者回到实时仓库并保持绿色legacy-editor-nodes-fixtures.ts/legacy-interfaces-fixtures.tsrestored—— 旧版Editor.nodes/**与非 Editor 接口 oracle 拥有者回归legacy-fixture-utils.tsadapted—— 旧 fixture 加载改为运行在 Bun 时代工具链上而非已死的 Babel 假设unhang-range.ts、positions.ts、fragment.tsadapted—— void 感知的 unhang 行为、positions 迭代器、折叠 fragment 读取失败时闭回[]等行为与恢复的 query 行对齐。在当前仓库的 packages/slate 中可以看到这一演进的最终形态不再存在packages/slate/test/**目录取而代之的是与源码同构的 spec 文件例如 create-editor.spec.ts、interfaces/path.spec.tsx、interfaces/range.spec.tsx以及 internal/transforms/moveNodes.spec.tsx、mergeNodes.spec.tsx、setNodes.spec.tsx、insertNodes.spec.tsx 等覆盖 transform 族的实时验证文件。从 packages/slate/package.json 看包名为platejs/slate53.3.10其test脚本经由plate-pkg p:test运行依赖slate0.126.2与slate-dom0.126.0——这与本批次关闭时当前窄化契约 直接契约文件的形态一致。八、给维护者与贡献者的可复用检查清单综合关闭文档、共识计划与台账这套删除测试族关闭流程可以提炼为一份不依赖 Slate 特定领域的通用检查清单先出矩阵后动代码每个仍开放的删除族必须先有可审计的Family Closure Matrix列删除路径/簇 id、族、删除数量、旧版声明、当前 proof 拥有者 file#line、状态、理由、新建 proof 文件、触动的台账行且总数必须精确对账到父级审计数量三态分类每一行/每簇必须落在mirrored now/supportable next/explicit skip之一supportable next未被恢复的必须重分类为explicit skip并写明不兼容原因非冗余门禁任何新 proof 落地前必须引用它不复制的现有 proof 行优先扩展现有契约文件新建契约文件只在隔离声明更清晰时才被允许代码缺口在包内修复恢复 proof 暴露的包代码缺口必须在包内修复不允许在文档里打太极hand-waved台账联动每个恢复或裁剪的族必须接线到 proof 台账与文件审查台账如 true-slate-rc-proof-ledger.md 与 release-file-review-ledger.md两级验证批次内逐族验证恢复族测试 全量门禁 最终关闭时重跑父级发布门禁证据未重开的车道必须显式说明原因显式关闭说明每个族必须有一条为什么不再需要恢复工作的 closeout note——已镜像了什么、恢复了什么、显式跳过了什么。这套流程的底层哲学是真实代码/proof 进展比原始恢复文件数更重要维护者需要的是可审计证据而非氛围vibes。它把删除测试从一次性的历史事故转化为持续可审计、可复验、可裁剪的工程资产。【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
