Terax 终端渲染器池架构解析模型所有权、呈现资源租约与故障恢复【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-ai导读Terax 是一套终端优先的 AI 原生开发工作区其终端内核基于 libghosttyWASM默认走 WebGPU 渲染并以自研 WebGL2 渲染器作为兼容回退。本文以 docs/architecture/terminal-renderer-pool.md 为骨架系统讲解 Terax 的终端模型model所有权模型、GPU 呈现资源池renderer pool的租约机制、分窗帧率调度、窗口遮挡与休眠下的资源回收策略以及渲染器替换的事务式恢复流程。读完你将理解为什么切换标签页、切换图形 API 甚至 GPU 上下文丢失都不会重置终端的解析器、回滚缓冲、选区、搜索与命令块状态以及 Terax 如何在约 7~8 MB 的轻量级打包体积下维持多标签终端的高性能呈现。核心所有权模型一个叶子 一个模型 一个 PTYTERAX.md 与本文档共同确立的第一条不可变约定是每个终端叶子terminal leaf独占一个 libghostty 模型与一个 PTY渲染器租约renderer lease永远不拥有终端状态。这意味着状态归属被严格划分模型与会话状态解析器、回滚缓冲、选区、搜索、命令块挂靠在叶子tab / pane上由useGhosttyTerminalSession每个叶子持有一个持久模型与 PTY呈现资源GPU 设备、pipeline、图集租约、损伤调度器是窗口级共享的由运行时runtime统一管理任何表面surface只以租约形式借用。因此切换标签页、更换图形 APIWebGPU → WebGL、GPU 上下文丢失、窗口遮挡恢复都只是呈现事务层面的变化永远触碰不到模型。TERAX.md明确写道WebGPU can fail over to WebGL without replacing the model, PTY, selection, search, or block historyWebGPU 可以无缝降级到 WebGL而无需替换模型、PTY、选区、搜索或命令块历史。这是整个渲染器池设计的第一性约束。呈现资源WebGPU 共享运行时WebGPU 路径的核心是 WebGpuTerminalRuntime。它通过模块级单例getWebGpuTerminalRuntime()提供给整个窗口一个窗口只持有一份GPU 设备device、两个渲染管线color pipeline 与 glyph pipeline、图集atlas租约与损伤调度器。从源码中可以确认的关键常量与机制常量值作用MAX_ATLAS_COUNT8窗口内活跃字形图集的上限超出后先尝试驱逐无引用图集否则抛出预算耗尽错误MAX_WARM_UNUSED_ATLASES1允许保留的空闲热图集数量避免短期切换时反复重建ATLAS_IDLE_TTL_MS30_000空闲图集的 30 秒存活期到期后被回收MAX_IN_FLIGHT_FRAMES2同一时刻最多只有 2 个 WebGPU 帧等待 GPU 完成帧提交采用每帧一个 encoder/submission的策略flushFrame中只要dirtySurfaces非空就创建一个带Terax terminal window frame标签的GPUCommandEncoder遍历本批表面逐一渲染最后只调用一次queue.submit([encoder.finish()])。inFlightFrames达到MAX_IN_FLIGHT_FRAMES时requestFrame直接返回脏帧被合并而不会产生新的上传与提交——这正是文档所述至多两个提交等待 GPU 完成的实现。图集以租约GlyphAtlasLease形式发放acquireGlyphAtlas/acquireIsolatedGlyphAtlas会以字体、字号、字重、行高、字距与 DPR 组合成 key同一 key 复用同一图集release()幂等地减少引用计数并触发延迟回收scheduleAtlasReap。空闲 CPU 字形缓存glyph cache保留一份、30 秒空闲生命周期其覆盖像素约 1 MiB只有使用 emoji 后才额外增加 1 MiB 彩色像素。WebGL 兼容回退至多五个渲染器槽位的池当 webview 不支持 WebGPU 时Terax 使用自研的 WebGL2 渲染器适配自上游 Ghostty 呈现层保留上游 MIT 署名见 webgl/UPSTREAM.md不安装、不携带任何 xterm 运行时或插件。WebGlTerminalRuntime 实现了与 WebGPU 对称的池化模型常量值说明MAX_WEBGL_RENDERER_SLOTS5窗口内最多 5 个 WebGL2 渲染器槽位MIN_WARM_WEBGL_RENDERER_SLOTS1始终保留 1 个空闲暖槽位WEBGL_RENDERER_IDLE_TTL_MS30_000空闲槽位超过 30 秒未使用即被销毁每个槽位独占一个WebGlCellRenderer它消费同一个 Ghostty 模型与同样的脏行dirty-row信息——与 WebGPU 渲染器共享模型侧的全部状态。槽位租约的生命周期是acquire(surface, host, profile)按渲染 profile字体、DPR 等查找空闲槽位若 5 个槽位都已占用且无空闲则抛出WebGL terminal renderer pool exhausted (5 visible panes)错误槽位绑定 surface 后resetModel()并将 canvasattach(host)release(surface)槽位归还池中detach()记录lastUsed并安排空闲清扫定时器sweepIdleSlots()超过 30 秒未使用的空闲槽位被dispose()并从池中移除但至少保留 1 个暖槽位。discard(surface)用于渲染器出错场景直接销毁该槽位。窗口隐藏时trimForHiddenDocument()会清掉所有无主槽位。值得强调的是池化的边界源码注释明确写道 Ghostty models are never pooled here这里从不池化 Ghostty 模型。WebGL 池只池化呈现器隐藏标签页释放 GPU 槽位的同时WASM 终端状态保持存活。帧率调度60 / 30 / 15 的按面板per-pane截止时间帧率并非全局统一而是由 SurfaceFramePacer 按每个面板自己的截止时间deadline驱动核心常量在 renderScheduling.ts 中常量值语义FOCUSED_TERMINAL_FRAME_INTERVAL_MS1000 / 60聚焦面板最多 60 fpsBACKGROUND_TERMINAL_FRAME_INTERVAL_MS1000 / 30后台面板独立截止时间最多 30 fpsUNFOCUSED_WINDOW_FRAME_INTERVAL_MS1000 / 15未聚焦窗口每面板最多 15 fpsINTERACTION_PRIORITY_MS150用户交互滚轮、拖动、按键给予该面板 150 ms 的聚焦级帧率特权关键实现细节terminalFrameIntervalMs(windowFocused, hasFocusedSurface)决定基础帧间隔但聚焦面板的输出不会把后台面板拉到 60 fps——每个 surface 独立计算自己的 deadlineinteract(surface, now)为交互面板写入now 150ms的优先截止时间期间按聚焦帧率渲染150 ms 到期即回落不启动任何空闲定时器或帧循环delay()返回最早截止时间 - 当前时间 - FRAME_LEAD_MS(1/60s)调度器据此使用setTimeout或requestAnimationFrame避免 RAF 回调抖动跳过本可呈现的帧WebGPU 的MAX_IN_FLIGHT_FRAMES 2保证 GPU 落后时脏工作只合并、不堆积。窗口生命周期遮挡、睡眠与两秒宽限呈现资源的回收完全由窗口可见性驱动由 windowPresentation.ts 提供的单一共享订阅组合了三路信号DOMvisibilitychange、原生 macOS 窗口遮挡occlusion与睡眠/唤醒通知通过 Tauri 事件terax:window-presentation与window_presentation_state命令桥接。各状态下的呈现行为可归纳为状态呈现行为可见、聚焦面板损伤驱动至多 60 fps可见、后台面板独立截止时间至多 30 fps可见、未聚焦窗口每面板至多 15 fps可见但正在交互的面板即使窗口未聚焦也享受 150 ms 的 60 fps 交互截止时间隐藏或完全遮挡的窗口帧、闪烁定时器、搜索工作、选区自动滚动立即暂停不可见不足 2 秒保留呈现资源避免桌面切换时的重复分配抖动不可见超过 2 秒释放表面缓冲、原生渲染状态、canvas 配置与图集纹理销毁 WebGL 上下文原生睡眠通知立即请求资源回收隐藏的终端标签页立即释放其呈现租约源码层面的佐证WebGpuTerminalRuntime.handleVisibility收到reclaim时挂起所有零引用图集WindowPresentationPolicy与WebGlTerminalRuntime的handleVisibility在不可见时直接cancelScheduledFrame()而 WebGPU canvas 被回收前会先unconfigure再缩放到 1x1同时保留目标几何信息供下一次呈现事务恢复。原生快照携带单调递增的revision迟到的 IPC 初始响应不会覆盖更新的状态。无论窗口如何变化PTY 与终端模型始终保持隐藏标签页的模型会继续解析输出通过有界的两消息窗口与 2 MiB 待处理/在途字节上限直到叶子关闭。文档与 ghostty-resource-efficiency.md 都强调Models keep parsing until their leaves close模型持续解析直到其叶子关闭。命令块与辅助输出惰性加载、归属模型、随呈现挂起命令块command blocks是 Ghostty 模型/会话的一部分包括其跟踪的原生 pinmarker命令锚点endpoint columns在解析期parser-time由 Ghostty 生成因此命令范围能跨回流reflow存活且不会把后续提示符和命令包含进去原生 marker 环上限2,048 个 pinJavaScript 侧历史上限1,000 条块 / 512 KiBUTF-16 估算的命令与 cwd 文本块控制器block controller与覆盖层overlay惰性加载只在块会话中使用隐藏或被遮挡时块的呈现工作停止共享 shell 编辑器拥有提示符输入交互式命令与备选屏alternate-screen应用拥有网格输入WebGPU 与 WebGL 两套呈现后端施加完全相同的输入与光标策略。可访问输出accessible output即屏幕阅读器文本是opt-in、惰性、有界的限制为 256 行 / 64 KiB可见时每秒最多刷新 4 次250 ms 合并并随窗口呈现一起挂起。它直接读取原生文本范围不会移动渲染器视口或选区——即使可访问文本刷新用户的滚动位置与选区保持不变。事务式恢复替换呈现永不触碰模型渲染器替换renderer replacement是本文档描述的最关键恢复路径其实现位于 replaceSessionSurface.ts核心顺序是从旧表面快照搜索状态searchController().snapshot()并挂起旧搜索创建替换表面create()并先 attach 新表面将搜索快照恢复到新表面restore(search)——不重置查询、不跳过当前匹配全部成功后才释放旧表面与旧输入previousInput?.dispose()previous?.dispose()若中途失败释放已创建的替换资源、resume()旧搜索并重新抛出错误——旧表面与模型保持完好。这一先建后拆的顺序保证了替换是原子的呈现层永远不存在无渲染器可用的窗口期。对应的故障处理语义WebGL 回退失败显示带重试Retry操作的错误呈现同时保持存活的模型与 PTY——用户重试只是再次替换呈现而不是重启会话WebGPU 设备丢失recoverDevice会先释放设备与图集、隐藏期间推迟设备重建窗口恢复可见后再重新初始化初始化期间丢失的设备被隔离quarantine而不是进入无界恢复循环文档明确禁止用序列化、重放、清空或重新 spawn 终端来修复呈现问题——呈现损坏与终端状态是两回事。TERAX.md补充了两个相关约束延迟导入WebGL 表面与渲染器只在选中、需要回退或被诊断显式请求时加载不能安装进已关闭、已重启或已替换的会话不支持图形能力时展示可见错误与重试而不是悄悄更换模型。资源边界与度量证据配套的 ghostty-resource-efficiency.md 记录了该所有权模型下的实测数据注意这些是核心 WASM 分配与压力测量不是应用总 RSS20 个空 120x40 模型在首帧渲染前候选实现 10.375 MiB对比基线 15.4375 MiB约 32.8% 的 WASM 分配下降单模型从 2.250 MiB 降到 1.938 MiB五模型压力运行每变体 655,360 次更新、约 62 MiB 输入字节SIMD 与标量变体最终均稳定在 68.125 MiB WASM 内存最后 16 个采样窗口零增长启用原生块 pin 时每模型恰有 2,048 个 marker原生呈现数组cell arrays 及其 grapheme、hyperlink、placement 快照首次呈现时才分配回收时释放但解析器、回滚、选区与命令 pin 全部保留隐藏期间的写入与 resize 不会重建呈现回归测试断言100 个未变化的已调度帧零上传零绘制WebGPU 单行上传 7,680 字节、WebGL 4,800 字形字节短暂停后不重新打包 cell隐藏光标/未聚焦窗口无闪烁唤醒1,000 次合并的搜索失效只推进一次搜索步骤选区行损伤不触发原生渲染更新。复现与验证入口如果你想在本地验证本文描述的呈现池行为仓库提供了可复现的工具链均不启动应用# 五模型压力测试颜色、Unicode、emoji、OSC 8 链接、回滚修剪、隐藏解析、呈现释放、resize 压缩 TERAX_SOAK_REPORT/tmp/terax-ghostty-soak.json pnpm soak:ghostty # 启用原生命令 pin 的块压力测试 TERAX_SOAK_BLOCKS1 TERAX_SOAK_REPORT/tmp/terax-block-soak.json pnpm soak:ghostty # 分配与解析工作负载的按产物对比每个产物独立进程 TERAX_PROFILE_BASELINE/tmp/terax-core-baseline TERAX_PROFILE_REPORT/tmp/terax-core-profile.json pnpm profile:ghostty运行时诊断可这样开启localStorage.setItem(terax:terminal-diagnostics, 1); // 重新加载后 window.__teraxTerm(); // 前端计数器 await window.__teraxTermSnapshot(); // 原生队列计数器与宿主 RSS var trace window.__teraxTermTrace(); // 有界 10 分钟资源记录最多 600 个样本1 秒一次 JSON.stringify(trace.stop()); // 切换桌面/遮挡/睡眠后捕获注意window.__teraxTermSnapshot()的宿主 RSS 只覆盖 Rust 宿主进程不含 WebContent 与 GPU 进程不能当作应用总内存。与相关文档的关系本文档是 TERAX.md 的展开说明若两者冲突以 TERAX.md 为准。关于所有权上限、测量方法与局限性的完整记录见 ghostty-resource-efficiency.md发布前的平台验证macOS 13 WKWebView、Windows WebView2/ConPTY、Linux WebKitGTK与打包验证门禁见 ghostty-release-readiness.md。两者都确认当前自动化检查建立的是可复现的核心/资源不变量尚未完成多平台、多日的打包级生产认证。【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Terax 终端渲染器池架构解析：模型所有权、呈现资源租约与故障恢复
Terax 终端渲染器池架构解析模型所有权、呈现资源租约与故障恢复【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-ai导读Terax 是一套终端优先的 AI 原生开发工作区其终端内核基于 libghosttyWASM默认走 WebGPU 渲染并以自研 WebGL2 渲染器作为兼容回退。本文以 docs/architecture/terminal-renderer-pool.md 为骨架系统讲解 Terax 的终端模型model所有权模型、GPU 呈现资源池renderer pool的租约机制、分窗帧率调度、窗口遮挡与休眠下的资源回收策略以及渲染器替换的事务式恢复流程。读完你将理解为什么切换标签页、切换图形 API 甚至 GPU 上下文丢失都不会重置终端的解析器、回滚缓冲、选区、搜索与命令块状态以及 Terax 如何在约 7~8 MB 的轻量级打包体积下维持多标签终端的高性能呈现。核心所有权模型一个叶子 一个模型 一个 PTYTERAX.md 与本文档共同确立的第一条不可变约定是每个终端叶子terminal leaf独占一个 libghostty 模型与一个 PTY渲染器租约renderer lease永远不拥有终端状态。这意味着状态归属被严格划分模型与会话状态解析器、回滚缓冲、选区、搜索、命令块挂靠在叶子tab / pane上由useGhosttyTerminalSession每个叶子持有一个持久模型与 PTY呈现资源GPU 设备、pipeline、图集租约、损伤调度器是窗口级共享的由运行时runtime统一管理任何表面surface只以租约形式借用。因此切换标签页、更换图形 APIWebGPU → WebGL、GPU 上下文丢失、窗口遮挡恢复都只是呈现事务层面的变化永远触碰不到模型。TERAX.md明确写道WebGPU can fail over to WebGL without replacing the model, PTY, selection, search, or block historyWebGPU 可以无缝降级到 WebGL而无需替换模型、PTY、选区、搜索或命令块历史。这是整个渲染器池设计的第一性约束。呈现资源WebGPU 共享运行时WebGPU 路径的核心是 WebGpuTerminalRuntime。它通过模块级单例getWebGpuTerminalRuntime()提供给整个窗口一个窗口只持有一份GPU 设备device、两个渲染管线color pipeline 与 glyph pipeline、图集atlas租约与损伤调度器。从源码中可以确认的关键常量与机制常量值作用MAX_ATLAS_COUNT8窗口内活跃字形图集的上限超出后先尝试驱逐无引用图集否则抛出预算耗尽错误MAX_WARM_UNUSED_ATLASES1允许保留的空闲热图集数量避免短期切换时反复重建ATLAS_IDLE_TTL_MS30_000空闲图集的 30 秒存活期到期后被回收MAX_IN_FLIGHT_FRAMES2同一时刻最多只有 2 个 WebGPU 帧等待 GPU 完成帧提交采用每帧一个 encoder/submission的策略flushFrame中只要dirtySurfaces非空就创建一个带Terax terminal window frame标签的GPUCommandEncoder遍历本批表面逐一渲染最后只调用一次queue.submit([encoder.finish()])。inFlightFrames达到MAX_IN_FLIGHT_FRAMES时requestFrame直接返回脏帧被合并而不会产生新的上传与提交——这正是文档所述至多两个提交等待 GPU 完成的实现。图集以租约GlyphAtlasLease形式发放acquireGlyphAtlas/acquireIsolatedGlyphAtlas会以字体、字号、字重、行高、字距与 DPR 组合成 key同一 key 复用同一图集release()幂等地减少引用计数并触发延迟回收scheduleAtlasReap。空闲 CPU 字形缓存glyph cache保留一份、30 秒空闲生命周期其覆盖像素约 1 MiB只有使用 emoji 后才额外增加 1 MiB 彩色像素。WebGL 兼容回退至多五个渲染器槽位的池当 webview 不支持 WebGPU 时Terax 使用自研的 WebGL2 渲染器适配自上游 Ghostty 呈现层保留上游 MIT 署名见 webgl/UPSTREAM.md不安装、不携带任何 xterm 运行时或插件。WebGlTerminalRuntime 实现了与 WebGPU 对称的池化模型常量值说明MAX_WEBGL_RENDERER_SLOTS5窗口内最多 5 个 WebGL2 渲染器槽位MIN_WARM_WEBGL_RENDERER_SLOTS1始终保留 1 个空闲暖槽位WEBGL_RENDERER_IDLE_TTL_MS30_000空闲槽位超过 30 秒未使用即被销毁每个槽位独占一个WebGlCellRenderer它消费同一个 Ghostty 模型与同样的脏行dirty-row信息——与 WebGPU 渲染器共享模型侧的全部状态。槽位租约的生命周期是acquire(surface, host, profile)按渲染 profile字体、DPR 等查找空闲槽位若 5 个槽位都已占用且无空闲则抛出WebGL terminal renderer pool exhausted (5 visible panes)错误槽位绑定 surface 后resetModel()并将 canvasattach(host)release(surface)槽位归还池中detach()记录lastUsed并安排空闲清扫定时器sweepIdleSlots()超过 30 秒未使用的空闲槽位被dispose()并从池中移除但至少保留 1 个暖槽位。discard(surface)用于渲染器出错场景直接销毁该槽位。窗口隐藏时trimForHiddenDocument()会清掉所有无主槽位。值得强调的是池化的边界源码注释明确写道 Ghostty models are never pooled here这里从不池化 Ghostty 模型。WebGL 池只池化呈现器隐藏标签页释放 GPU 槽位的同时WASM 终端状态保持存活。帧率调度60 / 30 / 15 的按面板per-pane截止时间帧率并非全局统一而是由 SurfaceFramePacer 按每个面板自己的截止时间deadline驱动核心常量在 renderScheduling.ts 中常量值语义FOCUSED_TERMINAL_FRAME_INTERVAL_MS1000 / 60聚焦面板最多 60 fpsBACKGROUND_TERMINAL_FRAME_INTERVAL_MS1000 / 30后台面板独立截止时间最多 30 fpsUNFOCUSED_WINDOW_FRAME_INTERVAL_MS1000 / 15未聚焦窗口每面板最多 15 fpsINTERACTION_PRIORITY_MS150用户交互滚轮、拖动、按键给予该面板 150 ms 的聚焦级帧率特权关键实现细节terminalFrameIntervalMs(windowFocused, hasFocusedSurface)决定基础帧间隔但聚焦面板的输出不会把后台面板拉到 60 fps——每个 surface 独立计算自己的 deadlineinteract(surface, now)为交互面板写入now 150ms的优先截止时间期间按聚焦帧率渲染150 ms 到期即回落不启动任何空闲定时器或帧循环delay()返回最早截止时间 - 当前时间 - FRAME_LEAD_MS(1/60s)调度器据此使用setTimeout或requestAnimationFrame避免 RAF 回调抖动跳过本可呈现的帧WebGPU 的MAX_IN_FLIGHT_FRAMES 2保证 GPU 落后时脏工作只合并、不堆积。窗口生命周期遮挡、睡眠与两秒宽限呈现资源的回收完全由窗口可见性驱动由 windowPresentation.ts 提供的单一共享订阅组合了三路信号DOMvisibilitychange、原生 macOS 窗口遮挡occlusion与睡眠/唤醒通知通过 Tauri 事件terax:window-presentation与window_presentation_state命令桥接。各状态下的呈现行为可归纳为状态呈现行为可见、聚焦面板损伤驱动至多 60 fps可见、后台面板独立截止时间至多 30 fps可见、未聚焦窗口每面板至多 15 fps可见但正在交互的面板即使窗口未聚焦也享受 150 ms 的 60 fps 交互截止时间隐藏或完全遮挡的窗口帧、闪烁定时器、搜索工作、选区自动滚动立即暂停不可见不足 2 秒保留呈现资源避免桌面切换时的重复分配抖动不可见超过 2 秒释放表面缓冲、原生渲染状态、canvas 配置与图集纹理销毁 WebGL 上下文原生睡眠通知立即请求资源回收隐藏的终端标签页立即释放其呈现租约源码层面的佐证WebGpuTerminalRuntime.handleVisibility收到reclaim时挂起所有零引用图集WindowPresentationPolicy与WebGlTerminalRuntime的handleVisibility在不可见时直接cancelScheduledFrame()而 WebGPU canvas 被回收前会先unconfigure再缩放到 1x1同时保留目标几何信息供下一次呈现事务恢复。原生快照携带单调递增的revision迟到的 IPC 初始响应不会覆盖更新的状态。无论窗口如何变化PTY 与终端模型始终保持隐藏标签页的模型会继续解析输出通过有界的两消息窗口与 2 MiB 待处理/在途字节上限直到叶子关闭。文档与 ghostty-resource-efficiency.md 都强调Models keep parsing until their leaves close模型持续解析直到其叶子关闭。命令块与辅助输出惰性加载、归属模型、随呈现挂起命令块command blocks是 Ghostty 模型/会话的一部分包括其跟踪的原生 pinmarker命令锚点endpoint columns在解析期parser-time由 Ghostty 生成因此命令范围能跨回流reflow存活且不会把后续提示符和命令包含进去原生 marker 环上限2,048 个 pinJavaScript 侧历史上限1,000 条块 / 512 KiBUTF-16 估算的命令与 cwd 文本块控制器block controller与覆盖层overlay惰性加载只在块会话中使用隐藏或被遮挡时块的呈现工作停止共享 shell 编辑器拥有提示符输入交互式命令与备选屏alternate-screen应用拥有网格输入WebGPU 与 WebGL 两套呈现后端施加完全相同的输入与光标策略。可访问输出accessible output即屏幕阅读器文本是opt-in、惰性、有界的限制为 256 行 / 64 KiB可见时每秒最多刷新 4 次250 ms 合并并随窗口呈现一起挂起。它直接读取原生文本范围不会移动渲染器视口或选区——即使可访问文本刷新用户的滚动位置与选区保持不变。事务式恢复替换呈现永不触碰模型渲染器替换renderer replacement是本文档描述的最关键恢复路径其实现位于 replaceSessionSurface.ts核心顺序是从旧表面快照搜索状态searchController().snapshot()并挂起旧搜索创建替换表面create()并先 attach 新表面将搜索快照恢复到新表面restore(search)——不重置查询、不跳过当前匹配全部成功后才释放旧表面与旧输入previousInput?.dispose()previous?.dispose()若中途失败释放已创建的替换资源、resume()旧搜索并重新抛出错误——旧表面与模型保持完好。这一先建后拆的顺序保证了替换是原子的呈现层永远不存在无渲染器可用的窗口期。对应的故障处理语义WebGL 回退失败显示带重试Retry操作的错误呈现同时保持存活的模型与 PTY——用户重试只是再次替换呈现而不是重启会话WebGPU 设备丢失recoverDevice会先释放设备与图集、隐藏期间推迟设备重建窗口恢复可见后再重新初始化初始化期间丢失的设备被隔离quarantine而不是进入无界恢复循环文档明确禁止用序列化、重放、清空或重新 spawn 终端来修复呈现问题——呈现损坏与终端状态是两回事。TERAX.md补充了两个相关约束延迟导入WebGL 表面与渲染器只在选中、需要回退或被诊断显式请求时加载不能安装进已关闭、已重启或已替换的会话不支持图形能力时展示可见错误与重试而不是悄悄更换模型。资源边界与度量证据配套的 ghostty-resource-efficiency.md 记录了该所有权模型下的实测数据注意这些是核心 WASM 分配与压力测量不是应用总 RSS20 个空 120x40 模型在首帧渲染前候选实现 10.375 MiB对比基线 15.4375 MiB约 32.8% 的 WASM 分配下降单模型从 2.250 MiB 降到 1.938 MiB五模型压力运行每变体 655,360 次更新、约 62 MiB 输入字节SIMD 与标量变体最终均稳定在 68.125 MiB WASM 内存最后 16 个采样窗口零增长启用原生块 pin 时每模型恰有 2,048 个 marker原生呈现数组cell arrays 及其 grapheme、hyperlink、placement 快照首次呈现时才分配回收时释放但解析器、回滚、选区与命令 pin 全部保留隐藏期间的写入与 resize 不会重建呈现回归测试断言100 个未变化的已调度帧零上传零绘制WebGPU 单行上传 7,680 字节、WebGL 4,800 字形字节短暂停后不重新打包 cell隐藏光标/未聚焦窗口无闪烁唤醒1,000 次合并的搜索失效只推进一次搜索步骤选区行损伤不触发原生渲染更新。复现与验证入口如果你想在本地验证本文描述的呈现池行为仓库提供了可复现的工具链均不启动应用# 五模型压力测试颜色、Unicode、emoji、OSC 8 链接、回滚修剪、隐藏解析、呈现释放、resize 压缩 TERAX_SOAK_REPORT/tmp/terax-ghostty-soak.json pnpm soak:ghostty # 启用原生命令 pin 的块压力测试 TERAX_SOAK_BLOCKS1 TERAX_SOAK_REPORT/tmp/terax-block-soak.json pnpm soak:ghostty # 分配与解析工作负载的按产物对比每个产物独立进程 TERAX_PROFILE_BASELINE/tmp/terax-core-baseline TERAX_PROFILE_REPORT/tmp/terax-core-profile.json pnpm profile:ghostty运行时诊断可这样开启localStorage.setItem(terax:terminal-diagnostics, 1); // 重新加载后 window.__teraxTerm(); // 前端计数器 await window.__teraxTermSnapshot(); // 原生队列计数器与宿主 RSS var trace window.__teraxTermTrace(); // 有界 10 分钟资源记录最多 600 个样本1 秒一次 JSON.stringify(trace.stop()); // 切换桌面/遮挡/睡眠后捕获注意window.__teraxTermSnapshot()的宿主 RSS 只覆盖 Rust 宿主进程不含 WebContent 与 GPU 进程不能当作应用总内存。与相关文档的关系本文档是 TERAX.md 的展开说明若两者冲突以 TERAX.md 为准。关于所有权上限、测量方法与局限性的完整记录见 ghostty-resource-efficiency.md发布前的平台验证macOS 13 WKWebView、Windows WebView2/ConPTY、Linux WebKitGTK与打包验证门禁见 ghostty-release-readiness.md。两者都确认当前自动化检查建立的是可复现的核心/资源不变量尚未完成多平台、多日的打包级生产认证。【免费下载链接】terax-aiLightweight (7MB) Terminal-first AI-native dev workspace项目地址: https://gitcode.com/GitHub_Trending/te/terax-ai创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考