English

本页沿带样式的单元格介绍字体、图集、GPU/CPU 绘制与保留帧损伤。 适配器选择和帧节奏见渲染模式，分配上限与记账见内存。

flowchart LR
    grid["带样式的网格单元格"] --> runs["样式与字符簇片段"]
    runs --> shape["FontStack + HarfBuzz 塑形"]
    shape --> fallback["回退字体解析"]
    fallback --> raster["DirectWrite 或 FreeType 光栅化"]
    raster --> glyphAtlas["CPU 字形图集"]
    media["已解码内联媒体"] --> imageAtlas["CPU 图像图集"]
    glyphAtlas --> presenter{"使用 Windows 软件呈现器？"}
    imageAtlas --> presenter
    presenter -- 是 --> cpu["读取 CPU 图集与实例，合成完整 BGRA 帧"]
    cpu --> gdi["GDI 呈现"]
    presenter -- 否 --> upload["脏矩形上传"]
    upload --> gpu["将实例绘入保留的 GPU 帧"]
    gpu --> blit["复制到交换链并呈现"]

sonicterm-render-model 是与渲染器无关的边界。应用为每个可见窗格提供一个 PaneRender，其中包含网格、窗格矩形、视口、光标、焦点、滚动条、广播状态和内联图像。 生产路径用独立参数传递 UI 状态；RenderInputs 仍是公开兼容类型，不是生产入口。 sonicterm-gpu::core::GpuRenderer 负责帧组装，并分派到其私有呈现器。网格、配置和界面类型 通过未改动的整 crate render_model::boundary 重导出进入渲染器。公开的 TextPipeline、 两个 Painter trait 和 RenderInputs 都保留为兼容接口；它们均不替代生产路径中的 PaneRender 和独立参数。 新建的生产渲染器会把仅供兼容的异步 loader 槽保留为 None。显式调用 set_async_loader(()) 仍会记录 Some(())，并可通过 async_loader() 观察，但不会启动字体 工作。FontStack 自身的回退解析和设备状态唤醒器保持不变。

应用使用非阻塞 try_lock 获取所有可见窗格的解析器。只要有一个窗格正忙，就推迟 整帧，而不是显示新旧状态混杂的窗格。渲染器仅含元数据的 FramePlan 在塑形前确定裁剪和 视口行槽；组帧阶段保留借用网格和解析器保护对象，并在呈现前释放，CPU 图集/缓存修改仍然有状态。

每个窗格只把不足一行的剩余空间移到文字网格上方，让完整行贴近配置的底部 padding。 偏移按整数物理像素应用，因此底部仍可能剩下不足一个像素。字号、行高、PTY 尺寸及配置的 padding 不变。受资源限制而行数较少的网格不吸收整行的未使用区域；若网格已经高于截断后 的像素矩形，则不再向下偏移。

文字背景、字形、光标、选区、链接、内联媒体与终端输入法共用规划后的网格原点。窗格装饰、 焦点闪烁、滚动条、分隔条和底部标签栏保持原几何。边距不对应终端单元格。窗口尺寸、DPI、 字体或 padding 变化会使旧布局失效。

sonicterm-engine::FontStack 把 sonicterm-font 适配给渲染器。默认主字体族是 Rec Mono St.Helens。匹配会考虑字体族、样式、字重、字宽、字体面索引、变体和码点 覆盖范围。可变字体元数据损坏、缺失或越界时，会回退到基础 OS/2 字重与字宽，不会中止应用。

平台字体发现隐藏在 FontLocator 之后：

• macOS 使用 CoreText 回退与字体 URL；
• Windows 使用 DirectWrite/GDI 描述信息并提取原始字体；
• 其它 Unix 系统使用 Fontconfig，并把候选限制为等宽、双宽或字符单元字体。

配置主字体之后，代码内置回退列表依次尝试 JetBrains Mono、Symbols Nerd Font Mono 和 Noto Color Emoji。已加载字体都不覆盖某码点时，后台解析器查找平台字体并追加到该 FontStack。自动解析会把带 OpenType MATH 表的字体排在 文本字体之后，但不会排除它；没有文本字体覆盖时，数学字体仍可提供该码点。在 [font] 中显式指定的字体族始终优先，不受 MATH 表影响。

字体重载后，已打包字体目录仍会附着在可见和预热渲染器上。Linux 包不会把随附的四个 Rec Mono face 安装到系统，因此必须保留这些目录。

手动标题优先；否则，前台为 rmux、tmux 或 screen 时，即使存在 CWD 也优先使用 非空原始 OSC 标题。其它进程保持 CWD 优先的自动标题。下表的图标查找只使用可执行文件身份。

操作系统提供前台可执行文件后，normalize_proc_name 会按 / 和 \\ 取文件名，去掉 一个登录 shell 的 - 前缀和一个不区分大小写的 .exe 后缀，再转为小写。界面随后只做 精确匹配，不解析参数、终端输出或窗口标题。未知进程在已有工作目录时使用文件夹字形 U+F07B，否则使用终端字形 U+F489。

前台进程探测只在 macOS 和 Windows 实现。Linux 与其它没有探测实现的平台不会返回 进程名，因此标签页使用工作目录的文件夹字形或终端回退字形。

当 SonicTerm 进程本身拥有提升的操作系统权限时，每个标签页还会显示一个独立且不动画的 锁形警告标记。Windows 从当前进程 token 读取这个全局状态；macOS 和 Linux 以有效用户 ID 为零作为判断依据。普通权限的 Windows SonicTerm 中，如果某个标签页当前的前台后代进程 拥有提升 token，也只在该标签页显示标记。每个窗格把前台进程缓存 500 毫秒。帧和 Windows 定时器只设置需求；sonicterm-fg-probe worker 在事件循环线程之外采样，在 Windows 上每批使用 一次进程表快照，并在 UIPI 阻止直接读取高完整性子进程 token 时识别所选后代路径中的真实 gsudo.exe broker。结果晚一个事件显示，且只在窗格进程身份未变、子进程未退出时显示。成功接受 输入后保证在 500 毫秒后探测；只要按标签页警告可见，独立的警告唤醒每 500 毫秒探测一次，直到 控制权回到普通 shell；子进程退出会立即清除进程名和警告。结果未变化的探测不会重绘，空闲标签页 也不会轮询。

