前言¶
DeepSeek Harness（dsh）是 DeepSeek 开源的智能体运行时，官方仓库把架构概括成一句话：一切皆插件。Web UI 默认就能完成模型配置、工作区选择和会话，外观则主要跟随内置主题。如果只想改配色、加一层角落光晕、换一张背景图或循环视频，不必上整套角色皮肤；社区插件 dsh-gui-customization 把这些选项收进「设置 → 界面设定」。
需要先分清两件事。DeepSeek Harness 本身由 DeepSeek 发布；插件目录站点 deepseek-harness-plugin.com 是独立的社区索引，与 DeepSeek / 幻方没有官方从属关系。下面的功能、安装命令和版本号，均以该目录页、插件 GitHub 仓库、npm 包以及 deepseek-ai/deepseek-harness 交叉核对为准。
这是什么¶
dsh-gui-customization 是面向 DeepSeek Harness Web UI 的主题定制插件，由 LAN-TINA-WS 维护，许可证 MIT，主要语言 TypeScript。目录分类为「主题与外观」。仓库自称「时装工坊」：改主题配色、自定义图片或视频背景、调节氛围灯，界面中英双语。
它和鲸鱼娘皮肤、桌宠不是同一类东西。能力集中在设置面板里的配色、光晕和背景，而不是替换整套角色立绘。package.json 里 dsh.client.platform 声明为 web，只挂网页界面。
当前发布版本在 npm 与 GitHub Release 上均为 0.6.2（2026-08-16 发布）。GitHub 仓库在 2026-08-17 核实为 14 星；社区目录页当时显示 10 星，星标以仓库页面为准。
核心功能¶
仓库根目录 README 与 CHANGELOG 对能力的描述可以对照如下。包内 packages/dsh-gui-customization/README.md 仍留有较早的台账和待办，其中「明暗分离编辑」「导入/导出」等条目已被后续版本实现，下文以根 README、CHANGELOG 和 0.6.2 发布说明为准。
配色¶
- 默认主题是 Nous 蓝，带明暗双模式。
- 四套预设一键切换：系统默认、Nous 蓝、靛紫、翡翠绿。
- 另有 13 个主题色字段，取色器与文本输入都可以改，点「应用配色」生效。
- CHANGELOG 0.6.0 起，深色主题有一套独立的 13 色；预设会把深色盘重置为配套方案，导出、导入和持久化同时携带明暗两套。
氛围光¶
角落光晕跟随主题主色。设置项包括开关、强度、呼吸幅度，以及 5 种位置模式，改完即时生效，不用刷新页面。
动态背景¶
- 图片：用系统文件选择对话框选本地图；README 写明内置预设「deepseek娘01」，CHANGELOG 0.5.2 又加入「deepseek娘02」「deepseek娘03」。
- 视频：同样走原生文件选择，静音循环播放。
- 图片与视频互斥，只能开一种。
- 主对话区会透出背景，并带一层随明暗变化的遮罩。
- 背景透明度滑块（CHANGELOG 0.5.0 记录范围为 10%–90%）和侧边栏透明开关。
- 背景文件存在浏览器 IndexedDB 里，刷新页面或重启 dsh 后仍能恢复。
CHANGELOG 还记了两处实际使用时会碰到的修复：0.5.1 起大图改走 Blob URL，避免部分浏览器丢弃大约 2 MB 以上的 CSS data URL；0.5.3 修复了深色主题下背景图/视频/预设透不出来的问题（由 FuturePioneer-3 提交）。
导入、导出与持久化¶
配色方案可以导出为 JSON，并自动复制到剪贴板；把 JSON 粘贴回去即可导入应用。界面文案随 DSH 的中/英文设置切换。设置项走 localStorage，背景走 IndexedDB。插件是组合插件形态，重启后仍在，并出现在「设置 → 插件」。
安装与启用¶
DeepSeek Harness 目前仍是 developer preview，官方 README 写明可能出现破坏性变更。本机还没有 CLI 时，可以按官方仓库的方式先拉起 Web UI：
npx @deepseek-ai/dsh web
默认地址是 http://127.0.0.1:3080。
社区目录页给出的安装命令原文如下，在 DeepSeek Harness 终端中运行即可：
dsh plugin add github:LAN-TINA-WS/dsh-gui-customization
该仓库是 pnpm monorepo，插件本体在 packages/dsh-gui-customization。根目录 README 与 v0.6.2 Release 说明都推荐带上 web profile 和子目录路径（仓库称国内网络下这条比等 npm 更快）：
dsh plugin --profile web add github:LAN-TINA-WS/dsh-gui-customization#path:packages/dsh-gui-customization
也可以从 npm 安装同名包（当前版本同样是 0.6.2）：
dsh plugin --profile web add dsh-gui-customization
或者从 Releases 下载 dsh-gui-customization-v0.6.2.zip，解压后用本地 link 安装。README 里的解压目录示例仍写着旧版 v0.5.2，以最新 Release 文件名为准：
dsh plugin --profile web add link:<解压目录>/dsh-gui-customization-v0.6.2
目录页还给出了固定 commit 的写法，把 #commit 换成实际哈希即可复现安装：
dsh plugin add github:LAN-TINA-WS/dsh-gui-customization#commit
无论用哪一种方式，安装后都需要重启 dsh web，再打开「设置 → 界面设定」配置。从 GitHub 安装源码时，pnpm 可能要求先允许该包的构建脚本，只对你审查过的仓库放行。
配置与使用¶
打开 Web UI 的「设置 → 界面设定」，区块与 README 配置表一致。
-
预设配色
先在「系统默认 / Nous 蓝 / 靛紫 / 翡翠绿」里选一套，确认明暗模式切换后颜色是否符合预期。CHANGELOG 0.6.1 修过一个回读问题：应用靛紫、翡翠绿或自定义色后再打开设置，高亮不再错误地停在「Nous 蓝」。 -
自定义颜色
改 13 个主题色字段，点「应用配色」。若同时使用明暗主题，按 0.6.0 的说明把深色盘单独编好，再导出备份。 -
导入 / 导出
导出后剪贴板里会有一份 JSON，可以留给自己下次重装，或贴进 issue 里分享。导入即应用，不需要再点一遍预设。 -
氛围光
打开开关后调强度、呼吸幅度和位置。这几项都是实时生效，适合边看主界面边微调。 -
背景图 / 视频
选本地图片、用内置「deepseek娘」预设，或选一段视频（静音循环）。图片和视频不要同时开。透明度滑块控制背景露多少，侧边栏透明开关单独控制侧栏是否透底。
改完刷新一次页面，确认配色和背景都还在。设置在 localStorage，背景在 IndexedDB，按仓库说明应能跨重启恢复。
适用场景与注意事项¶
适合已经在用 DSH Web UI、只想改外观、又不想换整套皮肤包的人。日常可以先套 Nous 蓝或靛紫，再决定要不要上背景图；需要把同一套配色同步到另一台机器时，用 JSON 导出即可。它不提供桌宠、角色立绘或侧边栏工作台，那些是目录里其他「主题与外观 / 界面增强」插件的范围。
使用前注意下面几条：
- 插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装前应检查源代码仓库和许可证；需要可复现安装时，固定 commit 哈希。
- 这是社区开源项目，MIT 许可。仓库说明
build/下的 tsdown 构建 preset 源自 dsh-web-ui（BSD-3-Clause），许可声明留在对应文件头部。 - 只作用于 Web UI，不能拿来改终端 TUI 或其他 profile 的外观。
- 背景文件存在本机浏览器存储里，换浏览器或清站点数据后需要重新选择。
- DeepSeek Harness 仍在快速迭代，第三方主题插件可能随宿主 API 变化而失效，升级 dsh 后如果界面设定消失，先核对插件是否仍加载。
问题、需求和配色分享，仓库指向 issue #1。
小结¶
dsh-gui-customization 把 DSH 网页界面的换装收成一组可持久化的设置：Nous 蓝等预设、13 色自定义、氛围光，以及图片/视频背景。它不是官方皮肤商店里的货架商品，而是 MIT 许可的社区组合插件，配置入口就在「设置 → 界面设定」。
目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-gui-customization/
GitHub：https://github.com/LAN-TINA-WS/dsh-gui-customization
