前言¶
DSH Web GUI 已经提供主题能力，但第三方开发者如果想加入自己的配色、图片背景或浅色/深色基底，通常还需要一个可安装、可验证、不改核心的插件层。dsh-skins 就是做这件事的客户端插件仓库：把皮肤注册进 DSH 的主题系统，并在设置页提供即时切换入口。
下面按已核实资料介绍它是什么、能做什么、怎么安装和验证。
这是什么¶
dsh-skins 是一个给 DeepSeek Harness (DSH) Web GUI 换肤的客户端插件仓库。
已核实资料中出现的名称和来源字段如下：
- 仓库名：
dsh-external/dsh-skins package.json包名：@dsh-external/dsh-web-skins- GitHub URL：
https://github.com/Moeblack/dsh-skins - 资料中的版权作者：
mattheliu
这些字段并不完全一致，且资料同时说明仓库当前为私有仓库、需要 dsh-external 组织读权限；另一方面，抓取页面可从 Moeblack/dsh-skins 访问。公开状态无法仅凭这些资料确认，使用前应先核对实际来源、访问权限和源码。
核心能力¶
通过官方 ThemeService 注册皮肤¶
按资料描述，本插件不直接改 DSH 核心前端，而是通过官方 ThemeService 注册第三方主题，并使用 --dsw-* alias token 做覆盖。资料将这种方式概括为“零核心改动”。
安装后，用户可以在设置页的通用区块看到“皮肤”选择器；点击皮肤即时切换，偏好写入 dsh.theme。
已列出的本地构建通过皮肤¶
资料列出四个本地构建通过的皮肤：
| 皮肤 ID | 基底 | 类型 | 说明 |
|---|---|---|---|
nord |
dark | token | 以 token 覆盖为主的皮肤 |
aurora |
dark | image | 图片背景皮肤 |
paper |
light | image | 浅色图片背景皮肤 |
dream |
dark | image | 图片背景皮肤 |
资料同时列出 neon-bamboo、ink-wash、harbor-night 为候选或未开工，不属于已发布皮肤。
图片背景与自包含资源¶
支持 dark/light 基底皮肤。图片皮肤会叠加 AI 生图背景。
资料说明背景图以 data URL 内联进 bundle，不依赖外部托管。也就是说，皮肤资源随插件交付，而不是要求用户额外配置外部图片地址。
本地构建与验证脚本¶
仓库提供本地构建和验证脚本，包括：
pnpm typecheck
pnpm build
pnpm test
pnpm verify
pnpm i18n
pnpm preview
pnpm verify 用于一次跑完 typecheck、build、test、产物冒烟，以及 i18n 双语一致性门禁。资料说明该门禁要求 README/docs 的中英文档结构一致，并成对更新。
安装与启用¶
先确认自己可以访问对应仓库。资料说明正式公开前请勿公开分发；如果仓库权限仍在 dsh-external 组织内，需要先获得相应读权限。
安装和启动命令如下：
omdsh market install dsh-web-skins --profile web --enable
omdsh activate --profile web
omdsh launch --profile web --
资料说明市场安装条目会把 id 解析为 @dsh-external/dsh-web-skins 与不可变 Git spec：
git+https://github.com/dsh-external/dsh-skins.git#78349585a85ab94fd3ad22bfcfa9816058da2d93
资料还说明每个 commit 作为不可变身份，因此更换皮肤版本会体现为更换 ref。OMDSH 默认禁用安装脚本。以上命令按资料原样列出。
典型用法¶
安装后切换皮肤¶
安装完成后，进入 DSH Web GUI：
- 打开 设置
- 进入 通用设置
- 在 皮肤 区块选择目标皮肤
- 点击后即时换肤
切换偏好会写入 dsh.theme。
新增一个皮肤¶
资料给出的新增路径是：
- 在
packages/dsh-web-skins/src/client/skins.ts增加SkinDefinition - 在
locales.ts补充skins.name.<id>的中英文案 - 如需图片背景，确保背景图以内联 data URL 进入 bundle
- 运行
pnpm verify做 typecheck、build、test、产物冒烟和 i18n 双语一致性门禁 - 在 README/docs 中登记新皮肤信息
经过上面的步骤后，可以在本地预览页查看效果：
pnpm preview
资料说明本地安装或预览依赖仓库旁的 fulltest-wt 快照或 Private DSH snapshot；资料未说明公开快照的获取方式。
适用场景与注意¶
适合以下情况：
- 你需要给 DSH Web GUI 增加第三方皮肤，而不是改核心源码
- 你需要 dark/light 基底皮肤，或需要叠加图片背景
- 你需要把皮肤定义、设置页入口和本地验证脚本放在同一个插件仓库中
- 你需要对 README/docs 中英文档做结构一致性检查
使用前注意：
- 插件以当前
dsh进程权限运行。安装前应检查源码、许可证、仓库来源和可执行逻辑。 package.json声明 license 为MIT；资料同时说明版权归mattheliu所有，仓库仅包含原创插件代码与 DSH 官方 logo 素材，不包含官方仓库其余源码。- 资料说明当前为私有仓库，正式公开前请勿公开分发。由于抓取 URL 与仓库名/包名不一致，公开状态无法仅凭资料确认。
- 候选皮肤
neon-bamboo、ink-wash、harbor-night不在已发布列表中，不要按已发布皮肤使用。 - DSH 理念是「一切皆插件」；社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应理解为官方应用商店。
结尾¶
dsh-skins 的价值在于把 DSH Web GUI 的换肤需求做成一个可安装、可验证的客户端插件：皮肤通过官方 ThemeService 注册，设置页可以直接切换，本地脚本也能跑 typecheck、build、test、verify 和 preview。
已核实资料提供的 GitHub 地址是：
https://github.com/Moeblack/dsh-skins
目录页未在已核实资料中提供可用 URL，因此本文不列出。