该标记由四边形组成的矢量界面元素绘制，不是字体字形或标题字符。背景使用主题 ANSI danger 红色，锁形则按线性光对比度选择黑色或白色，因此活动、非活动、悬停、自定义颜色、浅色、 深色和高对比度标签页都保持同样的警告样式。拖动源标签页时，整个标记采用通常的源透明度。

该标记不会替换或重新着色前台进程图标，也不会写入 Tab.title、auto_title 或 custom_title，所以 OSC 标题和手动重命名都不能移除或保存它。特权布局会先预留标记宽度 和间距，再只缩短标题后缀；空间允许时，开头的 #N 身份和进程图标始终保留。主窗口与拆出 窗口通过 GPU 和 Windows 软件渲染路径绘制同一个进程级状态。此标签页界面元素不会修改 可执行文件资源、原生窗口图标、任务栏、Dock、应用切换器或软件包图标。

以下是内置 Rec Mono 字体提供的私用区码点：

HarfBuzz 把样式片段塑形成字形 id、字符簇、推进量和偏移量，再把字符簇映射回终端列。 同一字符簇内的字形位置由 HarfBuzz 的累计笔位置与每个字形的水平、垂直偏移共同决定； 进入下一个字符簇时，笔位置会重置到其首个终端单元格。缺失字符簇会依次尝试回退字体； 最后使用 .notdef 或替代字形，不会停止应用。

帧内塑形从不等待回退字体查找。已加载字体都不覆盖的字符只会被调度一次，交给该配置的回退 工作线程，在之后某一帧合并其字体之前绘制为 notdef。每次帧内塑形只尝试获取工作线程待发布 句柄的锁：锁空闲时合并已发布的字体并重新塑形；工作线程持有锁时，这一帧用目前已合并的字体 塑形。一次调用最多塑形 MAX_FRAME_SHAPE_ATTEMPTS（8）次，超出后该片段只在这一帧报错，下一帧 重新开始。帧路径之外的显式调用者仍可以等待工作线程。

工作线程释放待发布句柄的锁之后，会递增回退通知的代次；每个通知至多有一个未送达的 FontFallbackReady 事件。处理程序为可见窗口请求一帧，对隐藏窗口只做标记。每一帧在计算标签宽度 和帧键之前调用一次 begin_frame_fonts：当通知或代次与上次应用的不同时，它清除行缓存、线条四边形 缓存和帧键，递增样式修订号，丢弃图集中的缺失字形条目和预编辑缓存，递增标签标题宽度纪元，清空界面 文本段缓存，并计入 font_fallback_applies。在一帧中途合并的字体可以绘制真实字形，而同一帧早先测量的 标题仍保留 notdef 的宽度；下一个被应用的代次会纠正它。

渲染器通过两个帧入口塑形：FontStack::shape_text_for_frame 与 measure_text_width_for_frame。每个 FontStack 按粗体/斜体样式记住其字体，因此预热后的字体栈塑形时不再复制文本样式，也不再对已加载字体 的键做哈希。只要共享 FontConfiguration 的 face_epoch 不变，记忆就有效。config_changed 在丢弃已 加载字体之后、重新加载字体目录之前递增该纪元，change_scaling 在其自身清除旁递增；字体栈的每个克隆 与 with_font_size 视图都与这个共享纪元比较，因此通过其中一个做出的替换对全部可见。回退合并在原处 扩展同一字体，不移动纪元，因此记住的字体会用合并后的句柄塑形。标签标题与搜索浮层的图标和标签按键 塑形一次，之后从保留的文本段绘制（见行缓存与塑形缓存）。

图集区分缺失字形与空字形。任何字体都无法解析的字符会作为缺失条目缓存，并绘制一个一像素宽的 轮廓框：在终端网格中占一个单元格，在界面文字中宽为一个推进量、高为一个上升高度，并像字形一样 被裁剪。空的字形图块（例如空格）只推进笔位置。

只有在片段没有组合附加内容、双宽单元格标志或常见连字参与字符时，可打印 ASCII 快速路径才绕过 HarfBuzz。受保护字符为：

= ! < > - _ : | & *

组合标记和变体选择符留在所属字符簇中。宽字符和多单元格连字保持自然推进量与偏移量。 替代回退字形会保留原字符簇坐标。

Windows 系统回退会完整编码 UTF-16；映射位置、剩余长度及 locale 范围都按代码单元计数。 补充平面字符始终保留为代理项对。映射返回零长度、越界或拆分代理项对时，整个原生回退请求 失败，不返回部分候选；调用方报告失败并继续其余已配置的字体查找源。成功请求返回的候选 按首次出现的顺序去重。

原始塑形文本和集合使用显式 sonicterm_font::payload TRACE 目标。显式启用的输出 sink 可以记录它们，崩溃历史不会。安全回退错误只保留阶段和大小/数量诊断，不保留受影响文本。 白色前景和不染色的彩色字形是正常渲染，不产生常规逐字形 warning。真正的图集和呈现诊断 仍然保留。

粗体和斜体负责选择字形。前景色不会切分塑形文字段。塑形后，渲染器解析主题默认色、256 色 索引和 24 位 RGB。反色会交换前景与背景。dim 会在保存的 sRGB 编码空间内，把前景向有效 背景混合 45%，随后再按 sRGB 表面或 CPU 混合的需要转换绘制值。

背景是四边形，不是字形。相邻且相同的非默认背景会合并。默认背景来自损伤清理。下划线段会 形成单线、双线、波浪、点线或虚线四边形。有 SGR 58 显式颜色时使用它，否则使用前景色。 GPU 线段端点存放在与 HSV 颜色变换分离的几何参数中，因此波浪下划线的形状不会改变其最终颜色。

解析器会保存 blink、hidden 和 strikethrough 标志。当前终端渲染器没有针对这三个标志的 专用绘制分支。

