本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-catppuccin-theme

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @nonamelego/dsh-catppuccin

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 玻璃拟态（Glassmorphism）
• 🙋 常见问题
• 💝 致谢
• 🎨 四个主题：Latte（浅色）、Frappé / Macchiato / Mocha（深色）
• 🧩 接入官方主题系统，与内置浅色 / 深色 / 跟随系统主题平级

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

在「外观」里看不到 Catppuccin 主题怎么办？

官方外观行只列内置的浅色/深色/跟随系统四个主题。Catppuccin 主题位于其正下方新增的一行（设置 → 常规 → Catppuccin），Latte / Frappé / Macchiato / Mocha 都在这里切换。

主题和玻璃质感的设置保存在哪里？会随 DSH Desktop 重启丢失吗？

选择持久保存在 DSH 安装目录下的 catppuccin-state.json 文件（跨端口、跨重启稳定），浏览器 localStorage 只做即时缓存与多标签页同步，因此 DSH Desktop 每次用随机回环端口启动也能自动恢复。

怎么升级插件？

设置页里有一行「检查 Catppuccin 插件更新」按钮，插件会查询 npm registry，发现新版会给出可直接复制的升级命令，profile 名由插件自动探测。也可以手动执行 dsh plugin --profile <profile> update @nonamelego/dsh-catppuccin。

关闭 Catppuccin 后界面会变成什么样？

选择「跟随系统」会还原你启用 Catppuccin 之前在官方外观里的偏好（浅色/深色/跟随系统），而不是强制重置为默认。

玻璃质感开关会影响哪些界面区域？

顶栏、侧边栏、输入框、统计行、轨迹视图、聊天气泡、新会话按钮这七个区域都会变成磨砂玻璃；关闭总开关则完全还原原生界面，无需刷新。

玻璃的「云母」与「兼容」两种模式有什么区别？

云母模式把界面改成悬浮磨砂玻璃卡片（顶栏/侧边栏/输入框等脱离边缘）；兼容模式保留原版排版，只把材质换成玻璃。

怎么卸载？

在对应 profile 下执行 dsh plugin remove @nonamelego/dsh-catppuccin，卸载时玻璃层会随插件 fiber 一起释放，不会留下残留 DOM 或样式。

我装的是 git/本地链接版本，能用「检查更新」吗？

能查，但插件会提示 npm 升级命令不适用，需要改用 git pull 或重新构建本地包。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则