统一 Slate v2 浏览器/输入证据的归属plate 仓库中的 Proof Ledger 合并实践【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate本篇技术指南基于 plate 仓库中的执行计划文档 2026-04-12-slate-v2-browser-input-proof-ledger-consolidation.md讲解一次“证据台账proof ledger归属合并”的完整过程把分散在多份文档中的 Slate v2 实时浏览器/输入场景证明live browser/input scenario-proof收敛到唯一的权威台账明确三份文档之间的职责边界与退出条件。读完后你可以掌握在大型迁移程序中如何设计“单一事实来源single source of truth”的证据台账体系并理解 plate 仓库中 Slate v2 重构项目的证明分层证明台账、文件审查台账、历史批次记录各自承担什么角色。背景为什么需要合并证据台账plate 仓库中的docs/slate-v2/**目录承载了 Slate v2 重写/迁移计划的实时文档栈详见 docs/slate-v2/overview.md其中至少存在三类容易混淆的“台账”文档证明台账proof ledger记录运行时行为是否被真实证明——例如某浏览器/输入场景IME 组合输入、零宽选区、移动端键盘是否有可复现的证据文件审查台账file review ledger记录每个遗留/删除文件是否被审查、迁移或删除即“per-file migration truth”见 docs/slate-v2/release-file-review-ledger.md批次记录batch note某一轮 IME/移动端/浏览器 RCrelease candidate批次执行过程中留下的原始上下文。问题在于合并计划执行前实时浏览器/输入场景的证明真值存放在docs/plans/2026-04-11-slate-v2-ime-mobile-browser-file-ledger.md这份 2026-04-11 的批次文件中。从源码结构看该文件同时包含场景行scenario rows、遗留文件审查清单和“当前读”Current Read判断一份文档既当批次记录又当实时证明权威随批次推进极易腐化。而该文件中的“Dual-Axis Behavior / Parity Ledger”表格placeholder IME、inline-edge IME、void-edge IME、Android composition/flush、iOS Safari 组合输入、Firefox 组合/选区恢复等约 10 个场景行每行带 proof lane、browser scope、预期/实际结果与工件链接正是这种“多职责混装”的典型场景行本身属于实时证明而“哪些遗留文件被审查过”则属于文件审查范畴。这份合并计划状态status: completed日期 2026-04-12的目标就是把实时证明真值从批次文件中搬走使每份文档只承担一种职责。合并目标把实时浏览器/输入证明迁到证明台账计划文档的 Goal 部分非常直接将实时浏览器/输入场景证明真值从2026-04-11-slate-v2-ime-mobile-browser-file-ledger.md迁出放入 docs/slate-v2/true-slate-rc-proof-ledger.md。即批次文件不再回答“哪些浏览器/输入场景已被证明”这个职责整体交给 Slate v2 的证明台账。合并后的三份文档职责边界Shape计划文档用三行定义了新职责拓扑这也是理解整个 slate-v2 文档栈的关键文档合并后的职责docs/slate-v2/true-slate-rc-proof-ledger.md拥有场景行scenario rows、审查范围review scope、当前读current read以及剩余的浏览器/输入证明债务remaining browser/input proof debtdocs/slate-v2/release-file-review-ledger.md拥有遗留文件与已删除文件族deleted-family的闭环真值docs/plans/2026-04-11-slate-v2-ime-mobile-browser-file-ledger.md降级为“仅历史批次/审查上下文”historical batch/review context only落地后旧的批次文件开头确实出现了历史注记引用块Historical batch/review note. Live browser/input scenario-proof truth now lives in true-slate-rc-proof-ledger.md. Live legacy-file closure truth now lives in release-file-review-ledger.md. Keep this file for archaeology and batch history, not as the active proof authority.文件正文中的“Ground Rules”缺失证明默认阻塞、只有无用户可见行为的引擎内部 helper 才可省略、旧文档中的“better-cut”措辞不能单独关闭该 lane 等则保留为批次历史的组成部分而不再作为实时证明规则的唯一出处。退出条件Exit计划文档给出了两条可验证的退出条件这也是判断合并是否完成的判据实时证明负责人引用live proof-owner refs全部指向true-slate-rc-proof-ledger.md旧文件台账文档不再是活跃的证明权威no longer the active proof authority。从仓库现状看这两条均已满足。docs/slate-v2/**下多份活跃文档如 docs/slate-v2/release-file-review-ledger.md 中大量条目的proof owner: true-slate-rc-proof-ledger.md都把浏览器/输入相关的运行时证明归属指向证明台账而旧批次文件的 front matter 虽然仍标记status: in_progress但正文已被历史注记明确降级。执行结果Result计划文档的 Result 部分记录了三项已完成的动作向证明台账补充浏览器/输入审查范围与当前读上下文true-slate-rc-proof-ledger.md中新增了对应的 review scope 和 current-read 内容。对照合并后的台账正文可以看到这类内容已经融入其 “Runtime Proof Lanes” 小节例如slate-react包运行时证明已实质关闭其中包括“focused runtime owners、required v2-only example/browser rows in Chromium、command-backed north-star perf owners”生成的 cursor/caret gauntlet“replayable and release-blocking for cursor/caret claims”移动端/IME 传输证明按显式 claim 元数据与描述符分类划界。切换活跃文档中的实时证明负责人引用docs/slate-v2各文档中原本指向旧批次文件的 proof-owner 字段改为指向证明台账。release-file-review-ledger.md的 “Runtime Recovery Snapshot” 小节是典型样本extension model、schema/normalization、headless core、operation-history integrity 等条目的 proof owner 全部写为true-slate-rc-proof-ledger.md而 “major file/test deletion review” 条目则写为proof owner: release-file-review-ledger.md——正好对应 Shape 中的职责切分。旧批次文件降级为历史批次/审查注记如上所述文件开头加入 “Historical batch/review note” 注记指向新的两份权威文档。合并后证明台账的结构要点理解合并价值需要知道承接方true-slate-rc-proof-ledger.md本身的结构front matterdate: 2026-04-18topic: slate-v2-proof-ledgerstatus: active。合并后它按以下小节组织实时证明真值Current Read给出当前主线判断例如“fresh-branch program now has package-runtime proof forslate-dom,slate-react, and the public read/update runtime spine”并明确下一个主线阻塞是“final same-turn gate closure”而不是缺 DOM、React、公开 API、kernel、gauntlet、移动端范围或大文档性能负责人。这里还保留了“不是”清单blind source rewrite、rewrite-avoidance theater、核心 API 未定稿前的 support-package churn用于防止证明台账被误读为放行信号。Runtime Proof Lanes逐条记录各运行 lane 的当前读包括slate核心、slate-dombridge.ts与clipboard-boundary.ts、slate-reactfocused runtime owners、Chromium 中要求的 v2-only 示例/浏览器行、cursor/caret gauntlet以及本次合并直接受益的“mobile/IME transport proof is scoped by explicit claim metadata and descriptor classification”——即移动端/IME 证明的边界定义从旧批次文件并入了这里的分类规则。V2 North-Star Proof Lanes记录北极星主张如 overlay 架构闭环、bench:react:huge-document:legacy-compare:local的 5000 块直接对比作为发布证明门槛1000 块运行仅为 smoke/debug以及 required v2-only example/proof rowshighlighted-text、persistent-annotation-anchors、external-decoration-sources、review-comments在 Chromium 中的真实状态。Rule给出不可越界的硬规则——“Do not upgrade this ledger from runtime proof to RC readiness until the final integration, build, typecheck, lint, and perf gates run”绿色 harness 行、窄浏览器证明、源码接近度或同路径示例都不能单独关闭 blanket claim-width 或 paritylegacy parity 也不能单独关闭北极星 lane。Current Support-Package Read记录slate-history、slate-hyperscript等支撑包的关闭状态含具体的测试所有者文件如packages/slate-history/test/history-contract.ts、integrity-contract.ts与对比基准读数如 typing undo29.35ms等 bounded-class 数据。可以看到旧批次文件中的“场景行 当前读”两类内容在承接后分别落入 Runtime Proof Lanes / North-Star Proof Lanes 的 lane 化描述和 Current Read 的总结性判断中——这不是简单搬运而是把“每行场景的证据细节”升维为“每条 lane 的当前状态 关闭规则”。与文件审查台账的交叉引用机制合并后release-file-review-ledger.md通过proof owner字段实现跨台账引用。以该文件的 “Package-Level Deletion And Recovery Trees” 小节为例packages/slate/test/**的 deleted core test-family bucket → proof owner 为true-slate-rc-proof-ledger.mdpackages/slate-react/**、packages/slate-history/**的 deleted family closure → proof owner 为release-file-review-ledger.mdplaywright/integration/examples/**→ proof owner 为docs/slate-browser/proof-lane-matrix.md浏览器证明 lane 矩阵。这种“文件审查台账记录 per-file 状态、但把行为证明委托给证明台账”的引用结构正是 Shape 一节的落地形态文件维度归文件台账行为维度归证明台账两者通过 proof owner 字段单向引用而不互相复制。工程启示从这次合并能学到什么台账文档的职责单一化。批次文件天然随时间过期若同时承担“实时证明权威”就会产生双写冲突把实时真值迁入长生命周期文档docs/slate-v2/**的 active 文档栈批次文件只留考古价值。用退出条件代替模糊的“整理完成”。本计划只给了两条可机械检查的退出条件引用指向 权威降级便于在任何时点验证合并是否仍然成立。引用转换与权威声明。降级不是删文档而是加显式注记“keep this file for archaeology and batch history, not as the active proof authority”防止后来者人或 Agent误读历史文件为当前真值。Rule 小节防越级。承接台账中的 Rule 明确规定运行时证明不得直接升级为 RC readiness把“证据分层”从组织约定固化为文档规则。相关文档索引合并计划本文主体docs/plans/2026-04-12-slate-v2-browser-input-proof-ledger-consolidation.md承接方证明台账docs/slate-v2/true-slate-rc-proof-ledger.md文件审查台账docs/slate-v2/release-file-review-ledger.md被降级的历史批次记录docs/plans/2026-04-11-slate-v2-ime-mobile-browser-file-ledger.md文档栈入口含 Read Order 与 Ownership 表其中证明状态一行即指向上述证明台账docs/slate-v2/overview.md同期文档栈整合计划上下文参考docs/plans/2026-04-12-slate-v2-doc-stack-consolidation.md【免费下载链接】plateRich-text editor with AI and shadcn/ui项目地址: https://gitcode.com/GitHub_Trending/pl/plate创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考