Windows 默认使用 DirectWrite 的 natural-symmetric ClearType 光栅化并禁用网格拟合， 保留轮廓对齐，而不是逐字形按 hint 独立吸附。支持彩色的字体使用既有 FreeType 彩色路径， 避免在 ClearType 掩码中丢失图像内容；其它 DirectWrite 失败也回退 FreeType。 macOS 和其它 Unix 使用 FreeType。FreeType 支持单色、灰度、LCD 次像素、BGRA 彩色 位图字形，以及 COLR/SVG 交接。HarfBuzz/COLR 绘制路径通过 Cairo 支持分层彩色字形和 线性、径向、扫描渐变。颜色线没有可用色标时不绘制任何内容；扫描渐变的平铺有上限， 因此畸形或极端颜色线会退化为粗略近似，而不会产生无界工作量。COLR 字体需要有效的 CPAL 颜色条目；调色板标签、条目标签和标志都是可选的。版本 0 的 CPAL 表（例如 Noto Color Emoji） 不含这些数组，仍能正常渲染：缺少标签时名称为空，缺少标志时取 0。存在的标签是一个名称 ID： 它解析为字体中具有该 ID 的名称记录，并按与字体名称相同的语言规则选择；没有对应记录的 ID 读作空名称。 COLRv1 字形若带有 ClipBox，会以设备像素作为外层裁剪作用于整个绘制图（包括合成分组），因此 Cairo 自身无法界定范围的绘制图（例如以 In 合成的渐变）仍会在其 ClipBox 内光栅化。ClipList 是可选的：没有 ClipBox 的字形不加裁剪地光栅化， 由其自身绘制界定范围；没有 ClipBox 且无法界定范围的绘制图没有有限的渲染结果，因此会失败，错误会指出缺少 ClipBox。 FreeType 对缺少 ClipBox 和读取 ClipBox 出错报告相同的状态，因此 SonicTerm 将两者都视为没有 ClipBox， 并尝试不加裁剪的渲染，仍受同样的范围检查约束。位图向外取整到整像素。

FreeType COLRv1 路径让所有绘制操作数都保持字体单位。PaintGlyph 轮廓以不缩放、 不变换的方式加载，渐变锚点和半径保持字体给出的值，由 FreeType 包含的根变换（依据字体的尺寸和变换构建）作为唯一的设备像素映射。因此在任何字号下， 渐变都留在其轮廓内的正确位置，合成斜体对轮廓和渐变只剪切一次，与对 ClipBox 的剪切一致。 这些轮廓从不做 hinting，合成粗体也不会加粗它们。不缩放加载有两个 FreeType 限制： 可变字体的轮廓坐标会被取整为整数字体单位；“tricky”字体的轮廓依赖 hinting 指令， 不缩放加载可能得到无意义的轮廓。

sonicterm-font::{ftwrap,hbwrap,fcwrap} 为生成的 FreeType、HarfBuzz、Fontconfig 绑定中的原始句柄管理安全生命周期。每次原生分配都配对正确的销毁函数。内嵌位图字形 先只加载度量，并在解码像素前检查字形分配预算。

对于字体字形，RasterTile::offset_x 相对水平笔位置测量，向右为正； RasterTile::offset_y 相对基线测量，向下为正。FontStack 将 bearing_x 和取负的 bearing_y 转换为这两个像素偏移，GlyphAtlas 再将它们复制到 GlyphInfo::px_offset。终端网格将笔位置锚定在字符簇首单元格的左边缘， 并把单元格内的基线位置加到纵向偏移上；塑形产生的步进和偏移另行应用。 界面文字使用其累进笔位置和基线，并按请求的文字大小缩放光栅偏移。 块字形和内嵌图片的生成方将两个偏移都设为零；它们的绘制路径忽略这些偏移， 改用单元格或图片矩形定位。

BGRA 彩色位图按非透明区域的半开边界裁剪，保留最后一行和一列墨迹。裁剪原点使 bearing 分别平移 +crop_x 与 -crop_y，而非按尺寸比缩放。自有通道转换、预乘、color/scaled 标志和分配上限保持不变。全透明但非空的位图保留原尺寸与 bearing，在 FontStack 转换和 图集插入后仍是有效空白字形，不会变成缺失字形哨兵。

独立状态圆圈 ⏺（U+23FA）、◯（U+25EF）、●（U+25CF）只在塑形后的字符簇 占一个非宽单元格，且没有组合字符或变体选择符时进行定向适配。图块按统一比例缩放到 单元格内保持纵横比的最大矩形，并沿两个轴居中。普通文字、复合字符簇、宽字形、自定义 块字形和多单元格连字保持自然光栅几何。GPU 与 Windows 软件呈现共用上游生成的同一矩形。

普通字体从磁盘流式读取：FreeType face 以回调流打开，只读取 FreeType 请求的数据帧； HarfBuzz blob 把文件读入自己的缓冲区。表目录中列出 SVG 或 COLR 表的字体 face 则不同： FreeType 会整份提取这些表（以及 CPAL），并在 face 存续期间一直保留；在回调流上每个 face 都持有自己的副本，彩色 emoji 字体的 SVG 表就有 18.55 MiB。这样的文件按文件版本（规范 路径、长度、修改时间，在 Unix 上还有设备号与 inode；Windows 使用路径、长度与修改时间） 整份读入一个共享的只读堆缓冲区，只读一次。该文件上的每个 FreeType face 都以内存流打开， 彩色表直接指向这块缓冲区而不被复制；每个 HarfBuzz blob（包括延迟构建的 SVG/COLRv1 绘制器）都包装同一块缓冲区。绘制器使用的正是其 FreeType face 打开的字节，即使之后磁盘上 的文件被替换或删除。

是否共享按 face 决定，依据是对 sfnt 表目录的有界读取（字体集先读 ttcf 头和所请求 face 的偏移，然后最多读取 256 条表记录）。格式错误或无法读取的表目录视为没有彩色表，继续使用 回调流。缓存只保存弱引用：最后一个使用它的 face 与 blob 关闭时缓冲区即被释放；磁盘上被 修改的文件属于新版本，会得到新的缓冲区。face 本身不共享。普通字体不共享，是因为把每个 字体文件（包括 75 MiB 的 CJK .ttc）整份保留所占的内存，多于它节省的彩色表。

源码固定版本为 FreeType 2.14.3、HarfBuzz 14.4.0、libpng 1.6.58 和 zlib 1.3.2。 仓库内的 FreeType 带有两项上游可变字体多余坐标修复；仓库内的 zlib 带有上游 inflateBack 无效距离修复以及三项相关的非阻塞 gzip 写入修复。这些修复已存在于导入的 源码中，而不是在构建时应用。准确的发布提交、归档 SHA-256、导入路径、每项已携带修复的 上游修订号与 URL，以及最终源码树摘要记录在 scripts/native-dependencies.json。头文件 报告基础发布版本，不包含额外修复修订号。Cairo 仍由平台提供；此清单不固定 Cairo，也不 表示 macOS 应用包已自包含其运行依赖。

