图标
-
qingjian-mark.svg:README 页头使用的透明竹简图标,与官网品牌图标一致。 -
logo.png(1024×1024,带透明通道的竹简):Linux 图标的源文件(见下面linux/hicolor),官网等处也用这个透明版。 -
macos/app.svg:macOS 应用图标源文件(输入法包与设置程序共用),图形同 Windows 的windows/app.svg,按 macOS 图标网格摆 (1024 画布居中 824 的圆角方块;不照网格画,macOS 26 会给图标垫一块灰底)。macos/render-app-icon.sh栅格化成macos/app.png随仓库提交,apps/macos/scripts/bundle.sh打包时用sips+iconutil由它生成Qingjian.icns。 -
fcitx4.png:由logo.png缩放到 48×48,供 Fcitx4 经典面板及托盘组件使用。 -
menu.svg:macOS 输入法图标源文件,黑色键帽镂空四片竹简(模板图,系统只取 alpha)。menu.pdf是它导出的 22×16pt 矢量版,打包时拷成qingjian-menu.pdf,Info.plist 的图标键都指向它。为什么是这个形式和尺寸见docs/design/architecture.md「Info.plist 约定」。改了 svg 重新导出:rsvg-convert -f pdf --page-width 22pt --page-height 16pt -w 22pt -h 16pt assets/icon/menu.svg -o assets/icon/menu.pdf -
windows/mode-zh.svg/mode-en.svg/mode-caps.svg:Windows 任务栏的中 / 英 / A 图标源文件(16×16 画布,单色)。windows/render-mode-icons.sh用 rsvg-convert + magick 栅格化成 16 / 20 / 24 / 32 四档的 8 位 alpha 蒙版, 写到apps/windows/tsf/resources/mode/,DLL 用include_bytes!嵌入、运行时按任务栏深浅色填色(com/mode/icon.rs)。 改了 svg 重跑脚本,生成物随仓库提交。 -
windows/app.svg/app-16.svg:Windows 应用图标源文件(安装器、开始菜单、Server exe、输入法列表共用的qingjian.ico)。 深绿圆角底衬白竹简:原图细长、透明底,缩到任务栏的 16px 只剩两根细绿条,深色任务栏上看不清;16px 那档单独画了像素对齐版。windows/render-app-icon.sh栅格化成 16–256 八档写到apps/windows/tsf/resources/qingjian.ico,改了 svg 重跑,生成物随仓库提交。 -
linux/hicolor/<尺寸>x<尺寸>/apps/qingjian.png:Linux 托盘与应用图标,freedesktop hicolor 八档 (16/22/24/32/48/64/128/256)。linux/render-icons.sh从logo.png等比栅格化(需要 magick),生成物随仓库提交, 源码安装与预编译包都不带栅格化依赖;apps/linux/scripts/files.py安装时按目录尺寸逐档拷到$XDG_DATA_HOME/icons/hicolor/。 改了源图重跑脚本;不要把 1024px 源图直接放进尺寸目录,不做缩放的托盘(如 Waybar)会显示成巨图。
Linux 发行版打包
八档 PNG 已栅格化并随仓库提交,打包时不需要 ImageMagick,逐档装进系统 hicolor 主题即可,文件名保持 qingjian.png:
for size in 16 22 24 32 48 64 128 256; do
install -Dm644 "assets/icon/linux/hicolor/${size}x${size}/apps/qingjian.png" \
"${pkgdir}/usr/share/icons/hicolor/${size}x${size}/apps/qingjian.png"
done
- 目录名的名义尺寸必须与 PNG 实际像素一致:不要把 1024px 的
logo.png塞进某个尺寸目录,也不要只装最大一档, 否则不做缩放的托盘(如 Waybar)会显示成巨图,或找不到 16px 小图标(#547)。 - 装进
/usr/share/qingjian/resources/assets/的那份是程序资源副本,图标主题不读这个路径,不能拿它代替 hicolor 安装。 - 多数发行版的
gtk-update-icon-cachehook(或 file trigger)会自动刷新缓存;没有的话在打包安装钩子中执行gtk-update-icon-cache -q -t -f /usr/share/icons/hicolor。
源码安装与官方预编译包走 apps/linux/scripts/files.py,装到 $XDG_DATA_HOME/icons/hicolor/(用户目录);系统级发行版包不要复用该路径,应装 /usr/share/icons/hicolor/。