[ui] Linux egui 未剥离 fc-match 可变字体集合的高 16 位实例索引导致启动崩溃

Aberta
  • Algo errado?
#1,402 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
3/5
Tempo estimado
1-2 dias
Facilidade para iniciantes
72/100
Tipo de issue
Bug
Clareza
Claramente especificada
Status de atividade
Ativa
Stack de tecnologia
linux, rust
Domínio
backend, desktop

Direção de pesquisa

Start in openless-all/app/linux-egui/src/ui/theme.rs, especially fontconfig_match() and the handling of %{index} before it reaches egui::FontData. Check how the parsed index is used for seen deduplication and the regular_face / medium_face comparison, then look for the linux-egui unit tests. Done means composite indices such as 262146 are normalized consistently and a regression test verifies the font-loading path no longer panics.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

现象
  • 触发条件：在预装 Google Noto Sans CJK 可变字体集合（NotoSansCJK-VF.ttc，如 Fedora 44 等现代 Linux 发行版默认配置）的系统上安装并启动 OpenLess-Linux-egui-2.0.2-Beta.4-150-x86_64.rpm（标签 v2.0.2-Beta.4-tauri，上游 beta 提交 c002b56c38d81bcd5044ddb22597a4e78ff2a88d）。
  • 当前表现：主进程拉起 UI 窗口子进程后，UI 子进程在解析 "openless-cjk" 字体时触发 epaint panic（退出码 101），窗口无法打开并导致宿主进程退出。
  • 证据：
    1. 真机运行日志（Fedora 44 KDE Plasma Wayland）： 
      openless[218836]: [INFO] openless_linux_egui::linux_app::window: [ui-host] spawned UI window process pid=218858 socket=/run/user/1000/openless-ui.sock
openless[218858]: thread 'main' (218858) panicked at epaint-0.37.0/src/text/family.rs:51:21:
openless[218858]: Error parsing "openless-cjk" TTF/OTF font file: Invalid index 262146 for font collection
openless[218836]: [ERROR] openless_linux_egui::linux_app: OpenLess host failed: UI window process failed: exit status: 101
    2. 本机 fc-match 实测输出： 
      $ fc-match -f "%{file}|%{index}\n" ":lang=zh-cn"
/usr/share/fonts/google-noto-sans-cjk-vf-fonts/NotoSansCJK-VF.ttc|262146
      在 Fontconfig / FreeType 中，针对可变字体集合（Variable Font TTC），FC_INDEX（%{index}）采用高 16 位存放命名可变实例索引（Named Instance Index）、低 16 位存放 TTC 字面索引（Face Index）：262146 == 0x00040002 == (4 << 16) | 2（即第 4 号可变实例、TTC 内第 2 号字面 Noto Sans CJK SC）。
    3. 源码定位：
      https://github.com/Open-Less/openless/blob/c002b56c38d81bcd5044ddb22597a4e78ff2a88d/openless-all/app/linux-egui/src/ui/theme.rs#L88-L100
      fontconfig_match() 将 %{index} 原样解析为 u32（262146）并直接传入 egui::FontData { index, .. }，而 epaint / ab_glyph / ttf-parser 仅接受 TTC 集合内的 16 位字面索引（index & 0xFFFF），传入含高 16 位实例号的复合值会直接越界 panic。
影响
  • 所有默认使用 NotoSansCJK-VF.ttc（或任何其他可变字体集合 .ttc）的 Linux 发行版（如 Fedora 等）用户，启动 OpenLess 时 UI 进程必定 100% 崩溃退出，应用完全无法打开。
建议接受标准
  • openless-all/app/linux-egui/src/ui/theme.rs 在解析 fc-match 返回的 %{index} 时剥离高 16 位可变字体实例索引（例如使用 index & 0xFFFF 提取 TTC face index），不再将 0x00040002（262146）等复合值原样传给 egui::FontData。
  • 对 seen 去重与 regular_face / medium_face 比较逻辑同步使用规范化后的 TTC face index（或明确处理可变字体同一 face index 下的去重语义）。
  • 在 linux-egui 单元测试中增加针对 fc-match 返回复合 FC_INDEX（如 262146 / 0x00040002）的解析与字体加载回归测试，确保不再触发 epaint 越界 panic。
TODO / 不确定项
  • egui 当前不支持可变字体字重轴（源码注释已说明），当 regular_face 与 medium_face 指向同一可变 .ttc 文件的同一 face index（仅高 16 位实例索引不同）时，剥离高 16 位后两者 (path, index) 相同，将按既有设计跳过重复注册 MEDIUM_FACE。
Linguagem predominante
Rust
Estrelas
3.7k
Forks
349
Merge médio
1d 13h
PRs com merge (30d)
98

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de Open-Less/openless

Todas as issues de Open-Less/openless

Issues semelhantes

Mais issues de Rust

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.