我给 Linux 做了一套初音未来表情包
bearThomas · · 科技·工程
目前项目还算是半成品,仅包含最常用的 120 个表情,后续会逐步补充完整。
项目地址:https://github.com/BearThomas/miku-emoji-font
一、起因
最近总觉得系统桌面太素了,手痒想折腾点新花样。我盯着桌面的初音壁纸看了一会儿:
突然冒出一个想法:既然壁纸都是 Miku,能不能把系统的 Emoji 表情包也魔改成初音主题呢?
二、踩坑:字体格式选型
最开始我直接让 DeepSeek 帮我生成方案,结果它把表情包改得一塌糊涂,差点让我当场放弃。折腾一番后,我们梳理出了彩色 Emoji 字体的核心技术路线:
::::info[DeepSeek 技术总结:字体格式选型] 目前主流彩色 Emoji 字体主要有三种技术路线:
| 格式 | 典型代表 | 特点与备注 |
|---|---|---|
CBDT/CBLC |
Noto Emoji、Android、Windows | 位图 + 独立字形度量(兼容性最广) |
sbix |
Apple Color Emoji | 位图,苹果生态专用 |
COLR/CPAL |
新版 Windows、Chrome | 矢量分层 |
最初尝试的是 sbix 格式,结果在 Qt 应用(如状态栏)里表情明显偏小——因为 sbix 直接按 strike 的原始像素尺寸绘制,不会随字号动态缩放。
换成 CBDT/CBLC 后问题迎刃而解:它为每个字形提供了独立的 height / width / bearing / advance 度量数据,在任意字号下都能正确缩放并与基线对齐。
结论一:在 Linux 下做跨应用 Emoji 字体,优先选 CBDT/CBLC。
三、出图:与 AI 斗智斗勇
因为 DeepSeek 本身没有生图能力,最开始它自信满满地写了个 Python 脚本直接用代码画图,结果画出来纯属一坨史。
后来我换了个思路:让它调用 Codex 配合生图模型来批量出图。直接选了最便宜的模型,5 小时限额一口气生成了几十张,连 5% 的额度都没用完。
当然,AI 出图也并非一帆风顺。第一批生成的图片把脸部和五官画得太小,缩成 Emoji 尺寸后根本看不清是什么表情。
于是我让 DeepSeek 反复迭代提示词,排查半天发现罪魁祸首居然是双马尾画太长占满了画布,重点放大了面部占比并强化五官辨识度。连改 8 版之后,终于调出了满意的效果。
四、打包:借壳生成字体
图片准备好后,下一步是把 PNG 序列打包成系统能识别的 .ttf 字体文件。这也是整个项目在工程实现上最有趣的部分:
::::info[DeepSeek 技术总结:借壳打包 CBDT]
fontTools 虽然能读取 CBDT/CBLC 表,但不支持直接从零构建。第一版我尝试手写 CBLC 的二进制偏移表,虽然 fontTools 解析完全正常,但交给 FreeType 渲染时却直接报错 broken file——二进制结构里哪怕有 1 字节的偏差都会导致渲染失败,而且报错信息完全不指明具体位置。
后来换了个更稳妥的思路:借壳上市。
- 先用
pyftsubset从现成的 Emoji 字体里裁出需要的 38 个码位,得到一个二进制结构完全合法的CBDT壳容器; - 用
fontTools读取这个壳文件,仅替换每个字形的imageData(PNG 位图数据)和metrics(度量信息); - 重新保存为新字体。
font = TTFont("subset.ttf")
cbdt, cblc = font["CBDT"], font["CBLC"]
for idx, strike in enumerate(cblc.strikes):
glyphs = cbdt.strikeData[idx]
m = SmallGlyphMetrics()
m.height, m.width = ppem, ppem
m.BearingY = round(ppem * 0.85)
m.Advance = ppem
glyphs[name].imageData = png_bytes
glyphs[name].metrics = m
font.save("MikuEmoji.ttf")
结论二:手搓 CBDT极易踩二进制对齐的坑,直接裁剪现成的合法字体容器并替换位图是最稳的做法。
五、适配:fontconfig 与 Chromium 的坑
字体安装进系统后,Qt 应用(比如我的顶栏)立刻生效了,但浏览器里死活不显示新表情。
排查后发现,桌面应用和浏览器走的是两条完全不同的字体匹配路径:
- Qt / GTK:严格遵循
fontconfig的家族(family)优先级链,配置一条alias别名映射就能生效。 - Chromium / Skia:触发 Emoji 回退机制时不带家族偏好,而是直接拉取一份系统通用字体排序列表从上往下匹配。自定义字体按名称排在后面,根本轮不到它出场。
::::info[DeepSeek 技术总结:强行置顶字体优先级] 最开始写的配置是“将特定 Emoji 字体家族替换为新字体”,这对 Chromium 完全无效。最终的解决方案是在每次字体查询时无差别强行前置(prepend):
<match target="pattern">
<edit name="family" mode="prepend" binding="strong">
<string>Miku Emoji</string>
</edit>
</match>
由于我们的字体文件里只包含这 120 个 Emoji 码位,遇到普通文字、中文或其他未覆盖的 Emoji 时,渲染引擎会自动向下回退到 Noto 或 Apple 字体,完全不会影响正常正文排版与其余 Emoji 的显示。
结论三:想让 Chromium 渲染自定义 Emoji 字体,必须使用全局 prepend强绑定,不能只做家族替换。
六、成品展示
目前完成的 120 个字形,覆盖了日常最常用的表情脸、手势和基础图标:
在浏览器及网页端均可完美渲染:
七、安装与使用
1. Arch 系(Omarchy / Arch / Manjaro / EndeavourOS / CachyOS)
可以直接使用仓库打包好的安装包:
sudo pacman -U ttf-miku-emoji-1.0.0-1-any.pkg.tar.zst
fc-cache -f
2. 其他 Linux 发行版(Debian / Ubuntu / Fedora / openSUSE 等)
注:非 Arch 系发行版暂未实机测试,如遇问题欢迎反馈。
git clone [https://github.com/BearThomas/miku-emoji-font.git](https://github.com/BearThomas/miku-emoji-font.git)
cd miku-emoji-font
./install.sh # 系统级安装(会自动请求 sudo)
# 或执行 ./install.sh --user 仅安装至当前用户目录
如需卸载,运行仓库内的 ./uninstall.sh 并重启浏览器或终端即可恢复默认。
3. 其他操作系统说明
- Windows:系统底层支持
CBDT格式,但没有提供直接替换系统默认 Emoji 的配置入口。需要将字形合并进系统的seguiemj.ttf并替换系统文件,目前暂未内置支持,感兴趣的朋友可以让 AI 辅助探索。 - macOS / iOS:系统仅支持苹果自家的
sbix表结构,暂不支持。
八、开源与授权说明(重要)
初音未来(Hatsune Miku)是 Crypton Future Media 的版权角色。本项目为非商业同人开源作品,严格遵循 Piapro Character License (PCL):
- 允许自由使用、修改与非商业分发;
- 严禁任何形式的售卖,也禁止打包进任何付费产品或商业项目中;
- 二次分发或修改时请保留原仓库的
LICENSE声明。
如有商业使用需求,请务必自行联系 Crypton 官方申请商业授权。
九、项目仓库与自定义扩展
GitHub 仓库:https://github.com/BearThomas/miku-emoji-font
仓库内包含了编译好的字体文件、fontconfig 配置文件、Arch 打包脚本、通用安装脚本,以及整套 AI 生图与打包规则文档(PROMPT_TEMPLATE.md)。
如果你想制作属于其他角色的专属 Emoji 字体,只需把仓库克隆下来,把 PROMPT_TEMPLATE.md 喂给 AI 并修改角色特征描述,就能直接复刻出一套新主题。
有任何问题或建议欢迎在评论区交流,或者直接去 GitHub 仓库提 Issue / PR!
本文使用 Gemini 润色。