Slate v2 Phase 9 高亮家族兼容矩阵搜索高亮与投影驱动高亮的替换证明指南【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本文基于仓库中的 Phase 9 Highlight Matrix 计划 展开深入拆解 Slate v2 在 Phase 9 阶段如何通过替换兼容矩阵replacement compatibility matrix扩展 highlight / decoration 家族的覆盖范围既保留遗留的search-highlighting行又新增当前投影驱动的highlighted-text行并通过跨仓库本地 runner 完成 Chromium 浏览器证明。读完本文你将掌握该矩阵的定位、约束边界、验证命令与家族现状的解读方法以及如何在 master-roadmap.md 与 decoration-roadmap.md 的路线图栈中追踪这些行是否真正落地。一、背景Phase 9 替换包络与高亮矩阵的定位在 Slate v2 的迁移路线中Phase 9 承担的是替换包络扩张replacement-envelope expansion工作逐家族扩大当前实现可以替换遗留实现的兼容性矩阵。高亮 / decoration 家族是其中的一个关键切面因为高亮类功能横跨搜索命中、代码语法着色、AI 建议、审阅评论等多种真实产品场景是验证投影驱动渲染projection-driven rendering能力是否达标的试金石。本计划文档 2026-04-06-slate-v2-phase9-highlight-matrix.md 被标注为status: complete即它是一份已经执行完毕的支持性计划Supporting plan。文档明确声明关于当前队列与路线图的最终事实以 master-roadmap.md 为准。因此在阅读本矩阵时应当把它当作某一阶段切片而非全局真相来源。二、目标与范围矩阵如何被扩展2.1 目标计划的目标非常收敛继续推进 Phase 9 替换包络扩张拓宽 highlight / decoration 家族的兼容性矩阵。这里的矩阵不是产品功能清单而是当前实现 vs 遗留实现的替换兼容性证据表——每一行代表一个示例example及其在 Chromium 中的浏览器证明状态。2.2 范围两行并存而非覆盖本次切片对矩阵做的是增量修改范围明确为三件事操作说明保留遗留行继续保留既有的 legacysearch-highlighting行不做删除或合并新增当前行新增当前currenthighlighted-text行代表投影驱动的高亮表面同步文档若新行干净落地则同步更新 scoreboard 与顶层 v2 文档使该切片在路线图栈中可见这种新旧各行、并存演进的做法正是替换矩阵的核心方法论不追求让当前行在字面上复制遗留行的产品形态而是用矩阵逐行呈现家族级的事实family-level truth。从 decoration-roadmap.md 的示例清单可以看出高亮家族实际由三个兄弟示例构成它们在该路线图中被并列管理search-highlighting—— 遗留搜索高亮示例code-highlighting—— 代码语法着色示例对应独立的 phase9-code-highlighting-matrix 计划highlighted-text—— 当前投影驱动的高亮文本示例三、约束拒绝伪造的直接对等声明本矩阵最值得注意的设计约束有三条它们共同定义了矩阵的证据纪律禁止伪造直接对等不得在旧的搜索 UI 与当前的投影驱动高亮表面之间做出虚假的直接对等fake direct parity声明。两者的内部机制不同——遗留路径走decoraterenderLeaf当前路径走projectionStorerenderSegment——因此矩阵记录的是当前实现能覆盖该家族能力的事实而不是两者产品形态完全一致的承诺。矩阵呈现家族级事实矩阵的价值在于让读者一眼看到当前家族覆盖的真实状态哪行已恢复、哪行是扩展、哪行仍漂移而不是把新老两套实现强行等价。通过跨仓库本地 runner 验证所有结论必须以浏览器内证明为准验证通道是run-cross-repo-local.sh脚本运行在固定端口3010上。这条约束在 example-parity-matrix.md 中有清晰的印证——遗留search-highlighting行在恢复遗留的 search/decorate 流程后状态被标记为recovered已恢复但其剩余漂移被如实记录为当前的projectionStorerenderSegment接线替代了遗留的decoraterenderLeaf同时注明两个高亮匹配的浏览器证明为绿色。这正是记录家族级事实、不掩盖机制差异的实例。四、进展与验证跨仓库本地 runner 实测4.1 本次切片完成的四件事计划的 Progress 部分列出了本次切片的实际交付向替换兼容矩阵新增了一行当前highlighted-text通过跨仓库本地 runner 证明了扩展后的矩阵同步了 scoreboard 与顶层 v2 文档使该 Phase 9 切片在路线图栈中可见执行了验证命令详见下节。4.2 验证命令逐段拆解计划文档给出了完整的验证命令这是本矩阵可复现性的核心bash ./scripts/run-cross-repo-local.sh 3010 /examples/rich-inline ../slate 3210 /examples/search-highlighting yarn build:slate-browser:playwright yarn exec playwright test playwright/integration/examples/replacement-compatibility.test.ts --projectchromium --workers1各参数含义如下参数含义3010当前current仓库示例的本地端口/examples/rich-inline当前仓库中用于替换证明的示例路径../slate遗留legacySlate 仓库的相对位置跨仓库对比3210遗留仓库示例的本地端口/examples/search-highlighting遗留仓库中的搜索高亮示例引号内的长命令在 Chromium 上执行 Playwright 集成测试先构建 slate-browser 的 Playwright 产物再以单 worker 运行replacement-compatibility.test.ts要点解读跨仓库验证需要同时启动两个仓库的示例服务端口3010与3210这正是替换兼容必须对照遗留实现实测的原因串行构建 单 worker--workers1保证浏览器证明的确定性避免并行干扰测试文件命名replacement-compatibility.test.ts是替换兼容矩阵的通用证明入口位于 legacy 仓库的playwright/integration/examples/目录下。五、矩阵落地后的现状从路线图与台账交叉验证矩阵的同步 scoreboard 与顶层文档环节保证了落地结果可以在多份文档中互相印证。以下四份仓库证据共同构成了高亮家族的当前状态快照master-roadmap.md将highlighted-text列为 required v2-only example/browser 行之一tranche-6 已 live 且 greentranche-7 作为已落地的 north-star proof 行保留并注明package/runtime 闭包不再是主要阻塞。replacement-gates-scoreboard.md给出可复现的测试命令bunx playwright test ./playwright/integration/examples/highlighted-text.test.ts --projectchromium并记录全部四个 v2-only example/browser 行在 Chromium 中均为绿色。ledgers/example-parity-matrix.md提供逐行的细粒度台账——search-highlighting为recovered已恢复highlighted-text为extended扩展search-highlighting的相似度数据为0.170属于source-close recovered row。decoration-roadmap.md把三个高亮示例与其对应测试search-highlighting.test.ts、code-highlighting.test.ts、highlighted-text.test.ts并列列出并给出了跨节点高亮源无需手动 leaf 扇出等能力结论同时记录了bench:replacement:search-highlighting:local等基准命令用于对比新旧实现的开关性能。5.1 如何阅读这些状态词在替换矩阵语境中recovered遗留示例的源码形状已尽量恢复浏览器证明为绿色但内部接线机制与遗留不同如 projection 驱动 vs decorate 驱动属可替换、但机制不同extended当前实现专属的新增行无遗留直接对应物代表家族能力在当前实现上的扩展覆盖green in Chromium以 Playwright 在 Chromium 上的端到端证明为准这是矩阵中已验证的唯一权威口径。六、给矩阵使用者的实践建议区分矩阵行与产品功能矩阵行回答当前实现能否替换遗留实现的该示例不代表产品形态对齐。若你的目标是迁移遗留搜索 UI应关注search-highlighting行的recovered状态与剩余漂移说明若你要在新实现上落地纯投影驱动高亮则看highlighted-text行。复现证明时保持端口纪律当前仓库端口3010、遗留仓库端口3210任何对矩阵状态的更新都应在本地 runner 上实测后写入而不是仅凭代码阅读下结论。以 master-roadmap 为最终事实本矩阵是阶段切片路线图整体状态tranche 归属、阻塞项、下一批工作请以 docs/slate-v2/master-roadmap.md 为准并以 docs/slate-v2/replacement-gates-scoreboard.md 的 scoreboard 作为门禁口径。七、总结Phase 9 高亮矩阵切片展示了 Slate v2 替换工程的一种成熟工作方式用矩阵 跨仓库浏览器证明 台账同步三步闭环逐家族推进替换包络。在 highlight / decoration 家族上它做到了保留遗留search-highlighting行、新增当前highlighted-text行、同步 scoreboard 与路线图且全程恪守不伪造直接对等、只呈现家族级事实的约束。对于任何需要评估当前实现能否接手遗留高亮功能的开发者这份矩阵及其背后 decoration-roadmap.md 的能力清单与 example-parity-matrix.md 的逐行台账都是可以直接引用的证据源。【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考