guanghu-ice-heart/skills/shared/guanghu-client-ui-brain/references/investigation-tauri-desktop-themes-20260812.md
冰朔 17c64a83ee feat(skills): GHS-014 候选 · 光湖产品客户端 UI 思维大脑登记上线
冰朔 2026-08-12 委托调研并定版 HoloLake 客户端首页,十二轮判词(v0.1→v1.3)
喂养成脑:首页=世界入口(GLS-0250 五域门厅拓扑投影);湖面禁机械形与硬线,
流动只取波光粼粼与雾光;三名归位(HoloLake 客户端/光湖世界/GH-AIOS 平台登记名);
主题=令牌组,五色湖取样(含亮色)。调研、因果链、定版规格、色板令牌、
七份经验回执与 v1.2/v1.3 参考实现全部入册。注册表 2026.08.12.1→.2,
候选册 GHB-012,README-SKILLS 映射同步。

人类责任主体:冰朔 ICE-GL∞
人格作者:铸渊 ICE-P-ZY001(QoderWork CN 实例)
2026-08-12 13:25:30 +08:00

3 KiB
Raw Blame History

调研 · 桌面软件的主题是怎么做的Tauri 语境)

2026-08-12 · 铸渊 ICE-P-ZY001 · 起因:冰朔点名调研 GitHub 上别人软件的主题/配色/UI 做法 方法GitHub 高星 Tauri 应用源码实读 + 主题机制归纳;结论直接用于 HoloLake 客户端定案

1 · 案例实读

应用 星数 技术栈 主题做法 可学的点
Clash Verge Rev 137k Tauri+React+MUI 组件库调色板createTheme+ 跟随系统明暗(@tauri-apps/api/window Theme+ 用户可注入自定义 CSS/主色/背景图 系统主题同步;用户自定义入口
cc-switch 126k Tauri+React+Radix/shadcn+Tailwind 设计令牌 + 无头组件,样式全自控 令牌派主流做法,外观上限高
Jan 44k Tauri+React+Tailwind Tailwind 深色基调 + 语义色 AI 桌面应用暗色标杆
Readest 23k Tauri+React 种子色派生bg/前景/主色 3 色经色彩算法(加深/提亮/邻近色/OKLCH推导全色板明暗两套支持环境光模式 用户换主题成本最低的机制
GitButler 21k Tauri+Svelte 全自绘 完全自控 辨识度最高,成本也最高
模板主流 Tauri v2 + shadcn/ui + Tailwind CSS 变量定义全部颜色,一处改全局 市面默认解

2 · 三个流派

A · 设计令牌 / CSS 变量派(主流,本项目选它) 三层结构:原始值(色值数字)→ 语义层(背景/主色/状态色)→ 组件层(组件用哪个语义色)。 全部用 CSS 变量承载,换主题=换一组变量。Readest 进阶玩法:只定 3 个种子色,算法推导全色板。

B · 组件库主题派Clash Verge 的 MUI 路线) 给组件库喂一份调色板配置,省事;外观天花板被组件库风格锁住,容易撞脸。

C · 全自绘派GitButler 像素级自控,辨识度最高;成本最高。

3 · 窗口层(桌面独有,网页没有)

  • 无边框窗口 + 自绘标题栏拖拽区macOS 可保留红绿灯titleBarStyle overlay
  • 窗口材质macOS NSVisualEffectView / Windows 云母·亚克力tauri-plugin-vibrancy——侧栏用半透明材质是"桌面感"关键来源
  • 跟随系统明暗Tauri 原生 API 读系统主题自动切换

4 · 本项目定案

  1. 客户端主题走令牌派CSS 变量三层组件不写死颜色v1.3 五色湖已验证:换主题=换一组变量)
  2. 不引入组件库主题配置(防锁脸);组件用无头/自绘
  3. 主题命名从光湖意象生长(五色湖:夜湖星光/晨湖曦光/星云紫夜/烛畔暖湖/清浅澄湖不用通用名dark/light
  4. 后续真机实现tauri.conf.json windows 配置 + 前端令牌注入 + 用户选择持久化(设置页)

5 · 来源

  • GitHubclash-verge-rev / cc-switch / Jan / Readest / GitButler 源码与主题文件在线实读
  • 光湖正本GLS-0257范式总纲HoloLake=人类进入光湖的原生入口、GLS-0250五域灯塔架构