IME 回归检查清单¶

后续问题台账¶

这些报告定义了持久验收契约，而不仅仅是来自一台机器的症状。

预编辑单元格前进量 (#19315)¶

单码位 CJK 字素使用当前 Unicode 提供方的单元格宽度和实测字体前进量。普通内联 span 保留浏览器双向文本和基线布局；相等的修正共享一个 run。保持字形不缩放，并使下划线、光标和候选文本框与渲染的预编辑对齐。追加 ASCII、emoji 或其他文字系统时，不得改变现有 CJK 前缀的修正。组合序列、emoji、其他文字系统和空白保留原生整形。字体加载、排版变更和渲染器度量变更必须更新打开的组合；行尾重绘保留其未变更的节点。

冷字体测量和带样式的 run 共享固定的工作预算。重复的 CJK 可以保持为一个已修正的 run；预算耗尽后，剩余文本保留其原生前进量。这会刻意在异常多样的长组合尾部保留原始间距不匹配，而不会将前缀切换回原生间距，也不会重建数千个 span。

terminal-ime-xterm-preedit-cell-grid.test.ts 覆盖文本保留、原生文本簇、生命周期和有界工作。terminal-ime-preedit-cell-grid.spec.ts 检查渲染字形原点、光标/textarea 几何、下划线、字体变更，以及在 DPR 1、1.25 和 2 下 WebGL 开/关时的原生整形。 terminal-ime-preedit-continuity.spec.ts 覆盖混合后缀和预算跨越。 这些检查通过 CDP 使用 Chromium 组合；它们不能替代原生操作系统 IME 证据。

有界状态与所有权契约¶

每个临时集合和所有权跟踪器都必须具有明确的生命周期和边界：

• Native Chat 使用 NATIVE_FILE_DROP_MAX_PATHS（256）。如果已解析的完成结果将超过上限，则整个批次会被原子性地拒绝，并且溢出通知在结算期间保持可见；已接受的路径保留顺序和重复项。队列在重新进入之前以及禁用或 pane-owner 重新挂载时清除。
• 终端占位符掩码跟踪一个标量 activeSessionId，因为 xterm 渲染一个组合视图。较新的开始会取代较旧的开始，过期的结束无法清除最新的所有者，而失焦或销毁会清除它。组合路由有意保留其按 ID 的引用计数映射，用于传输所有权；它不会被标量替换。
• 输入诊断将待处理和被忽略的回显候选项限制在 MAX_PENDING_ECHO_CANDIDATES（64），限制待处理的用户输入信号，排空超时的候选项，并在面板分离时清除所有序列。溢出会成为明确模糊的突发，而不是任意归因。

Native Chat 异步附件结算¶

附件解析是一种外部语义写入，包括本地文件选择、粘贴图像的临时保存和 SSH 上传。在组合处于活动状态时，它不得替换浏览器拥有的 textarea 值。

• 启动两个并发 SSH 上传，先解析第二个，并返回同一路径两次。保留完成顺序和两个重复项。
• 在第一个结算事件时，在刷新排队路径之前采用浏览器 DOM。在一个 React 批次中执行 compositionend 然后失焦，以及失焦然后 compositionend；两种顺序都必须恰好采用并刷新一次。
• 如果 composer 在上传解析之前或队列刷新之前变为禁用，则丢弃该结果。
• 如果省略 compositionend，失焦会执行相同的一次性结算，而不会聚焦 textarea 或抢回焦点。

跨平台验证¶

合成 DOM 事件证明了 Orca 的事件和渲染契约，但它们不会演练操作系统的输入法。变更还必须覆盖：

对于远程证据，live 表示拥有主机报告了当前验证会话或进程身份。exited 需要由主机拥有的正面证据，证明同一身份已终止或不存在。任何传输失败、过期身份、超时或无法询问拥有主机，都会使结果变为 unverifiable；它绝不是组合或 PTY 进程已退出的证据。

代码优雅性门禁¶

每个修复必须通过以下所有检查：

• 复用已经拥有该状态或覆盖层的组件；不要引入第二个组合状态机。
• 明确浏览器、渲染器和 PTY 的所有权边界。临时文本不得泄漏到已提交状态或 PTY 输入中。
• 将本地选择、粘贴图像的临时保存以及 SSH 上传结果通过一个已解析附件汇聚点路由；队列中只应包含语义路径，绝不能包含整个草稿快照。
• 将正确性更改与无关的微优化分开。
• 使用有界的每次组合状态和工作量。随其所有者一起销毁每个监听器、计时器、观察器和 DOM 节点。
• 使用成对的负向测试，保留普通拉丁输入、混合样式终端内容、本地和 SSH PTY、预览终端以及文件夹工作区。
• 将平台特殊行为隐藏在事件契约或运行时平台检查之后；不要根据 IME 供应商、语言或终端代理名称进行分支。
• 将规范的 xterm 源补丁视为唯一手工编辑的源，然后一起重新生成其 bundle 补丁和 lockfile。
• 优先使用确定性重放或状态转换测试。原生证据是第二层，绝不能替代回归覆盖。