XHIM UI 图标与主题

这里保存 XHIM Demo 和 UI Kit 共用的图标与基础主题。业务 App 可以替换颜色、字体、 圆角和消息气泡，不会影响登录、同步或消息发送。

各端从哪里使用

平台	UI 包	资源
iOS / macOS	XHIMSwiftUI	Asset Catalog
Android	Java Demo 为主；xhim-ui-compose 为可选 UI Kit	Vector Drawable
Windows	XHIM.UI.Wpf	WPF Geometry
HarmonyOS	@xihansoftware/xhim	HAR media SVG
Web / Electron / React Native / Flutter	各端 Demo	随包的 Lucide SVG/Path，不在运行时下载

推荐修改顺序

1. 先运行未修改的 Demo；
2. 在平台 Theme 中替换品牌色和字体；
3. 替换会话、消息、联系人和群组图标；
4. 检查浅色、深色、常用字号和无障碍模式；
5. 重新运行聊天、联系人和群组页面。

业务项目优先覆盖平台 Theme，不要直接修改生成后的某一个平台图标。需要统一更新全部 平台时，修改 xhim-design-tokens.json 和源 SVG，再运行资源导入检查。

Demo 中所有用户可见的功能图标都使用 App 自带的矢量资源，包括返回、关闭、 发送、搜索、更多、刷新和密码显示按钮。不依赖 SF Symbols、Android 系统 Drawable 或平台默认图标来完成品牌 UI。系统键盘、无障碍提示和操作系统本身的 安全弹窗保持系统行为，不用图标伪造。

iOS 26 及更高版本的 Demo 明确关闭导航栏自动 Liquid Glass 外观，返回按钮使用 本地矢量资源和自定义容器，不由系统重新套用玻璃背景。

图标许可

当前基础图标来自 Lucide 1.14.0。许可证和每个源文件的 SHA-256 位于 lucide/1.14.0/。发布应用时保留随包提供的许可证文件。

重新生成图标

发布构建不会临时联网下载资源。升级图标版本时，在独立目录取得审核过的 Lucide 版本， 然后运行：

git clone --depth 1 --branch 1.14.0 \
  https://github.com/lucide-icons/lucide.git /tmp/lucide

python3 scripts/ui/import_lucide_icons.py --source-checkout /tmp/lucide
python3 scripts/ui/import_lucide_icons.py --check

如果只需要修改业务 App 的视觉样式，不必重新运行导入器，直接使用平台 Theme 覆盖即可。