zhijun-dai/Catppuccin-dsh-theme

目录

• 简介
• 特性
• 预览
• 安装
• 使用
• 常见问题
• 工作原理
• 💝 致谢

简介

🐱 DeepSeek Harness 的 Catppuccin 主题插件——一个包同时适配 Web GUI（dsh web）、DSH Desktop 与 dsh-TUI 终端：

• Web / 桌面端：整个界面用官方 26 色粉彩盘重新上色，不是一两个强调色， 是全组件覆盖。
• dsh-TUI：四套官方主题色板安装时自动同步到 ~/.dsh-tui/themes/。

内置 Catppuccin 四个风味——Latte、Frappé、Macchiato、Mocha—— 接入官方主题系统，与内置浅色 / 深色 / 跟随系统平级，在 设置 → 常规 → 外观 下方提供一行 Catppuccin 一键切换。选择自动保存、重启自动恢复； 切回默认即逐像素还原内置外观，卸载零残留。

特性

• 🎨 完整的 Catppuccin 颜色——每个值都是官方色盘颜色（或色盘内混色）， 界面没有默认的 DeepSeek 蓝灰。
• 🖱️ 组件级染色——消息气泡、工具调用行、代码块标签、时间戳、hover 交互全部按色盘上色：鼠标滑过变主题色，空工作区标题是品牌 mauve。
• 💻 dsh-TUI 终端主题——一条命令装进终端客户端，启动自动同步四套主题， 见 安装 · dsh-TUI。
• 🔄 更新检查——设置页静默检查 npm 新版本（另有手动按钮）， 有新版直接给出可复制的升级命令。
• 🧠 记住你的选择——重启自动恢复，宿主重新断言偏好也不丢； 关闭时还原你原本的浅色 / 深色偏好，而不是强制"跟随系统"。
• 🗄️ 双层持久化——DSH Desktop 每次启动换随机端口、localStorage 清空， 选择依然从 $DSH_HOME 恢复。
• ⚙️ 零侵入——切回默认逐像素还原，不留任何注入样式。

预览

四个风味在 DeepSeek Harness 中的实际效果（文首大图为四主题合成）：

安装

从 GitHub 安装（推荐——始终最新）：

dsh plugin --profile web add github:zhijun-dai/Catppuccin-dsh-theme

从 npm 安装：

dsh plugin --profile web add dsh-catppuccin

💡 npm 版本可能比 GitHub 滞后一点。想要最新版用上面的 GitHub 安装 （可用 #分支名 锁定分支）。

DSH Desktop 用户装到桌面 profile：

dsh plugin --profile desktop add dsh-catppuccin

dsh-TUI 终端主题

同一个包也会把四套 Catppuccin 主题同步进 dsh-TUI。装进 TUI profile， 首次启动即生效：

dsh plugin --profile dsh-tui add dsh-catppuccin

在 TUI 里切换：/theme catppuccin-mocha。

💡 如果你同时用 Web / Desktop 和 dsh-TUI，装到 web profile 也会在每次 启动时保持 TUI 主题同步，无需二次安装。磁盘上没有 ~/.dsh-tui？ 严格 no-op，不会创建任何东西。

装完重启 web 服务：

dsh web

使用

打开 Web UI，进入 设置 → 常规，选择四个 Catppuccin 风味之一 （选「默认」恢复内置外观）。选择按浏览器保存，启动时自动恢复。

常见问题

Q：装完在设置里看不到 Catppuccin 行？

确认装进了 dsh web 实际使用的 profile（上面的 --profile web）， 装完重启 dsh web。

Q：选择是怎么记住的？

存两层：浏览器 localStorage（即时）+ Desktop 场景下 $DSH_HOME 下的小文件（耐久）——所以重启、切模型、Desktop 换端口都不丢。 你在内置外观行显式选的浅色 / 深色永远优先。

Q：怎么升级？

重跑一次安装命令（会拉到最新版），或者看设置页——它会在有新版本时 静默提示，并给出可直接复制的升级命令。然后重启 dsh web。

工作原理

主题定义由官方 catppuccin/palette 的 palette.json 生成（不手改色值）。scripts/gen-themes.mjs 把每个风味的 26 个 Catppuccin 颜色映射到 dsh @deepseek-ai/dsh-client-ui-theme 样式表的 --dsw-alias-* token 目录（含 --shiki-* 语法高亮色和泄漏的 --dsw-static-deepseek-* 静态色），写出 themes/ 下的逐风味 token 表， 并内嵌进浏览器端 bundle lib/client.js。dsh-TUI 主题由 scripts/gen-tui-themes.mjs 生成。

💝 致谢

• zhijun-dai
• Catppuccin
• KinGao294/dsh-skin — 本插件的参考实现
• DeepSeek