Repository navigation
fix(render): 跳过 swash 读不了轮廓的脚本字体,修 macOS 27 中文候选空白 - #348
Merged
yenharvey merged 66 commits intoOct 10, 2026
Merged
Conversation
样例帧抽到 tests/scenes/,离线预览与快照测试共用,另加只有拼音行、短候选、横排云端词三个场景 21 张图逐像素比 tests/snapshots/<os>/ 的基准,metrics.txt 同时比尺寸、内容区与状态条格边界 字体环境按 fingerprint.txt 判断,对不上、没有基准或没有系统字体时跳过,CI 不会误报 FontLibrary 加 font_files() 供指纹用;先出了 macOS 的基准,Windows 等上 box 时补
对标 Figma:自由图层 + 数据插槽 + 组件变体,Taffy 布局,效果与动画由渲染器统一画 主题包 = theme.json + 图片 + 可分发字体;开源字体默认随包、商业字体只引用 分阶段:先用新格式复刻内置主题并过快照测试,再做静态效果、动画、Figma 插件、网页编辑器
渲染器改成按帧建场景树(scene/:Taffy 布局树 + 每节点一个 Visual)→ 布局 → 按树序画,候选窗与状态条都走这一条 竖排三列用 grid 自动取各行最宽,删掉手算列宽的 columns / item;横排与拼音行用 flex,高亮条与光标绝对定位 布局不取整、文字测量按节点缓存:21 张快照 debug / release 逐像素一致,每帧耗时与旧实现差 +0.6% 拼音行宽度改按各段宽度相加,与画的时候一致(原先按整串量) taffy 0.14 进 workspace 依赖,只开 flexbox 与 grid
内置「青简」写成 themes/qingjian/theme.json 编进 crate;删掉 Theme 结构体、Palette 与 renderer/ 里写死的布局常量 renderer/build/ 按模板 + 帧数据实例化:frame / text / icon / preedit / annotation / use / repeat,when 条件,表格布局对齐竖排三列 theme/file/ 是 serde 模型;加载时检查颜色变量、文字样式、组件引用,找不到的记警告、渲染时退回缺省 状态条尺寸与颜色取主题 status 分节;壳侧 Theme::light / dark 接口不变 21 张快照逐像素一致,每帧耗时与上个提交持平
ThemeMode 改名 Appearance;[general] appearance 是外观(system / light / dark),theme 是主题 id(缺省 qingjian) 旧写法 theme = "dark" 仍能读:没写 appearance 时按外观读、主题用内置的,这三个词因此不能当主题 id;读取走 appearance() / theme_id() 设置页写 appearance 时顺手迁移旧行:theme 改成 qingjian,两行注释换成模板里的,只迁一次 帧协议字段在 Rust 里改名 appearance,线上仍叫 theme,旧 DLL 照常解析,协议版本不变 mac 偏好设置与 Windows 设置程序改写 appearance 键;配置模板分成两行
主题支持 extends(以内置主题为底,对象逐键合并、数组整个替换)与条件颜色 { if, then, else };青简绿加 hl_* 变量,像素不变
新增 system-blue 系统蓝、wechat 微信绿,都 extends 青简绿只改颜色;Theme::builtin(id) / builtins() 取
mac 偏好设置与 Windows 设置程序「候选窗口」页加「主题」下拉,按显示名列出、写回 id;两端按 theme_id() 加载,不认识的 id 退回青简绿
配置迁移补漏:写 theme 时旧的外观值补写成 appearance(先选主题会丢深色),注释一并换成模板里的
新增 8 张主题快照,原有 21 张逐像素不变
ThemeLibrary 合并内置主题与 <用户数据目录>/themes/<id>/theme.json:目录名须等于 meta.id,不能与内置主题重名或用外观词,读不进来的跳过并记警告 热加载按目录戳(各 theme.json 的修改时间与大小):mac 在激活期间每秒的配置检查里 refresh,Windows Server 在热加载轮询里比戳后重发设置让 UI 线程重读 mac 偏好设置与 Windows 设置程序的主题下拉列出内置 + 用户主题;platform 加 dirs::themes_dir,mac 加 paths::themes_dir 用户文档新增「设置 → 主题」,数据与日志页加 themes/
fill 可写线性 / 径向渐变(CSS 角度,色标均分或带位置)与图片(整张拉伸或九宫格,scale 指定几倍图);纯色仍走原画法,原有快照逐像素不变 border 画在内侧;opacity 作用于整棵子树(离屏图层合成);场景节点 Visual::Fill 泛化为 Box(填充 + 边框 + 圆角) 图片随主题目录加载(Theme::from_dir),只认 PNG、边长 ≤ 4096、路径不能出主题目录,读不进来记警告不画 meta.appearance 锁定外观:浅色图片做底的主题配深色文字看不清,锁浅色后不再跟随切换 新增能力展示测试主题 tests/themes/showcase(程序生成的图)与 4 张快照;设计文档与用户文档「主题」同步
节点可写 effects:drop-shadow / inner-shadow,形状取节点自己画面的 alpha(圆角框、九宫格图片、文字),可叠多层
窗口阴影就是根节点的投影,位图按投影伸出距离留边;mac 面板关系统阴影、改贴渲染器画的,与 Windows 同一份像素(系统绘制退路仍用系统阴影)
Renderer::render / render_status 去掉 shadow 参数,公开的 Shadow 删除;状态条阴影写在 status.effects
文字样式加 weight(数字或 thin…black),节点 font 可写 { base, size, weight } 行内改;Windows 加载 Segoe UI 与雅黑 / 正黑的粗细体文件
九宫格内部分割线取整像素,修接缝处 alpha 不满、底下有投影时透出细线
原有 31 张快照逐像素不变;1 倍屏一张改为带阴影,展示主题四张用上新效果
text / annotation / preedit 可写 stroke: { width, color }(颜色可按条件):cosmic-text 取字形轮廓拼成一条路径,圆角接头按两倍宽描一次、字形压在上面,露出向外的宽度,不占排版宽度;位图 emoji 不描
自己不画东西的容器(没填充的框、译文、拼音行)加 effects 时取子节点当阴影形状,文字阴影、发光因此可用
加 zeno 依赖(swash 同版本)匹配轮廓命令
原有 37 张快照逐像素不变;展示主题四张用上描边、译文阴影、页码发光
不加新写法:负 inset 的绝对定位节点就是伸出窗口的装饰 位图按场景画出范围开(scene/extent.rs:自己画东西的节点连同投影伸出、文字描边),根节点的盒子是内容区,壳照旧按内容区贴光标,装饰可伸到屏幕外 Windows 候选窗加 WS_EX_TRANSPARENT,鼠标整个穿透,与 mac 面板一致,装饰盖住应用的部分不挡点击(待 box 真机验) 原有 37 张快照逐像素不变;展示主题竖排两张加了右上角徽章与左下角花瓣,位图向上、向右撑大
box(Win11 25H2)上 QINGJIAN_UPDATE_SNAPSHOTS=1 出的 33 张,字体环境含 Segoe UI 与雅黑的粗细体文件;逐张看过,与 mac 效果一致 同批真机验过:主题选择、旧配置迁移(theme = "system" → appearance + theme id)、阴影、字重、描边、伸出装饰、鼠标穿透、主题文件热加载
节点写 id + transition:新一帧按 id 与上一帧配对,位置、大小、不透明度从旧值插值(缓动曲线同 CSS);同一帧里 id 重复才按出现顺序加序号,只在高亮行出现的高亮条换行后仍配得上 Renderer 留住上一帧(renderer/retained.rs),render 返回 next_frame,壳到点调 tick 只重画不重建树;过渡中途再来一帧从半路接着走;画出范围按起止两头的并算,动画中位图不变大小 mac 用 NSTimer(candidates/animation.rs),Windows 在 UI 线程消息循环截 WM_TIMER;窗口收起停动画并 forget;跟随系统「减少动态效果」/「动画效果」 性能:效果遮罩与图片填充框按「节点 + 位置大小 + 画布大小」缓存,动的节点及拿子节点当形状的上级容器才重算;九宫格同色格按纯色填(同 Skia 固定颜色格),缓存贴回用整数混合绕开 tiny-skia 的高精度图片流水线;blend_mask 按行处理(结果逐位不变) 展示主题新帧 20 → 15.5 ms、过渡帧 19 → 7.3 ms(mac release 2 倍屏) 快照:31 张不变;展示主题竖排两张花瓣边缘 158 像素取整差异;新增过渡半路一帧,并断言播完的最后一帧与直接画的一致。Windows 基准待 box 重出
节点写 animation:关键帧平移 / 旋转 / 缩放 / 不透明度,作用于整棵子树、不影响布局;属性只在写了它的关键帧间插值,开头结尾缺的按缺省值补(同 CSS);loop: false 播一轮停住 时钟从窗口出现算起、打字中不重置、forget 归零;减少动态效果时停在第一帧;画出范围按一轮里能到的最远处算(旋转取外接圆) 带姿态节点整棵子树画进缓存小图,按姿态绕中心变换贴上 循环帧局部重画(renderer/partial.rs + scene/split.rs):动画节点把树序切段,不动的段各缓存一张图层,每帧只在动画节点新旧位置的区域里按原先后叠段与节点;与整张重画只差半透明取整(≤ 3/255,测试断言);有过渡或动画节点不独立时整张重画 blend_mask 按覆盖率查表(同 Skia A8 遮罩);壳的定时器按 next_frame 间隔跳(过渡 16 ms、循环 33 ms) 展示主题循环帧 3.6 → 0.2 ms(mac release 2 倍屏,第一帧切段约 7 ms) 内置三主题的高亮条加 id + transition(100 ms ease-out);快照每张先 forget,不与上一张配对 快照:静止的全部不变;过渡半路改用青简绿(transition-mid),新增展示主题循环 600 ms 一帧(showcase-loop)。Windows 基准待 box 重出
main 这段时间的 24 个提交(辅码、智能 ABC、笔画码表、Linux 第一阶段、横排矩阵等)合进主题分支。 渲染器:主题分支已把手算坐标的 horizontal / vertical / top_line 换成场景树 + theme.json,main 加在旧文件上的功能按新结构重做: - 辅码:候选词后面的 `[kf]`(模板 `word` 组件加 `code` 绑定,与译文同色、同一条基线)与拼音行里带下划线的码段(PreeditStyle::AuxCode),加 aux-code 两个快照场景,原有基准图未变。 - 横排矩阵:main 的 renderer/matrix.rs 建在旧渲染器上,随旧渲染器删掉,场景树这边还没有矩阵窗口;移植之前 mac 壳只在系统绘制下展开矩阵(Host::grid_keys 多一个 !uses_bitmap() 条件)。见 docs/notes/crate-notes.md。 其余:ThemeMode 已改名 Appearance,main 新进来的 Linux Server 与 Windows 的辅码显示开关跟着改;mac 设置项编号 51 撞了,HorizontalGrid 改 52;Windows 热加载里主题目录戳与 codes/ 目录快照两段并存。
macOS 27 的苹方换成私有 hvgl 轮廓的可变字体(PingFangUI.ttc,无 glyf/CFF,无公开文档, googlefonts/fontations#1369 在跟进支持),swash 栅格化每个字形都返回空,中文候选整窗画 不出来;静态的 PingFang.ttc 也不在 AssetsV2 里了,清单只能落到 Reserved 的这份。 - 脚本字体加载前解析 TTC/sfnt 表目录,任一面带 glyf / CFF 才加载,否则跳过并记 warn; emoji 走 sbix 位图,不做这项检查 - 简体清单补 Songti.ttc(静态 glyf),hvgl 苹方被跳过时简体回退到宋体,候选不至于空白; 苹方能正常栅格化的系统上行为不变
dayuer
pushed a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
pushed a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
pushed a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
dayuer
added a commit
to dayuer/qingjian
that referenced
this pull request
Oct 3, 2026
emoji 挤占候选位置的反馈很多;[general] emoji 缺省开,关掉后 emoji 表照样加载、只是不出候选,切换不用重载数据。 macOS / Windows 偏好设置各加一个勾选框,Linux 读配置。 Closes qingjian-team#79 Closes qingjian-team#272 Closes qingjian-team#335 Closes qingjian-team#483
中文模式里英文词与前缀补全会插到中文候选中间,不打英文的人觉得干扰;[general] english_in_chinese 缺省开, 关掉后中文模式不出英文词与补全,英文模式不受影响。关着时「中文候选排在英文词前面」没有意义,界面上置灰。 Closes qingjian-team#104
Unihan 里 嗯 只有 ng / n 两个读音,都不是拼音音节,生成词库时整个字被丢掉,en 与 ng 都打不出来; 各家输入法都用 en 打它。语料里 嗯 有 34 万次,重跑 bigram 后 en 首选 嗯,enen / endui / enhaode 整句也对。 代价:enren 的整句「嗯人」排到 恩人 前面(enqing / enhui 原来就是 恩庆 / 恩会 排第一,回退分数的老问题)。
嗯 的标准音 ng 不是拼音音节,音节表不收叹词写法(收进去 fangan / hengao 会多出 fa ng an 这类切分); 只在整段正好是 ng 时按快捷候选给它、排第一,双拼与注音不受影响。
基础词库收「嗯」(en),语言模型按新词库重新统计;其余文件与 data-v3 相同。 Closes qingjian-team#300
Candle 创建 Metal 设备时会用到 macOS 15 才有的 MTLResidencySetDescriptor,macOS 14 上直接 panic;缺这个类时改用 CPU,精度随设备走(Metal F16、CPU F32)。
Windows Server 从没把 [[custom_phrases]] 装进 Engine,配置写了也不出候选;启动时装一次,热加载时重设,校验失败只记日志、保留原短语。 Closes qingjian-team#471
0.1.4-、0.1.4-beta. 这类预发布段为空的写法以前被当成正式版或带空段的预发布版,现在解析失败。
鼠标点击上屏要知道点在哪:每个候选一块、每条译词一块(按义项分隔数),布局完成后换算成内容区像素随位图交出; 横排底下那行译文对应高亮的候选。
点候选与按它的数字键一样,点右侧译词与按译词键一样上屏那一条;只有青简渲染器给点击区域,所以只有它收鼠标, 系统绘制时点击照旧穿过去。候选窗口不知道是哪个会话,activateServer: 时记下当前控制器。
候选窗只在候选与译词的点击区域收鼠标,其余照旧穿透,按下不抢焦点;点中的目标交给 Router 按数字键 / 译词键同一套上屏。 Server 写不了文档,上屏的字挂在焦点会话上,DLL 下一拍轮询随 Update.commit 取走写进去,赶在轮询前来的键把它接在结果前面。 协议升到 8(本周期第一次升,Linux 插件一起改);更老的 DLL 读不到 commit,不收它们的点击。 Closes qingjian-team#199 Closes qingjian-team#233
中文模式组句时敲 , . ? ! 等会转全角的标点,先上屏高亮候选再补全角标点(nihao, → 你好,),与微信、搜狗一致;[general] punct_commits 开关,关掉是标点进英文直输段的老行为。
搜狗等方案的 ü 键与 j/q/x/y 拼出 jv 这类不合法的音节,查不到词;解不出时规范化为 ju/qu/xu/yu,同键已有的合法读法优先。 Closes qingjian-team#416
qingjian-team#402 加的 punct_commits 缺省开会改掉所有人组句中敲标点的老行为(进英文直输段整段原样上屏); 用户能感知的行为变了时保持老行为,新行为留给需要的人在「设置 → 通用」勾上。几条验证新行为的测试改为显式打开。
点击上屏把协议升到 8 时漏了 mock 与 transport 测试里写死的 7,CI 的 core job 因此 ctest 全挂。
默认的「Merge branch '…'」不合约定却被 commit-msg 放行了;git merge 本身会走 commit-msg,去掉豁免就能在合并时拦下。 贡献指南不再要求不加 AI 署名:属于个人习惯,钩子查不出,外部 PR squash 合并时信息由维护者定。
从微软拼音、搜狗迁移来的用户习惯把 ü 统一敲在 v 上;jv / qv / xv / yv 归一到词库写法 ju / qu / xu / yu。 双拼解码出这几个写法时同样归一,与 qingjian-team#443 的 ü 键一致。 Closes qingjian-team#422
测试写死 Alt + 1,Windows 缺省译词键是 Ctrl,在 Windows 上跑 workspace 测试必挂。 Closes qingjian-team#368
…14d64511d8e1b74de to 7e38f4b43b4db5c8dd498af069a4f6196df1d067 (qingjian-team#409) Bumps [dtolnay/rust-toolchain](https://github.com/dtolnay/rust-toolchain) from 02cb101ec7c40f2c49e1d9714d64511d8e1b74de to 7e38f4b43b4db5c8dd498af069a4f6196df1d067. - [Release notes](https://github.com/dtolnay/rust-toolchain/releases) - [Commits](dtolnay/rust-toolchain@02cb101...7e38f4b) --- updated-dependencies: - dependency-name: dtolnay/rust-toolchain dependency-version: 7e38f4b43b4db5c8dd498af069a4f6196df1d067 dependency-type: direct:production ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [async-openai](https://github.com/64bit/async-openai) from 0.42.0 to 0.42.1. - [Release notes](https://github.com/64bit/async-openai/releases) - [Commits](64bit/async-openai@async-openai-v0.42.0...async-openai-v0.42.1) --- updated-dependencies: - dependency-name: async-openai dependency-version: 0.42.1 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [zerocopy](https://github.com/google/zerocopy) from 0.8.57 to 0.8.59. - [Release notes](https://github.com/google/zerocopy/releases) - [Commits](google/zerocopy@v0.8.57...v0.8.59) --- updated-dependencies: - dependency-name: zerocopy dependency-version: 0.8.59 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Bumps [thiserror](https://github.com/dtolnay/thiserror) from 2.0.20 to 2.0.21. - [Release notes](https://github.com/dtolnay/thiserror/releases) - [Commits](dtolnay/thiserror@2.0.20...2.0.21) --- updated-dependencies: - dependency-name: thiserror dependency-version: 2.0.21 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] <[email protected]> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
workspace 树补 render / update / windows 各 package 与 linux 实况,依赖图改正 dictionary 依赖 format,协议版本号对齐代码。
文档里的版本号每升一次协议就落后一处(architecture 写 7、linux-fcitx5 写 6,代码已是 8)。
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
关闭 #347。先说明: contributing.md 写了渲染器相关暂不接受 PR——这个改动是平台兼容性修复(macOS 27 上中文候选整窗空白,核心功能对所有用户不可用),改的也只是字体加载清单这一小块,不是主题/绘制逻辑;如果维护者仍认为该等渲染器稳定后处理,欢迎直接关掉,把 PR 当排查记录用,诊断都在 #347。
改了什么
macOS 27 把苹方换成了私有
hvgl轮廓的可变字体(无glyf/CFF,swash 读不出任何字形,静态版 PingFang.ttc 也不在 AssetsV2 了),导致中文候选整窗空白。fonts/mod.rs:脚本字体加载前解析 TTC/sfnt 表目录,任一面带glyf/CFF才加载,否则跳过并记 warn,让回退落到清单里还能栅格化的字体上。emoji 走 sbix 位图、没有轮廓表,不做这项检查。fonts/macos.rs:简体清单补上静态 glyf 的Songti.ttc,hvgl 苹方被跳过时简体回退到宋体,候选不至于空白;苹方能正常栅格化的系统上清单与行为不变。docs/notes/crate-notes.md:同步字体加载的实现要点。平台
改动都在
#[cfg(target_os = "macos")]的fonts/macos.rs与平台无关的加载函数里,Windows / Linux 的脚本字体清单不受影响。合并前清单
cargo fmt --all --check、cargo clippy --workspace --all-targets -- -D warnings、cargo test --workspace本机全过(Apple Silicon,52 个测试套件全绿,含新增 2 个)docs/user/无需改CHANGELOG.md怎么验证的
bundle.sh --install装到~/Library/Input Methods。font = "")切到青简打nihao,候选窗只有拼音行、序号、emoji 与英文释义,中文全部缺失;cargo run --release -p qingjian-render --example preview -- --out target/preview的深色竖排 PNG 同样空白。WARN 字体轮廓是 swash 读不了的格式…跳过 path=…/PingFangUI.ttc,候选窗正常出中文。用户侧配自定义字体(如霞鹜文楷)不受影响,照常走with_ui_font。