给 DeepSeek Harness 换一套可调的皮肤（dsh-dream-skin）

DeepSeek Harness（DSH）的网页界面默认外观是统一的。想让工作区安静一点、顺眼一点的人，一般会去找换肤插件。同类做法多是往渲染进程里注入 CSS，客户端一升级就得重来，dsh-dream-skin 走的是 DSH 官方给第三方插件留的主题注册通道，以插件形式接入。

dsh-dream-skin 是给 DeepSeek Harness 网页端换肤的 JavaScript 插件：装进 DSH 后，可在设置里切换 8 套预设皮肤、配壁纸与强调色，还能导入导出主题包。

装完重启，界面就带着一套已经调好的出厂配置。想改的都在「设置 → 外观（Theme）」里：换皮肤、传壁纸、拖滑杆。它输出的东西就是界面外观本身，外加一份能发给别人的 *.dsh-theme.json 主题包。插件已发布到 npm，仓库用 MIT 许可证开源，主要语言是 JavaScript，地址为 https://github.com/RevolutionLA/dsh-dream-skin。

基础用法

安装与依赖

前提是本机已装好 DSH，并且能起网页端界面。插件已发布到 npm，不需要 clone 仓库。README 给了两条路。

一条是把下面这句话直接发给你的 DSH，让它自己装：

请帮我安装 dsh-dream-skin 换肤插件（https://github.com/RevolutionLA/dsh-dream-skin 或 npm 的 dsh-dream-skin），装完告诉我如何重启 DSH Web。

不想麻烦 Agent 就自己在命令行敲：

dsh plugin --profile web add dsh-dream-skin && dsh web

这里的 --profile web 指网页端 profile。官方桌面版（Electron）的 desktop profile 由应用独占管理，CLI 会硬拒，得在应用内的插件管理里更新。除了 DSH 本体，仓库里没有列其他依赖。

最短能跑通的示例

DSH 已装好、能起 web 界面的情况下，最短路径就是上面那条命令：

dsh plugin --profile web add dsh-dream-skin && dsh web

装完重启 DSH Web，重新打开界面即可。README 特意提醒了一句：已经装过老版本的 profile，请用 add 而不是 update，原因见下面「实际使用中的坑」。

确认它跑起来了

重启后进「设置 → 外观（Theme）」，能看到 Mirage 系列的 8 套皮肤——abyss、aurora、nebula、ember、midnight、ivory、mist、rose，说明插件已经加载。首次安装自带出厂配置：星云皮肤、内置壁纸，以及调好的玻璃数值，装完重启就能用。随便切一套皮肤，界面立刻跟着变，这一跑就算成功。

设置里找不到「外观」这一节，说明插件没被加载，去插件管理里确认状态。桌面版还要确认是在应用内的插件管理里更新的，而不是走 CLI。

主要功能

预设与材质

• 8 套 Mirage 预设皮肤：在「设置 → 外观（Theme）」一键切换。浅色系是 mist、ivory、rose，其余为深色系。每套自带专属默认参数，涵盖弥散光浓度、模糊、侧栏与输入框透明度、弹窗透明度、玻璃材质，切到哪套就是哪套的最佳状态，自己调过的参数不会被覆盖。仓库称 8 套皮肤全部通过 228 项可测质量门，其中 217 项调色门、11 项工艺门，检测的是 OKLCH 感知明度阶梯、三级文字对比度（同时对齐 WCAG 2.1 与 APCA）、信号色相分离与跨皮肤可区分度。
• 玻璃材质：毛玻璃与液态玻璃一键切换。透明度滑杆越往右越透；模糊只有一个旋钮，同时驱动壁纸与玻璃表面。
• 弹窗不透明度：一个滑块控制下拉菜单、浮层、弹窗的底填充透明度，跟随持久化保存。凡是用「弹层底色」令牌铺底的面，包括设置面板、插件管理、轨迹图 tooltip、卡片浮层，共享一层 92% 可读性下限，滑杆拉到底也不会读穿；下拉菜单与遮罩这两条腿仍是全量程。卡片、输入框、消息气泡则保持内层不透明，不被壁纸盖住。

壁纸与主题包

• 自定义壁纸 2.0：支持本地图、图片 URL、渐变预设三种来源。可调透明度与模糊，填充方式有三档——裁剪填满、完整显示、模糊填充。本地图会自动压缩到 2MB 以内。每套皮肤会自动建议一张渐变，也可以开启自动弱化，聚焦任务时降低干扰。高级壁纸里预填了必应每日一图接口，点「应用链接」即可，重复点会强制重新拉图，不会被浏览器缓存挡回旧图；任意图片 URL 加定时自动更新也支持。
• 每用户强调色 Accent：在当前皮肤上叠加自定义品牌色，走的是 overrideTokens 层，不动皮肤本身。提供 12 个典型色块一键选色，另有选色盘、随机、恢复主题色。
• 主题包导入 / 导出 / 分享：一个 *.dsh-theme.json 等于 manifest 加全套 tokens。可以导入文件、一键应用、复制分享链接，分享链接把配置编码进 URL hash，分发不需要写代码。
• 本地主题包库：导入过的主题包集中展示，支持应用、收藏、移除；「换一个试试」会随机换一个和当前不同的主题。导入时会校验格式、必填 token 与颜色合法性，失败或移除时安全回滚，不做破坏性更改。
• 默认还原与持久化：一键回到 DSH 内置外观，跟随系统。皮肤、壁纸、透明度这类设置走三层持久化，随开随关。README 没有展开这三层具体指什么。

