xterm 6 升级与 prompt reflow patch

先说结论

旅程 A：崩溃是怎样消失的

1. 旧版的竞态窗口

应用层已有标准清理顺序：取消 observer / animation frame、释放 addon、最后释放 terminal。本次没有绕开或延迟 dispose；真正变化发生在依赖层。

// TerminalPanel.tsx — 生命周期逻辑没有改写
return () => {
  disposed = true;
  observer.disconnect();
  cancelAnimationFrame(fitFrame);
  for (const addon of addons.reverse()) addon.dispose();
  terminal.dispose();
};

2. 升级承担的职责

xterm 6 在 dispose 时清理 viewport 定时器，从根上关闭“对象已销毁、延迟回调仍在跑”的窗口。因此 PR 只把 TerminalPanel 里的历史注释改成当前事实，没有额外制造应用层 workaround。

旅程 B：prompt reflow patch 在做什么

1. 它不是运行时 monkey patch

根目录 postinstall 会运行 scripts/patch-xterm-prompt-reflow.mjs。脚本直接改写安装后的 xterm bundle，所以应用启动时拿到的已经是修正过的实现。

"postinstall": "bun run install:electron && node scripts/fix-node-pty-spawn-helper.mjs && node scripts/patch-xterm-prompt-reflow.mjs"

2. 真正改变行为的只有一个边界

// upstream
const e = this.ybase + this.y;
if (e >= l && e < l + c.length) continue;

// patched
const e = this.ybase + this.y;
if (e >= l && e - 2 < l + c.length) continue;

原逻辑只跳过“真正包含 cursor”的 wrapped group。powerlevel10k 的 prompt 往往由 cursor 上方几行和当前输入行共同组成；SIGWINCH 后 shell 会重绘这块区域。如果 xterm 先把上方 prompt 当普通历史重新换行，shell 又画一遍，就出现残留幽灵行。

3. 为什么必须改四个 bundle

4. patch 如何避免悄悄腐烂

for (const target of targets) {
  if (manifest.version !== target.version) {
    process.exit(1);
  }

  if (source.includes(target.guarded)) continue;
  if (!source.includes(target.unguarded)) process.exit(1);

  writeFileSync(bundlePath, source.replace(target.unguarded, target.guarded));
}

• 版本锁定：只允许目标包为 6.0.0。
• 签名锁定：必须找到精确的 minified 原表达式，避免误改相似逻辑。
• 幂等：已经存在 guarded 表达式时直接跳过，重复安装不会二次修改。
• fail closed：版本、文件或签名漂移时退出 1，让依赖升级显式失败。

实验如何改变最终方案

一开始最自然的假设是：“上游升级后，也许旧 patch 可以删掉。”所以 E2E 先构造了不打 patch 的候选版本，再用真实 powerlevel10k prompt 做对照。

所以最终提交不是机械沿用旧脚本：它把目标版本和四份 6.0 bundle 的新签名重新锁定，并让脚本在依赖内容漂移时主动阻断安装。

整体心智模型

术语与角色

验证结果与薄冰区

• bun install --frozen-lockfile 通过，说明 lockfile 与 postinstall patch 可复现。
• bun run check 与完整 verify 通过，包含生产构建。
• snapshot、scrollback、alternate screen 路径均通过。
• 真实 prompt resize 对照证明 patch 仍然必要。

另外，WebGL addon dispose 外层已有的 try/catch 保持不变；本次没有把相邻历史防御代码顺手重构进来。

验收清单

• 升级完整：desktop 与 daemon 的 xterm 生态版本成套推进。
• 崩溃闭环：快速 remount 不再产生 disposed dimensions page error。
• 视觉闭环：powerlevel10k prompt 在 1500 / 1100 / 850 / 650 px 均保持 1 行。
• 数据一致：live terminal、scrollback、alt-screen、snapshot 均通过。
• 安装可控：patch 可重复执行，依赖签名漂移时 fail closed。
• 回归验证：320 个测试文件、3231 个测试和生产构建通过。

覆盖范围