FreeType 配置在第三方源码树之外生成，启用错误字符串、外部 zlib、PNG 字形、长 PCF 族名、次像素光栅化和受支持的布尔次像素 hinting 选项。定义缺失、重复或出现意外值会 使构建失败；C 编译探针还会检查预处理后这些选项仍然启用。不会恢复已淘汰的数值型 hinting 转换。Cargo 监视原生源码和配置输入；构建既不下载源码，也不初始化子模块。

仓库中的 Rust 绑定由 bindgen-cli 0.71.1 重新生成。两个生成脚本共用原生构建的配置生成器， 并优先包含生成头文件，确保 bindgen 和编译出的库看到相同的 FreeType 选项；保留定宽整数覆盖、定点数包装、 显式 unsafe 块和同级测试声明。原生版本测试检查实际链接的 FreeType/HarfBuzz 版本， 并核对 FreeType 无符号 span ABI。更新和验证命令见 仓库与工具链。

RowGlyphCache 按 (pane id, 内容键) 保存每行的字形记录、下划线段、缺字方框和缺失字符。 内容键是 SipHash（每个缓存实例各自随机生成密钥），依次覆盖该行的每个单元格、列数、样式修订号、 单元格尺寸、基线、光栅尺寸、是否由软件呈现器绘制，以及该行的活动悬停片段。它不包含绝对行、 视口行位置、窗格原点、表面尺寸或选区，因此滚动、随窗格移动或被选中的行保持同一个键并直接重放。 记录按行内单元格网格定位：图集区域、颜色、分开保存的光栅偏移与塑形偏移、光栅尺寸以及字形 跨越的列。命中和未命中都在该行当前的行位置与原点处投影这些记录（单元格原点、光栅偏移、 塑形偏移、状态标记适配、设备像素对齐、NDC），因此重放的行与重新塑形得到的字节完全相同。 每个条目还记录其图集内容身份，身份不同的查找不会命中。随机密钥可阻止离线构造碰撞；64 位 碰撞仍然可能发生，这是这个概率性缓存在被淘汰前重放错误行的唯一情形。

只接纳完整的行。若某行有字形被图集拒绝、有块字形什么也没画出、有样式段塑形失败，或缺少塑形器 或光栅化器，该行从局部缓冲绘制但不缓存；每个样式段仍会塑形并绘制。缓存为缺失的字形、空白 以及非块字形的零面积图块是稳定结果，仍可接纳。在软件呈现器上，块字形按依赖行位置的整数目标 尺寸光栅化，因此查找含块字形的行时会在当前位置重新计算每个块的目标尺寸，尺寸不同即未命中， 新的塑形结果替换该条目。

每次组装都先用所有被绘制窗格的尺寸调用一次 begin_frame；未被绘制或尺寸改变的窗格此时被释放。 在每个窗格内，固定阶段先计算计划要发出的每一行的键，并在第一次接纳之前把这些键与已呈现帧 显示的键（已提交的行位置）一起固定；淘汰从不移除已固定的键。每个发出的行位置的键先暂存， 只有该帧呈现时才提交；其他任何结果（包括组装或呈现器返回 Err）都丢弃暂存。每个窗格最多保存 4 × rows 个条目和 4 × rows × cols 个单元格的负载；超出任一上限的接纳会按最久未用顺序淘汰 该窗格未固定的行，直到降到各上限的四分之三。大于 cols 个单元格负载的行永不接纳。所有窗格 合计的负载通过拒绝接纳保持在 448 MiB 以内，表、行位置向量与固定列表通过让窗格不被跟踪（照常 绘制但不缓存）保持在 64 MiB 以内，因此每次变更后缓存报告的存储都不超过每渲染器 512 MiB 的包络。 脏行不会删除任何字形行：内容变化本身就会未命中。LineQuadCache 为每个 (pane id, absolute row) 保存一个背景/装饰投影，用包含视口行位置和选区重叠的行哈希验证；脏行按绝对行使条目失效， 容量已满时清空。

行缓存之下没有塑形结果缓存：按内容建键的行缓存已经会重放重复的行，未命中的行会重新塑形。两个界面 缓存在网格之外保留塑形结果：

• 标签标题。 一张 64 槽的固定表按标签位置保存每个标题适配后的文本段。键为显示文本、标签字体的键 （字体族、大小、字重、缩放与字体栈是否存在）、标签标题回退纪元、光栅尺寸以及文本可用宽度；颜色是 绘制参数，不属于键。预热且未变的标题绘制时不塑形。只有整标题测量、省略号测量与最终塑形都成功，且 不超过 256 字节文本与 512 个字形时才保留；测量失败时照旧绘制，不保留任何内容。位置 64 及之后的标签 不经缓存绘制，每帧丢弃位置不小于标签数的槽位。应用回退代次会递增纪元，因此以 notdef 保留的标题会 未命中一次，并用合并后的字体重新塑形：与行缓存相同的一帧延迟。
• 界面文本段。 一张 32 槽的固定表保留搜索浮层的图标与标签文本段，按样式、大小、原生 em、字体栈 与文本线性查找；表满时未命中会替换最久未用的条目。徽标宽度读取文本段的原始塑形推进量，与 measure_text_width_for_frame 的结果逐位相同；绘制与字段几何读取同一文本段经空白调整后的笔推进量。 准入同样限制为 256 字节与 512 个字形。正文字体栈没有自己的纪元，因此应用回退代次会清空这张表。

字体变更、缩放变更与 clear_shape_cache 会在行缓存失效旁清空两张表，因为被替换的字体可能保持每个 标题键不变。主题变更两者都不清除。由主题派生的界面调色板也会保留：构造时预先生成，只有主题颜色不同 时才重新派生。只有主题颜色字符串合计不超过 4 KiB 时才保留；超过的主题每次请求都重新派生，从不保留。

字体、主题、缩放、窗格身份、图集重置或内容身份变化都会使相关条目失效。字体或 DPI 变化会一起重建正文、页脚和标签页标题字体栈，并使共享字形图集失效：

• 终端文字、命令面板查询/结果和普通界面文字使用配置的正文大小；
• 命令面板页脚与分类/不可用原因副标题使用 max(正文 - 1, 1)；
• 标签页标题使用 正文 + 1。

三个字体栈使用相同的字体族、DPI 和字重比例。原生光栅角色标签会分开图集条目，因此 页脚或标签页标题不会缩放已缓存的正文位图。

