dsh-catppuccin

<img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/logos/exports/1544x1544_circle.png" width="100" alt="Logo"/><br/> Catppuccin for <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>

中文 | English

目录

<a href="#简介">简介</a> ·
<a href="#特性">特性</a> ·
<a href="#预览">预览</a> ·
<a href="#安装">安装</a> ·
<a href="#使用">使用</a> ·
<a href="#玻璃拟态glassmorphism">玻璃拟态</a> ·
<a href="#兼容性权限与失败边界">兼容性</a> ·
<a href="#开发">开发</a> ·
<a href="#-常见问题">🙋 常见问题</a> ·
<a href="#-致谢">💝 致谢</a>

关键字高亮 · Latte & Mocha

简介

DeepSeek Harness 的 Catppuccin 主题插件——一个包同时适配 Web GUI（dsh web）、桌面版（官方 Electron 壳 apps/desktop 与社区 DSH Desktop， 共用 desktop profile）与 dsh-TUI 终端： Web / 桌面端做全界面换色与玻璃质感，TUI 端自动同步四套官方主题色板。

它内置 Catppuccin 的四个主题——Latte、Frappé、Macchiato、Mocha—— 把整个界面的配色都换成对应的 Catppuccin 色板；并在设置里拥有自己的独立分区 （设置 → Catppuccin：风味、代码高亮、自定义覆盖、玻璃质感、更新检查、反馈与支持都在这一页）， 选择会自动保存、重启自动恢复。

同时内置一套可开关的玻璃质感（Glassmorphism）皮肤：顶栏、侧边栏、 输入框、轨迹视图、聊天气泡、新会话按钮都变成磨砂玻璃卡片， 模糊度、磨砂度、背景亮度均可自由调节，玻璃颜色自动跟随当前 Catppuccin 主题。

特性

• 🎨 四个主题：Latte（浅色）、Frappé / Macchiato / Mocha（深色）
• 🧩 接入官方主题系统，与内置浅色 / 深色 / 跟随系统主题平级
• 🎯 全界面配色覆盖，不只是一两个强调色
• ⚙️ 设置页独立分区一键切换，选择自动保存、重启自动恢复
• 🔧 自定义 token 覆盖：按「--dsw-* 变量: 值」逐条覆盖单个配色 token（例如把注释色换成蓝色），与所选风味一起持久保存
• 🖍️ 代码块高亮风格：默认 / 注释斜体（italic-comments）两套 shiki 风格可选
• 🌐 中 / 英 / 日 / 韩 / 西 / 法 / 德七语文案（跟随系统语言）
• 🪟 玻璃质感（云母模式）：顶栏 / 侧边栏 / 输入框 / 轨迹视图 / 聊天气泡 / 新会话按钮磨砂玻璃效果，设置里一键开关；云母 / 兼容双模式（兼容模式保持原版排版， 只给输入框卡片与浮层上玻璃），模糊度、磨砂度、 背景亮度自由调节（交互参考 DSH-Transparent-UI-Plugin）
• 🌫️ 玻璃拟态细节：页面上下边缘渐变模糊、折叠侧边栏悬浮玻璃、 随主题的氛围地面（同色系渐变；两枚柔光斑是可选开关、默认关）——内容滚入视口边缘时柔化穿过， 玻璃透着地面的明暗，层次更立体
• 🎨 玻璃配色自动跟随当前 Catppuccin 主题
• 🔄 检查 Catppuccin 插件更新：设置页一键检测本插件（dsh-catppuccin）在 npm 上的最新版本，发现新版直接给出可复制的升级命令；默认开启自动检查（启动后一次 + 每 6 小时），更新渠道可选稳定版 / Beta
• 💬 反馈与支持：设置区底部与插件详情页附 GitHub 链接——遇到问题可提 Issue，喜欢就点个 Star ⭐
• 💻 dsh-TUI 终端主题：一条安装命令装进 dsh-TUI，四套主题自动同步到 ~/.dsh-tui/themes/，见安装 · dsh-TUI

预览

四个主题在 DeepSeek Harness 中的实际效果（截图来自本地 GUI，文首大图为四主题斜切合成）：

🌻 Latte（浅色）

🪴 Frappé（深色）

🌺 Macchiato（深色）

🌿 Mocha（深色）

玻璃质感（Mica 云母模式）

同一会话在浅色（Latte）与深色（Mocha）下的磨砂玻璃效果：顶栏、侧边栏、 聊天气泡与输入框都是玻璃卡片，消息滚过页面边缘时被柔化 （截图来自本地 GUI）：

🌻 Latte（浅色玻璃）

🌿 Mocha（深色玻璃）

安装

方式一：从 npm 安装（推荐）

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

装完重启 dsh web 即可，dsh plugin 会自动把它加进 profile 的 bundles。 其他 profile 把命令里的 web 换成对应名字即可（如 headless）。

桌面版：官方桌面壳与社区桌面壳都读同一个 profile $DSH_HOME/profiles/desktop，但 两者装/升插件的方式完全不同、也不通用——按你用的壳选一列：

	官方桌面壳（DeepSeek Harness 客户端）	社区桌面壳（DSH Desktop）
安装	应用内的插件界面 → 添加插件 → 填包名 @nonamelego/dsh-catppuccin（也接受 Git 地址 / 压缩包 / 本地路径）	在打开的 终端里执行命令：<br>dsh plugin --profile desktop add @nonamelego/dsh-catppuccin
升级	先在插件界面里把插件删除，再重新填一遍同一个包名安装（v0.2.0 没有升级入口，也没有版本选择器）	与 web 类似的更新命令：<br>dsh plugin --profile desktop update @nonamelego/dsh-catppuccin
谁执行 pnpm	应用自带的 pnpm	应用自带的 pnpm

两种方式改完都要重启桌面应用才会加载新版本。

…