---
title: "使用 DSH Dream Skin 自定义主题、壁纸和透明效果"
seo_title: "DSH Dream Skin 设置：主题、壁纸、透明度与强调色"
description: "在 DeepSeek Harness（DSH）Web 中安装 Dream Skin，设置主题、壁纸、模糊、透明度与强调色，并检查本地存储和远程图片。"
canonical: https://52dsh.com/tutorials/revolutionla-dsh-dream-skin-install-config/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["Node.js 与 pnpm","独立 web Profile","可丢弃测试工作区"]
difficulty: intermediate
estimated_action_time: null
next_steps: null
published_at: 2026-08-22
updated_at: 2026-10-02
verified_on: 2026-10-02
maintenance_status: community
verification_level: source_reviewed
risk_level: medium
dsh_version: 0.2.0-rc.2
plugin_id: revolutionla-dsh-dream-skin
tutorial_kind: plugin_configuration
related_plugin_url: https://52dsh.com/plugins/revolutionla-dsh-dream-skin/
---

# 使用 DSH Dream Skin 自定义主题、壁纸和透明效果

在 DeepSeek Harness（DSH）Web 中安装 Dream Skin，设置主题、壁纸、模糊、透明度与强调色，并检查本地存储和远程图片。

<!-- BEGIN REVIEWED GUIDE SUPPLEMENT -->
## 2026-10-02 更新到 Dream Skin 9.29.0，适配 DSH 0.2.0-rc.2

本页安装目标更新为 `dsh-dream-skin@9.29.0`，命令固定使用 DSH 0.2.0-rc.2。新版本声明兼容 0.2.0-rc.2；本站只做了固定版本的源码与发布包静态复核，没有安装或运行。

- 版本号从 0.4.10 跳到 9.29.0，是作者从 8.28.0 起改用"月.日.当日序号"的日期版本，发布者与仓库都没有变化。
- 分享链接会自动导入：打开带主题 hash 的 DSH 地址即导入并登记主题包，无二次确认（client.js tryImportFromHash）；主题值经过 CSS 过滤，但仍应只打开可信来源的分享链接。
- 第三方图床请求：图片 URL 壁纸及可选定时刷新由浏览器直接请求外部主机（出厂预填 uapis.cn bing-daily），会暴露 IP 与 UA；默认壁纸为内联 SVG，定时刷新默认关闭。
- 宿主 DOM 依赖与残留：插件通过 MutationObserver 给宿主 DOM 打标记并注入材质样式，宿主改版会导致部分透明度失效（作者记录 6 个锚点中 4 个漂移）；卸载后 $DSH_HOME/dream-skin.json 与 localStorage 会保留。

**仍在使用 DSH 0.1.x：** 仍在使用 DSH 0.1.x 的用户：之前收录的 0.4.10（提交 96fe8c5494d6）peer 为 ^0.1.0-rc.6，只适用于 0.1.x，在 DSH 0.2.0-rc.1 及以上会被宿主整包跳过（外观设置全部消失，不报错）。9.29.0 的 peer 范围同时覆盖 0.1.0-rc.6 起的 0.1.x 与 0.2.x，0.1.x 用户也可以直接安装 dsh-dream-skin@9.29.0；如需保留旧版，可继续使用 github:RevolutionLA/dsh-dream-skin#96fe8c5494d6。两个版本共用同一个 $DSH_HOME/dream-skin.json 与 localStorage 键。