quad 缓存容量约为可见总行数的四倍，容量已满或几何变化时清空；字形缓存由上面的每窗格 配额和预算约束。remove_pane 先淘汰该窗格字形行，再淘汰 quad 行，保留其它窗格并请求表压缩。 当前分配统计表与嵌套向量容量，不只统计有效长度。

字体变化重建字体栈、重置字形元数据，并使两种行缓存与 FrameKey 失效；DPI 变化还重建 匹配的图集上传资源。主题变化推进样式修订号并标脏全部窗格行。接受表面 resize 后，先替换 保留纹理、使两种缓存和帧键失效，再调整 grid/PTY。拓扑字段改变下一帧键，但拓扑本身 不清空行缓存。光标、选区、搜索、快速选择、IME、面板和通知等逐帧浮层独立组装。

CPU GlyphAtlas 是正方形 BGRA8 纹理，按需增长到最大 2048×2048（按每像素四字节计算为 16 MiB），索引条目最多 16,384 个。缩放系数不超过 1.5 时普通渲染器从 START_ATLAS_DIM_1X 起步，高于 1.5 时从 START_ATLAS_DIM_2X 起步；两者都是 2048，因此普通渲染器保持一直以来的 完整分配。预热的备用窗口可能从不绘制，因此从 256 的下限起步，在被接管后再增长；节省的内存 只来自预热备用窗口。图块放不下时图集先翻倍：常驻图块保持像素 位置，复制其像素并重新计算 UV，并为每个图块排队一个带类型的重新上传矩形；不会重新光栅化。 增长会推进图集身份，因此引发增长的帧被丢弃并重试一次，不重置图集。只有达到 2048 或条目上限时 才会淘汰。图像图集只使用固定尺寸构造函数，永不增长：它以 1×1 占位符启动，出现可渲染媒体而被 提升时替换为固定的 2048×2048 存储，空闲时再降级回占位符。分层打包器会先复用已释放矩形，再扩展 分层。键包含字体槽位、字形 id、字符、样式和原生光栅角色。

普通起始尺寸的基于测量的选取尚未完成。sonicterm_text::start_size_inputs::validate_table_start 在其单元测试和 glyph-atlas-working-set 步骤中检查两个起始常量。它始终接受不节省任何内存的 2048，因此空的或不完整的 START_SIZE_INPUTS 表在该尺寸下有效。任何更小的起始尺寸都会被拒绝， 除非以下三条同时成立：SIZING_ORACLE_COMPLETE 为 true；表中记录了该缩放下的每个必需输入 （缩放 1 下 macOS 与 Windows 上性能场景 S9 和 S12 结束时的图集，以及每个缩放下两个平台上 工作集辅助程序和 Windows 真实渲染器对 S9 与 S12 的测量）；并且起始规则对这些行恰好选出该 尺寸。任何把必需字形画成豆腐块（未解析、已解析但未光栅化，或大到无法放置）的测量都会选择 2048，因此永远 不能证明更小的起始尺寸合理。每条 glyph_atlas_working_set 行以 incomplete_glyphs 报告这一 数量；辅助程序对 S9 的测量目前报告了光栅化失败的 emoji，因此选择 2048。光栅化失败只能由 RASTER_EXCEPTIONS 中的条目豁免，且在每个失败仍能指出其字体的位置应用：条目指明平台、光栅角色、 字体内容与索引、字形 id、样式与字号，从不指明整个字族或文件名，并附有在添加它的 PR 中审阅过的原因。 字体内容为 <namespace>:sha256:<hex>，即加载该字体所用字节的 SHA-256，file、builtin 与 memory 各有独立的命名空间，因此与已审阅文件同名的无关文件永远不会被批准；文件名只保留在报告中供阅读。 无法解析到字体或字体字节无法读取的失败、未解析的字符以及超尺寸的必需图块从不豁免。该步骤打印原始失败、带原因的已批准 失败以及其余未批准的失败；只有未批准的数量计入 incomplete_glyphs。该列表为空，因此每个光栅化失败 仍然选择 2048。

SIZING_ORACLE_COMPLETE 为 false，仅记录行无法降低起始尺寸。Windows 真实渲染器覆盖测试等待 一帧已呈现且其终端行与 chrome 都未报告缺失字形的画面。两项报告都包含未画出任何内容的成形字形 （被图集拒绝、光栅化结果为空，或大到无法放置）以及从未完成整形的标签标题。随后测试检查每个 常驻图块都以相同光栅尺寸出现在辅助程序的集合中，并且对 S9 检查取自夹具最后一行的代表性 emoji 与 CJK 码位在两个缩放下都是常驻的真实图块。它只证明该帧请求过的字形，而不是辅助程序测量的每个 字形。在这些检查于 Windows CI 上通过并记录测量行之前，该开关保持为 false。

插入规则如下：

1. 命中时更新条目的最近使用帧；
2. 光栅化失败时保存零面积哨兵，避免每帧重试；
3. 空格使用零面积条目，无需上传；
4. 普通、次像素和彩色图块复制到 BGRA 存储；
5. 每次写入记录紧密脏矩形；
6. 图块放不下时，可增长且小于 2048 的图集先翻倍；达到 2048 或条目上限时，确定性淘汰最冷的 四分之一，再重试分配。

淘汰不仅用于限制内存，也是正确性要求；若只是拒绝新条目，内存虽然不再增长，后续字形 却会消失。图集重置会原地清除元数据与打包状态，不会把 16 MiB CPU 像素分配清零。 图集局部内容身份会在每次重置或淘汰时变化。组帧和输入法预编辑缓存还会结合设备代次与 渲染器持有的分配代次，因此替换图集中的相同计数不能验证旧 UV。身份戳变化时，会在呈现器 接收前放弃已组装字形，返回 AtlasRetry，不确认网格。淘汰计数只用于诊断，重置时仍归零； 重置或替换日志不会把仅身份变化描述为淘汰。行缓存 API 继续使用现有的 u64 内容身份， 并在分配变化时清空。私有 atlas_lifecycle.rs 模块负责图集重置、图像图集升降级、上传镜像 重建和重试结算，设备门禁及连续 240 次组装的图像空闲策略保持不变；另一个按时间的触发在可渲染媒体最后一次可见 30 秒后 释放已提升的图像图集，无需组装帧（见内联图像）。两个呈现器借用同一 FrameBatches，其中包含基础 quad、图像、字形、覆盖层 quad 和覆盖层字形切片；保留原顺序， 不复制可绘制数据。

