Catppuccin for DeepSeek Harness
中文 | English
目录
简介 · 特性 · 预览 · 安装 · 使用 · 玻璃拟态 · 兼容性 · 开发 · 🙋 常见问题 · 💝 致谢
关键字高亮 · 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 地址 / 压缩包 / 本地路径) · 在打开的 终端里执行命令:dsh plugin --profile desktop add @nonamelego/dsh-catppuccin 升级 · 先在插件界面里把插件删除,再重新填一遍同一个包名安装(v0.2.0 没有升级入口,也没有版本选择器) · 与 web 类似的更新命令:dsh plugin --profile desktop update @nonamelego/dsh-catppuccin 谁执行 pnpm · 应用自带的 pnpm · 应用自带的 pnpm
两种方式改完都要重启桌面应用才会加载新版本。
⚠️ 两列别混用:官方壳的插件界面不执行命令;社区壳那条 update 命令对官方壳也不适用。
另外,系统 PATH 上那个普通 `dsh` 两个壳都管不了 `desktop`——上游把 desktop 当自己保留的
profile,会直接报 error: profile "desktop" is managed exclusively by the Electron application。
想用 CLI 管就用别的 profile 名(web、headless、dsh-tui)。
本插件的桌面支持以
官方 web + 官方 desktop 为维护核心;社区壳的 desktopProfiles 服务探测也保留。
但官方壳的 profile 进程没有专用的环境标记(它的 DSH_DESKTOP_NODE_EXECUTABLE 只注入给
包安装子进程),所以本插件改为识别 Electron-as-node 运行时(process.versions.electron)
来判定官方桌面版;设置的读写不受影响。
方式二:从仓库安装
dsh plugin --profile web add https://github.com/NoNameLeGo/dsh-catppuccin-theme
从 git 安装时 pnpm 可能要求允许构建脚本——按 pnpm 的提示把对应包加进 profile pnpm-workspace.yaml 的 allowBuilds 后重跑一次即可。
桌面版同理,但按上面的表走:官方壳在插件界面里直接填 Git 地址;社区壳把这条命令的 dsh plugin --profile web add … 换成 dsh plugin --profile desktop add …。
dsh-TUI(终端版)主题
本节针对第三方终端前端 dsh-TUI(需先自行装好它)。 与 Web GUI 插件同一个包,用标准的插件安装命令装进 dsh-tui profile:
dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin
从仓库安装同理(也可用 git 形式,效果一致):
dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-theme
包里带一个只做主题同步的小插件行(dsh-catppuccin-tui-themes,不依赖任何服务):dsh-TUI 启动时自动把四套主题 JSON 同步到 ~/.dsh-tui/themes/,之后升级包即同步新版配色。装完启动 dsh --profile dsh-tui,在 dsh-TUI 里用 /theme 选择 Catppuccin Latte / Frappé / Macchiato / Mocha,或直接 /theme catppuccin-mocha 切换(选择会持久化,下次启动自动恢复)。
💡 已为 Web GUI 装过本插件、同时用 dsh-TUI 的话,无需重复安装:Web 端每次
启动会自动同步主题到 ~/.dsh-tui/themes/(仅当该目录已存在)。
📁 不想装包也可手动复制:把 themes/*.json 拷进 ~/.dsh-tui/themes/
(Windows:%USERPROFILE%.dsh-tui\themes),只是不随版本自动更新。
⚠️ catppuccin-*.json 归本插件所有、同步时会被覆盖;想自定义请改名另存。
💡 TUI 主题只管 TUI 内部配色,终端背景由你的终端决定——建议也配上对应
风味的 Catppuccin(见 Catppuccin ports 列表),观感最一致。
使用
- 打开 Web GUI(默认
http://127.0.0.1:3080);在 DSH Desktop 中则直接打开桌面应用即可。 - 打开 设置,在左侧导航里点 Catppuccin(官方各节之后的独立分区)。
- 在 主题 区域选择风味:
Latte(浅色)、Frappé、Macchiato 或 Mocha(深色)。
- 选择 跟随系统 则回退到官方主题——会还原你启用 Catppuccin 之前
的官方偏好(浅色 / 深色 / 跟随系统),而不是强制重置。
另一处入口:在 插件页(Plugins)点开本插件自己的卡片,中间会出现同一组设置
(Catppuccin 主题 / 玻璃质感 / 检查更新 / 反馈与支持)——两处读写的是同一份偏好,改哪边都一样。
该区域由宿主(≥ 0.2.0-rc.2 的插件详情页)提供,更旧的版本上没有。
代码高亮与自定义覆盖
- 代码高亮风格:默认 / 注释斜体(italic-comments)——只影响代码块与 diff 的 shiki 高亮配色。
- 自定义覆盖(折叠区,按钮上显示已有条数):按「
--dsw-* 变量: 值」逐条覆盖单个 token,
例如 --dsw-static-blue-500 → #89b4fa。键名失焦生效(必须以 -- 开头,否则该条会被丢弃); 值同样失焦生效、清空值即删除该条;✕ 删除整行。覆盖持久保存,与所选风味一起生效。
玻璃质感
在 设置 → Catppuccin 页里找到 玻璃质感 区域:
- 总开关:开启后顶栏、侧边栏、输入框、轨迹视图变为磨砂玻璃;
关闭即完全还原原生界面(无需刷新)。
- 模式:云母效果把界面改成悬浮磨砂卡片;兼容模式保持原版排版,
只把材质换成玻璃。
- 性能:云母效果会在大面积区域(顶栏、输入框、侧边栏)做背景模糊,
流式输出时占用 GPU 较明显(同一会话实测峰值约 80%,兼容模式不到 30%); 模糊半径本身不是主因(调到 0 px 也照样计费——只要不是 none,每帧都要回读背景)。 在意占用就用兼容模式:它只在输入框卡片与浮层上做玻璃,命中面明显更小。
- 预设:清透 / 标准 / 磨砂 三档一键套用;想微调再用下面的滑条
(当前旋钮值与某档一致时该档高亮)。
- 玻璃模糊度(0–40 px)、磨砂度(0–100%):控制玻璃的模糊半径与
不透明度。
- 背景亮度:深色模式 0–50 压暗、浅色模式 50–100 提亮(50 为原样),
直接调和进地面底色;拉到两端时氛围层淡出,回到纯白 / 纯黑。
- 地面光斑:在地面渐变上叠两枚固定于屏幕的柔光斑(
0.6.3 的观感),默认关——