Skip to content
Back to search

dsh-catppuccin-theme

DeepSeek Harness Web GUI 的 Catppuccin 主题插件:Latte / Frappé / Macchiato / Mocha 四种主题一键切换,内置可开关的玻璃质感(Glassmorphism)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/NoNameLeGo/dsh-catppuccin-theme with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/NoNameLeGo/dsh-catppuccin-theme'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/nonamelego--dsh-catppuccin-theme/badge.svg)](/listings/nonamelego--dsh-catppuccin-theme)

HTML

<a href="/listings/nonamelego--dsh-catppuccin-theme"><img src="/api/listings/nonamelego--dsh-catppuccin-theme/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

方式一:从 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](https://github.com/deepseek-ai/deepseek-harness) 客户端) | 社区桌面壳([DSH Desktop](https://github.com/anywhere-labs/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 |

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

> ⚠️ **两列别混用**:官方壳的插件界面不执行命令;社区壳那条 `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](https://github.com/ccch1mneyyy/dsh-TUI)**(终端版)主题

本节针对第三方终端前端 **[dsh-TUI](https://github.com/ccch1mneyyy/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 列表](https://github.com/catppuccin/catppuccin#-ports)),观感最一致。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 469 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <h3 align="center">
  2. <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/logos/exports/1544x1544_circle.png" width="100" alt="Logo"/><br/>
  3. <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/>
  4. Catppuccin for <a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>
  5. <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/misc/transparent.png" height="30" width="0px"/>
  6. </h3>
  7. <p align="center">
  8. <a href="https://github.com/NoNameLeGo/dsh-catppuccin-theme/stargazers"><img src="https://img.shields.io/github/stars/NoNameLeGo/dsh-catppuccin-theme?colorA=363a4f&colorB=b7bdf8&style=for-the-badge"></a>
  9. <a href="https://github.com/NoNameLeGo/dsh-catppuccin-theme/issues"><img src="https://img.shields.io/github/issues/NoNameLeGo/dsh-catppuccin-theme?colorA=363a4f&colorB=f5a97f&style=for-the-badge"></a>
  10. <a href="https://github.com/NoNameLeGo/dsh-catppuccin-theme/contributors"><img src="https://img.shields.io/github/contributors/NoNameLeGo/dsh-catppuccin-theme?colorA=363a4f&colorB=a6da95&style=for-the-badge"></a>
  11. <a href="https://www.npmjs.com/package/@nonamelego/dsh-catppuccin"><img src="https://img.shields.io/npm/v/@nonamelego/dsh-catppuccin?colorA=363a4f&colorB=a6da95&style=for-the-badge"></a>
  12. <a href="https://www.npmjs.com/package/@nonamelego/dsh-catppuccin"><img src="https://img.shields.io/npm/dt/@nonamelego/dsh-catppuccin?colorA=363a4f&colorB=f5a97f&style=for-the-badge"></a>
  13. </p>
  14. **中文** | [English](README.en.md)
  15. ## 目录
  16. <p align="center">
  17. <a href="#简介">简介</a> ·
  18. <a href="#特性">特性</a> ·
  19. <a href="#预览">预览</a> ·
  20. <a href="#安装">安装</a> ·
  21. <a href="#使用">使用</a> ·
  22. <a href="#玻璃拟态glassmorphism">玻璃拟态</a> ·
  23. <a href="#兼容性权限与失败边界">兼容性</a> ·
  24. <a href="#开发">开发</a> ·
  25. <a href="#-常见问题">🙋 常见问题</a> ·
  26. <a href="#-致谢">💝 致谢</a>
  27. </p>
  28. <p align="center">
  29. <img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/combined.png" width="100%" alt="Catppuccin 四主题下的 DeepSeek Harness"/>
  30. </p>
  31. <details>
  32. <summary> 关键字高亮 · Latte &amp; Mocha</summary>
  33. <p align="center">
  34. <img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-combined.png" width="100%" alt="玻璃质感 · Latte & Mocha"/>
  35. </p>
  36. </details>
  37. ## 简介
  38. [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的
  39. [Catppuccin](https://github.com/catppuccin/catppuccin) 主题插件——一个包同时适配
  40. **Web GUI**(`dsh web`)、**桌面版**(官方 Electron 壳 `apps/desktop` 与社区 DSH Desktop,
  41. 共用 `desktop` profile)与 **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)** 终端:
  42. Web / 桌面端做全界面换色与玻璃质感,TUI 端自动同步四套官方主题色板。
  43. 它内置 Catppuccin 的四个主题——**Latte**、**Frappé**、**Macchiato**、**Mocha**——
  44. 把整个界面的配色都换成对应的 Catppuccin 色板;并在设置里拥有**自己的独立分区**
  45. (**设置 → Catppuccin**:风味、代码高亮、自定义覆盖、玻璃质感、更新检查、反馈与支持都在这一页),
  46. 选择会自动保存、重启自动恢复。
  47. 同时内置一套可开关的**玻璃质感**(Glassmorphism)皮肤:顶栏、侧边栏、
  48. 输入框、轨迹视图、聊天气泡、新会话按钮都变成磨砂玻璃卡片,
  49. 模糊度、磨砂度、背景亮度均可自由调节,玻璃颜色自动跟随当前
  50. Catppuccin 主题。
  51. ## 特性
  52. - 🎨 四个主题:Latte(浅色)、Frappé / Macchiato / Mocha(深色)
  53. - 🧩 接入官方主题系统,与内置浅色 / 深色 / 跟随系统主题平级
  54. - 🎯 全界面配色覆盖,不只是一两个强调色
  55. - ⚙️ 设置页独立分区一键切换,选择自动保存、重启自动恢复
  56. - 🔧 **自定义 token 覆盖**:按「`--dsw-* 变量: 值`」逐条覆盖单个配色 token(例如把注释色换成蓝色),与所选风味一起持久保存
  57. - 🖍️ **代码块高亮风格**:默认 / 注释斜体(italic-comments)两套 shiki 风格可选
  58. - 🌐 中 / 英 / 日 / 韩 / 西 / 法 / 德七语文案(跟随系统语言)
  59. - 🪟 **玻璃质感**(云母模式):顶栏 / 侧边栏 / 输入框 / 轨迹视图 / 聊天气泡 /
  60. 新会话按钮磨砂玻璃效果,设置里一键开关;云母 / 兼容双模式(兼容模式保持原版排版,
  61. 只给输入框卡片与浮层上玻璃),模糊度、磨砂度、
  62. 背景亮度自由调节(交互参考 [DSH-Transparent-UI-Plugin](https://github.com/WYH66666666/DSH-Transparent-UI-Plugin))
  63. - 🌫️ **玻璃拟态细节**:页面上下边缘渐变模糊、折叠侧边栏悬浮玻璃、
  64. 随主题的氛围地面(同色系渐变;两枚柔光斑是**可选开关、默认关**)——内容滚入视口边缘时柔化穿过,
  65. 玻璃透着地面的明暗,层次更立体
  66. - 🎨 玻璃配色自动跟随当前 Catppuccin 主题
  67. - 🔄 **检查 Catppuccin 插件更新**:设置页一键检测本插件(dsh-catppuccin)在 npm 上的最新版本,发现新版直接给出可复制的升级命令;**默认开启自动检查**(启动后一次 + 每 6 小时),更新渠道可选稳定版 / Beta
  68. - 💬 **反馈与支持**:设置区底部与插件详情页附 GitHub 链接——遇到问题可提 Issue,喜欢就点个 Star ⭐
  69. - 💻 **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI) 终端主题**:一条安装命令装进 dsh-TUI,四套主题自动同步到 `~/.dsh-tui/themes/`,见[安装 · dsh-TUI](#dsh-tui终端版主题)
  70. ## 预览
  71. 四个主题在 DeepSeek Harness 中的实际效果(截图来自本地 GUI,文首大图为四主题斜切合成):
  72. <details>
  73. <summary>🌻 Latte(浅色)</summary>
  74. <img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/latte.png"/>
  75. </details>
  76. <details>
  77. <summary>🪴 Frappé(深色)</summary>
  78. <img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/frappe.png"/>
  79. </details>
  80. <details>
  81. <summary>🌺 Macchiato(深色)</summary>
  82. <img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/macchiato.png"/>
  83. </details>
  84. <details>
  85. <summary>🌿 Mocha(深色)</summary>
  86. <img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/mocha.png"/>
  87. </details>
  88. ### 玻璃质感(Mica 云母模式)
  89. 同一会话在浅色(Latte)与深色(Mocha)下的磨砂玻璃效果:顶栏、侧边栏、
  90. 聊天气泡与输入框都是玻璃卡片,消息滚过页面边缘时被柔化
  91. (截图来自本地 GUI):
  92. <details>
  93. <summary>🌻 Latte(浅色玻璃)</summary>
  94. <img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-latte.png"/>
  95. </details>
  96. <details>
  97. <summary>🌿 Mocha(深色玻璃)</summary>
  98. <img src="https://raw.githubusercontent.com/NoNameLeGo/dsh-catppuccin-theme/main/assets/previews/glass-mocha.png"/>
  99. </details>
  100. ## 安装
  101. ### 方式一:从 npm 安装(推荐)
  102. ```sh
  103. dsh plugin --profile web add @nonamelego/dsh-catppuccin
  104. ```
  105. 装完重启 `dsh web` 即可,`dsh plugin` 会自动把它加进 profile 的 bundles。
  106. 其他 profile 把命令里的 `web` 换成对应名字即可(如 `headless`)。
  107. **桌面版**:官方桌面壳与社区桌面壳都读**同一个 profile** `$DSH_HOME/profiles/desktop`,但
  108. **两者装/升插件的方式完全不同、也不通用**——按你用的壳选一列:
  109. | | 官方桌面壳([DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 客户端) | 社区桌面壳([DSH Desktop](https://github.com/anywhere-labs/dsh-desktop)) |
  110. |---|---|---|
  111. | **安装** | 应用内的**插件界面** → 添加插件 → 填包名 `@nonamelego/dsh-catppuccin`(也接受 Git 地址 / 压缩包 / 本地路径) | 在打开的 **终端**里执行命令:<br>`dsh plugin --profile desktop add @nonamelego/dsh-catppuccin` |
  112. | **升级** | **先在插件界面里把插件删除,再重新填一遍同一个包名安装**(v0.2.0 没有升级入口,也没有版本选择器) | 与 web 类似的更新命令:<br>`dsh plugin --profile desktop update @nonamelego/dsh-catppuccin` |
  113. | 谁执行 pnpm | 应用自带的 pnpm | 应用自带的 pnpm |
  114. 两种方式改完都要**重启桌面应用**才会加载新版本。
  115. > ⚠️ **两列别混用**:官方壳的插件界面不执行命令;社区壳那条 `update` 命令对官方壳也不适用。
  116. > 另外,**系统 PATH 上那个普通 `dsh` 两个壳都管不了 `desktop`**——上游把 `desktop` 当自己保留的
  117. > profile,会直接报 `error: profile "desktop" is managed exclusively by the Electron application`。
  118. > 想用 CLI 管就用别的 profile 名(`web`、`headless`、`dsh-tui`)。
  119. > 本插件的桌面支持以
  120. > **官方 web + 官方 desktop** 为维护核心;社区壳的 `desktopProfiles` 服务探测也保留。
  121. > 但官方壳的 profile 进程**没有**专用的环境标记(它的 `DSH_DESKTOP_NODE_EXECUTABLE` 只注入给
  122. > 包安装子进程),所以本插件改为识别 **Electron-as-node 运行时**(`process.versions.electron`)
  123. > 来判定官方桌面版;设置的读写不受影响。
  124. ### 方式二:从仓库安装
  125. ```sh
  126. dsh plugin --profile web add https://github.com/NoNameLeGo/dsh-catppuccin-theme
  127. ```
  128. 从 git 安装时 pnpm 可能要求允许构建脚本——按 pnpm 的提示把对应包加进 profile
  129. `pnpm-workspace.yaml` 的 `allowBuilds` 后重跑一次即可。
  130. 桌面版同理,但按上面的表走:**官方壳**在插件界面里直接填 Git 地址;**社区壳**把这条命令的
  131. `dsh plugin --profile web add …` 换成 `dsh plugin --profile desktop add …`。
  132. ### **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)**(终端版)主题
  133. 本节针对第三方终端前端 **[dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)**(需先自行装好它)。
  134. 与 Web GUI 插件同一个包,用标准的插件安装命令装进 dsh-tui profile:
  135. ```sh
  136. dsh plugin --profile dsh-tui add @nonamelego/dsh-catppuccin
  137. ```
  138. 从仓库安装同理(也可用 git 形式,效果一致):
  139. ```sh
  140. dsh plugin --profile dsh-tui add https://github.com/NoNameLeGo/dsh-catppuccin-theme
  141. ```
  142. 包里带一个只做主题同步的小插件行(`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` 切换(选择会持久化,下次启动自动恢复)。
  143. > 💡 已为 Web GUI 装过本插件、同时用 dsh-TUI 的话,无需重复安装:Web 端每次
  144. > 启动会自动同步主题到 `~/.dsh-tui/themes/`(仅当该目录已存在)。
  145. > 📁 不想装包也可手动复制:把 `themes/*.json` 拷进 `~/.dsh-tui/themes/`
  146. > (Windows:`%USERPROFILE%\.dsh-tui\themes\`),只是不随版本自动更新。
  147. > ⚠️ `catppuccin-*.json` 归本插件所有、同步时会被覆盖;想自定义请改名另存。
  148. > 💡 TUI 主题只管 TUI 内部配色,终端背景由你的终端决定——建议也配上对应
  149. > 风味的 Catppuccin(见 [Catppuccin ports 列表](https://github.com/catppuccin/catppuccin#-ports)),观感最一致。
  150. ## 使用
  151. 1. 打开 Web GUI(默认 `http://127.0.0.1:3080`);在 [DSH Desktop](https://github.com/anywhere-labs/dsh-desktop) 中则直接打开桌面应用即可。
  152. 2. 打开 **设置**,在左侧导航里点 **Catppuccin**(官方各节之后的独立分区)。
  153. 3. 在 **主题** 区域选择风味:
  154. **Latte**(浅色)、**Frappé**、**Macchiato** 或 **Mocha**(深色)。
  155. 4. 打开 **跟随系统深色/浅色**:浅色时用 **Latte**、深色时用你选的风味(默认 **Mocha**),
  156. 随 Windows 的深浅色设置自动切换——原生标题栏和窗口按钮也会一起变。
  157. 深色端可单独选 Frappé / Macchiato / Mocha。
  158. 5. 选择 **关闭(官方主题)** 则回退到官方主题——会还原你启用 Catppuccin 之前
  159. 的官方偏好(浅色 / 深色 / 跟随系统),而不是强制重置。
  160. > 「跟随系统」一词以前指第 5 步的「关闭」,0.7.0 起两个功能分开命名,见上。
  161. > **另一处入口**:在 **插件页**(Plugins)点开本插件自己的卡片,中间会出现**同一组设置**
  162. > (Catppuccin 主题 / 玻璃质感 / 检查更新 / 反馈与支持)——两处读写的是同一份偏好,改哪边都一样。
  163. > 该区域由宿主(≥ `0.2.0-rc.2` 的插件详情页)提供,更旧的版本上没有。
  164. ### 代码高亮与自定义覆盖
  165. - **代码高亮风格**:默认 / **注释斜体**(italic-comments)——只影响代码块与 diff 的 shiki 高亮配色。
  166. - **自定义覆盖**(折叠区,按钮上显示已有条数):按「`--dsw-* 变量: 值`」逐条覆盖单个 token,
  167. 例如 `--dsw-static-blue-500` → `#89b4fa`。**键名**失焦生效(必须以 `--` 开头,否则该条会被丢弃);
  168. **值**同样失焦生效、**清空值即删除该条**;✕ 删除整行。覆盖持久保存,与所选风味一起生效。
  169. ### 玻璃质感
  170. 在 **设置 → Catppuccin** 页里找到 **玻璃质感** 区域:
  171. - **总开关**:开启后顶栏、侧边栏、输入框、轨迹视图变为磨砂玻璃;
  172. 关闭即完全还原原生界面(无需刷新)。
  173. - **模式**:**云母效果**把界面改成悬浮磨砂卡片;**兼容模式**保持原版排版,
  174. 只把材质换成玻璃。
  175. - **性能**:云母效果会在**大面积区域**(顶栏、输入框、侧边栏)做背景模糊,
  176. 流式输出时占用 GPU 较明显(同一会话实测峰值约 80%,兼容模式不到 30%);
  177. 模糊半径本身不是主因(调到 0 px 也照样计费——只要不是 `none`,每帧都要回读背景)。
  178. 在意占用就用**兼容模式**:它只在输入框卡片与浮层上做玻璃,命中面明显更小。
  179. - **预设**:**清透 / 标准 / 磨砂** 三档一键套用;想微调再用下面的滑条
  180. (当前旋钮值与某档一致时该档高亮)。
  181. - **玻璃模糊度**(0–40 px)、**磨砂度**(0–100%):控制玻璃的模糊半径与
  182. 不透明度。
  183. - **背景亮度**:深色模式 0–50 压暗、浅色模式 50–100 提亮(50 为原样),
  184. 直接调和进地面底色;拉到两端时氛围层淡出,回到纯白 / 纯黑。
  185. - **卡片间距**(4–24 px,**仅云母**):悬浮卡与窗口边缘的留白,另附**紧凑 / 标准 / 宽松**三档
  186. (8 / 12 / 20 px,默认标准)。只改外边距,正文列宽不变——间距是从侧栏列里扣的,所以**侧栏卡自身会变窄**;
  187. 折叠侧栏时窄轨最多向右探出 16px(再大会压住正文)。兼容模式与这个旋钮无关,设置里也会一并隐藏。
  188. - **地面光斑**:在地面渐变上叠两枚**固定于屏幕**的柔光斑(`0.6.3` 的观感),**默认关**——
  189. 光斑不跟面板走,每块玻璃透出的是它的不同部位,打开后左上角会明显偏亮。
  190. 打开后还有 **光斑强度**(0–200%,`100%` 就是上述观感,默认值;上限是**保守值**,按 Latte 上文字的
  191. 对比度预算定,见 `docs/issue-32-glow-tuning.md`)和 **光斑范围**(100–250%,`100%` = 出厂的两枚半径;
  192. 只放大,用来把光摊平、别堆在角落里)——
  193. 强度只放大两枚光斑,**不动**洗底渐变;背景亮度拉到两端时氛围归零,光斑随之淡出。
  194. - **就地预览**:玻璃区里有一条**地面样本条**(拖亮度或切光斑,它当场变化——取的就是页面地面那套色);
  195. 代码高亮下方有**代码样本**(直接读 `--shiki-token-*`,切「柔和注释」即刻变色);
  196. 模式选择旁的 **看一眼主界面** 会关掉设置页,让你直接看真实布局。
  197. 玻璃配色自动跟随当前主题,切换 Latte / Frappé / Macchiato / Mocha 时即时
  198. 变色;所有设置跨重启自动恢复。
  199. ### 检查 Catppuccin 插件更新
  200. 在 **设置 → Catppuccin** 页的 **玻璃质感** 下方找到 **检查更新** 区域:
  201. - 点击 **检查更新** 即对比 npm 上的最新版与当前版本:已是最新 → 显示当前
  202. 版本号;发现新版 → 显示新版本号并给出可复制的升级命令(命令中的 profile
  203. 名自动探测,无需手动替换;探测失败才回退为 `web`)。
  204. - **自动检查**:默认开启——启动后检查一次、之后每 6 小时一次(该行可关闭);
  205. **渠道**可选 **稳定版**(只跟 `latest`)或 **Beta 版**(连预发布一起跟)。
  206. - 本插件为本地链接 / 源码安装(`link:` / `file:` / git)时不显示 npm 升级
  207. 命令,会提示改用 `git pull` 或重新构建。
  208. - 通道策略:正式版只跟随 `latest` 标签;预发布版同时跟随 `beta`(升级命令
  209. 自动带 `@beta`)。离线或网络失败时显示原因并可重试。
  210. - 升级路径按**宿主**分流:**官方桌面版**(DeepSeek Harness 客户端)不给命令行——
  211. 它没有可达的终端入口,所以这一行改为给出 **`包名@渠道`** 并提示在
  212. **插件界面**里先删除、再重新安装(与上面「桌面版」段的升级路径一致);
  213. **社区桌面壳**与 **web** 仍照常给出可复制的 `dsh plugin …` 命令。
  214. 判定由宿主完成(`web` / `community-desktop` / `official-desktop`),无需你选。
  215. ## 玻璃拟态(Glassmorphism)
  216. **玻璃拟态**是一种视觉风格:界面面板像一片磨砂玻璃——半透明填充、
  217. 背景模糊(`backdrop-filter: blur()`)和玻璃细节(描边、内高光、柔和投影),
  218. 透过它能看到并柔化背后的内容。
  219. 本插件的具体效果:
  220. - **六个区域玻璃化**:顶栏、侧边栏、输入框、轨迹视图、聊天气泡
  221. 和新会话按钮;云母模式下成为带圆角的悬浮卡片,聊天内容滚动时从玻璃
  222. 下方穿过、被模糊;折叠侧边栏时导航条同样悬浮在聊天区边缘
  223. (「性能与用量」统计行不套玻璃卡、留在卡外,但自 `0.6.4` 起它下面有一条**同色磨砂背板**,
  224. 防止滚动正文从状态栏读数底下透出——见 CHANGELOG 的 `0.6.2`「拆除融合带」与 `0.6.4` 的 issue #29);
  225. - **页面边缘渐变模糊**:视口上下各有一条渐变模糊带,消息滚到边缘时被
  226. 柔化穿过——内容在边界「融化」(借鉴
  227. [DSH-Transparent-UI-Plugin](https://github.com/WYH66666666/DSH-Transparent-UI-Plugin)
  228. 的 Aqua 皮肤);
  229. - **配色自动跟随主题**:Latte 是浅色玻璃、Mocha 是深色玻璃,切换主题即时
  230. 变色;页面地面取当前主题色,叠同色系渐变与柔光斑,背景亮度旋钮调和进
  231. 地面底色(详见 `docs/issue-25-ambient-ground.md`);
  232. - **一键开关**:关闭即完全还原原生界面,插件卸载不留任何残留。
  233. ### 兼容模式误命中了别的面?
  234. 兼容模式靠**类名子串与语义属性**给宿主与第三方插件的悬浮面加玻璃,不需要插件配合——
  235. 代价是子串匹配**无法区分「面」与「面里的行级容器」**。自 `0.5.8` 起,明确会被命中的族只剩这些:
  236. | 族 | 锚点 |
  237. |---|---|
  238. | 输入框卡片 | `[data-composer-card]`(材质画在它的 `::before` 上,见 issue #19) |
  239. | 菜单 | `[data-menu-material='translucent']`(宿主 MenuSurface 的材质钩子;配方覆写它自带材质面读的 `--dsw-menu-surface-fill` / `--dsw-menu-backdrop-filter`)+ 手写菜单兜底 `[role='menu']:not([data-menu-material]):not([data-menu-material] *)` |
  240. | 弹出层 | `[class*='popover']` / `[class*='dropdown']`(仍是子串) |
  241. | 模态框 | `[role='presentation'] > [role='dialog'][aria-modal='true']`(**座位守卫**:只命中挂在 `[role='presentation']` 下面的面板;body 直挂的全屏浮层不算,见 issue #34) |
  242. | 宿主右侧栏(仅展开态) | `[data-sidebar-right-panel][data-sidebar-right-open]` |
  243. **第三方插件里新出现的类名仍可能被误命中**。遇到时走三步:**① 只读取证**(一段粘进控制台的探针脚本,
  244. 列出命中的元素与规则)→ **② 临时止血**(外部注入一条 `!important` 还原;本插件**不**提供
  245. 「自定义 CSS」配置项)→ **③ 反馈**(把取证输出连同 DSH 与插件版本提到
  246. [issues](https://github.com/NoNameLeGo/dsh-catppuccin-theme/issues))。
  247. 三步的完整说明、探针脚本与历史(#16 / #17 / #19)见 [docs/glass-mis-hits.md](docs/glass-mis-hits.md)。
  248. ### 环境限制:玻璃需要宿主提供可透出的底色
  249. 玻璃层用 `backdrop-filter` 读取**它背后实际被画出来的像素**。本插件只负责给面加材质,
  250. **不负责给宿主造透明底**:宿主若把窗口与自绘容器刷成不透明色,玻璃面背后就没有可柔化的
  251. 内容,效果退化为**半透明叠色**——能看到色调,看不到悬浮/磨砂层次。
  252. | 宿主 | 表现 | 原因 |
  253. |---|---|---|
  254. | 官方 Web GUI / 官方桌面壳 | 正常 | 窗口与容器提供可透出的底 |
  255. | 第三方 DSH Desktop(`dsh-plugin-desktop` `2.0.17`) | 仅半透明叠色 | Windows 上静默把窗口材质强制为 `off`(设置里的 Mica/纯色选项选了不生效);同时把侧栏表面与自绘容器刷成不透明面板色(`--dsh-desktop-frame-fill` / `.dshDesktopSidebarSurface` 取 `--dsw-alias-bg-layer-1`) |
  256. **本插件不会为此加 `!important` 覆写**:那等于让插件去接宿主的容器结构,宿主一改就碎,
  257. 也偏离「只改材质」的定位。宿主将来若能提供 Windows 原生窗口材质(`backgroundMaterial: mica/acrylic`),
  258. 本套实现无需改动即可受益。
  259. 自查(玻璃「正常」与「观感平」返回的 computed 值可能**完全相同**,差别只在宿主有没有给出透明底):
  260. ```js
  261. const s = document.querySelector('[data-dsh-glass-surface]'), cs = getComputedStyle(s)
  262. console.table({ backdropFilter: cs.backdropFilter, background: cs.backgroundColor,
  263. radius: cs.borderRadius, roots: [...document.documentElement.attributes]
  264. .map(a => a.name).filter(n => n.includes('glass')).join(', ') })
  265. ```
  266. 更早的第三方壳版本尚无可靠对照(无法确认当时主题/玻璃是否真的作用到侧栏),暂不下结论。
  267. ## 兼容性、权限与失败边界
  268. ### 兼容范围
  269. | 项 | 声明 |
  270. |---|---|
  271. | DSH | `>=0.1.7-rc.1`(设置页消费官方 `dsh-client-ui-primitives` 的 `SegmentedControl`,该导出自 `0.1.7-alpha.1` 起才有;旧的 `settingsScope` 通道代码保留,但 0.1.5 / 0.1.6 宿主不再声明支持) |
  272. | Node.js | `>=20` |
  273. | Profile | `web`(Web GUI 与两个桌面壳都启动 web 界面,共用本插件);桌面端默认 profile 名为 `desktop`(已声明) |
  274. | 已验证的具体版本 | `0.2.1-rc.5`:官方桌面壳真机验收——启动正常、token 逐项生效、玻璃配方完整(顶栏 / 输入卡 / dock / 菜单 / 设置壳逐面实测),`--dsw-*` 全表与前端构建产物**逐字节不变**([审计](docs/issue-0.2.1-rc.5-adaptation-audit.md));`0.2.1-rc.3`:三个新 More 菜单自动继承玻璃、视图标签行与 `-95/107` 滚动补偿不冲突([审计](docs/issue-0.2.1-rc.3-adaptation-audit.md));`0.2.1-rc.2`:官方桌面壳真机验收——插件正常启动、token 逐项生效、玻璃配方完整,**改设置真写回 `cordis.patch.yml`(修复前不写)**、重启后从文档采纳回来([审计](docs/desktop-0.2.1-adaptation-audit.md));`0.2.0-rc.2`:官方桌面壳自带运行时的启动级 e2e(19/19)、真机桌面窗口像素与标题栏取色链路、`configForms` 落盘([审计](docs/desktop-0.2.0-adaptation-audit.md));`0.1.7-rc.1`:真实 profile 上完成安装、启动、改设置落盘与重启恢复([证据](docs/issue-15-settings-seam-0.1.7.md));`0.1.7-rc.2`:启动级 e2e 与玻璃层的真页采样(issue #16 / #17);`0.1.5-rc.1`:按 CI 口径复跑的启动级 e2e(**历史记录**,已低于当前兼容下限) |
  275. `package.json` 的 `dsh.compatibility`(`dsh` / `dshReleases` / `dshOperations`)声明清单以文件为准,
  276. 当前是 `0.1.7-rc.1` / `0.2.0-rc.2` / `0.2.1-rc.2` / `0.2.1-rc.3` / `0.2.1-rc.5`(兼容下限 `>=0.1.7-rc.1`);
  277. 更早的 `0.1.5-rc.*` 与 `0.1.7-alpha.*` 是**当时**的验证记录,不在声明内。
  278. ⚠️ 商铺按「上游最新三版」窗口判定(`latest` / `next` / `alpha` 里版本号最高的那个往下数三版),
  279. **窗口内至少命中一条**才不会显示「兼容未声明」——所以上游每发一版都要跟,见
  280. `docs/issue-0.2.1-rc.5-adaptation-audit.md` §6.1。
  281. 色彩覆盖以 `dsh-v0.2.0-rc.2` 的 `design-platform.css` 为基线:每方案 190 个 `--dsw-*` token(static 77 /
  282. alias 101 / specific 11 / 非三族 1)全覆盖,含 0.2.0 新增的 17 个 alias。
  283. ### 第三方插件的浮层约定(issue #41)
  284. 玻璃层给输入卡(`[data-composer-card]`)建立了**层叠上下文**(`z-index: 8`),因为它必须压住滚动的转录区、
  285. 宿主 dock 行与上下渐隐带(后两者都是 `z-index: 7`)。代价是:**渲染在卡内的 `position: fixed` / `absolute`
  286. 弹出面板,最高只能到卡这一层**——面板写多大的 `z-index` 都只是「卡内的数字」。
  287. 所以装了别的插件、在**玻璃开启**时看到它的面板「被正文盖住」或「毛玻璃变成一整块灰」,不是那个面板自己的
  288. 问题,是它没离开卡片:
  289. 1. **首选**:`createPortal(panel, document.body)`,用视口坐标定位。
  290. 2. 必须在卡内渲染:改成 `position: absolute` + 卡内定位(`fixed` 还会被宿主的
  291. `will-change: transform` 重新锚定到 composer 座位,位置会整体偏),并接受「最高到卡层」。
  292. 3. 调大 `z-index` 没用——跨不出卡。
  293. 只在**玻璃开启**时存在;关掉玻璃 = 上游原样。分析与取证见
  294. [`docs/issue-41-composer-stacking-trap.md`](docs/issue-41-composer-stacking-trap.md)。
  295. ### 权限与外部访问
  296. | 类别 | 用途 | 边界 |
  297. |---|---|---|
  298. | 文件读 | 识别当前 profile 与安装来源(`$DSH_HOME/profiles/` 下的目录名);一次性读取旧状态文件 `~/.dsh/catppuccin-state.json` 做迁移 | 只读;`DSH_HOME` 取自 `process.env.DSH_HOME`,缺省 `~/.dsh` |
  299. | 文件写 | 把四套 TUI 主题 JSON 同步到 `~/.dsh-tui/themes/`(dsh-TUI 只从该目录读主题,无注册 API) | 只写这一个目录;`~/.dsh-tui` 不存在时是严格 no-op。设置本身由 DSH 的 settings 服务写入,插件只经官方服务读写 |
  300. | 网络 | 「检查更新」读取 npm registry 上 `@nonamelego/dsh-catppuccin` 的元数据;页面侧再向本插件的宿主路由取一次结果 | 只访问 `registry.npmjs.org` 与同源插件路由;**无遥测、无上报**;离线时该行报错、不影响使用 |
  301. | 命令 | 无 | 不执行任何子进程 / shell |
  302. | 凭据 | 无 | 不读取任何 token、key、密码;仅读 `DSH_HOME` 与桌面壳标记类环境变量 |
  303. ### 失败边界
  304. - 更新检查失败(离线、registry 异常、限流)只影响设置页那一行,**不阻塞启动**,也不影响主题与玻璃;
  305. - 主题注册失败时 DSH 自身主题照常可用;
  306. - 安装期只执行 `prepare`(本地用它构建 `lib/`)。仓库里的 `scripts/`(截图、E2E、changelog 生成)**不随 npm 包发布**(`files` 不含 `scripts`),也不会在安装时执行。
  307. ## 开发
  308. ```sh
  309. pnpm install # 装依赖
  310. pnpm typecheck # tsc --noEmit:src 的类型检查
  311. pnpm typecheck:tests # tsc --noEmit:tests 的类型检查
  312. pnpm test # vitest
  313. pnpm build # tsdown -> lib/index.js(服务端)+ lib/client.js(浏览器)
  314. ```
  315. 配色表由 `scripts/generate-palettes.mjs` 生成,**不要手改** `src/client/palettes.ts`;
  316. CHANGELOG 草稿由 `pnpm changelog:gen` 从 conventional 提交里产出。
  317. 完整命令清单、生成器与 typedoc、本地 link 调试见 [CONTRIBUTING.md](CONTRIBUTING.md);
  318. 状态契约的版本迁移约定见 [docs/state-migrations.md](docs/state-migrations.md)。
  319. ## 🙋 常见问题
  320. - Q: **_"为什么外观行里看不到 Catppuccin 主题?"_**\
  321. A: 官方外观行只列出内置的浅色/深色/跟随系统偏好。四个主题在它正下方的
  322. **Catppuccin** 行里。
  323. - Q: **_"我的主题选择是怎么记住的?"_**
  324. A: 选择持久保存在 DSH 的官方设置里(同一台机器的 DSH 共享这份偏好),浏览器
  325. localStorage 作为即时缓存与多标签页同步。落点随 DSH 版本而异:**0.1.6 及更早**
  326. 存于 DSH home 下的官方 settings 文档(`catppuccin` 命名空间);**0.1.7 起**上游
  327. 改为「插件配置表单」,落点是当前 profile 的 patch 文件里本插件的 `config:` 段
  328. (本插件两套都支持,按宿主实际提供的服务自动选择)。因此换浏览器、清站点数据、
  329. 自定义端口(`dsh web --port`)或再开一个桌面实例,偏好都不会丢;
  330. **DSH Desktop**(官方壳与 `anywhere-labs/dsh-desktop`)同样跨重启自动恢复。
  331. 玻璃质感开关与各旋钮同样持久保存。0.5.0 起旧版 `catppuccin-state.json`
  332. 会在首次启动时一次性迁移进官方设置(文件保留作回退)。
  333. - Q: **_"窄窗口下侧边栏没有自动收起、主内容区被压得很窄,是插件的问题吗?"_**\
  334. A: 不是。这是 DSH 上游 `ui-layout` 的行为:视口 **< 1024px** 时侧栏**默认自动收起**;
  335. 只有你手动点过侧栏开关,它才会以 280px 展开并挤压主区(主区 = 视口宽 − 280,501px
  336. 窗口下就是 221px),再点一次即收回。上游把这个「窄帧手动展开挤压」列为已知限制。
  337. 侧栏滚动条也是上游的**指针可达性**提示:指针不在侧栏内时不绘制,移进去(或直接滚轮)
  338. 就会出现。逐项实测读数与上游代码坐标见
  339. [docs/issue-18-narrow-sidebar.md](docs/issue-18-narrow-sidebar.md)。
  340. - Q: **_"怎么知道这个插件有没有新版本?"_**
  341. A: 设置 → Catppuccin → **检查更新** 一键检测本插件在 npm 上的最新版本,
  342. 发现新版会给出可复制的升级命令;也可以随时手动执行
  343. `dsh plugin --profile web update @nonamelego/dsh-catppuccin`
  344. (或重新 `add` 最新版)。
  345. **桌面版要分壳**:社区壳 [DSH Desktop](https://github.com/anywhere-labs/dsh-desktop) 在应用内的
  346. DSH 终端里用同一条命令(把 `web` 换成 `desktop`);**官方壳没有升级入口**——要在插件界面里
  347. **先删掉本插件,再重新填一遍包名 `@nonamelego/dsh-catppuccin` 安装**,然后重启应用。
  348. 两种方式不通用,详见上面「安装 → 桌面版」的对照表。
  349. - Q: **_"升级命令跑了,但版本没变(桌面版重启后也还是旧的)?"_**\
  350. A: 大概率是 pnpm 11 内置的**最小发布年龄**(`minimumReleaseAge`,默认 **24 小时**)把刚发布的版本
  351. 静默过滤掉了:`pnpm add` 会解析到**上一个**符合窗口的版本(例如新 beta 发布当天去装 `@beta`,
  352. 实际装到的仍是上一个 beta),而界面显示的却是目标版本。三条出路,任选其一:
  353. ① **指名精确版本**(最省事)——`@nonamelego/dsh-catppuccin@0.5.10-beta.0`,pnpm 会自动把该版本
  354. 写进当前 profile 的 `minimumReleaseAgeExclude`;② 在当前 profile 的 `pnpm-workspace.yaml` 里
  355. 给本包**整包豁免**(一次配置,之后每个新 beta 都能立刻装):
  356. `minimumReleaseAgeExclude:` 换行再加 ` - '@nonamelego/dsh-catppuccin'`;③ 等版本发布满 24 小时。
  357. 判断方法:看 profile 里 `node_modules/@nonamelego/dsh-catppuccin/package.json` 的 `version`,
  358. 以及 `pnpm-lock.yaml` 里那个包的 `specifier:`。
  359. ## 💝 致谢
  360. - [Catppuccin](https://github.com/catppuccin) 提供的色板与 port 模板
  361. - [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 的插件体系
  362. - [DSH-Transparent-UI-Plugin](https://github.com/WYH66666666/DSH-Transparent-UI-Plugin)
  363. 的玻璃质感交互与实现参考(云母 / 兼容双模式、模糊度 / 磨砂度等旋钮设计)
  364. &nbsp;
  365. <p align="center">
  366. <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/footers/gray0_ctp_on_line.svg?sanitize=true" />
  367. </p>
  368. <p align="center">
  369. Copyright &copy; 2021-present <a href="https://github.com/catppuccin" target="_blank">Catppuccin Org</a>
  370. </p>
  371. <p align="center">
  372. <a href="https://github.com/catppuccin/catppuccin/blob/main/LICENSE"><img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&logoColor=d9e0ee&colorA=363a4f&colorB=b7bdf8"/></a>
  373. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.