CPU 图集契约会区分像素含义：单色与 DirectWrite 次像素图块是线性覆盖率掩码，自带颜色的 字形像素则是预乘、sRGB 编码的 BGRA8。每次写入都会把紧密脏矩形记录为 Coverage 或 Color；淘汰槽位中的替换写入会取代与它相交的旧记录，避免用旧图块类型解释最新字节。 同步只合并相同类型的矩形；覆盖率字节原样复制，只有彩色矩形会从编码空间预乘转换为通过 sRGB view 解码后等于预乘线性颜色的存储值。CPU 字节始终不会被重写。

一个 Bgra8Unorm 字形纹理同时提供两个 view，不复制像素负载。其 bind group 把 unorm 覆盖率 view 和 sRGB 彩色 view 分别配对最近点 sampler。普通字形（包括带次像素标记的实例） 选择覆盖率 view，彩色字形实例选择彩色 view。实例标志保持不变：flags.x 选择自带颜色的 字形，flags.y 保留 DirectWrite 次像素标记。Windows 软件呈现会保留完整的原始 CPU 图集， 但对应 GPU 纹理缩为 1×1 占位符；回到 GPU 呈现时会重建匹配纹理、重置携带 UV 的缓存， 并强制完整重绘。

DirectWrite 生成逻辑红、绿、蓝 ClearType 覆盖率。SonicTerm 会原样保留这些原生覆盖率字节， 不再应用隐藏的对比度曲线；显式 weight_scale 是单色文字唯一的覆盖率调节。 先选择字体，再对常规、粗体、斜体、粗斜体及单色回退字形使用同一调节。固定字号和 DPI 时， 粗细变化不改变单元格间距、基线、位图尺寸、bearing 和推进量。各字体保留自然墨迹形状； 彩色图像内容不参与粗细调节。三个通道的最大值 写入 alpha。引擎只把字节布局从 RGBA 改为 CPU 图集使用的 BGRA，不执行色彩空间转换。使用 [font].subpixel_aa = "off" 时，两种 presenter 都把保存的 alpha 最大值当作单一灰度覆盖率； rgb 把逻辑通道映射到对应显示通道，bgr 则交换红、蓝。GPU 路径从 unorm 覆盖率 view 取样，并用 dual-source blending 分别衰减目标通道。Windows 软件路径读取原始 BGRA 字节， 在线性光空间执行同一操作。彩色字形与内联图像优先于次像素标记，永远不会进入该分支或覆盖率 view。两种 presenter 会先把预乘的编码彩色纹素转换为预乘线性 RGBA，再做最近点或双线性 取样；随后在线性光空间合成，并只在输出时编码一次 RGB。模式只属于呈现状态，因此修改模式 会使帧失效，但保留字体栈、光栅图块与图集。

软件字形的一比一和重采样轴使用同一稳定目标像素原点。最近点采样不越出字形图块； 顶部/左侧裁剪会跳过隐藏的源行/列。锐角、圆角和线段 quad 都使用有限预乘线性 RGBA （0 ≤ RGB ≤ alpha ≤ 1）；不透明度或 mask 覆盖率同时缩放 RGB 与 alpha。

[font].subpixel_aa 可选 off、rgb、bgr，默认值是 off。只有以下条件全部满足时， SonicTerm 才会把非 off 请求解析为 LCD 呈现：

• 主机是 Windows；
• 配置的 backdrop 选择不透明硬件 alpha 模式；
• 终端背景的实际 opacity 为 1；
• 最终 presenter 是 Windows CPU/GDI，或 wgpu 设备支持 DUAL_SOURCE_BLENDING。

因此 Mica、Acrylic、Tabbed、opacity 小于 1、不支持的 GPU 设备和非 Windows 主机都会 确定性使用灰度。软件呈现覆盖即使强制 GDI 交换链本身不透明，也不会让配置为透明 backdrop 的窗口取得 LCD 资格。

Windows 创建设备时只会在 adapter 已公布支持后请求 DUAL_SOURCE_BLENDING；其它主机不请求 任何 LCD 可选 feature。该 feature 在创建共享设备时协商，因此 off 可以实时改为 rgb 或 bgr，无需重建设备。实际模式进入保留帧键；修改请求只会使帧失效并重绘，不会重建字体或 任一图集。

对一个次像素样本，coverage 是逻辑 RGB 覆盖率（bgr 会交换 R/B），foreground 是经过 变换的预乘线性前景色：

weights.rgb = coverage.rgb * foreground.a
source.rgb = foreground.rgb * coverage.rgb
source.a = max(weights.r, weights.g, weights.b)
destination.rgb *= 1 - weights.rgb
destination.a *= 1 - source.a

GPU pipeline 把源颜色与目标衰减量分别作为两个 blend source 输出。非 LCD 分支把单一 alpha 作为第二个 source，因此单色文字、彩色字形、图像和 quad 仍保持普通 source-over。Windows CPU presenter 解码 sRGB BGRA 目标，在线性光空间执行同一逐通道公式，再只编码一次 RGB。 off 把次像素图块中保存的 alpha 最大值作为灰度覆盖率。

iTerm2 文件图像、kitty graphics 和 Sixel 事件由应用解码。声明宽或高超过 2,048 像素， 或像素乘积超过 2,048² 的编码图像，会在解码前拒绝。被接受的 iTerm2/kitty 图像会 缩放到渲染宽高都不超过 1,024 像素。Sixel 直接解码进同样单边上限为 1,024 像素的 缓冲。结果使用预乘、sRGB 编码的 BGRA8：RGB 已编码，并已乘以线性 alpha 通道。

在 Windows 上，图像序列先经过 ConPTY；ConPTY 可能在应用收到之前丢弃 Sixel 与 kitty graphics，见终端 IO 与 VT。

已解码图像仍由所属窗格拥有；数量和字节上限见内存。渲染器把可见图像复制到 独立图像图集，因此媒体压力不能淘汰文字字形，也不能复用文字 UV。图像可见范围是目标矩形、 所属窗格扣除内边距后的实际内容矩形与表面的交集。图像裁剪不使用单元格布局最小值：内边距耗尽 窗格空间时，图像裁剪范围为空，即使网格仍保留一个单元格。同一可见性检查控制图集驻留和绘制； 完全裁剪或尚未解码的图像 既不提升图集，也不分配图块。裁剪保留原始位置和缩放，并将可见目标/UV 与原始已打包图块的 采样边界分开保存。两种 presenter 都在像素中心插值，包括原始尺寸下的分数位置，并把采样点 限制在原始图块内，而不是窗格裁剪边缘。不分配裁剪后的解码像素副本，绘制顺序与图集上限不变。