参数与配置

常用参数

命令行层面只有一条命令和一个参数：

dsh plugin --profile web add dsh-dream-skin

--profile 决定装进哪个 profile，网页端写 web。桌面版的 desktop profile 由应用独占管理，CLI 会硬拒，需要在应用内更新。子命令用 add，不要用 update。README 给的一键安装句子里没有其他参数。

真正影响观感的调节项都在界面上，不在命令行：壁纸透明度、壁纸模糊、填充方式、侧栏透明度、输入框透明度、弹窗透明度、玻璃材质、强调色。这些是滑杆和色块，仓库里没有写出对应的命令行写法。

配置文件

插件对外唯一成文的文件格式是主题包 *.dsh-theme.json，内容是一个 manifest 加全套 tokens。仓库里没有列出每个字段的名称与取值含义，只说明导入时会校验格式、必填 token 与颜色合法性。

壁纸与外观状态本身没有可手改的配置文件，都在「设置 → 外观」的界面上完成。除此之外仓库里没有说明其他配置文件。

实际使用中的坑

• 老 profile 用 update 会报「已是最新」，界面却没变。v10.10.0 的发布说明里写明了原因：10.9.x 之前依赖范围写的是 ^9.29.0，按 semver 到不了 10.x 版本，所以 update 会以为已经是最新。改用 add 即可。这条是版本机制，不是偶发故障。
• 输入框透明度滑杆不生效。有用户在 v9.13.1、DSH 0.1.5-rc.2 上报告，用默认主题或切到透明材质，滑杆都没有作用。该 issue 当前状态为已解决。
• 壁纸层写死 cover，非 16:9 的图被裁掉大半。有用户实测 2560×1440 屏幕：1152×2016 的图放大 2.22 倍后只看得到中间 32%，1536×1536 只看得到 56%。后来插件加上了填充方式选项（裁剪填满 / 完整显示 / 模糊填充）。该 issue 已解决。
• 侧边栏与聊天背景的透明度分开调，侧边栏怎么拉都全透明，两边看着割裂。同类反馈还有设置对话框透明度过高、主页会话内容直接透过来，浅色或高对比壁纸下最明显。这两条都已解决。
• 插件加载失败：报 client-modules: require("@deepseek-ai/dsh-client-store") missed the module table，插件起不来。该 issue 已解决。

几个同类怎么选

下面三个都是 DSH 网页端的皮肤插件，形态相近，取向不同。

• dsh-dream-skin（本项目，★219）
  适合谁：天天用 DSH 网页端、愿意在设置里花几分钟滑滑杆，想要一整套可调材质与配色系统的人。
  部署方式：npm 包，一条 dsh plugin --profile web add dsh-dream-skin，或者让 DSH 的 Agent 自己装。
  主要限制：只服务于 DSH 网页端，离开 DSH 没有用；壁纸来源是静态图、图片 URL 与渐变，没有动态壁纸；仓库里没有说明这三层持久化写到了哪里。
  什么情况下选它更合适：需要 8 套原创预设、每用户强调色、主题包导入导出与分享链接这些成套能力时。
  项目地址：RevolutionLA/dsh-dream-skin
• elysia395/dsh-wallpaper-engine（★946）
  适合谁：本机已经装了 Wallpaper Engine、想把里面的动态壁纸搬进 DSH 界面的人。
  部署方式：DSH 插件；素材里没有更细的部署说明，未逐一核实。
  主要限制：核心能力是壁纸搬运与液态玻璃 UI，材质与配色的可调项按素材描述不如本项目细，也没有出厂壁纸与出厂皮肤。
  什么情况下选它更合适：要的就是动态场景壁纸，由内置的 WebWallGL 引擎实时渲染。
  项目地址：elysia395/dsh-wallpaper-engine
• XieRW/dsh-beauty-skins（★101）
  适合谁：想从现成壁纸预览网格里点一张就换、配色自动跟着壁纸走的人。
  部署方式：DSH 插件；素材里没有更细的部署说明，未逐一核实。
  主要限制：图源来自「哲风壁纸」的预览网格，配色由壁纸提取，自己捏材质的空间小。
  什么情况下选它更合适：不想调参数，接受「选一张图就完事」的用法。
  项目地址：XieRW/dsh-beauty-skins

要动态壁纸，或者本机 Wallpaper Engine 库里有大量场景壁纸，dsh-wallpaper-engine 比本项目对口；本项目的壁纸来源是静态图、URL 和渐变，做不了实时渲染，这是它明确的短板。反过来，把皮肤当成一套能调、能导出分享的材质系统来用，主题包与强调色这两层本项目多出来了。

适合谁

适合天天开着 DSH 网页端、觉得默认外观不顺眼，并且愿意在设置里花几分钟调的人。需要把一套配色分享给同事的，主题包 JSON 加分享链接够用。一次装好长期挂着、不想因为客户端更新再折腾的，插件形态也对路。

用别的编辑器或客户端、根本不装 DSH 的，这个插件没有用武之地。要动态壁纸的，去看 dsh-wallpaper-engine。想装完一个开关就完事、不想碰任何滑杆的，单一美学的定制皮肤更省事。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.2 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。