前言¶
DeepSeek Harness（DSH）的 Web GUI 自带浅色、深色与跟随系统几套官方主题，配色走 --dsw-* 设计令牌。若你日常开发或调试智能体时长时间盯着界面，默认主题未必合眼；社区里也有透明 UI、自定义 CSS 等做法，但要么只改局部，要么需要自行维护样式。
下面介绍维护者 NoNameLeGo 发布的 dsh-catppuccin-theme（npm 包名 @nonamelego/dsh-catppuccin）。它把 Catppuccin 的 Latte、Frappé、Macchiato、Mocha 四套色板注册进 DSH 官方主题系统，并可选开启玻璃质感（Glassmorphism）皮肤；同一包还覆盖 Web GUI、dsh web、DSH Desktop 与 dsh-TUI 终端配色。
这是什么¶
dsh-catppuccin-theme 是 DeepSeek Harness 的主题类插件，分类为「趣味换装」。维护者 NoNameLeGo，源码托管于 GitHub，当前 npm 版本 0.4.0，许可证 MIT，GitHub 星标约 18。
它解决两件事：一是把界面全量映射到 Catppuccin 色板（不只改强调色）；二是在设置里提供可开关、可调参数的磨砂玻璃皮肤，顶栏、侧边栏、输入框等区域可呈现玻璃卡片效果，配色随当前 Catppuccin 主题自动切换。
核心功能¶
四套 Catppuccin 主题¶
插件内置 Catppuccin 官方四主题：
- Latte（浅色）
- Frappé、Macchiato、Mocha（深色）
接入 DSH 官方主题系统，与内置浅色 / 深色 / 跟随系统平级。选择会写入本地偏好，重启后自动恢复。选「跟随系统」会回退到启用 Catppuccin 之前的官方主题偏好，而非强制重置。
全界面配色与设置入口¶
插件重映射 --dsw-* 令牌阶梯，覆盖 Web 界面主要区域。安装并重启后，在 设置 → 常规 → 外观 下方会出现 Catppuccin 行，用于一键切换上述四套主题。
玻璃质感（Glassmorphism）¶
在 Catppuccin 主题 下方有 玻璃质感 设置：
- 总开关：开启后顶栏、侧边栏、输入框、统计行、轨迹视图、聊天气泡、新会话按钮变为磨砂玻璃；关闭即还原原生界面。
- 模式：云母效果（悬浮磨砂卡片）或 兼容模式（保持原版排版，仅换材质）。
- 预设：清透 / 标准 / 磨砂三档；也可调节玻璃模糊度（0–40 px）、磨砂度（0–100%）、背景亮度。
- 玻璃颜色跟随当前 Catppuccin 主题；页面上下边缘有渐变模糊，折叠侧边栏可呈现悬浮玻璃效果。
dsh-TUI 终端主题¶
同一 npm 包含 TUI 主题同步逻辑。安装到 dsh-tui profile 后，启动时会将四套主题 JSON 同步到 ~/.dsh-tui/themes/（Windows 为 %USERPROFILE%\.dsh-tui\themes\）。在 dsh-TUI 内可用 /theme 选择 Catppuccin Latte / Frappé / Macchiato / Mocha，或 /theme catppuccin-mocha 直接切换。
其他能力¶
- 中英文双语文案，跟随系统语言。
- 设置 → 常规 中 检查 Catppuccin 插件更新：对比 npm 最新版，发现新版时给出可复制的升级命令（profile 名自动探测）。
- 已为 Web GUI 安装且
~/.dsh-tui/themes/已存在时，Web 端启动也会同步 TUI 主题，通常无需重复安装。
安装与启用¶
插件以 DSH profile 为单位安装。dsh plugin 会把包装进对应 profile 的 bundles，装完需重启对应进程。
Web GUI（推荐 npm）¶
面向 dsh web 的 Web GUI，在终端执行：
dsh plugin --profile web add @nonamelego/dsh-catppuccin
装完重启 dsh web 即可。其他 profile 将命令中的 web 换成 profile 名（例如 headless）。
DSH Desktop¶
桌面版默认 profile 为 desktop：
dsh plugin --profile desktop add @nonamelego/dsh-catppuccin
在 DSH 终端中运行；若托盘里选了别的 profile，换成对应名字。装完重启 DSH Desktop 生效。
从 GitHub 仓库安装¶
npm 不可用或需跟踪源码时：
dsh plugin --profile web add https://github.com/NoNameLeGo/dsh-catppuccin-theme
Desktop 同理，把 web 换成 desktop。从 git 安装时，若 pnpm 提示构建脚本受限，按提示在 profile 的 pnpm-workspace.yaml 的 allowBuilds 中加入对应包后重跑。
dsh-TUI¶
dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin
或：
dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-theme
装完启动 dsh --profile dsh-tui，用 /theme 切换 Catppuccin 主题。也可手动复制包内 themes/*.json 到 ~/.dsh-tui/themes/，但不会随版本自动更新；catppuccin-*.json 同步时会被覆盖，自定义请改名另存。
典型用法¶
切换 Catppuccin 主题¶
- 打开 Web GUI（默认
http://127.0.0.1:3080），或在 DSH Desktop 中打开桌面应用。 - 进入 设置 → 常规。
- 在 外观 下方 Catppuccin 行选择 Latte、Frappé、Macchiato 或 Mocha。
- 界面即时换色；偏好自动保存，下次启动恢复。
开启并调节玻璃质感¶
- 仍在 设置 → 常规，找到 Catppuccin 主题 下方的 玻璃质感。
- 打开总开关，按需选 云母效果 或 兼容模式。
- 先用 清透 / 标准 / 磨砂 预设，再用滑条微调模糊度、磨砂度与背景亮度。
- 切换 Catppuccin 主题时，玻璃配色同步变化；关闭总开关即回到原生界面。
检查插件更新¶
在 玻璃质感 下方点击 检查更新。若 npm 上有新版本，界面会显示版本号并提供可复制升级命令；本地 link: / file: / git 安装时会提示改用 git pull 或重新构建。
dsh-TUI 中切换主题¶
安装 dsh-tui profile 后：
dsh --profile dsh-tui
在 TUI 内执行 /theme，选择 Catppuccin 系列，或：
/theme catppuccin-mocha
TUI 主题只管 TUI 内部配色；终端背景仍由你所用终端决定，可配合 Catppuccin 终端主题以获得一致观感。
适用场景与注意¶
适合谁
- 长时间使用 DSH Web GUI 或 Desktop，希望界面统一到 Catppuccin 配色。
- 需要在浅色 Latte 与深色 Mocha 等风格间快速切换，且希望偏好持久化。
- 喜欢磨砂玻璃视觉，又不想单独维护 CSS 或透明 UI 插件。
- 同时使用 dsh-TUI，希望终端内配色与 Web 端同一套 Catppuccin 色板。
使用前请注意
- DSH 插件在 当前 dsh 进程的权限与环境中运行。安装前建议阅读 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全与合规要求。
- 社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系；安装命令以 README 与 npm 包为准。
- 若 外观 区域看不到 Catppuccin 行，常见原因是插件未正确加入 profile bundles 或未重启
dsh web/ Desktop；可检查dsh plugin list与 profile 配置。 - TUI 侧
catppuccin-*.json由插件同步覆盖；有自定义需求请另存文件名。
结尾¶
dsh-catppuccin-theme 把 Catppuccin 四套主题和可选玻璃质感接进 DSH 官方外观体系，Web、Desktop、TUI 一条安装路径即可覆盖。若你正在找「装完就能换整套配色、还能调磨砂玻璃」的主题插件，可以从此处入手。