GPU 脏矩形打包时， 每个非透明像素先在编码空间反预乘并限制范围，再经 sRGB 传递函数解码、在线性光空间乘以 alpha，最后重新编码后存储；透明像素规范化为 [0, 0, 0, 0]，alpha 保持不变。CPU 字节 不会被重写。Windows 软件呈现会对每个选中的纹素执行相同的零 alpha 规范化及 反预乘/限制/解码/重新预乘操作，再对得到的预乘线性采样点做过滤。GPU 只分配一个 Bgra8Unorm 纹理，通过其 sRGB 彩色 view 做线性过滤；硬件同样会先解码再双线性过滤。 两种 presenter 使用相同的纹素中心约定，并把采样点限制在当前图像图块内，避免相邻已打包 图块渗入边缘；随后在线性光空间合成，并只在输出时编码一次 RGB。图像图集以 1×1 CPU/GPU 占位符启动，仅在出现可渲染媒体时提升为 2048×2048； 连续 240 帧没有可渲染媒体后再降回占位符；窗口可见且空闲时，可渲染媒体最后一次可见 30 秒后也会在不组装帧的情况下 降回占位符。释放的调试日志以 reason（idle_frames 或 idle_interval）说明原因，下一个带媒体的帧会在绘制任何图像 之前重新提升图集。图像图集填满时跳过较早图像，不会淘汰文字。

GpuRenderer::new 仍为同步构造；new_with_shared_context 在共享设备上创建窗口专属表面， 不再请求设备。另一条分阶段路径在窗口事件循环线程上通过 ContextRequest::startup 准备自持有的表面，在工作线程上通过 ContextRequest::run 协商 adapter 和设备，再把上下文 交回事件循环线程，由 GpuRenderer::finish_startup 完成构造。完成阶段复用该表面和设备； 配置、管线、字体栈及渲染器所有权仍在窗口线程上。失败的请求保留表面、实例和窗口， 由调用方负责释放。

Windows 原生字重测试使用此分阶段路径，同时只保留一个进行中的请求。其阻塞请求对照要求 先处理用户事件，再处理一次原生重绘回调，之后才允许协商继续。完成通知唤醒事件循环， 无需轮询重绘。生产 App 仍使用同步构造函数；分阶段协商不会把字体初始化或帧渲染移出窗口线程。

两种呈现器都限制每边 16,384 像素、BGRA 总量 160 MiB；wgpu 还遵守 max_texture_dimension_2d。初始几何无效时构建失败；try_resize 拒绝时返回 false 并保留可用表面。SoftwareFrame::new/prepare 在分配前拒绝无效 CPU 帧。 GlyphInstance 保存 NDC 矩形、UV、线性前景调制色和彩色/次像素/图像图集标志。

损伤区域是正确性边界，不只是性能优化。每次 VT/网格修改都必须在同一轮更新中标记受 影响的行。

指针切换窗格焦点、选区的按下/拖动/释放、滚轮滚动、滚动条拖动和分隔条拖动都不会给整个窗口 加网格脏行。选区和焦点属于窗口身份，视口属于窗格身份，因此由帧计划重绘；quad 缓存以选区重叠和 行位置为键，字形缓存只以内容为键。指针焦点和分隔条拖动以 TopologyDirt::ResizeOnly 完成拓扑变化：尺寸变化的网格 每一行都是脏的，移动的窗格强制整帧，未变化的窗格保留其行。标签页激活、重排和转移仍保留 整窗口脏行。窗口焦点变化同样不加网格脏行。

flowchart TD
    change["可见状态变化"] --> screen{"屏幕缓冲区"}
    screen -- 主屏幕 --> rows["合并视口脏行"]
    screen -- 备用屏幕 --> dirty{"有任一脏行？"}
    dirty -- 是 --> pane["完整表面裁剪窗格"]
    dirty -- 否 --> none["无终端损伤"]
    rows --> union["与界面及浮层损伤合并"]
    pane --> union
    none --> union
    union --> retained["在损伤裁剪内重绘保留帧"]
    retained --> present["复制并呈现"]

主屏幕窗格可以只重绘视口脏行的并集。分数 DPI 下的行边界使用 floor/ceil，避免相邻行 之间出现缝隙；随后在垂直方向各扩展一个原生字体单元高度，使字形 bearing、定位标记和 压缩行距不会把墨迹留在保留帧裁剪范围之外。扩展后的区域仍限制在 pane 和表面边界内。 备用屏幕窗格只要有一行标脏，就损伤完整的表面裁剪窗格。这覆盖 TUI 滚动、插入/删除行、 反向索引、擦除等固定位置更新，避免窄行集合留下旧像素。

离屏帧在首次使用或替换完整表面时，只执行一次 attachment clear，不再绘制第二个背景重置矩形。 局部损伤会加载保留帧，再在损伤裁剪范围内通过无混合的重置绘制，用预乘背景直接替换旧像素。 重置与内容共享一次缓冲上传，使用不同绘制区间；普通内容仍使用 source-over，LCD 文字仍使用 dual-source blending。透明重置不会累积 alpha，也不会改变损伤范围外的像素，不依赖后续重绘来 完成擦除。重置后，GPU 内容按以下顺序绘制：

基础矩形 -> 内联图像 -> 基础字形 -> 浮层矩形 -> 浮层字形

裁剪矩形把重绘限制在损伤区域内。渲染器的 wgpu::util::TextureBlitter 在提交和 呈现前把保留帧复制到交换链。表面格式固定为 TextureFormat::Bgra8UnormSrgb；颜色在 进入着色器前转为线性值，让 sRGB 目标只执行一次伽马编码。

帧键变化时，计划器会为每个变化的字段分类，而不是重绘整个表面。WindowIdentity::classify 与 PaneIdentity::classify 解构每一个字段，因此新增字段在被分类之前无法通过编译。

窗格的 revision 与 dirty_generation 是脏行字段，不属于类别：它们通过绘制脏实时行的 行位置条带（含墨迹边距）造成损伤。hovered_url_cells 保留自己的窄路径，即新旧悬停行。