依据：[固定证据 1](https://github.com/RevolutionLA/dsh-dream-skin/blob/4e63b25e187fcb7bc93c65664888ce4f22617990/README.md)。
<!-- END REVIEWED GUIDE SUPPLEMENT -->

dsh-dream-skin 9.29.0 基于 DSH 官方 Theme Token 提供八套原生主题、壁纸（本地图/URL/渐变，新增裁剪填满、完整显示、模糊填充三种填充方式）、玻璃材质与各区域透明度、强调色、主题包导入导出与分享链接。

如果你的目标是为 DSH Web 设置主题、壁纸、模糊、透明度和强调色，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-dream-skin。本文锁定作者仓库提交 `4e63b25e187f`；已复核固定提交的原始资料，未进行运行实测。

> 对应插件：[查看 dsh-dream-skin 的功能、权限与兼容性说明](/plugins/revolutionla-dsh-dream-skin/)。先确认它适合你的工作流，再执行安装。

## 先确认是否适合你

- **分类**：界面交互
- **风险等级**：medium
- **核验证据**：source_reviewed
- **兼容性边界**：9.29.0 的 6 条 @deepseek-ai/dsh-client-* peer 为 >=0.1.0-rc.6 <0.3.0-0，按 semver 7 includePrerelease 计算满足 0.2.0-rc.2，也覆盖 0.1.x；0.3.x 被明确排除。@deepseek-ai/cordis ^4.0.1 与 react ^18.2.0 不在宿主预检范围。以上为声明层面兼容，52DSH 未在 0.2.0-rc.2 上运行验证；作者自述在 0.2.0-rc.1 上复核，未覆盖从 npm 全新安装路径。要求 Node.js >=18。
- **主要权限关注**：浏览器端注册主题、注入一个材质 <style> 并用 MutationObserver/定时器给宿主 DOM 打标记以调整透明度；读写 dsh-dream-skin:* localStorage 键与诊断全局量 window.__DSH_DREAM_SKIN_STATUS__；Host 端注册 /dream-skin/api（Host/Origin 信任围栏，非认证）并原子写入 $DSH_HOME/dream-skin.json（0600）。不读取模型凭据、不注册 Agent 工具、不启动子进程。

如果你准备在重要工作区使用，先阅读插件详情页的权限和数据流说明；“源码已审阅”或“资料已整理”都不等于安全认证。

## 安装前准备

**本页 DSH 命令版本：** `0.2.0-rc.2`。9.29.0 声明的 DSH 版本范围包含 0.2.0-rc.2，本页固定 DSH 0.2.0-rc.2。仅静态复核，未在本站运行验证。

- **DSH 0.2.0-rc.2**：通过 npx 运行 `@deepseek-ai/dsh@0.2.0-rc.2`，并使用独立的 web Profile 测试。
- **Node.js 18+**：插件 engines 声明 Node.js >=18。
- **可信壁纸来源**：使用图片 URL 壁纸时只填写可信的 HTTPS 图床地址。

1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本，并确认 `pnpm` 可用。
2. 使用独立的 `web` Profile 和可丢弃测试工作区，不直接连接生产目录。
3. 备份当前 Profile 配置，并记录安装前的 `--dump-config` 输出。
4. 核对固定来源中的外部服务、账号、运行时和平台限制。
5. 作者资料未显示明确的插件专属环境变量；如果运行时要求凭据，不要根据同类插件猜测变量名。

## 安装 dsh-dream-skin

52DSH 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

```bash
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web add dsh-dream-skin@9.29.0
```

GitHub 源码插件如果被 pnpm 拦截构建脚本，先检查终端提示的具体包和脚本。只在 `web` Profile 中放行确实需要的构建项，不要全局放行未知依赖。



## 插件专属配置

### 配置目标

- `设置 → 外观（Theme）`：切换皮肤、强调色、壁纸与填充方式、玻璃材质透明度，导入或导出主题包。
- `$DSH_HOME/dream-skin.json`：Host 端保存的外观偏好，跨端口和重启保持；由插件自动读写，不需要手改。

### 主题包文件（*.dsh-theme.json）

证据：[固定来源](https://github.com/RevolutionLA/dsh-dream-skin/blob/4e63b25e187fcb7bc93c65664888ce4f22617990/docs/examples/sample-theme-pack.json)。将路径、账号和凭据占位符替换为测试值。

```json
{
  "format": "dsh-dream-skin/pack",
  "version": 1,
  "manifest": {
    "id": "aurora-test",
    "name": "Aurora Test",
    "nameZh": "极光测试",
    "author": "RevolutionLA",
    "version": "1.0.0",
    "colorScheme": "dark",
    "accent": "#34d399",
    "tokens": {
      "--dsw-alias-bg-base": "#04120f",
      "--dsw-alias-bg-layer-1": "#0a1d18",
      "--dsw-alias-brand-primary": "#34d399",
      "--dsw-alias-label-primary": "#eafaf2",
      "--dsw-alias-label-secondary": "#92d5b8",
      "--dsw-alias-border-l1": "#0f2a22",
      "--dsw-alias-border-l2": "#1a3a30"
    }
  }
}
```

### 安装后设置

1. 重启 DSH Web 后打开 设置 → 外观（Theme），确认出现皮肤、强调色、壁纸与主题包等设置行。
2. 先使用内置皮肤和本地图片或渐变壁纸；需要图片 URL 时只填可信 HTTPS 地址，定时刷新按需手动开启。


## 配置验证与成功结果

先导出配置，再启动同一版本的 DSH Web：

```bash
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile web --dump-config
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web
```

1. **导出 web Profile 组合配置，确认 dream-skin 加载条目存在。**

   ```bash
   npx --yes @deepseek-ai/dsh@0.2.0-rc.2 --profile web --dump-config
   ```

   期望结果：输出中出现 id 为 dream-skin、name 为 dsh-dream-skin 的条目。

2. **启动 DSH Web，在 设置 → 外观（Theme）切换一套内置皮肤。**

   ```bash
   npx --yes @deepseek-ai/dsh@0.2.0-rc.2 web
   ```

   期望结果：界面配色立即切换；刷新页面后仍保持所选皮肤。

3. **在浏览器开发者工具控制台读取 window.__DSH_DREAM_SKIN_STATUS__。**

   期望结果：build 为 9.29.0，status 为 ready。

## 第一次使用

- 在 设置 → 外观（Theme）选择 nebula 皮肤，把壁纸切到本地图片并选择“模糊填充”。
- 导入示例主题包 sample-theme-pack.json，应用“极光测试”后再导出一份作为备份。

## 数据、权限与凭据

**数据流：**内置 Token、导入的主题包 JSON 或 URL hash 分享链接 → 客户端格式与 CSS 值校验 → Theme Runtime、localStorage 与 /dream-skin/api → $DSH_HOME/dream-skin.json；选择图片 URL 壁纸时浏览器直接请求该图片主机（出厂预填 uapis.cn bing-daily 链接，但默认壁纸为内联 SVG、定时刷新默认关闭）；开启定时刷新后按间隔带时间戳重新拉取；插件自身未发现遥测或其他外部请求。

**权限关注：**浏览器端注册主题、注入一个材质 <style> 并用 MutationObserver/定时器给宿主 DOM 打标记以调整透明度；读写 dsh-dream-skin:* localStorage 键与诊断全局量 window.__DSH_DREAM_SKIN_STATUS__；Host 端注册 /dream-skin/api（Host/Origin 信任围栏，非认证）并原子写入 $DSH_HOME/dream-skin.json（0600）。不读取模型凭据、不注册 Agent 工具、不启动子进程。

**数据存储：**浏览器 localStorage 的 dsh-dream-skin:* 键，以及 $DSH_HOME/dream-skin.json（经 /dream-skin/api 读写，文件权限 0600）。

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

## 卸载、回退与清理

停止 DSH 后，从同一个 Profile 移除包：

```bash
npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web remove dsh-dream-skin
```

1. 运行 npx --yes @deepseek-ai/dsh@0.2.0-rc.2 plugin --profile web remove dsh-dream-skin，并重启 DSH Web。
2. 如不再需要外观偏好，删除 $DSH_HOME/dream-skin.json，并在浏览器中清除该 DSH 地址下的 dsh-dream-skin:* localStorage 键。

## 常见问题

### 升级后外观设置整体消失

DSH 0.2.x 会跳过 peer 不满足的插件；确认已安装 9.29.0 而不是 0.4.10，并查看 DSH 启动日志中的插件跳过记录。

### 图片 URL 壁纸不显示

只支持 http、https 与 data:image 链接；检查图床可访问性，或改用本地图片和渐变。

### 安装时提示新版本被拒绝

可能是 pnpm 最小发布年龄策略拦截新版本；按作者 README 的更新说明处理，或稍后重试。

### 安装成功但页面或命令没有出现

先运行 `--dump-config` 确认 Bundle 已进入 `web` Profile，再重启 DSH Web 并硬刷新浏览器。不要通过反复扩大权限来解决加载问题。

### 插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务，检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文，并核对当前安装目标是否仍对应本页固定提交。

作者固定资料中未识别到独立故障章节。遇到插件特有错误时，应先停止 DSH、保留日志并回退插件。

## 固定来源证据

以下资料是本文配置结论的依据：

- [README.md](https://github.com/RevolutionLA/dsh-dream-skin/blob/4e63b25e187fcb7bc93c65664888ce4f22617990/README.md)
- [SECURITY.md](https://github.com/RevolutionLA/dsh-dream-skin/blob/4e63b25e187fcb7bc93c65664888ce4f22617990/SECURITY.md)

继续查看：[返回 dsh-dream-skin 插件详情页](/plugins/revolutionla-dsh-dream-skin/)，重新核对兼容性、权限、同类插件和来源状态。

## 原始来源

- https://github.com/RevolutionLA/dsh-dream-skin
- https://github.com/RevolutionLA/dsh-dream-skin/blob/4e63b25e187fcb7bc93c65664888ce4f22617990/package.json
- https://github.com/deepseek-ai/deepseek-harness/blob/639ed015397290b3745d163aafe02ffee4aa3f84/packages/boot/app-boot/src/plugin-compatibility.ts
- https://github.com/RevolutionLA/dsh-dream-skin/blob/4e63b25e187fcb7bc93c65664888ce4f22617990/README.md
- https://github.com/RevolutionLA/dsh-dream-skin/blob/4e63b25e187fcb7bc93c65664888ce4f22617990/SECURITY.md