前言¶
DSH 的桌面端和 Web 端默认外观是统一的，想换个视觉氛围时，通常只能忍受默认配色，或者自己改样式、改配置文件，改完又怕升级后被覆盖。dsh-theme-mist 是 ffyfox 维护的社区插件，把 DSH Go 参考设计的色彩、材质与圆角语言移植到桌面/Web 端，做成一个可热插拔的客户端主题：内置六套强调色，支持浅色 / 深色 / 跟随系统，禁用后不残留样式。下面介绍它的定位、功能、安装与使用方式。
这是什么¶
一句话：dsh-theme-mist 是 DeepSeek Harness（桌面端与 Web 端）的客户端视觉主题插件，包名 dsh-theme-mist，作者 ffyfox，当前版本 0.1.0，以 MIT License 开源。
它解决的问题是：让界面换肤变成「装插件 + 在官方设置里点一下」，而不是手改配置文件。它属于社区目录的「趣味换装」分类，是第三方社区插件，不是官方商店里的东西，与 DSH Go、DeepSeek 官方均无关联或背书。
核心功能¶
六套配色 × 明暗三态¶
内置雾蓝、黛青、暮紫、松石、琥珀、石墨六套强调色，并与官方「浅色 / 深色 / 跟随系统」叠加使用。浅色是微染冷白纸面，深色是偏蓝的深石板色（不是纯黑）。README 说明这 12 种组合全部通过 WCAG AA 对比度校验。
强调色只用在主操作按钮、关键选中态和右上角柔和光晕上，大面积背景与卡片靠明度层级和 0.5px 发丝描边拉开空间感，避免整屏着色。
两种侧栏材质¶
左侧栏提供两种材质：
- 玻璃（默认）：半透明抽屉底板，配 0.5px 发丝描边与右侧大圆角。
- 平铺：去掉底板，让页面渐变与右上角光晕直接贯穿三栏。
底部输入区采用悬浮毛玻璃，滚动对话时消息会从输入卡背后透出。
原生设置集成与零残留卸载¶
所有开关都嵌入官方「设置 → 通用设置」面板，无需手改配置文件。禁用或卸载后，所有令牌与样式表会还原为官方默认外观。
零 DOM 重写¶
插件包名描述里写明 “zero DOM rewrite”，即主题不依赖重写页面 DOM，而是通过注入官方客户端主题、设置与 locale 模块来叠加样式。
安装与启用¶
桌面端¶
打开桌面端左侧栏 「插件」→「添加插件」，输入：
dsh-theme-mist
Web 端¶
dsh plugin --profile web add dsh-theme-mist
个性化设置¶
安装启用后打开 「设置 → 通用设置」，会看到新增的两项：
| 设置项 | 选项 | 说明 |
|---|---|---|
| 配色 | 雾蓝 · 黛青 · 暮紫 · 松石 · 琥珀 · 石墨 | 点击色块即时切换。 |
| 侧栏材质 | 玻璃（默认） · 平铺 | 玻璃为半透明抽屉底板；平铺去掉底板，让渐变与光晕直接贯穿三栏。 |
卸载¶
桌面端在 「插件」 页面找到 Mist 主题 (dsh-theme-mist)，点击移除即可。
Web 端：
dsh plugin --profile web remove dsh-theme-mist
开发与检查¶
仓库提供完整的本地校验流程：
pnpm install # 安装依赖
pnpm build # 构建 lib/index.js 与 lib/client.js
pnpm verify # 构建 + 类型检查 + 单元测试 + 配色/令牌/打包契约校验
pnpm verify 实际串联的是 build、typecheck、test、check:palettes、check:tokens、check:pack 六个环节。底层实现细节见仓库内的 docs/architecture.md、docs/visual-spec.md 与配色色阶表 docs/reference/palette-tables.md。
适用场景与注意¶
适合想给 DSH 桌面端 / Web 端换一个统一视觉风格、又希望随时能干净卸载的开发者和团队。主题只在外观层生效，不改变对话或插件行为。
需要注意三点：
- 插件以当前 dsh 进程的权限运行，安装前应先阅读源码与许可证。该项目为 MIT License，另有
NOTICE声明独立重实现与第三方致谢。 - 插件声明的运行要求是
engines.dsh为>=0.2.1-alpha.1 <0.3.0，安装前确认本机 dsh 版本在该范围内。 - 这是社区插件，与 DeepSeek 官方无关联，功能与样式以仓库 README 为准。
小结¶
dsh-theme-mist 的价值在于把换肤收敛到一个插件：六套强调色、明暗跟随系统、两种侧栏材质，且卸载后零残留。适合需要统一界面氛围但又不想维护自定义补丁的场景。
目录页：https://www.skillhub.cn/plugins/ffyfox/dsh-theme-mist
代码仓库：https://github.com/ffyfox/dsh-theme-mist