命令徽标的哈希包含状态种类和绘制出的徽标，因此运行中的标签页不会每秒重绘标签栏带，但种类 变化（例如尚未绘制徽标时从空闲变为运行中）会重绘一次。块状 光标会重着色整个字形实例，其高度可能超过光标行加边距，所以组装之后损伤还会覆盖被重着色的 字形：重着色结果变化时加入前后两侧的范围，只有光标或焦点类别时加入当前范围。非有限的重着色 范围加入活动窗格，非有限的标签标题墨迹加入整个表面。光标形状、光标闪烁和焦点的设置方法会 保留帧键，因此这些变化以类别的形式到达计划器，而不是变成首帧。

以下变化仍损伤整个表面或整个窗格：

• 旧键或新键中有活动覆盖层时，帧键的任何变化都损伤整个表面，因为覆盖层画在所有内容之上， 而预编辑跟随实时光标，帧键只记录绘制出的光标单元格；光标隐藏、窗口失焦、窗格只读或视图 向上回滚时，该单元格不存在；
• 备用屏幕窗格上的类别变化损伤该窗格整体；
• 降级路径对任何类别变化都重绘整个表面，首帧也是整个表面。

同一帧中变化的多个类别合并成唯一的损伤矩形，因此标签栏带与光标同时变化时，两者之间的区域 也会重绘。damage_waste_permille_sum 计数（日志）衡量该矩形超出 其各部分的面积。帧键变化但没有脏实时行且损伤为空（例如 set_autowrap 引起的修订号变化）时， 计划为 Noop，不确认任何脏行。帧键未变化，以及唯一的脏行都已滚出视图的变化，也计划为 Noop；其他帧都是 Partial 或 Full。

窄损伤之所以正确，是因为每个与损伤相交的图元都会被组装，并在裁剪下按顺序绘制。Full 帧组装 每一行。Partial 帧组装每个脏行位置、墨迹扩边条带与损伤区域相交的每一行，以及有效墨迹记录与 损伤区域、绘制出的光标单元格或最近一次呈现的光标重着色范围相交的每一行；未组装的行保留其已保留 的像素和记录。终端行以外的内容（窗格装饰、光标、选区、高亮、 内联图像、滚动条、标签栏和覆盖层）完整组装，由裁剪限制写入。

一行的墨迹记录是它呈现内容的外扩取整并集：字形、tofu、背景与下划线 quad，不按窗格裁剪，因此 相邻窗格溢出的字形或相隔数行的高字形都能被找到。记录在组装期间暂存，只在帧呈现时提交；只有 当该行位置仍显示同一绝对行且内容戳相同时才可信；干净的可见行没有有效记录时，该帧为 Full。 组装之后，重着色与标签标题的扩展仍可能扩大损伤；若最终损伤触及本帧未组装行的记录，则在同一次 渲染调用中重新以 Full 组装该帧，并在 partial_fallbacks 中计一次。

已呈现的 Partial 帧按窗格只确认其组装了行位置的脏实时行；Full 帧确认所有行。位于向上回滚 视图下方的脏实时行没有行位置，因此保留脏位，直到某一帧绘制它。

GpuRenderer::render_with_outcome 把每一帧报告为一个 PresentOutcome。present.rs 把帧的 图层交给唯一的呈现器：在 Windows 上启用软件渲染降级时交给 GDI 呈现器，否则交给 wgpu 交换链呈现器。 渲染主体中没有呈现器相关的 cfg 分支。

flowchart TD
    start["render_with_outcome"] --> panes{"有窗格吗？"}
    panes -->|否| noPanes["Skipped(NoPanes)"]
    panes -->|是| gate{"设备接受工作吗？"}
    gate -->|否| unavailable["RenderingUnavailable"]
    gate -->|是| plan{"帧计划"}
    plan -->|帧键相同| unchangedPlan{"有保留的 GDI 帧吗？"}
    unchangedPlan -->|是| reblitGate{"设备接受缓存帧呈现吗？"}
    reblitGate -->|是| reblit["CachedReblit"]
    reblitGate -->|否| unavailable
    unchangedPlan -->|否| skipUnchanged["Skipped(Unchanged)"]
    plan -->|没有需要组装的像素| skipNoop["Skipped(Noop)"]
    plan -->|绘制| evicted{"组装期间图集身份变化吗？"}
    evicted -->|是| atlasRetry["AtlasRetry"]
    evicted -->|否| presenter{"呈现器"}
    presenter -->|Windows 软件渲染| gdi["组装 CPU 帧并用 GDI 位块传输"]
    presenter -->|其他情况| acquire{"获得交换链纹理吗？"}
    acquire -->|没有纹理| recovered{"恢复后设备接受工作吗？"}
    recovered -->|是| surfaceRetry["SurfaceRetry(reason)"]
    recovered -->|否| unavailable
    acquire -->|有纹理| wgpuPresent["绘制、提交并呈现"]
    gdi --> kept{"设备接受了这一帧吗？"}
    wgpuPresent --> kept
    kept -->|是| presented["Presented"]
    kept -->|否| unavailable

只有 Presented 会推进 successful_frame_count 并确认计划；其他结果都保留脏行。缓存重绘仍推进 present_call_count，但不确认新计划；GDI 传输前后都检查设备，停止时会在请求焦点闪烁重绘之前返回。 对于 wgpu，Presented 表示提交与呈现调用通过设备检查，并不证明之后的物理扫描输出成功。表面丢失不是 设备丢失：设备停止后，表面结果报告为 RenderingUnavailable。已停止设备上重新配置或重建的表面 立即报告停止，不请求重绘；超时或被遮挡的表面仍请求下一次重绘，把一次性的停止报告留给那一帧的 设备检查。设备可用时，带类型的 Timeout 重试由应用控制节奏，Occluded 抑制帧并使用 渲染模式中仅 macOS 的低频探测。其它表面原因保留渲染器的原生请求； Result 适配器只为 Timeout/Occluded 恢复原生重试，不对其它原因重复请求。

GpuRenderer::render 保留 Result<()> 签名：它运行 render_with_outcome，再通过 PresentOutcome::into_render_result 映射结果。主窗口和子窗口的重绘路径调用 render_with_outcome 并应用同样的映射，因此日志和运行时冒烟检查看到的就是 render 返回的结果。

方框线、块元素、Powerline、Braille、六分块、八分块、进度符号等字符可以绕过字体回退。 BlockKey::from_char 选择几何，block_sprite_with_cell_metrics 使用 tiny-skia 光栅化。 保留的字体槽位可避免与原生字体字形冲突。从 WezTerm 适配的实现署名保存在 crates/sonicterm-block-glyph/LICENSE-WEZTERM。